Annotation of 3BSD/cmd/uucp/README, revision 1.1.1.1

1.1       root        1:        A substantial number of minor changes were made to ``uucp''
                      2: at the end of February and early March, before Dave Nowitz returned
                      3: to Piscataway. Changes made after March, 15, 1979, will be available through 
                      4: stockroom category, ``uucp_changes''.  Any installation with a version
                      5: of ``uucp'' obtained before March 15, should obtain the whole
                      6: distribution afresh.
                      7: 
                      8:        Most of the changes are relatively benign. See the file CHANGES
                      9: for a list of what has been done.  PLEASE NOTE that there is one
                     10: important difference between the present version and previous versions:
                     11: there is a change to the file ``L-devices''. For each entry representing
                     12: an ACU insert the string "ACU " at the beginning of the line; for each
                     13: direct connection, insert "DIR ". This should take all of a minute.
                     14: 
                     15:        Two short shell procedures, ``uutest'' and ``uucheck'' are
                     16: included in the distribution. You may find them useful for administrative
                     17: purposes. Put links to them in your personal bin directory. (On
                     18: our system, they live in /usr/lib/uucp.)
                     19: 
                     20:                        PWB 1.2 SYSTEMS
                     21:         There is a new stockroom category, called ``pwbuucp'', (made March 21)
                     22: which gives additional information regarding installing uucp on PWB 1.2 
                     23: systems.  This information is by courtesy of Brian Redman.
                     24: 
                     25:                        GENERAL  INSTRUCTIONS
                     26:         Before running "uucp", you should change the define for "MYNAME"
                     27: in "uucp.h" to whoever you are, and recompile.
                     28: As delivered, "uucp" thinks that it is running on the ``usg'' system.
                     29: 
                     30: NOTE - To export executable code:
                     31: A new routine (uucpname.c) has been added which returns the local uucp name.
                     32: If no action is taken, this routine will return the value
                     33: of "MYNAME".  By defining "UNAME" as value 1 in "uucp.h", the value returned
                     34: is determined by a call to "uname(&utsname)" where utsname is a structure
                     35: which contains an element "nodename" - the uucpname for the local system.
                     36: 
                     37:         Since all ACUs are not created equal, the last character which must
                     38: be sent to the ACU may differ on your system.  The value "ACULAST" in
                     39: "uucp.h" should be modified if necessary.
                     40: 
                     41:         To run successfully you will need to provide working
                     42: versions of the following files:
                     43: 
                     44:   L-devices     entries for call-units and hard-wired connections
                     45:   L-dialcodes   decodes abbreviations occurring in L.sys
                     46:   L.sys         pertinent details about other systems that you
                     47:                 may call, as the result of prior agreement.
                     48:   USERFILE      user accessibility information
                     49: 
                     50: The information in these files is specific to each installation.
                     51: The versions supplied are arbitrarily modified versions of files
                     52: used on the Usg machine, and are provided only for your
                     53: information.
                     54: 
                     55:         As delivered, "uucp" is set up to use the following
                     56: directories (contrary to some documentation):
                     57: 
                     58:         /usr/src/cmd/uucp       source files
                     59:         /usr/lib/uucp           executable programs and data files
                     60:         /usr/spool/uucp         work-in-progress
                     61:         /usr/lib/uucp/.XQTDIR      work area for "uuxqt"
                     62:         /usr/spool/uucppublic   uucp public directory
                     63: 
                     64: "/usr/bin/uucp (uux)" is linked to "/usr/lib/uucp/uucp (uux)".
                     65: 
                     66: NOTE - some resent changes have moved some to the directories.
                     67: The names appear in uucp.h and the "uucp.mk" file.
                     68: (SPOOL, XQTDIR, PUBDIR, INSDIR, THISDIR)
                     69: The login directory for the uucp login(s) should be the PUBDIR
                     70: directory.
                     71: 
                     72:        Note also that there is an array called "Cmds" in the file
                     73: "uuxqt.c" which names the commands which may be executed at
                     74: the request of a remote user, via "uux". You will most probably
                     75: wish to modify the initialization of this array, to reflect the
                     76: commands you are willing to allow on your system.
                     77: 
                     78:        The ``mail'' command has been modified, so that it may
                     79: only be used to send mail, when it is invoked under a name beginning
                     80: with 'r'. (In the receive mode, it can be used to invoke a shell,
                     81: thus creating a potential security hole.)
                     82: When sending mail to a remote site, ``mail'' invokes the ``rmail''
                     83: command at the remote site. Hence you should create an ``rmail''
                     84: command by linking to ``/bin/mail", and ensure that ``Cmds''
                     85: contains an entry for ``rmail'', but not ``mail''.
                     86: 
                     87:         Note that other systems which may contact you via "uucp"
                     88: will have to login using information that you supply. When UNIX/TS is
                     89: delivered there is a user "uucp" (with no initial password) whose
                     90: default shell is (and must be) "/usr/lib/uucp/uucico". If you
                     91: wish to use "uucp" to contact other systems you will need to
                     92: obtain username and password information from them in advance and
                     93: to store this in "L.sys".  Since the file "L.sys" contains
                     94: sensitive information about how to access other systems which are
                     95: willing to converse with you, it is important that the "L.sys"
                     96: file be properly protected. You will find that ensuring a high
                     97: level of protection is not a trivial task. As a minimum you will
                     98: need to set correctly the permissions on the file itself, its
                     99: parent directory and every executable "set-uid-to-root" file in
                    100: your whole system ... and then ensure that the root password is
                    101: secure ... as a bare minimum.
                    102: 
                    103:         The programs "uuclean" and "uulog" are provided for
                    104: housekeeping.  These should be run frequently, e.g. by "cron".
                    105: Prototypes of procedures that may be run by "cron" are provided
                    106: here as the files "uudemon.*".  Note also that "uudemon.hr"
                    107: starts up "uucico" to initiate transfers that have been delayed
                    108: for some reason, or to poll passive systems for work.
                    109: 
                    110:        Some installations may wish to use both the old and new
                    111: versions of "uucp" concurrently for a while. This will be because some
                    112: but not all of your correspondents have made the switch from the
                    113: old to the new. The old version is no longer supported and the
                    114: switch should be made as soon as possible. In the interim, you
                    115: may replace the /usr/bin/uucp (which is linked to 
                    116: /usr/lib/uucp/uucp) by a shell procedure such as:
                    117: 
                    118:        for i in $*
                    119:        do
                    120:            case $i in
                    121:                old!* | dull!* | slow!* )
                    122:                    /usr/lib/uucp/olduucp $*
                    123:                    echo old uucp used
                    124:                    exit;;
                    125:            esac
                    126:        /usr/lib/uucp/uucp $*
                    127: 
                    128: (This assumes that the old version of "uucp" has been moved to "olduucp".)
                    129: 
                    130: For further information contact D. Nowitz (PY 6120) or 
                    131: J. Lions (MH 5667) or U. Arazy (MH 7659).

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.