workbench/c/Shell/Shell.h

   1 /*
   2     Copyright © 1995-2014, The AROS Development Team. All rights reserved.
   3     $Id$
   4 */
   5
   6 #ifndef SHELL_H
   7 #define SHELL_H 1
   8
   9 #include <dos/dosextens.h>
  10 #include <dos/dos.h>    /* for BPTR             */
  11
  12 #include "buffer.h"
  13
  14 #define FILE_MAX 256 /* max length of file name */
  15 #define LINE_MAX 512 /* max length of full command line */
  16
  17 /* TODO move */
  18 /* Template options (copied *AND MODIFIED* from ReadArgs) */
  19 #define REQUIRED 0x80 /* /A */
  20 #define KEYWORD  0x40 /* /K */
  21 #define MULTIPLE 0x20 /* /M */
  22 #define NORMAL   0x00 /* No option */
  23 #define SWITCH   0x01 /* /S, implies /K */
  24 #define TOGGLE   0x02 /* /T, implies /K */
  25 #define NUMERIC  0x04 /* /N */
  26 #define REST     0x08 /* /F */
  27
  28 #define MAXARGS    32
  29 #define MAXARGLEN  32
  30
  31 struct SArg
  32 {
  33     TEXT   name[MAXARGLEN];
  34     LONG   namelen;
  35     LONG   len;
  36     IPTR   def;
  37     LONG   deflen;
  38     UBYTE  type;
  39 };
  40
  41 typedef struct _ShellState
  42 {
  43     BPTR        newIn;
  44     BPTR        newOut;
  45     BPTR        oldIn;
  46     BPTR        oldOut;
  47
  48     TEXT        command[FILE_MAX + 2];  /* command buffer */
  49
  50     BPTR        oldHomeDir;     /* shared lock on program file's directory */
  51
  52     LONG        cliNumber;
  53
  54     LONG        argcount;       /* script args count */
  55     struct SArg args[MAXARGS];  /* args definitions */
  56     IPTR        arg[MAXARGS];   /* args values */
  57     struct RDArgs *arg_rd;      /* Current RDArgs return state */
  58
  59     TEXT        bra, ket, dollar, dot;
  60     TEXT        mchar0, pchar0;
  61
  62     struct _ShellState *stack;
  63
  64     ULONG       flags;          /* DOS/CliInit*() flags cache */
  65
  66     APTR        ss_DOSBase;
  67     APTR        ss_SysBase;
  68 } ShellState;
  69
  70 #define DOSBase (ss->ss_DOSBase)
  71 #define SysBase ((struct ExecBase *)ss->ss_SysBase)
  72
  73 /* Function: convertLine
  74  *
  75  * Action:   Parses a command line and returns a filtered version (removing
  76  *           redirections, incorporating embedded commands, taking care of
  77  *           variable references and aliases.
  78  *
  79  * Input:    ShellState         *ss           --  this state
  80  *           Buffer             *in           --  input string
  81  *           Buffer             *out          --  output command string
  82  *           BOOL               *haveCommand  --  true if line have command
  83  *
  84  * Output:   LONG  --  error code or 0 if everything went OK
  85  */
  86 LONG convertLine(ShellState *ss, Buffer *in, Buffer *out, BOOL *haveCommand);
  87
  88 LONG convertLineDot(ShellState *ss, Buffer *in);
  89
  90 /* Function: readLine
  91  *
  92  * Action:   Read one line of a stream into a buffer.
  93  *
  94  * Input:    ShellState                  *ss        --  this state
  95  *           struct CommandLineInterface *cli       --  the CLI
  96  *           Buffer                      *out       --  the result
  97  *           BOOL                        *moreLeft  --  not end of stream result
  98  *
  99  * Note:     This routine reads a full command line.
 100  *           As a side effect, it also updates ss->pchar0 and ss->mchar0
 101  *
 102  * Output:   SIPTR --  DOS error code
 103  */
 104 LONG readLine(ShellState *ss, struct CommandLineInterface *cli, Buffer *out, BOOL *moreLeft);
 105
 106 /* Function: checkLine
 107  *
 108  * Action:   Parse a command line and do consistency checks
 109  *
 110  * Input:    ShellState              *ss    --  this state
 111  *           Buffer                  *in    --  the input buffer
 112  *           Buffer                  *out   --  the result will be stored here
 113  *           BOOL                     echo  --  true if command echoed
 114  *
 115  * Output:   LONG --  DOS error code
 116  */
 117 LONG checkLine(ShellState *ss, Buffer *in, Buffer *out, BOOL echo);
 118
 119 /* Function: releaseFiles
 120  *
 121  * Action:   Deallocate file resources used for redirecion and reinstall
 122  *           standard input and output streams.
 123  *
 124  * Input:    ShellState *ss  --  this state
 125  *
 126  * Output:   --
 127  */
 128 void releaseFiles(ShellState *ss);
 129
 130 /* Function: interact
 131  *
 132  * Action:   Execute a commandfile and then perform standard shell user
 133  *           interaction.
 134  *
 135  * Input:    ShellState     *is           --  this state
 136  *
 137  * Output:   LONG  --  error code
 138  */
 139 LONG interact(ShellState *ss);
 140
 141
 142 /* Function: Redirection_release
 143  *
 144  * Action:   Release resources allocated in the state
 145  *
 146  * Input:    ShellState     *ss  --  this state
 147  *
 148  * Output:   --
 149  */
 150 void Redirection_release(ShellState *ss);
 151
 152 /* Function: Redirection_init
 153  *
 154  * Action:   Initialize a state structure
 155  *
 156  * Input:    ShellState     *ss  --  this state
 157  *
 158  * Output:   LONG  --  DOS error code
 159  */
 160 LONG Redirection_init(ShellState *ss);
 161
 162 /* Function: setPath
 163  *
 164  * Action:   Set the current command (standard) path.
 165  *
 166  * Input:    BPTR lock  --  a lock on the directory
 167  *
 168  * Notes:    This will set the current directory name via
 169  *           SetCurrentDirName() even though this is not used later.
 170  *
 171  * Output:   --
 172  */
 173 void setPath(ShellState *ss, BPTR lock);
 174
 175 /* Function: cliPrompt
 176  *
 177  * Action:   Print the prompt to indicate that user input is viable.
 178  *
 179  * Input:    ShellState     *ss  --  this state
 180  *
 181  * Output:   --
 182  */
 183 void cliPrompt(ShellState *ss);
 184
 185 /* Other internal functions
 186  *
 187  * FIXME: some doc ?
 188  */
 189 void initDefaultInterpreterState(ShellState *ss);
 190 void popInterpreterState(ShellState *ss);
 191 LONG pushInterpreterState(ShellState *ss);
 192
 193 LONG convertArg(ShellState *ss, Buffer *in, Buffer *out, BOOL *quoted);
 194 LONG convertBackTicks(ShellState *ss, Buffer *in, Buffer *out, BOOL *quoted);
 195 LONG convertRedir(ShellState *ss, Buffer *in, Buffer *out);
 196 LONG convertVar(ShellState *ss, Buffer *in, Buffer *out, BOOL *quoted);
 197 LONG l2a(LONG x, STRPTR buf); /* long to ascii */
 198
 199 void cliEcho(ShellState *ss, CONST_STRPTR args);
 200 LONG cliLen(CONST_STRPTR s);
 201 BOOL cliNan(CONST_STRPTR s);
 202 void cliVarNum(ShellState *ss, CONST_STRPTR name, LONG value);
 203
 204 #endif