Communication Commands uucp(1C)
NAME
uucp, uulog, uuname - UNIX-to-UNIX system copy
SYNOPSIS
uucp [-c -C] [-d -f] [-ggrade] [-jmr] [-nuser] [-sfile]
[-xdebuglevel] source-file destination-file
uulog [-ssys] [-fsystem] [-x] [-number] system
uuname [-c -l]
DESCRIPTION
uucp
The uucp utility copies files named by the source-file argu-
ments to the destination-file argument.
uulog
The uulog utility queries a log file of uucp or uuxqt tran-
sactions in file /var/uucp/.Log/uucico/system or
/var/uucp/.Log/uuxqt/system.
uuname
The uuname utility lists the names of systems known to uucp.
OPTIONS
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 (default).
-f Does not make intermediate directories for
the file copy.
-g grade grade can be either a single letter,
number, or a string of alphanumeric char-
acters defining a service grade. The
uuglist command can determine whether it
SunOS 5.11 Last change: 9 Mar 2005 1
Communication Commands uucp(1C)
is appropriate to use the single letter,
number, or a string of alphanumeric char-
acters as a service grade. The output from
the uuglist command is a list of service
grades that are available, or a message
that says to use a single letter or number
as a grade of service.
-j Prints the uucp job identification string
on standard output. This job identifica-
tion 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 sys-
tem.
-m Sends mail to the requester when the copy
is complete.
-n user Notifies user on the remote system that a
file was sent.
When multiple -n options are passed in,
uucp only retains the value specified for
the last -n option. This is the only user
notified.
-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 debuglevel Produce debugging output on standard out-
put. debuglevel is a number between 0 and
9. As debuglevel increases to 9, more
detailed debugging information is given.
This option may not be available on all
systems.
uulog
The following options cause uulog to print logging informa-
tion:
SunOS 5.11 Last change: 9 Mar 2005 2
Communication Commands uucp(1C)
-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 function.
Other options used in conjunction with the above options
are:
-x Looks in the uuxqt log file for the given system.
-number Executes a tail command of number lines.
uuname
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
file.
-l Displays the local system name.
OPERANDS
The source file name may be a path name on your machine, or
may have the form:
system-name!pathname
where system-name is taken from a list of system names that
uucp knows about. sourcefile is restricted to no more than
one system-name. The destination system-name may also
include a list of system names such as
system-name!system-name!...!system-name!pathname
In this case, an attempt is made to send the file, using the
specified route, to the destination. Care should be taken to
SunOS 5.11 Last change: 9 Mar 2005 3
Communication Commands uucp(1C)
ensure that intermediate nodes in the route are willing to
forward information. See NOTES 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 are 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 destina-
tion is appended to /var/spool/uucppublic. This
destination is treated as a filename unless more
than one file is being transferred by this request
or the destination is already a directory. To
ensure that the destination is a directory, follow
it with a forward slash (/). For example, ~/dan/ as
the destination creates 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 fails. If the destination-file is a directory,
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 ses-
sion terminates, if the remote machine is configured to
transfer the spooled files to the local machine, the remote
machine initiates 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.
SunOS 5.11 Last change: 9 Mar 2005 4
Communication Commands uucp(1C)
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)).
ENVIRONMENT VARIABLES
See environ(5) for descriptions of the following environment
variables that affect the execution of uucp: LANG, LCAL,
LCOLATE, LCTYPE, LCMESAGES, LCTIME, NLSPATH, and TZ.
EXIT STATUS
The following exit values are returned:
0 Successful completion.
>0 An error occurred.
FILES
/etc/uucp/* other data files
/var/spool/uucp spool directories
/usr/lib/uucp/* other program files
/var/spool/uucppublic/* public directory for receiving
and sending
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
SunOS 5.11 Last change: 9 Mar 2005 5
Communication Commands uucp(1C)
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWbnuu
Interface Stability Standard
SEE ALSO
mail(1), uuglist(1C), uustat(1C), uux(1C), Uutry(1M),
uuxqt(1M), chmod(2), attributes(5), environ(5), standards(5)
NOTES
For security reasons, the domain of remotely accessible
files may be severely restricted. You probably are not able
to access files by path name. Ask a responsible person on
the remote system to send them to you. For the same reasons
you are probably not able to send files to arbitrary path
names. As distributed, the remotely accessible files are
those whose names begin /var/spool/uucppublic (equivalent to
~/).
All files received by uucp are owned by uucp.
The -m option only works when sending files or receiving a
single file. Receiving multiple files specified by special
shell characters ?, &, and [...] does 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 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 fails.
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.
SunOS 5.11 Last change: 9 Mar 2005 6
Communication Commands uucp(1C)
Configuration files must be treated as C (or POSIX) locale
text files.
SunOS 5.11 Last change: 9 Mar 2005 7
|
