|
138
|
1 <refentry id="shell">
|
|
|
2 <refnamediv>
|
|
|
3 <refname>SHELL</refname>
|
|
|
4 <refpurpose>OS-9 Command Interpreter</refpurpose>
|
|
|
5 </refnamediv>
|
|
|
6
|
|
|
7 <refsynopsisdiv>
|
|
|
8 <cmdsynopsis>
|
|
|
9 <command>SHELL</command>
|
|
|
10 <arg choice="plain">&replstart;arglist&replend;</arg>
|
|
|
11 </cmdsynopsis>
|
|
|
12 </refsynopsisdiv>
|
|
|
13
|
|
|
14 <refsect1><title>Description</title>
|
|
|
15 <para>
|
|
|
16 The Shell is OS-9's command interpreter program. It reads data from
|
|
|
17 its standard input path (the keyboard or a file), and interprets the
|
|
|
18 data as a sequence of commands. - The basic function of the shell is
|
|
|
19 to initiate and control execution of other OS-9 programs.
|
|
|
20 </para>
|
|
|
21 <para>
|
|
|
22 The shell reads and interprets one text line at a time from the
|
|
|
23 standard input path. After interpretation of each line it reads
|
|
|
24 another until an end-of-file condition occurs, at which time it
|
|
|
25 terminates itself. A special case is when the shell is called from
|
|
|
26 another program, in which case it will take the parameter area (rest
|
|
|
27 of the command line) as its first line of input. If this command
|
|
|
28 line consists of "built in" commands only, more lines will be read
|
|
|
29 and processed; otherwise control will return to the calling program
|
|
|
30 after the single command line is processed.
|
|
|
31 </para>
|
|
|
32 <para>
|
|
|
33 The rest of this description is a technical specification of the
|
|
|
34 shell syntax. Use of the Shell is described fully in Chapters 2
|
|
|
35 and 4 of this manual.
|
|
|
36 </para>
|
|
|
37 </refsect1>
|
|
|
38 <refsect1><title>Shell Input Line Formal Syntax</title>
|
|
|
39 <synopsis>
|
|
|
40 &replstart;pgm line&replend; := &replstart;pgm&replend; {&replstart;pgm&replend;}
|
|
|
41 &replstart;pgm&replend; := [&replstart;params&replend;] [ &replstart;name&replend; [&replstart;modif&replend;] [&replstart;pgm params&replend;] [&replstart;modif&replend;] ] [&replstart;sep&replend;]
|
|
|
42
|
|
|
43 Program Specifications
|
|
|
44
|
|
|
45 &replstart;name&replend; := &replstart;module name&replend;
|
|
|
46 := &replstart;pathlist&replend;
|
|
|
47 := ( &replstart;pgm list&replend; )
|
|
|
48
|
|
|
49 Parameters
|
|
|
50
|
|
|
51 &replstart;params&replend;:= &replstart;param&replend; { &replstart;delim&replend; &replstart;param&replend; }
|
|
|
52 &replstart;delim&replend; := space or comma characters
|
|
|
53 &replstart;param&replend; := ex &replstart;name&replend; [&replstart;modif&replend;] chain to program specified
|
|
|
54 := chd &replstart;pathlist&replend; change working directory
|
|
|
55 := kill &replstart;procID&replend; send abort signal to process
|
|
|
56 := setpr&replstart;procID&replend; &replstart;pty&replend; change process priority
|
|
|
57 := chx &replstart;pathlist&replend; change execution directory
|
|
|
58 := w wait for any process to die
|
|
|
59 := p turn "OS9:" prompting on
|
|
|
60 := -p turn prompting off
|
|
|
61 := t echo input lines to std output
|
|
|
62 := -t don't echo input lines
|
|
|
63 := -x dont abort on error
|
|
|
64 := x abort on error
|
|
|
65 := * &replstart;text&replend; comment line: not processed
|
|
|
66 &replstart;sep&replend; := ; sequential execution separator
|
|
|
67 := & concurrent execution separator
|
|
|
68 := ! pipeline separator
|
|
|
69 := &replstart;cr&replend; end-of-line (sequential execution separator)
|
|
|
70
|
|
|
71
|
|
|
72 Modifiers
|
|
|
73
|
|
|
74 &replstart;modif&replend; := &replstart;mod&replend; { &replstart;delim&replend; &replstart;mod&replend; }
|
|
|
75 &replstart;mod&replend; := < &replstart;pathlist&replend; redirect standard input
|
|
|
76 := > &replstart;pathlist&replend; redirect standard output
|
|
|
77 := >> &replstart;pathlist&replend; redirect standard error output
|
|
|
78 := # &replstart;integer&replend; set process memory size in pages
|
|
|
79 := # &replstart;integer&replend; K set program memory size in 1K increments
|
|
|
80 </synopsis>
|
|
|
81 </refsect1>
|
|
|
82 </refentry>
|
|
|
83
|
