1 /* $NetBSD: shell.h,v 1.25 2017/07/26 03:44:43 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 * @(#)shell.h 8.2 (Berkeley) 5/4/95 35 */ 36 37 /* 38 * The follow should be set to reflect the type of system you have: 39 * JOBS -> 1 if you have Berkeley job control, 0 otherwise. 40 * define BSD if you are running 4.2 BSD or later. 41 * define SYSV if you are running under System V. 42 * define DEBUG=1 to compile in debugging ('set -o debug' to turn on) 43 * define DEBUG=2 to compile in and enable debugging. 44 * define DEBUG=3 for DEBUG==2 + enable most standard debug output 45 * define DEBUG=4 for DEBUG==2 + enable absolutely everything 46 * define DO_SHAREDVFORK to indicate that vfork(2) shares its address 47 * with its parent. 48 * define BOGUS_NOT_COMMAND to allow ! reserved words in weird places 49 * (traditional ash behaviour.) 50 * 51 * When debugging is on, debugging info will be written to ./trace and 52 * a quit signal will generate a core dump. 53 */ 54 55 #ifndef SHELL_H 56 #define SHELL_H 57 #include <sys/param.h> 58 59 #define JOBS 1 60 #ifndef BSD 61 #define BSD 1 62 #endif 63 64 #ifndef DO_SHAREDVFORK 65 #if defined(__NetBSD_Version__) && __NetBSD_Version__ >= 104000000 66 #define DO_SHAREDVFORK 67 #endif 68 #endif 69 70 typedef void *pointer; 71 #ifndef NULL 72 #define NULL (void *)0 73 #endif 74 #ifndef STATIC 75 #define STATIC /* empty */ 76 #endif 77 #define MKINIT /* empty */ 78 79 #include <sys/cdefs.h> 80 81 extern const char nullstr[1]; /* null string */ 82 83 #ifdef SMALL 84 #undef DEBUG 85 #endif 86 87 #ifdef DEBUG 88 89 extern uint64_t DFlags; 90 extern int ShNest; 91 92 /* 93 * This is selected as there are 26 letters in ascii - not that that 94 * matters for anything, just makes it easier to assign a different 95 * command letter to each debug option. We currently use only 18 96 * so this could be reduced, but that is of no real benefit. It can also 97 * be increased, but that both limits the maximum value tha can be 98 * used with DBG_EXTRAS(), and causes problems with verbose option naming. 99 */ 100 #define DBG_VBOSE_SHIFT 26 101 #define DBG_EXTRAS(n) ((DBG_VBOSE_SHIFT * 2) + (n)) 102 103 /* 104 * Unconditional tracing for compatibility with old tracing setup. 105 */ 106 #define TRACE(param) do { \ 107 trace param; \ 108 } while (/*CONSTCOND*/ 0) 109 #define TRACEV(param) do { \ 110 tracev param; \ 111 } while (/*CONSTCOND*/ 0) 112 113 /* 114 * and the newer conditional tracing, so the mainainer can control 115 * just how much debug output is dumped to the trace file 116 * (once the rest of the shell is converted to use it). 117 * 118 * in the X forms, "xtra" can be any legal C statement(s) without (bare) commas 119 * executed if the relevant debug flag is enabled, after any tracing output. 120 */ 121 #define CTRACE(when, param) do { \ 122 if ((DFlags & (when)) != 0) \ 123 trace param; \ 124 } while (/*CONSTCOND*/ 0) 125 126 #define CCTRACE(when,cond,param) do { \ 127 if ((cond) && (DFlags & (when)) != 0) \ 128 trace param; \ 129 } while (/*CONSTCOND*/ 0) 130 131 #define CTRACEV(when, param) do { \ 132 if ((DFlags & (when)) != 0) \ 133 tracev param; \ 134 } while (/*CONSTCOND*/ 0) 135 136 #define XTRACE(when, param, xtra) do { \ 137 if ((DFlags & (when)) != 0) { \ 138 trace param; \ 139 xtra; \ 140 } \ 141 } while (/*CONSTCOND*/ 0) 142 143 #define VTRACE(when, param) do { \ 144 if ((DFlags & \ 145 (when)<<DBG_VBOSE_SHIFT) != 0) \ 146 trace param; \ 147 } while (/*CONSTCOND*/ 0) 148 149 #define CVTRACE(when,cond,param) do { \ 150 if ((cond) && (DFlags & \ 151 (when)<<DBG_VBOSE_SHIFT) != 0) \ 152 trace param; \ 153 } while (/*CONSTCOND*/ 0) 154 155 #define VTRACEV(when, param) do { \ 156 if ((DFlags & \ 157 (when)<<DBG_VBOSE_SHIFT) != 0) \ 158 tracev param; \ 159 } while (/*CONSTCOND*/ 0) 160 161 #define VXTRACE(when, param, xtra) do { \ 162 if ((DFlags & \ 163 (when)<<DBG_VBOSE_SHIFT) != 0) {\ 164 trace param; \ 165 xtra; \ 166 } \ 167 } while (/*CONSTCOND*/ 0) 168 169 #define SHELL_FORKED() ShNest++ 170 #define VFORK_BLOCK { const int _ShNest = ShNest; 171 #define VFORK_END } 172 #define VFORK_UNDO() ShNest = _ShNest 173 174 #define DBG_ALWAYS (1LL << 0) 175 #define DBG_PARSE (1LL << 1) /* r (read commands) */ 176 #define DBG_EVAL (1LL << 2) /* e */ 177 #define DBG_EXPAND (1LL << 3) /* x */ 178 #define DBG_JOBS (1LL << 4) /* j */ 179 #define DBG_PROCS (1LL << 5) /* p */ 180 #define DBG_REDIR (1LL << 6) /* f (fds) */ 181 #define DBG_CMDS (1LL << 7) /* c */ 182 #define DBG_ERRS (1LL << 8) /* z (?) */ 183 #define DBG_WAIT (1LL << 9) /* w */ 184 #define DBG_TRAP (1LL << 10) /* t */ 185 #define DBG_VARS (1LL << 11) /* v */ 186 #define DBG_INPUT (1LL << 12) /* i */ 187 #define DBG_OUTPUT (1LL << 13) /* o */ 188 #define DBG_MEM (1LL << 14) /* m */ 189 #define DBG_ARITH (1LL << 15) /* a */ 190 #define DBG_HISTORY (1LL << 16) /* h */ 191 #define DBG_SIG (1LL << 17) /* s */ 192 193 /* 194 * reserved extras: b=builtins l=alias 195 * still free: d g k n q u y 196 */ 197 198 /* use VTRACE(DBG_ALWAYS, (...)) to test this one */ 199 #define DBG_VERBOSE (1LL << DBG_VBOSE_SHIFT) 200 201 /* DBG_EXTRAS 0 .. 11 (max) only - non-alpha options (no VTRACE !!) */ 202 #define DBG_U0 (1LL << DBG_EXTRAS(0)) /* 0 - ad-hoc extra flags */ 203 #define DBG_U1 (1LL << DBG_EXTRAS(1)) /* 1 - for short term */ 204 #define DBG_U2 (1LL << DBG_EXTRAS(2)) /* 2 - extra tracing*/ 205 206 #define DBG_LINE (1LL << DBG_EXTRAS(9)) /* @ ($LINENO) */ 207 #define DBG_PID (1LL << DBG_EXTRAS(10)) /* $ ($$) */ 208 #define DBG_NEST (1LL << DBG_EXTRAS(11)) /* ^ */ 209 210 extern void set_debug(const char *, int); 211 212 #else /* DEBUG */ 213 214 #define TRACE(param) /* historic normal trace */ 215 #define TRACEV(param) /* historic varargs trace */ 216 217 #define CTRACE(when, param) /* conditional normal trace */ 218 #define CCTRACE(when, cond, param) /* more conditional normal trace */ 219 #define CTRACEV(when, param) /* conditional varargs trace */ 220 #define XTRACE(when, param, extra) /* conditional trace, plus more */ 221 #define VTRACE(when, param) /* conditional verbose trace */ 222 #define CVTRACE(when, cond, param) /* more conditional verbose trace */ 223 #define VTRACEV(when, param) /* conditional verbose varargs trace */ 224 #define VXTRACE(when, param, extra) /* cond verbose trace, plus more */ 225 226 #define SHELL_FORKED() 227 #define VFORK_BLOCK 228 #define VFORK_END 229 #define VFORK_UNDO() 230 231 #endif /* DEBUG */ 232 233 #endif /* SHELL_H */ 234