Return to uucico.8 CVS log

Up to [CSRG BSD Unix] / 43BSDTahoe / man / man8

Annotation of 43BSDTahoe/man/man8/uucico.8, revision 1.1

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

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