From 5f25fb9e936d229b76c7bd0bdfd3dfbb848345ad Mon Sep 17 00:00:00 2001 From: Kirk McKusick Date: Fri, 25 Apr 1986 05:23:10 -0800 Subject: [PATCH] update from rfg SCCS-vsn: usr.bin/uucp/uucico/uucico.8 6.2 SCCS-vsn: usr.bin/uucp/uuclean/uuclean.8 6.3 SCCS-vsn: usr.bin/uucp/uusnap/uusnap.8 6.2 --- usr/src/usr.bin/uucp/uucico/uucico.8 | 179 +++++++++++++++++-------- usr/src/usr.bin/uucp/uuclean/uuclean.8 | 30 ++--- usr/src/usr.bin/uucp/uusnap/uusnap.8 | 16 +-- 3 files changed, 149 insertions(+), 76 deletions(-) diff --git a/usr/src/usr.bin/uucp/uucico/uucico.8 b/usr/src/usr.bin/uucp/uucico/uucico.8 index 53fb7f21aa..a9f01704ec 100644 --- a/usr/src/usr.bin/uucp/uucico/uucico.8 +++ b/usr/src/usr.bin/uucp/uucico/uucico.8 @@ -1,11 +1,11 @@ -.\" @(#)uucico.8 6.1 (Berkeley) %G% +.\" @(#)uucico.8 6.2 (Berkeley) %G% .\" .TH UUCICO 8C "" .UC 6 .SH NAME -uucicio \- uupoll transfer files queued by uucp or uux +uucico \- transfer files queued by uucp or uux .SH SYNOPSIS -.B uucico +.B /usr/lib/uucp/uucico [ .BI \-d spooldir ] [ @@ -23,65 +23,82 @@ uucicio \- uupoll transfer files queued by uucp or uux ] [ .BI \-t turnaround ] -.PP -.B uupoll -[ -.BI \-g grade -] [ -.B -n -] -system [ system1 ... ] .SH DESCRIPTION -.I uucico +.I Uucico performs the actual work involved in transferring files between systems. -.I uucp +.IR Uucp (1C) and -.I uux -merely queue requests for data transfer which uucico processes. +.IR uux (1C) +merely queue requests for data transfer which +.I uucico +processes. .PP The following options are available. .TP 8 .BI \-d spooldir Use .I spooldir -as the spool directory. +as the spool directory. The default is /usr/spool/uucp. .TP 8 .BI \-g grade Only send jobs of grade .I grade or higher this transfer. -.TP 8 -.B \-R -Reverse roles. This tells the remote system to begin sending its -jobs first, instead of waiting for the local machine to finish. +The grade of a job is specified when the job is queued by +.I uucp +or +.IR uux . .TP 8 .BI \-r role .I role -is either 1 or 0. It signifies whether uucico is to run in -master or slave mode. 1 is used when starting +is either 1 or 0; it indicates whether +.I uucico +is to start up in +master or slave role, respectively. 1 is used when running .I uucico -by hand. 0 is used when another system calls the local system. +by hand or from +.IR cron (8). +0 is used when another system calls the local system. +Slave role is the default. +.TP 8 +.B \-R +Reverse roles. When used with the +.B \-r1 +option, this tells the remote system to begin sending its +jobs first, instead of waiting for the local machine to finish. .TP 8 .BI \-s system Call only system .IR system . If .B \-s -is not specified, and \-r1 is specifed, +is not specified, and \-r1 is specified, .I uucico will attempt to call all systems for which there is work. If .B \-s is specified, a call will be made even if there is -no work for that system. This is useful for polling -systems. +no work for that system. This is useful for polling. .TP 8 .BI \-x debug Turn on debugging at level .IR debug . Level 5 is a good start when trying to find out why a call failed. Level 9 is very detailed. Level 99 is absurdly verbose. +If +.I role +is 1 (master), output is normally written to the standard message +output +.IR stderr . +If +.I stderr +is unavailable, output is written to +.RI /usr/spool/uucp/AUDIT/ system. +When +.I role +is 0 (slave), debugging output is always written to the AUDIT +file. .TP 8 .B \-L Only call ``local'' sites. A site is considered local if @@ -95,46 +112,102 @@ Use as the line turnaround time (in minutes) instead of the default 30. If .I turnaround is missing or 0, line turnaround will be disabled. -After uucico has been running in Slave mode for +After +.I uucico +has been running in slave role for .I turnaround -minutes, it will attempt to run in master mode by negotiating with the -remote machine. In the past, a large transfer of news in -one direction would hold up mail going in the other direction. +minutes, it will attempt to run in master role by negotiating with the +remote machine. +In earlier versions of +.IR uucico , +a transfer of many large files in one direction would hold up mail +going in the other direction. With the turnaround code working, the message flow will be more bidirectional in the short term. -This option only works with newer uucicos and is ignored by older ones. +This option only works with newer +.IR uucico 's +and is ignored by older ones. .PP If .I uucico receives a .B SIGFPE (see -.IR kill (1)) +.IR kill (1)), it will toggle the debugging on or off. .PP -This program will typically be started by -.IR cron (8). +.I Uucico +is commonly used either of two ways: as a daemon run periodically by +.IR cron (8) +to call out to remote systems, and as a ``shell'' for remote systems +who call in. +For calling out periodically, a typical line in +.I crontab +would be: .PP -.B uupoll -is used to force a poll of a remote system. It queues a null job -for the remote system and invokes -.I uucico. -If the -.I \-g -flag is specified, the null job will be queued with grade -.IR grade . -If -.I \-n -is specified, the null job will be queued, but an immediate +.nf + 0 * * * * /usr/lib/uucp/uucico -r1 +.fi +.PP +This will run .I uucico -will not be invoked. +every hour in master role. +For each system that has transfer requests queued, +.I uucico +calls the system, logs in, and executes the transfers. The file +.IR L.sys (5) +is consulted for information about how to log in, while +.IR L-devices (5) +specifies available lines and modems for calling. +.PP +For remote systems to dial in, an entry in the +.IR passwd (5) +file must be created, with a login ``shell'' of +.IR uucico . +For example: +.PP +.nf + nuucp:Password:6:1::/usr/spool/uucppublic:/usr/lib/uucp/uucico +.fi +.PP +The UID for UUCP remote logins is not critical, so long as it differs from +the UUCP Administrative login (usually UID 5). +The latter owns the UUCP files, and assigning +this UID to a remote login would be an extreme security hazard. .SH FILES -.TP 22 -/usr/lib/uucp -directory with commands used by uucico internally -.TP -/usr/spoool/uucp -spool directory +.ta \w'/usr/spool/uucp/D.hostnameX/ 'u +.nf +/usr/lib/uucp/ UUCP internal files/utilities +/usr/lib/uucp/L-devices Local device descriptions +/usr/lib/uucp/L-dialcodes Phone numbers and prefixes +/usr/lib/uucp/L.aliases Hostname aliases +/usr/lib/uucp/L.cmds Remote command permissions list +/usr/lib/uucp/L.sys Host connection specifications +/usr/lib/uucp/USERFILE Remote directory tree permissions list +.PP +/usr/spool/uucp/ Spool directory +/usr/spool/uucp/AUDIT/* Debugging audit trails +/usr/spool/uucp/C./ Control files directory +/usr/spool/uucp/D./ Incoming data file directory +/usr/spool/uucp/D.hostname/ Outgoing data file directory +/usr/spool/uucp/D.hostnameX/ Outgoing execution file directory +/usr/spool/uucp/CORRUPT/ Place for corrupted C. and D. files +/usr/spool/uucp/ERRLOG UUCP internal error log +/usr/spool/uucp/LOGFILE UUCP system activity log +/usr/spool/uucp/LCK/LCK..* Device lock files +/usr/spool/uucp/SYSLOG File transfer statistics log +/usr/spool/uucp/STST/* System status files +/usr/spool/uucp/TM./ File transfer temp directory +/usr/spool/uucp/X./ Incoming execution file directory +.PP +/usr/spool/uucppublic Public access directory +.fi .SH SEE ALSO +uucp(1C), uuq(1C), uux(1C), L-devices(5), L-dialcodes(5), L.aliases(5), +L.cmds(5), L.sys(5), uuclean(8C), uupoll(8C), uusnap(8C), uuxqt(8C) +.PP +D. A. Nowitz and M. E. Lesk, +.IR "A Dial-Up Network of UNIX Systems" . +.PP D. A. Nowitz, -Uucp Implementation Description +.IR "Uucp Implementation Description" . diff --git a/usr/src/usr.bin/uucp/uuclean/uuclean.8 b/usr/src/usr.bin/uucp/uuclean/uuclean.8 index 1e0f9f485a..29d23cb6d4 100644 --- a/usr/src/usr.bin/uucp/uuclean/uuclean.8 +++ b/usr/src/usr.bin/uucp/uuclean/uuclean.8 @@ -2,15 +2,21 @@ .\" All rights reserved. The Berkeley software License Agreement .\" specifies the terms and conditions for redistribution. .\" -.\" @(#)uuclean.8 6.2 (Berkeley) %G% +.\" @(#)uuclean.8 6.3 (Berkeley) %G% .\" .TH UUCLEAN 8C "" .UC 5 .SH NAME uuclean \- uucp spool directory clean-up .SH SYNOPSIS -.B uuclean -[ option ] ... +.B /usr/lib/uucp/uuclean +[ +.B -m +] [ +.BI -n time +] [ +.BI -p pre +] .SH DESCRIPTION .I Uuclean will scan the spool directory for files with the @@ -26,12 +32,6 @@ as the file prefix. Up to 10 .B \-p arguments may be specified. -A -.B \-p -without any -.I pre -following will cause all files older than the -specified time to be deleted. .TP .BI \-n time Files whose age is more than @@ -43,15 +43,15 @@ test is satisfied. .B \-m Send mail to the owner of the file when it is deleted. +.TP +.BI \-d subdirectory +Only the specified subdirectory will be cleaned. .PP -This program will typically be started by +This program will typically be run daily by .IR cron (8). .SH FILES .TP 22 -/usr/lib/uucp -directory with commands used by uuclean internally -.TP /usr/spool/uucp -spool directory +Spool directory .SH SEE ALSO -uucp(1C), uux(1C) +uucp(1C), uux(1C), uucico(8C) diff --git a/usr/src/usr.bin/uucp/uusnap/uusnap.8 b/usr/src/usr.bin/uucp/uusnap/uusnap.8 index 3490dee9a7..3582bfb4c5 100644 --- a/usr/src/usr.bin/uucp/uusnap/uusnap.8 +++ b/usr/src/usr.bin/uucp/uusnap/uusnap.8 @@ -2,7 +2,7 @@ .\" All rights reserved. The Berkeley software License Agreement .\" specifies the terms and conditions for redistribution. .\" -.\" @(#)uusnap.8 6.1 (Berkeley) %G% +.\" @(#)uusnap.8 6.2 (Berkeley) %G% .\" .TH UUSNAP 8C "" .UC 5 @@ -11,7 +11,8 @@ uusnap \- show snapshot of the UUCP system .SH SYNOPSIS .B uusnap .SH DESCRIPTION -Uusnap displays in tabular format a synopsis of the current UUCP +.I Uusnap +displays in tabular format a synopsis of the current UUCP situation. The format of each line is as follows: .PP .ti +10 @@ -23,10 +24,9 @@ and "Message" is the current status message for that site as found in the STST file. .PP Included in "Message" may be the time left before UUCP can re-try the -call, and the count of the number of times that UUCP has tried to -reach the site. +call, and the count of the number of times that UUCP has tried +(unsuccessfully) to reach the site. .SH SEE ALSO -uucp(1C), -UUCP Implementation Guide -.SH AUTHOR -Randy King +uucp(1C), uux(1C), uuq(1C), uucico(8C) +.br +.I "UUCP Implementation Guide" -- 2.20.1