Annotation of 3BSD/cmd/csh/sh.h, revision 1.1.1.1

1.1       root        1: /* Copyright (c) 1979 Regents of the University of California */
                      2: #include "sh.local.h"
                      3: /*
                      4:  * C shell
                      5:  *
                      6:  * Bill Joy, UC Berkeley
                      7:  * October, 1978
                      8:  */
                      9: #include <sys/types.h>
                     10: #include <sys/stat.h>
                     11: #include <sys/dir.h>
                     12: 
                     13: #define        isdir(d)        ((d.st_mode & S_IFMT) == S_IFDIR)
                     14: 
                     15: #include <errno.h>
                     16: #include <setjmp.h>
                     17: #include <signal.h>
                     18: 
                     19: typedef        char    bool;
                     20: 
                     21: #define        eq(a, b)        (strcmp(a, b) == 0)
                     22: 
                     23: /*
                     24:  * Global flags
                     25:  */
                     26: bool   didcch;                 /* Have closed unused fd's for child */
                     27: bool   didfds;                 /* Have setup i/o fd's for child */
                     28: bool   doneinp;                /* EOF indicator after reset from readc */
                     29: bool   exiterr;                /* Exit if error or non-zero exit status */
                     30: bool   child;                  /* Child shell ... errors cause exit */
                     31: bool   haderr;                 /* Reset was because of an error */
                     32: bool   intty;                  /* Input is a tty */
                     33: bool   intact;                 /* We are interactive... therefore prompt */
                     34: bool   justpr;                 /* Just print because of :p hist mod */
                     35: bool   loginsh;                /* We are a loginsh -> .login/.logout */
                     36: bool   noexec;                 /* Don't execute, just syntax check */
                     37: bool   setintr;                /* Set interrupts on/off -> Wait intr... */
                     38: bool   timflg;                 /* Time the next waited for command */
                     39: 
                     40: /*
                     41:  * Global i/o info
                     42:  */
                     43: char   *arginp;                /* Argument input for sh -c and internal `xx` */
                     44: int    onelflg;                /* 2 -> need line for -t, 1 -> exit on read */
                     45: char   *file;                  /* Name of shell file for $0 */
                     46: 
                     47: char   *err;                   /* Error message from scanner/parser */
                     48: int    errno;                  /* Error from C library routines */
                     49: char   *shtemp;                /* Temp name for << shell files in /tmp */
                     50: time_t time0;                  /* Time at which the shell started */
                     51: 
                     52: /*
                     53:  * Miscellany
                     54:  */
                     55: char   *doldol;                /* Character pid for $$ */
                     56: int    uid;                    /* Invokers uid */
                     57: time_t chktim;                 /* Time mail last checked */
                     58: 
                     59: /*
                     60:  * These are declared here because they want to be
                     61:  * initialized in sh.init.c (to allow them to be made readonly)
                     62:  */
                     63: char   *mesg[];
                     64: 
                     65: struct biltins {
                     66:        char    *bname;
                     67:        int     (*bfunct)();
                     68:        short   minargs, maxargs;
                     69: } bfunc[];
                     70: 
                     71: struct srch {
                     72:        char    *s_name;
                     73:        short   s_value;
                     74: } srchn[];
                     75: 
                     76: /*
                     77:  * To be able to redirect i/o for builtins easily, the shell moves the i/o
                     78:  * descriptors it uses away from 0,1,2.
                     79:  * Ideally these should be in units which are closed across exec's
                     80:  * (this saves work) but for version 6, this is not usually possible.
                     81:  * The desired initial values for these descriptors are defined in
                     82:  * sh.local.h.
                     83:  */
                     84: short  SHIN;                   /* Current shell input (script) */
                     85: short  SHOUT;                  /* Shell output */
                     86: short  SHDIAG;                 /* Diagnostic output... shell errs go here */
                     87: short  OLDSTD;                 /* Old standard input (def for cmds) */
                     88: 
                     89: /*
                     90:  * Error control
                     91:  *
                     92:  * Errors in scanning and parsing set up an error message to be printed
                     93:  * at the end and complete.  Other errors always cause a reset.
                     94:  * Because of source commands and .cshrc we need nested error catches.
                     95:  */
                     96: 
                     97: jmp_buf        reslab;
                     98: 
                     99: #define        setexit()       setjmp(reslab)
                    100: #define        reset()         longjmp(reslab)
                    101:        /* Should use structure assignment here */
                    102: #define        getexit(a)      copy(a, reslab, sizeof reslab)
                    103: #define        resexit(a)      copy(reslab, a, sizeof reslab)
                    104: 
                    105: char   *gointr;                /* Label for an onintr transfer */
                    106: int    (*parintr)();           /* Parents interrupt catch */
                    107: int    (*parterm)();           /* Parents terminate catch */
                    108: 
                    109: /*
                    110:  * Lexical definitions.
                    111:  *
                    112:  * All lexical space is allocated dynamically.
                    113:  * The eighth bit of characters is used to prevent recognition,
                    114:  * and eventually stripped.
                    115:  */
                    116: #define        QUOTE   0200            /* Eighth char bit used internally for 'ing */
                    117: #define        TRIM    0177            /* Mask to strip quote bit */
                    118: 
                    119: /*
                    120:  * Each level of input has a buffered input structure.
                    121:  * There are one or more blocks of buffered input for each level,
                    122:  * exactly one if the input is seekable and tell is available.
                    123:  * In other cases, the shell buffers enough blocks to keep all loops
                    124:  * in the buffer.
                    125:  */
                    126: struct Bin {
                    127:        off_t   Bfseekp;                /* Seek pointer */
                    128:        off_t   Bfbobp;                 /* Seekp of beginning of buffers */
                    129:        off_t   Bfeobp;                 /* Seekp of end of buffers */
                    130:        short   Bfblocks;               /* Number of buffer blocks */
                    131:        char    **Bfbuf;                /* The array of buffer blocks */
                    132: } B;
                    133: 
                    134: #define        fseekp  B.Bfseekp
                    135: #define        fbobp   B.Bfbobp
                    136: #define        feobp   B.Bfeobp
                    137: #define        fblocks B.Bfblocks
                    138: #define        fbuf    B.Bfbuf
                    139: 
                    140: off_t  btell();
                    141: 
                    142: /*
                    143:  * The shell finds commands in loops by reseeking the input
                    144:  * For whiles, in particular, it reseeks to the beginning of the
                    145:  * line the while was on; hence the while placement restrictions.
                    146:  */
                    147: off_t  lineloc;
                    148: 
                    149: #ifdef TELL
                    150: off_t  tell();
                    151: bool   cantell;                        /* Is current source tellable ? */
                    152: #endif
                    153: 
                    154: /*
                    155:  * Input lines are parsed into doubly linked circular
                    156:  * lists of words of the following form.
                    157:  */
                    158: struct wordent {
                    159:        char    *word;
                    160:        struct  wordent *prev;
                    161:        struct  wordent *next;
                    162: };
                    163: 
                    164: /*
                    165:  * During word building, both in the initial lexical phase and
                    166:  * when expanding $ variable substitutions, expansion by `!' and `$'
                    167:  * must be inhibited when reading ahead in routines which are themselves
                    168:  * processing `!' and `$' expansion or after characters such as `\' or in
                    169:  * quotations.  The following flags are passed to the getC routines
                    170:  * telling them which of these substitutions are appropriate for the
                    171:  * next character to be returned.
                    172:  */
                    173: #define        DODOL   1
                    174: #define        DOEXCL  2
                    175: #define        DOALL   DODOL|DOEXCL
                    176: 
                    177: /*
                    178:  * Labuf implements a general buffer for lookahead during lexical operations.
                    179:  * Text which is to be placed in the input stream can be stuck here.
                    180:  * We stick parsed ahead $ constructs during initial input,
                    181:  * process id's from `$$', and modified variable values (from qualifiers
                    182:  * during expansion in sh.dol.c) here.
                    183:  */
                    184: char   labuf[256];
                    185: char   *lap;
                    186: 
                    187: /*
                    188:  * Parser structure
                    189:  *
                    190:  * Each command is parsed to a tree of command structures and
                    191:  * flags are set bottom up during this process, to be propagated down
                    192:  * as needed during the semantics/exeuction pass (sh.sem.c).
                    193:  */
                    194: struct command {
                    195:        short   t_dtyp;                         /* Type of node */
                    196:        short   t_dflg;                         /* Flags, e.g. FAND|... */
                    197:        union {
                    198:                char    *T_dlef;                /* Input redirect word */
                    199:                struct  command *T_dcar;        /* Left part of list/pipe */
                    200:        } L;
                    201:        union {
                    202:                char    *T_drit;                /* Output redirect word */
                    203:                struct  command *T_dcdr;        /* Right part of list/pipe */
                    204:        } R;
                    205: #define        t_dlef  L.T_dlef
                    206: #define        t_dcar  L.T_dcar
                    207: #define        t_drit  R.T_drit
                    208: #define        t_dcdr  R.T_dcdr
                    209:        char    **t_dcom;                       /* Command/argument vector */
                    210:        struct  command *t_dspr;                /* Pointer to ()'d subtree */
                    211: };
                    212: 
                    213: #define        TCOM    1               /* t_dcom <t_dlef >t_drit       */
                    214: #define        TPAR    2               /* ( t_dspr ) <t_dlef >t_drit   */
                    215: #define        TFIL    3               /* t_dlef | t_drit              */
                    216: #define        TLST    4               /* t_dlef ; t_drit              */
                    217: #define        TOR     5               /* t_dlef || t_drit             */
                    218: #define        TAND    6               /* t_dlef && t_drit             */
                    219: 
                    220: #define        FAND    (1<<0)          /* executes in background       */
                    221: #define        FCAT    (1<<1)          /* output is redirected >>      */
                    222: #define        FPIN    (1<<2)          /* input is a pipe              */
                    223: #define        FPOU    (1<<3)          /* output is a pipe             */
                    224: #define        FPAR    (1<<4)          /* don't fork, last ()ized cmd  */
                    225: #define        FINT    (1<<5)          /* don't make interruptible     */
                    226: #define        FPRS    (1<<6)          /* print number when forked     */
                    227: #define        FDIAG   (1<<7)          /* redirect unit 2 with unit 1  */
                    228: #define        FANY    (1<<8)          /* output was !                 */
                    229: #define        FHERE   (1<<9)          /* input redirection is <<      */
                    230: #define        FREDO   (1<<10)         /* reexec aft if, repeat,...    */
                    231: 
                    232: /*
                    233:  * The keywords for the parser
                    234:  */
                    235: #define        ZBREAK          0
                    236: #define        ZBRKSW          1
                    237: #define        ZCASE           2
                    238: #define        ZDEFAULT        3
                    239: #define        ZELSE           4
                    240: #define        ZEND            5
                    241: #define        ZENDIF          6
                    242: #define        ZENDSW          7
                    243: #define        ZEXIT           8
                    244: #define        ZFOREACH        9
                    245: #define        ZGOTO           10
                    246: #define        ZIF             11
                    247: #define        ZLABEL          12
                    248: #define        ZLET            13
                    249: #define        ZSET            14
                    250: #define        ZSWITCH         15
                    251: #define        ZTEST           16
                    252: #define        ZTHEN           17
                    253: #define        ZWHILE          18
                    254: 
                    255: /*
                    256:  * Structure defining the existing while/foreach loops at this
                    257:  * source level.  Loops are implemented by seeking back in the
                    258:  * input.  For foreach (fe), the word list is attached here.
                    259:  */
                    260: struct whyle {
                    261:        off_t   w_start;                /* Point to restart loop */
                    262:        off_t   w_end;                  /* End of loop (0 if unknown) */
                    263:        char    **w_fe, **w_fe0;        /* Current/initial wordlist for fe */
                    264:        char    *w_fename;              /* Name for fe */
                    265:        struct  whyle *w_next;          /* Next (more outer) loop */
                    266: } *whyles;
                    267: 
                    268: /*
                    269:  * Variable structure
                    270:  *
                    271:  * Lists of aliases and variables are sorted alphabetically by name
                    272:  */
                    273: struct varent {
                    274:        char    **vec;          /* Array of words which is the value */
                    275:        char    *name;          /* Name of variable/alias */
                    276:        struct  varent *link;
                    277: } shvhed, aliases;
                    278: 
                    279: /*
                    280:  * The following are for interfacing redo substitution in
                    281:  * aliases to the lexical routines.
                    282:  */
                    283: struct wordent *alhistp;               /* Argument list (first) */
                    284: struct wordent *alhistt;               /* Node after last in arg list */
                    285: char   **alvec;                        /* The (remnants of) alias vector */
                    286: 
                    287: /*
                    288:  * Filename/command name expansion variables
                    289:  */
                    290: short  gflag;                          /* After tglob -> is globbing needed? */
                    291: 
                    292: /*
                    293:  * A reasonable limit on number of arguments would seem to be
                    294:  * the maximum number of characters in an arg list / 6.
                    295:  */
                    296: #define        GAVSIZ  NCARGS / 6
                    297: 
                    298: /*
                    299:  * Variables for filename expansion
                    300:  */
                    301: char   **gargv;                        /* Pointer to the (stack) arglist */
                    302: short  gargc;                          /* Number args in gargv */
                    303: short  gnleft;
                    304: 
                    305: /*
                    306:  * Variables for command expansion.
                    307:  */
                    308: char   **pargv;                        /* Pointer to the argv list space */
                    309: char   *pargs;                         /* Pointer to start current word */
                    310: short  pargc;                          /* Count of arguments in pargv */
                    311: short  pnleft;                         /* Number of chars left in pargs */
                    312: char   *pargcp;                        /* Current index into pargs */
                    313: 
                    314: /*
                    315:  * History list
                    316:  *
                    317:  * Each history list entry contains an embedded wordlist
                    318:  * from the scanner, a number for the event, and a reference count
                    319:  * to aid in discarding old entries.
                    320:  *
                    321:  * Essentially "invisible" entries are put on the history list
                    322:  * when history substitution includes modifiers, and thrown away
                    323:  * at the next discarding since their event numbers are very negative.
                    324:  */
                    325: struct Hist {
                    326:        struct  wordent Hlex;
                    327:        int     Hnum;
                    328:        int     Href;
                    329:        struct  Hist *Hnext;
                    330: } Histlist;
                    331: 
                    332: int    eventno;                        /* Next events number */
                    333: int    lastev;                         /* Last event reference (default) */
                    334: 
                    335: char   *Dfix1();
                    336: struct varent *adrof(), *adrof1();
                    337: char   **blkcat();
                    338: char   **blkcpy();
                    339: char   **blkend();
                    340: char   **blkspl();
                    341: char   *calloc();
                    342: char   *cname();
                    343: char   **copyblk();
                    344: char   **dobackp();
                    345: char   *domod();
                    346: struct wordent *dosub();
                    347: char   *exp3();
                    348: char   *exp3a();
                    349: char   *exp4();
                    350: char   *exp5();
                    351: char   *exp6();
                    352: struct Hist *enthist();
                    353: struct Hist *findev();
                    354: struct wordent *freenod();
                    355: char   *getenv();
                    356: char   *getinx();
                    357: struct varent *getvx();
                    358: struct passwd *getpwnam();
                    359: struct wordent *gethent();
                    360: struct wordent *getsub();
                    361: char   *globone();
                    362: struct biltins *isbfunc();
                    363: char   **glob();
                    364: char   *operate();
                    365: int    pintr();
                    366: char   *putn();
                    367: char   **saveblk();
                    368: char   *savestr();
                    369: char   *strcat();
                    370: char   *strcpy();
                    371: char   *strend();
                    372: char   *strings();
                    373: char   *strip();
                    374: char   *strspl();
                    375: char   *subword();
                    376: struct command *syntax();
                    377: struct command *syn0();
                    378: struct command *syn1();
                    379: struct command *syn1a();
                    380: struct command *syn1b();
                    381: struct command *syn2();
                    382: struct command *syn3();
                    383: int    tglob();
                    384: int    trim();
                    385: char   *value(), *value1();
                    386: char   *xhome();
                    387: char   *xname();
                    388: char   *xset();
                    389: 
                    390: #define        NOSTR   ((char *) 0)
                    391: 
                    392: /*
                    393:  * setname is a macro to save space (see sh.err.c)
                    394:  */
                    395: char   *bname;
                    396: #define        setname(a)      bname = (a);
                    397: 
                    398: #ifdef VFORK
                    399: char   *Vsav;
                    400: char   **Vav;
                    401: char   *Vdp;
                    402: #endif

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.