Annotation of 43BSDReno/usr.bin/uucp/uucico.8, revision 1.1

1.1     ! root        1: .\" Copyright (c) 1988 Regents of the University of California.
        !             2: .\" All rights reserved.  The Berkeley software License Agreement
        !             3: .\" specifies the terms and conditions for redistribution.
        !             4: .\"
        !             5: .\"    @(#)uucico.8    6.5 (Berkeley) 6/24/90
        !             6: .\"
        !             7: .TH UUCICO 8 "June 24, 1990"
        !             8: .UC 6
        !             9: .SH NAME
        !            10: uucico, uucpd \- transfer files queued by uucp or uux
        !            11: .SH SYNOPSIS
        !            12: .B /usr/lib/uucp/uucico
        !            13: [
        !            14: .BI \-d spooldir
        !            15: ] [
        !            16: .BI \-g grade
        !            17: ] [
        !            18: .BI \-r role
        !            19: ] [
        !            20: .B \-R
        !            21: ] [
        !            22: .BI \-s system
        !            23: ] [
        !            24: .BI \-x debug
        !            25: ] [
        !            26: .B \-L
        !            27: ] [
        !            28: .BI \-t turnaround
        !            29: ]
        !            30: .PP
        !            31: .B uucpd
        !            32: .SH DESCRIPTION
        !            33: .I Uucico
        !            34: performs the actual work involved in transferring files between
        !            35: systems. 
        !            36: .IR Uucp (1)
        !            37: and
        !            38: .IR uux (1)
        !            39: merely queue requests for data transfer which
        !            40: .I uucico
        !            41: processes.
        !            42: .PP
        !            43: The following options are available.
        !            44: .TP 8
        !            45: .BI \-d spooldir
        !            46: Use
        !            47: .I spooldir
        !            48: as the spool directory. The default is /var/spool/uucp.
        !            49: .TP 8
        !            50: .BI \-g grade
        !            51: Only send jobs of grade
        !            52: .I grade
        !            53: or higher this transfer.
        !            54: The grade of a job is specified when the job is queued by
        !            55: .I uucp
        !            56: or
        !            57: .IR uux .
        !            58: .TP 8
        !            59: .BI \-r role
        !            60: .I role
        !            61: is either 1 or 0; it indicates whether
        !            62: .I uucico
        !            63: is to start up in 
        !            64: master or slave role, respectively. 1 is used when running 
        !            65: .I uucico
        !            66: by hand or from
        !            67: .IR cron (8).
        !            68: 0 is used when another system calls the local system.
        !            69: Slave role is the default.
        !            70: .TP 8
        !            71: .B \-R
        !            72: Reverse roles.  When used with the
        !            73: .B \-r1
        !            74: option, this tells the remote system to begin sending its
        !            75: jobs first, instead of waiting for the local machine to finish.
        !            76: .TP 8
        !            77: .BI \-s system
        !            78: Call only system
        !            79: .IR system .
        !            80: If 
        !            81: .B \-s
        !            82: is not specified, and \-r1 is specified,
        !            83: .I uucico
        !            84: will attempt to call all systems for which there is work.
        !            85: If
        !            86: .B \-s
        !            87: is specified, a call will be made even if there is
        !            88: no work for that system. This is useful for polling.
        !            89: .TP 8
        !            90: .BI \-x debug
        !            91: Turn on debugging at level
        !            92: .IR debug .
        !            93: Level 5 is a good start when trying to find out why a call
        !            94: failed. Level 9 is very detailed. Level 99 is absurdly verbose.
        !            95: If
        !            96: .I role
        !            97: is 1 (master), output is normally written to the standard message
        !            98: output
        !            99: .IR stderr .
        !           100: If
        !           101: .I stderr
        !           102: is unavailable, output is written to
        !           103: .RI /var/spool/uucp/AUDIT/ system.
        !           104: When
        !           105: .I role
        !           106: is 0 (slave), debugging output is always written to the AUDIT
        !           107: file.
        !           108: .TP 8
        !           109: .B \-L
        !           110: Only call ``local'' sites. A site is considered local if
        !           111: the device-type field in 
        !           112: .I L.sys
        !           113: is one of LOCAL, DIR or TCP.
        !           114: .TP 8
        !           115: .BI \-t turnaround
        !           116: Use
        !           117: .I turnaround
        !           118: as the line turnaround time (in minutes) instead of the default 30.  If 
        !           119: .I turnaround
        !           120: is missing or 0, line turnaround will be disabled.
        !           121: After
        !           122: .I uucico
        !           123: has been running in slave role for
        !           124: .I turnaround 
        !           125: minutes, it will attempt to run in master role by negotiating with the
        !           126: remote machine.
        !           127: In earlier versions of
        !           128: .IR uucico ,
        !           129: a transfer of many large files in one direction would hold up mail
        !           130: going in the other direction.
        !           131: With the turnaround code working, the message flow will be more
        !           132: bidirectional in the short term.
        !           133: This option only works with newer
        !           134: .IR uucico 's
        !           135: and is ignored by older ones.
        !           136: .PP
        !           137: If
        !           138: .I uucico
        !           139: receives a
        !           140: .B SIGFPE
        !           141: (see
        !           142: .IR kill (1)),
        !           143: it will toggle the debugging on or off.
        !           144: .PP
        !           145: .I Uucpd
        !           146: is the server for supporting uucp connections over networks.
        !           147: .I Uucpd
        !           148: listens for service requests at the port indicated in the ``uucp''
        !           149: service specification; see \fIservices\fP\|(5).
        !           150: The server provides login name and password authentication before starting up
        !           151: .I uucico
        !           152: for the rest of the transaction.
        !           153: .PP
        !           154: .I Uucico
        !           155: is commonly used either of two ways: as a daemon run periodically by
        !           156: .IR cron (8)
        !           157: to call out to remote systems, and as a ``shell'' for remote systems
        !           158: who call in.
        !           159: For calling out periodically, a typical line in
        !           160: .I crontab
        !           161: would be:
        !           162: .PP
        !           163: .nf
        !           164:        0       *       *       *       *       /usr/lib/uucp/uucico -r1
        !           165: .fi
        !           166: .PP
        !           167: This will run
        !           168: .I uucico
        !           169: every hour in master role. 
        !           170: For each system that has transfer requests queued, 
        !           171: .I uucico
        !           172: calls the system, logs in, and executes the transfers. The file
        !           173: .IR L.sys (5)
        !           174: is consulted for information about how to log in, while
        !           175: .IR L-devices (5)
        !           176: specifies available lines and modems for calling.
        !           177: .PP
        !           178: For remote systems to dial in, an entry in the
        !           179: .IR passwd (5)
        !           180: file must be created, with a login ``shell'' of
        !           181: .IR uucico .
        !           182: For example:
        !           183: .PP
        !           184: .nf
        !           185:        nuucp:Password:6:1::/var/spool/uucppublic:/usr/lib/uucp/uucico
        !           186: .fi
        !           187: .PP
        !           188: The UID for UUCP remote logins is not critical, so long as it differs from
        !           189: the UUCP Administrative login.
        !           190: The latter owns the UUCP files, and assigning
        !           191: this UID to a remote login would be an extreme security hazard. 
        !           192: .SH FILES
        !           193: .ta \w'/var/spool/uucp/D.hostnameX/  'u
        !           194: .nf
        !           195: /usr/lib/uucp/ UUCP internal files/utilities
        !           196: /usr/lib/uucp/L-devices        Local device descriptions
        !           197: /usr/lib/uucp/L-dialcodes      Phone numbers and prefixes
        !           198: /usr/lib/uucp/L.aliases        Hostname aliases
        !           199: /usr/lib/uucp/L.cmds   Remote command permissions list
        !           200: /usr/lib/uucp/L.sys    Host connection specifications
        !           201: /usr/lib/uucp/USERFILE Remote directory tree permissions list
        !           202: .PP
        !           203: /var/spool/uucp/       Spool directory
        !           204: /var/spool/uucp/AUDIT/*        Debugging audit trails
        !           205: /var/spool/uucp/C./    Control files directory
        !           206: /var/spool/uucp/D./    Incoming data file directory
        !           207: /var/spool/uucp/D.hostname/    Outgoing data file directory
        !           208: /var/spool/uucp/D.hostnameX/   Outgoing execution file directory
        !           209: /var/spool/uucp/CORRUPT/       Place for corrupted C. and D. files
        !           210: /var/spool/uucp/ERRLOG UUCP internal error log
        !           211: /var/spool/uucp/LOGFILE        UUCP system activity log
        !           212: /var/spool/uucp/LCK/LCK..*     Device lock files
        !           213: /var/spool/uucp/SYSLOG File transfer statistics log
        !           214: /var/spool/uucp/STST/* System status files
        !           215: /var/spool/uucp/TM./   File transfer temp directory
        !           216: /var/spool/uucp/X./    Incoming execution file directory
        !           217: .PP
        !           218: /var/spool/uucppublic  Public access directory
        !           219: .fi
        !           220: .SH SEE ALSO
        !           221: uucp(1), uuq(1), uux(1), L-devices(5), L-dialcodes(5), L.aliases(5),
        !           222: L.cmds(5), L.sys(5), uuclean(8), uupoll(8), uusnap(8), uuxqt(8)
        !           223: .PP
        !           224: D. A. Nowitz and M. E. Lesk,
        !           225: .IR "A Dial-Up Network of UNIX Systems" .
        !           226: .PP
        !           227: D. A. Nowitz,
        !           228: .IR "Uucp Implementation Description" .

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.