xref: /netbsd-src/bin/sh/var.h (revision c38e7cc395b1472a774ff828e46123de44c628e9)
1 /*	$NetBSD: var.h,v 1.36 2017/10/28 03:59:11 kre Exp $	*/
2 
3 /*-
4  * Copyright (c) 1991, 1993
5  *	The Regents of the University of California.  All rights reserved.
6  *
7  * This code is derived from software contributed to Berkeley by
8  * Kenneth Almquist.
9  *
10  * Redistribution and use in source and binary forms, with or without
11  * modification, are permitted provided that the following conditions
12  * are met:
13  * 1. Redistributions of source code must retain the above copyright
14  *    notice, this list of conditions and the following disclaimer.
15  * 2. Redistributions in binary form must reproduce the above copyright
16  *    notice, this list of conditions and the following disclaimer in the
17  *    documentation and/or other materials provided with the distribution.
18  * 3. Neither the name of the University nor the names of its contributors
19  *    may be used to endorse or promote products derived from this software
20  *    without specific prior written permission.
21  *
22  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
23  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
24  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
25  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
26  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
27  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
28  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
29  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
30  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
31  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32  * SUCH DAMAGE.
33  *
34  *	@(#)var.h	8.2 (Berkeley) 5/4/95
35  */
36 
37 #ifndef	VUNSET		/* double include protection */
38 /*
39  * Shell variables.
40  */
41 
42 /* flags */
43 #define VUNSET		0x0001	/* the variable is not set */
44 #define VEXPORT		0x0002	/* variable is exported */
45 #define VREADONLY	0x0004	/* variable cannot be modified */
46 #define VNOEXPORT	0x0008	/* variable may not be exported */
47 
48 #define VSTRFIXED	0x0010	/* variable struct is statically allocated */
49 #define VTEXTFIXED	0x0020	/* text is statically allocated */
50 #define VSTACK		0x0040	/* text is allocated on the stack */
51 #define VNOFUNC		0x0100	/* don't call the callback function */
52 #define VFUNCREF	0x0200	/* the function is called on ref, not set */
53 
54 #define VNOSET		0x4000	/* do not set variable - just readonly test */
55 #define VNOERROR	0x8000	/* be quiet if set fails (no error msg) */
56 
57 struct var;
58 
59 union var_func_union {		/* function to be called when:  */
60 	void (*set_func)(const char *);		/* variable gets set/unset */
61 	char*(*ref_func)(struct var *);		/* variable is referenced */
62 };
63 
64 struct var {
65 	struct var *next;		/* next entry in hash list */
66 	int flags;			/* flags are defined above */
67 	char *text;			/* name=value */
68 	int name_len;			/* length of name */
69 	union var_func_union v_u;	/* function to apply (sometimes) */
70 };
71 
72 
73 struct localvar {
74 	struct localvar *next;		/* next local variable in list */
75 	struct var *vp;			/* the variable that was made local */
76 	int flags;			/* saved flags */
77 	char *text;			/* saved text */
78 };
79 
80 
81 extern struct localvar *localvars;
82 
83 extern struct var vifs;
84 extern char ifs_default[];
85 extern struct var vmail;
86 extern struct var vmpath;
87 extern struct var vpath;
88 extern struct var vps1;
89 extern struct var vps2;
90 extern struct var vps4;
91 extern struct var line_num;
92 #ifndef SMALL
93 extern struct var editrc;
94 extern struct var vterm;
95 extern struct var vtermcap;
96 extern struct var vhistsize;
97 extern struct var ps_lit;
98 extern struct var euname;
99 extern struct var random_num;
100 extern intmax_t sh_start_time;
101 #endif
102 
103 extern int line_number;
104 extern int funclinebase;
105 extern int funclineabs;
106 
107 /*
108  * The following macros access the values of the above variables.
109  * They have to skip over the name.  They return the null string
110  * for unset variables.
111  */
112 
113 #define ifsset()	((vifs.flags & VUNSET) == 0)
114 #define ifsval()	(ifsset() ? (vifs.text + 4) : ifs_default)
115 #define mailval()	(vmail.text + 5)
116 #define mpathval()	(vmpath.text + 9)
117 #define pathval()	(vpath.text + 5)
118 #define ps1val()	(vps1.text + 4)
119 #define ps2val()	(vps2.text + 4)
120 #define ps4val()	(vps4.text + 4)
121 #define optindval()	(voptind.text + 7)
122 #ifndef SMALL
123 #define histsizeval()	(vhistsize.text + 9)
124 #define termval()	(vterm.text + 5)
125 #endif
126 
127 #define mpathset()	((vmpath.flags & VUNSET) == 0)
128 
129 void initvar(void);
130 void setvar(const char *, const char *, int);
131 void setvareq(char *, int);
132 struct strlist;
133 void listsetvar(struct strlist *, int);
134 char *lookupvar(const char *);
135 char *bltinlookup(const char *, int);
136 char **environment(void);
137 void shprocvar(void);
138 int showvars(const char *, int, int, const char *);
139 void mklocal(const char *, int);
140 void listmklocal(struct strlist *, int);
141 void poplocalvars(void);
142 int unsetvar(const char *, int);
143 void choose_ps1(void);
144 int setvarsafe(const char *, const char *, int);
145 void print_quoted(const char *);
146 int validname(const char *, int, int *);
147 
148 #endif
149