intro(1M) intro(1M)
NAME
intro - introduction to system maintenance commands and
application programs
DESCRIPTION
This section describes, in alphabetical order, commands that
are used chiefly for system maintenance and administration
purposes. The commands in this section should be used along
with those listed in Section 1 of the Oreo Command
Reference. References to other manual entries not of the
form name(1M), name(7) or name(8) refer to entries of that
manual. Unless otherwise noted, commands described in this
section accept options and other arguments according to the
following syntax:
name [arg(s)] [cmdarg(s)] ...
where:
name is the command name (the name of an executable
file);
arg can be:
-noargletter(s),
(a single letter representing an option
without an argument); or
-argletter <>optarg
(where -argletter is a single letter
representing an option that requires an
argument, <> is optional white space, and
optarg is an argument (character string)
satisfying the preceding -argletter.
[] indicates an optional argument.
cmdarg is a metasymbol indicating a pathname (or
other command argument) that does not begin
with - or, - by itself (indicating the
standard input).
... indicates that arguments may be repeated any
number of times.
SEE ALSO
The SEE ALSO sections of the manual pages refer to other
relevant documentation.
DIAGNOSTICS
Upon termination, each command returns two bytes of status,
one supplied by the system and giving the cause for
termination, and (in the case of "normal" termination) one
Page 1 (last mod. 1/15/87)
intro(1M) intro(1M)
supplied by the program (see wait(2) and exit(2)). The
former byte is 0 for normal termination; the latter is
customarily 0 for successful execution and non-zero to
indicate troubles such as erroneous parameters, bad or
inaccessible data, or other inability to cope with the task
at hand. It is called variously "exit code", "exit status",
or "return code", and is described only where special
conventions are involved.
WARNINGS
Some commands produce unexpected results when processing
files containing null characters. These commands often
treat text input lines as strings and therefore become
confused upon encountering a null character (the string
terminator) within a line.
Page 2 (last mod. 1/15/87)