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


     uucp [-c | -C]  [-d |  -f]   [-ggrade]  [-jmr]  [-nuser]  [-
     sfile] [-xdebug_level] source-file destination-file

     uulog [-ssys] [-fsystem] [-x] [-number] system

     uuname [-c | -l]


     The uucp utility copies files named by the source-file argu-
     ments to the destination-file argument.

     The uulog utility queries a log file of uucp or uuxqt  tran-
     sactions    in    file    /var/uucp/.Log/uucico/system    or

     The uuname utility lists the names of systems known to uucp.


     The following options are supported by uucp:

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

     -C    Forces the copy of local files to the spool  directory
           for transfer.

     -d    Makes all necessary  directories  for  the  file  copy

     -f    Does not make intermediate directories  for  the  file

     -g grade
           grade can be either a  single  letter,  number,  or  a
           string  of  alphanumeric characters defining a service
           grade. The uuglist command can determine whether it is
           appropriate  to  use  the  single letter, number, or a
           string of alphanumeric characters as a service  grade.
           The  output from the uuglist command will be a list of
           service grades that are available, or a  message  that
           says  to  use  a single letter or number as a grade of

     -j    Prints the uucp job identification string on  standard
           output.  This job identification can be used by uustat
           to obtain the status of a uucp job or to  terminate  a
           uucp  job.   The  uucp job is valid as long as the job
           remains queued on the local system.

     -m    Sends mail to the requester when the copy is complete.

     -n user
           Notifies user on the remote system  that  a  file  was

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

     -s file
           Reports status of the transfer to file. This option is
           accepted  for compatibility, but it is ignored because
           it is insecure.

     -x debug_level
           Produce   debugging   output   on   standard   output.
           debug_level   is   a   number  between  0  and  9.  As
           debug_level increases to 9,  more  detailed  debugging
           information is given. This option may not be available
           on all systems.

     The following options cause uulog to print logging  informa-

     -s sys
           Prints information about file transfer work  involving
           system sys.

     -f system
           Executes a tail -f command of the  file  transfer  log
           for  system. You must press <BREAK> to exit this func-

     Other options used in conjunction  with  the  above  options

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

           Executes a tail command of number lines.

     The following options are supported by  uuname:

     -c    Displays the names of systems known  to  cu.  The  two
           lists  are the same, unless your machine is using dif-
           ferent Systems files for cu and uucp. See the Sysfiles

     -l    Displays the local system name.


     The source file name may be a path name on your machine,  or
     may have the form:


     where system-name is taken from a list of system names  that
     uucp  knows about. source_file is restricted to no more than
     one  system-name.  The  destination  system-name  may   also
     include a list of system names such as


     In this case, an attempt is made to send the file, using the
     specified route, to the destination. Care should be taken to
     ensure that intermediate nodes in the route are  willing  to
     forward information (see NOTES below for restrictions).

     For C-Shell users, the exclamation point (!) character  must
     be  surrounded  by  single  quotes  ('),  or  preceded  by a
     backslash (\).

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

     Pathnames may be one of the following:

     1. An absolute pathname.

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

     3. A pathname preceded by ~/destination where destination is
        appended  to  /var/spool/uucppublic. (Note: This destina-
        tion will be treated as a filename unless more  than  one
        file is being transferred by this request or the destina-
        tion is already a directory. To ensure that the  destina-
        tion  is a directory, follow it with a forward slash (/).
        For example, ~/dan/ as the destination  will  create  the
        directory  /var/spool/uucppublic/dan if it does not exist
        and put the requested file(s) in that directory).

     Anything else is prefixed by the current directory.

     If the result is an erroneous path name for the remote  sys-
     tem, the copy will fail. If the destination-file is a direc-
     tory, the last part of the source-file name is used.
     Invoking uucp with shell wildcard characters as  the  remote
     source-file  invokes the uux(1C) command to execute the uucp
     command on the  remote  machine.  The  remote  uucp  command
     spools  the  files  on  the remote machine.  After the first
     session terminates, if the remote machine is  configured  to
     transfer  the spooled files to the local machine, the remote
     machine will initiate a call and send the files;  otherwise,
     the  user  must  "call"  the  remote machine to transfer the
     files from the spool directory to the  local  machine.  This
     call  can  be  done  manually  using Uutry(1M), or as a side
     effect of another uux(1C) or uucp call.

     Notice that the local machine must have permission  to  exe-
     cute the uucp command on the remote machine in order for the
     remote machine to send the spooled files.

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


     See environ(5) for descriptions of the following environment
     variables  that  affect the execution of uucp: LANG, LC_ALL,


     The following exit values are returned:

     0     Successful completion.

     >0    An error occurred.


           other data files

           spool directories

           other program files

           public directory for receiving and sending


     See attributes(5) for descriptions of the  following  attri-

    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    | Availability                | SUNWbnuu                    |
    | Interface Stability         | Standard                    |


     mail(1),  uuglist(1C),   uustat(1C),   uux(1C),   Uutry(1M),
     uuxqt(1M), chmod(2), attributes(5), environ(5), standards(5)


     For security reasons,  the  domain  of  remotely  accessible
     files  may  be severely restricted. You will probably not be
     able to access files by path name; ask a responsible  person
     on  the remote system to send them to you. For the same rea-
     sons you will probably not be able to send  files  to  arbi-
     trary  path  names.  As distributed, the remotely accessible
     files are  those  whose  names  begin  /var/spool/uucppublic
     (equivalent to ~/).

     All files received by uucp will be owned by uucp.

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

     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 compatible  ver-
     sions of uucp.

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

     Strings that  are  passed  to  remote  systems  may  not  be
     evaluated  in the  same locale as the one in use by the pro-
     cess that invoked uucp on  the local system.

     Configuration files must be treated as C (or  POSIX)  locale
     text files.

Man(1) output converted with man2html