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
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
|
#ifndef VAR_H
#define VAR_H
/*
* Copyright (c) 2001 Marc Espie.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE OPENBSD PROJECT AND CONTRIBUTORS
* ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
* A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OPENBSD
* PROJECT OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*/
extern void Var_Init(void);
#ifdef CLEANUP
extern void Var_End(void);
#else
#define Var_End()
#endif
extern GSymT *VAR_GLOBAL; /* Variables defined in a global context, e.g
* in the Makefile itself */
extern GSymT *VAR_CMD; /* Variables defined on the command line */
/* Global contexts handling. */
/* value = Var_Valuei(name, end);
* Returns value of global variable name/end, or NULL if inexistent. */
extern char *Var_Valuei(const char *, const char *);
#define Var_Value(n) Var_Valuei(n, NULL)
/* Var_Seti(name, end, val, ctxt);
* Sets value val of variable name/end in context ctxt. Copies val. */
extern void Var_Seti(const char *, const char *, const char *,
GSymT *);
#define Var_Set(n, v, ctxt) Var_Seti(n, NULL, v, ctxt)
/* Var_Appendi(name, end, val, cxt);
* Appends value val to variable name/end in context ctxt, defining it
* if it does not already exist, and inserting one space otherwise. */
extern void Var_Appendi(const char *, const char *,
const char *, GSymT *);
#define Var_Append(n, v, ctxt) Var_Appendi(n, NULL, v, ctxt)
/* Var_Delete(name);
* Deletes a variable from the global context. */
extern void Var_Delete(const char *);
/* Local context handling */
#define TARGET_INDEX 0
#define PREFIX_INDEX 1
#define ARCHIVE_INDEX 2
#define MEMBER_INDEX 3
#define OODATE_INDEX 4
#define ALLSRC_INDEX 5
#define IMPSRC_INDEX 6
extern char *Varq_Value(int, GNode *);
extern void Varq_Set(int, const char *, GNode *);
extern void Varq_Append(int, const char *, GNode *);
/* SymTable_Init(t);
* Inits the local symtable in a GNode. */
extern void SymTable_Init(SymTable *);
/* SymTable_destroy(t);
* Destroys the local symtable in a GNode. */
extern void SymTable_Destroy(SymTable *);
/* Several ways to parse a variable specification. */
/* value = Var_Parse(varspec, ctxt, undef_is_bad, &length, &freeit);
* Parses a variable specification varspec and evaluates it in context
* ctxt. Returns the resulting value, freeit indicates whether it's
* a copy that should be freed when no longer needed. If it's not a
* copy, it's only valid until the next time variables are set.
* The length of the spec is returned in length, e.g., varspec begins
* at the $ and ends at the closing } or ). Returns special value
* var_Error if a problem occurred. */
extern char *Var_Parse(const char *, SymTable *, bool, size_t *,
bool *);
/* Note that var_Error is an instance of the empty string "", so that
* callers who don't care don't need to. */
extern char var_Error[];
/* length = Var_ParseSkip(varspec, ctxt, &ok);
* Parses a variable specification and returns the specification
* length. Fills ok if the varspec is correct, that pointer can be
* NULL if this information is not needed. */
extern size_t Var_ParseSkip(const char *, SymTable *, bool *);
/* ok = Var_ParseBuffer(buf, varspec, ctxt, undef_is_bad, &length);
* Similar to Var_Parse, except the value is directly appended to
* buffer buf. */
extern bool Var_ParseBuffer(Buffer, const char *, SymTable *,
bool, size_t *);
/* The substitution itself */
/* subst = Var_Subst(str, ctxt, undef_is_bad);
* Substitutes all variable values in string str under context ctxt.
* Emit a PARSE_FATAL error if undef_is_bad and an undef variable is
* encountered. The result is always a copy that should be free. */
extern char *Var_Subst(const char *, SymTable *, bool);
/* Var_SubstVar(buf, str, varname, val);
* Substitutes variable varname with value val in string str, adding
* the result to buffer buf. undefs are never error. */
extern void Var_SubstVar(Buffer, const char *, const char *, const char *);
/* Note that substituting to a buffer in Var_Subst is not useful. On the
* other hand, handling intervals in Var_Subst and Var_Parse would be
* useful, but this is hard. */
/* Var_Dump();
* Print out all global variables. */
extern void Var_Dump(void);
/* Var_AddCmdline(name);
* Add all variable values from VAR_CMD to variable name.
* Used to propagate variable values to submakes through MAKEFLAGS. */
extern void Var_AddCmdline(const char *);
extern bool oldVars; /* Do old-style variable substitution */
extern bool checkEnvFirst; /* true if environment should be searched for
* variables before the global context */
#endif
|
