Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ uucp(1) — DG/UX 4.00

Media Vault

Software Library

Restoration Projects

Artifacts Sought



                                                                  uucp(1)



        _________________________________________________________________
        uucp, uulog, uuname                                       Command
        UNIX-to-UNIX system copy
        _________________________________________________________________


        SYNTAX

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


        DESCRIPTION

           uucp

        uucp copies files named by the source-file arguments 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 foward information
        (see WARNINGS below for restrictions).

        The shell metacharacters ?, * and [...] appearing in path-name
        will be expanded on the appropriate system.

        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 destination
                  is appended to /usr/spool/uucppublic; (NOTE:  This
                  destination will be treated as a file name unless more
                  than one file is being transfered by this request or
                  the destination is already a directory.  To ensure that



        DG/UX 4.00                                                 Page 1
               Licensed material--property of copyright holder(s)





                                                                  uucp(1)



                  it is a directory, follow the destination with a '/'.
                  For example ~/dan/ as the destination will create the
                  directory /usr/spool/uucppublic/dan if it does not
                  exist and put the requested file(s) in that directory).

             (4)  anything else is prefixed by the current directory.

        If the result is an erroneous path name for the remote system the
        copy will fail.  If the destination-file is a directory, 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 directory
                  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 conversation.

        -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 completed.

        -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.






        DG/UX 4.00                                                 Page 2
               Licensed material--property of copyright holder(s)





                                                                  uucp(1)



           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 involving
                  system sys.

        -fsystem  Does a ``tail -f'' of the file transfer log for system.
                  (You must press ^D to exit this function.)

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

        -number   Indicates that a ``tail'' command of number lines
                  should be executed (see "WARNING" section)..


           uuname

        uuname lists the names of systems known to uucp.  The -c option
        lists 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.



        _________________________________________________________________
        EXAMPLES

        $ uucp -d -m file? sys2!/usr/spool/uucppublic


        The above example will send any files that begin with "file" and
        have one other character at the end of the name (such as "file1",
        "file2" "file3", etc.) to sys_2.  All of the files will be
        deposited into the /usr/spool/uucppublic on sys_2.  With the
        included options, directories will be created as needed, and the
        user will be notified by mail about the file transfer.

        _________________________________________________________________


        FILES

        /usr/spool/uucpspool directories
        /usr/spool/uucppublic/*public directory for receiving and
                       sending (/usr/spool/uucppublic)



        DG/UX 4.00                                                 Page 3
               Licensed material--property of copyright holder(s)





                                                                  uucp(1)



        /usr/lib/uucp/*other data and program files


        SEE ALSO

        mail(1), uustat(1), uux(1), uuxqt(1M) in the System Manager's
        Reference for the DG/UX System.
        chmod(2) in the Programmer's Reference for the DG/UX System.


        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.

        The value 0 will print out the entire file when using uulog-
        number.


        BUGS

        Protected files and files that are in protected directories that
        are owned by the requestor can be sent by uucp.  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.













        DG/UX 4.00                                                 Page 4
               Licensed material--property of copyright holder(s)



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