xref: /freebsd/bin/sh/var.h (revision 8fc257994d0ce2396196d7a06d50d20c8015f4b7)
1 /*-
2  * Copyright (c) 1991, 1993
3  *	The Regents of the University of California.  All rights reserved.
4  *
5  * This code is derived from software contributed to Berkeley by
6  * Kenneth Almquist.
7  *
8  * Redistribution and use in source and binary forms, with or without
9  * modification, are permitted provided that the following conditions
10  * are met:
11  * 1. Redistributions of source code must retain the above copyright
12  *    notice, this list of conditions and the following disclaimer.
13  * 2. Redistributions in binary form must reproduce the above copyright
14  *    notice, this list of conditions and the following disclaimer in the
15  *    documentation and/or other materials provided with the distribution.
16  * 4. Neither the name of the University nor the names of its contributors
17  *    may be used to endorse or promote products derived from this software
18  *    without specific prior written permission.
19  *
20  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
21  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
24  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30  * SUCH DAMAGE.
31  *
32  *	@(#)var.h	8.2 (Berkeley) 5/4/95
33  * $FreeBSD$
34  */
35 
36 /*
37  * Shell variables.
38  */
39 
40 /* flags */
41 #define VEXPORT		0x01	/* variable is exported */
42 #define VREADONLY	0x02	/* variable cannot be modified */
43 #define VSTRFIXED	0x04	/* variable struct is statically allocated */
44 #define VTEXTFIXED	0x08	/* text is statically allocated */
45 #define VSTACK		0x10	/* text is allocated on the stack */
46 #define VUNSET		0x20	/* the variable is not set */
47 #define VNOFUNC		0x40	/* don't call the callback function */
48 
49 
50 struct var {
51 	struct var *next;		/* next entry in hash list */
52 	int flags;			/* flags are defined above */
53 	char *text;			/* name=value */
54 	void (*func)(const char *);
55 					/* function to be called when  */
56 					/* the variable gets set/unset */
57 };
58 
59 
60 struct localvar {
61 	struct localvar *next;		/* next local variable in list */
62 	struct var *vp;			/* the variable that was made local */
63 	int flags;			/* saved flags */
64 	char *text;			/* saved text */
65 };
66 
67 
68 struct localvar *localvars;
69 
70 extern struct var vifs;
71 extern struct var vmail;
72 extern struct var vmpath;
73 extern struct var vpath;
74 extern struct var vppid;
75 extern struct var vps1;
76 extern struct var vps2;
77 extern struct var vps4;
78 #ifndef NO_HISTORY
79 extern struct var vhistsize;
80 extern struct var vterm;
81 #endif
82 
83 /*
84  * The following macros access the values of the above variables.
85  * They have to skip over the name.  They return the null string
86  * for unset variables.
87  */
88 
89 #define ifsval()	(vifs.text + 4)
90 #define ifsset()	((vifs.flags & VUNSET) == 0)
91 #define mailval()	(vmail.text + 5)
92 #define mpathval()	(vmpath.text + 9)
93 #define pathval()	(vpath.text + 5)
94 #define ps1val()	(vps1.text + 4)
95 #define ps2val()	(vps2.text + 4)
96 #define ps4val()	(vps4.text + 4)
97 #define optindval()	(voptind.text + 7)
98 #ifndef NO_HISTORY
99 #define histsizeval()	(vhistsize.text + 9)
100 #define termval()	(vterm.text + 5)
101 #endif
102 
103 #define mpathset()	((vmpath.flags & VUNSET) == 0)
104 
105 void initvar(void);
106 void setvar(const char *, const char *, int);
107 void setvareq(char *, int);
108 struct strlist;
109 void listsetvar(struct strlist *);
110 char *lookupvar(const char *);
111 char *bltinlookup(const char *, int);
112 void bltinsetlocale(void);
113 void bltinunsetlocale(void);
114 char **environment(void);
115 int showvarscmd(int, char **);
116 int exportcmd(int, char **);
117 int localcmd(int, char **);
118 void mklocal(char *);
119 void poplocalvars(void);
120 int setvarcmd(int, char **);
121 int unsetcmd(int, char **);
122 int unsetvar(const char *);
123 int setvarsafe(const char *, const char *, int);
124