blob: 9b7a4caf1df9603cd1d77441419fbf2286cda1a9 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
|
/*
* Copyright 1993-2002 Christopher Seiwald and Perforce Software, Inc.
*
* This file is part of Jam - see jam.c for Copyright information.
*/
/*
* pathsys.h - PATHNAME struct
*/
/*
* PATHNAME - a name of a file, broken into <grist>dir/base/suffix(member)
*
* <grist> - salt to distinguish between targets that would otherwise have the
* same name - it never appears in the bound name of a target.
*
* (member) - archive member name: the syntax is arbitrary, but must agree in
* path_parse(), path_build() and the Jambase.
*/
#ifndef PATHSYS_VP_20020211_H
#define PATHSYS_VP_20020211_H
#include "object.h"
#include "strings.h"
typedef struct _pathpart
{
char const * ptr;
int len;
} PATHPART;
typedef struct _pathname
{
PATHPART part[ 6 ];
#define f_grist part[ 0 ]
#define f_root part[ 1 ]
#define f_dir part[ 2 ]
#define f_base part[ 3 ]
#define f_suffix part[ 4 ]
#define f_member part[ 5 ]
} PATHNAME;
void path_build( PATHNAME *, string * file );
void path_parse( char const * file, PATHNAME * );
void path_parent( PATHNAME * );
/* Given a path, returns an object containing an equivalent path in canonical
* format that can be used as a unique key for that path. Equivalent paths such
* as a/b, A\B, and a\B on NT all yield the same key.
*/
OBJECT * path_as_key( OBJECT * path );
/* Called as an optimization when we know we have a path that is already in its
* canonical/long/key form. Avoids the need for some subsequent path_as_key()
* call to do a potentially expensive path conversion requiring access to the
* actual underlying file system.
*/
void path_register_key( OBJECT * canonic_path );
/* Returns a static pointer to the system dependent path to the temporary
* directory. NOTE: Does *not* include a trailing path separator.
*/
string const * path_tmpdir( void );
/* Returns a new temporary name. */
OBJECT * path_tmpnam( void );
/* Returns a new temporary path. */
OBJECT * path_tmpfile( void );
/* Give the first argument to 'main', return a full path to our executable.
* Returns null in the unlikely case it cannot be determined. Caller is
* responsible for freeing the string.
*
* Implemented in jam.c
*/
char * executable_path( char const * argv0 );
void path_done( void );
#endif
|
