INTRO(1M)           RISC/os Reference Manual            INTRO(1M)



NAME
     intro - introduction to 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 User's Reference
     Manual and Sections 1, 2, 3, 4, and 5 of the Programmer's
     Reference Manual.  References of the form name(1), (2), (3),
     (4) and (5) refer to entries in the above manuals.  Refer-
     ences of the form name(1M), name(7) or name(8) refer to
     entries in this manual.

     Because of command restructuring for the Virtual File System
     architecture, there are several instances of multiple manual
     pages with the same name.  For example, there are four
     manual pages called mount(1M).  In each such case the first
     of the multiple pages describes the syntax and options of
     the generic command, that is, those options applicable to
     all FSTypes (file system types).  The succeeding pages
     describe the functionality of the FSType-specific modules of
     the command.  These pages all display the name of the FSType
     to which they pertain centered and in parentheses at the top
     of the page.  Note that the administrator should not attempt
     to call these modules directly.  The generic command pro-
     vides a common interface to all of them.  Thus the FSType-
     specific manual pages should not be viewed as describing
     distinct commands, but rather as detailing those aspects of
     a command that are specific to a particular FSType.

COMMAND SYNTAX
     Unless otherwise noted, commands described in this section
     accept options and other arguments according to the follow-
     ing syntax:

          name [option(s)] [cmdarg(s)]
     where:

     name         The name of an executable file

     option       - noargletter(s) or,
                  - argletter<>optarg
                  where <> is optional white space

     noargletter  A single letter representing an option without
                  an argument

     argletter    A single letter representing an option requir-
                  ing an argument




                        Printed 11/19/92                   Page 1

INTRO(1M)           RISC/os Reference Manual            INTRO(1M)



     optarg       Argument (character string) satisfying preced-
                  ing argletter

     cmdarg       Pathname (or other command argument) not begin-
                  ning with - or, - by itself indicating the
                  standard input

SEE ALSO
     getopt(1) in the User's Reference Manual.
     getopt(3C) in the Programmer's Reference Manual.

DIAGNOSTICS
     Upon termination, each command returns 0 for normal termina-
     tion 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.

NOTES
     Unfortunately, not all commands adhere to the standard syn-
     tax.

































 Page 2                 Printed 11/19/92