Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ csr — Apollo

Media Vault

Software Library

Restoration Projects

Artifacts Sought

10.0;csr (command_search_rules, revision 1.0, 88/01/21
csr (command_search_rules) -- Set or display command search rules.
usage:  csr [dir ...] [-a dir...]



DESCRIPTION
     Command search rules determine which directories the shell examines to
     find commands. csr lets you display or change this list. If you run a new
     shell script, the subordinate shell inherits the search rules of the
     parent shell. Note that this does not apply to shells you create with the
     SHELL key, since the SHELL key actually creates a new, separate process.
     Its shell receives the default search rules described below.

     By default, the shell looks for commands in this order:

     1. Your working directory ("."), or the directory specified by the
        command's pathname.

     2. Your personal command directory, ~/com (the com subdirectory of your
        naming directory).

     3. The system command directory, /com.

     4. The directory /usr/apollo/bin.

     Specifying csr without arguments or options displays the current command
     search rules.

ARGUMENTS
     directory (optional)
                    Specify new command search sequence.  Multiple directory
                    pathnames are permitted; separate names with blanks.  The
                    shell searches the directories in the order that you
                    specify.

                    Default if omitted:
                                   display current search rules unless -a is
                                   specified

OPTIONS
     -a dir_name    Append the specified directory name(s) to the existing
                    command search sequence.  This allows you to add a new
                    directory to the end of the list without retyping the
                    entire list. Multiple directory pathnames are permitted;
                    separate names with blanks.


EXAMPLES
     Display current search rules.

     $ csr
     . ~/com /com /usr/apollo/bin


     Set new search sequence by adding an additional command directory.

     $ csr . ~/com //us/myproj/com /com


     Append the directory ~/com/special_commands to the current list of
     directory names.

     $ csr -a ~/com/special_commands

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026