Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ uucp(1C) — Interactive 2.2

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

mail(1)

uustat(1C)

Uutry(1M)

uux(1C)

uuxqt(1M)

chmod(2)



          UUCP(1C)             INTERACTIVE UNIX System             UUCP(1C)



          NAME
               uucp, uulog, uuname - UNIX-to-UNIX system copy

          SYNOPSIS
               uucp [ options ] source-files destination-file
               uulog [ options ] -ssystem
               uulog [ options ] system
               uulog [ options ] -fsystem
               uuname [ -l ] [ -c ]

          DESCRIPTION
             uucp
               uucp copies files named by the source-files argument to the
               destination-file argument.  A file name may be a path name
               on your machine, or may have the form:

                    system-name!path-name

               where system-name is taken from a list of system names that
               uucp knows about.  The system-name may also be a list of
               names such as

                    system-name!system-name!...!system-name!path-name

               in which case an attempt is made to send the file via the
               specified route, to the destination.  See WARNINGS and BUGS
               below for restrictions.  Care should be taken to ensure that
               intermediate nodes in the route are willing to forward
               information (see WARNINGS below for restrictions).

               The following shell metacharacters are disallowed in
               system-name:

                    ` ; & | ^ < > ( ) <CR> <TAB> <SPACE>

               Path names may be one of:

                    (1)  a full path name.

                    (2)  a path name preceded by ~user where user is a
                         login name on the specified system and is replaced
                         by that user's login directory.

                    (3)  a path name preceded by ~/destination where desti-
                         nation is appended to /usr/spool/uucppublic;
                         [NOTE:  This destination will be treated as a file
                         name unless more than one file is being
                         transferred by this request or the destination is
                         already a directory.  To ensure that it is a
                         directory, follow the destination with a '/'.  For
                         example ~/dan/ as the destination will make the
                         directory /usr/spool/uucppublic/dan if it does not
                         exist and put the requested file(s) in that


          Rev. Basic Networking Utilities                            Page 1





          UUCP(1C)             INTERACTIVE UNIX System             UUCP(1C)



                         directory].

                    (4)  anything else is prefixed by the current direc-
                         tory.

               If the result is an erroneous path name for the remote sys-
               tem, the copy will fail.  If the destination-file is a
               directory, the last part of the source-file name is used.

               uucp preserves execute permissions across the transmission
               and gives 0666 read and write permissions [see chmod(2)].

               The following options are interpreted by uucp:

               -c        Do not copy local file to the spool directory for
                         transfer to the remote machine (default).

               -C        Force the copy of local files to the spool direc-
                         tory for transfer.

               -d        Make all necessary directories for the file copy
                         (default).

               -f        Do not make intermediate directories for the file
                         copy.

               -ggrade   Grade is a single letter/number; lower ascii
                         sequence characters will cause the job to be
                         transmitted earlier during a particular conversa-
                         tion.

               -j        Output the job identification ASCII string on the
                         standard output.  This job identification can be
                         used by uustat to obtain the status or terminate a
                         job.

               -m        Send mail to the requester when the copy is com-
                         pleted.

               -nuser    Notify user on the remote system that a file was
                         sent.

               -r        Do not start the file transfer, just queue the
                         job.

               -sfile    Report status of the transfer to file.  Note that
                         the file must be a full path name.

               -xdebug_level
                         Produce debugging output on standard output.  The
                         debug_level is a number between 0 and 9; higher
                         numbers give more detailed information.



          Rev. Basic Networking Utilities                            Page 2





          UUCP(1C)             INTERACTIVE UNIX System             UUCP(1C)



             uulog
               uulog queries a log file of uucp or uuxqt transactions in a
               file

                           /usr/spool/uucp/.Log/uucico/system,
                                            or
                            /usr/spool/uucp/.Log/uuxqt/system.

               The options cause uulog to print logging information:

               -ssys     Print information about file transfer work involv-
                         ing system sys.

               -fsystem  Does a "tail -f" of the file transfer log for sys-
                         tem.  (You must hit BREAK to exit this function.)
                         Other options used in conjunction with the above:

               -x        Look in the uuxqt log file for the given system.

               -number   Indicates that a "tail" command of number lines
                         should be executed.

             uuname
               uuname lists the names of systems known to uucp.  The -c
               option returns the names of systems known to cu.  (The two
               lists are the same, unless your machine is using different
               Systems files for cu and uucp.  See the Sysfiles file.)  The
               -l option returns the local system name.



























          Rev. Basic Networking Utilities                            Page 3





          UUCP(1C)             INTERACTIVE UNIX System             UUCP(1C)



          FILES
               /usr/spool/uucp  spool directories
               /usr/spool/uucppublic/*public directory for receiving and
                                sending (/usr/spool/uucppublic)
               /usr/lib/uucp/*  other data and program files

          SEE ALSO
               mail(1), uustat(1C), Uutry(1M), uux(1C), uuxqt(1M).
               chmod(2) in the INTERACTIVE SDS Guide and Programmer's
               Reference Manual.

          WARNINGS
               The domain of remotely accessible files can (and for obvious
               security reasons, usually should) be severely restricted.
               You will very likely not be able to fetch files by path
               name; ask a responsible person on the remote system to send
               them to you.  For the same reasons, you will probably not be
               able to send files to arbitrary path names.  As distributed,
               the remotely accessible files are those whose names begin
               /usr/spool/uucppublic (equivalent to ~/).

               All files received by uucp will be owned by uucp.

               The -m option will only work sending files or receiving a
               single file.  Receiving multiple files specified by special
               shell characters ? * [...] will not activate the -m option.

               The forwarding of files through other systems may not be
               compatible with the previous version of uucp.  If forwarding
               is used, all systems in the route must have the same version
               of uucp.

          BUGS
               Protected files and files that are in protected directories
               that are owned by the requester can be sent by uucp using
               the -C option.  However, if the requestor is root, and the
               directory is not searchable by "other" or the file is not
               readable by "other", the request will fail.

















          Rev. Basic Networking Utilities                            Page 4



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