1 /* $NetBSD: var.h,v 1.42 2026/05/28 10:07:58 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 52 #define VUNSAFE 0x0080 /* variable value imported from environment */ 53 54 #define VNOFUNC 0x0100 /* don't call the callback function */ 55 #define VFUNCREF 0x0200 /* the function is called on ref, not set */ 56 #define VFUNCPOST 0x0400 /* call callback func after setting var */ 57 58 #define VSPECIAL 0x1000 /* magic properties not lost when set */ 59 #define VDOEXPORT 0x2000 /* obey VEXPORT even if VNOEXPORT */ 60 #define VNOSET 0x4000 /* do not set variable - just readonly test */ 61 #define VNOERROR 0x8000 /* be quiet if set fails (no error msg) */ 62 63 struct var; 64 65 union var_func_union { /* function to be called when: */ 66 /* variable set/unset */ 67 void (*set_func)(const char *, int, struct var *); 68 char*(*ref_func)(struct var *); /* variable is referenced */ 69 }; 70 71 struct var { 72 struct var *next; /* next entry in hash list */ 73 int flags; /* flags are defined above */ 74 char *text; /* name=value */ 75 int name_len; /* length of name */ 76 union var_func_union v_u; /* function to apply (sometimes) */ 77 }; 78 79 80 struct localvar { 81 struct localvar *next; /* next local variable in list */ 82 struct var *vp; /* the variable that was made local */ 83 int flags; /* saved flags */ 84 char *text; /* saved text */ 85 union var_func_union v_u; /* saved function */ 86 }; 87 88 89 extern struct localvar *localvars; 90 91 extern struct var vifs; 92 extern char ifs_default[]; 93 extern struct var vmail; 94 extern struct var vmpath; 95 extern struct var vpath; 96 extern struct var vps1; 97 extern struct var vps2; 98 extern struct var vps4; 99 extern struct var line_num; 100 #ifndef SMALL 101 extern struct var editrc; 102 extern struct var vterm; 103 extern struct var vtermcap; 104 extern struct var vhistappend; 105 extern struct var vhistfile; 106 extern struct var vhistsize; 107 extern struct var ps_lit; 108 extern struct var euname; 109 extern struct var random_num; 110 extern intmax_t sh_start_time; 111 extern struct var lc_all; 112 extern struct var lc_collate; 113 extern struct var lc_ctype; 114 extern struct var lc_messages; 115 extern struct var lc_monetary; 116 extern struct var lc_numeric; 117 extern struct var lc_time; 118 extern struct var lc_lang; 119 #endif 120 121 extern int line_number; 122 extern int funclinebase; 123 extern int funclineabs; 124 125 /* 126 * The following macros access the values of the above variables. 127 * They have to skip over the name. They return the null string 128 * for unset variables. 129 */ 130 131 #define ifsset() ((vifs.flags & VUNSET) == 0) 132 #define ifsval() (ifsset() ? (vifs.text + 4) : ifs_default) 133 #define mailval() (vmail.text + 5) 134 #define mpathval() (vmpath.text + 9) 135 #define pathval() (vpath.text + 5) 136 #define ps1val() (vps1.text + 4) 137 #define ps2val() (vps2.text + 4) 138 #define ps4val() (vps4.text + 4) 139 #define optindval() (voptind.text + 7) 140 #ifndef SMALL 141 #define histsizeval() (vhistsize.text + 9) 142 #define histsizeflags() (vhistsize.flags) 143 #define histfileval() (vhistfile.text + 9) 144 #define histfileflags() (vhistfile.flags) 145 #define histappval() (vhistappend.text + 11) 146 #define histappflags() (vhistappend.flags) 147 #define termval() (vterm.text + 5) 148 #endif 149 150 #define mpathset() ((vmpath.flags & VUNSET) == 0) 151 152 void initvar(void); 153 void setvar(const char *, const char *, int); 154 void setvareq(char *, int); 155 struct strlist; 156 void listsetvar(struct strlist *, int); 157 char *lookupvar(const char *); 158 char *bltinlookup(const char *, int); 159 char **environment(void); 160 void shprocvar(void); 161 int showvars(const char *, int, int, const char *); 162 void mklocal(const char *, int); 163 void listmklocal(struct strlist *, int); 164 void poplocalvars(void); 165 int unsetvar(const char *, int); 166 void choose_ps1(void); 167 void setvar_invocation(int, char **); 168 int setvarsafe(const char *, const char *, int); 169 void setvareqsafe(char *, int); 170 void print_quoted(const char *); 171 int validname(const char *, int, int *); 172 173 #endif 174
Indexes created Fri Jul 24 00:25:35 UTC 2026