|
|
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" .
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.