Annotation of coherent/g/usr/lib/uucp/tay104/uucico.8, revision 1.1.1.1

1.1       root        1: ''' $Id: uucico.8,v 1.1 93/07/30 07:54:33 bin Exp Locker: bin $
                      2: .TH uucico 8 "Taylor UUCP 1.04"
                      3: .SH NAME
                      4: uucico \- UUCP file transfer daemon
                      5: .SH SYNOPSIS
                      6: .B uucico
                      7: [ options ]
                      8: .SH DESCRIPTION
                      9: The
                     10: .I uucico
                     11: daemon processes file transfer requests queued by
                     12: .I uucp
                     13: (1) and
                     14: .I uux
                     15: (1).  It is started when
                     16: .I uucp
                     17: or
                     18: .I uux
                     19: is run (unless they are given the
                     20: .B \-r
                     21: option).  It is also typically started periodically using
                     22: entries in the
                     23: .I crontab
                     24: table(s).
                     25: 
                     26: When invoked with the
                     27: .B \-r1
                     28: option or the
                     29: .B \-s
                     30: or
                     31: .B \-S
                     32: option, the daemon will place a call to a remote system, running in
                     33: master mode.
                     34: Otherwise the daemon will start in slave mode, accepting a
                     35: call from a remote system.  Typically a special login name will be set
                     36: up for UUCP which automatically invokes
                     37: .I uucico
                     38: when a call is made.
                     39: 
                     40: When
                     41: .I uucico
                     42: terminates, it invokes the
                     43: .I uuxqt
                     44: (8) daemon, unless the
                     45: .B \-q
                     46: option is given;
                     47: .I uuxqt
                     48: (8) executes any work orders created by
                     49: .I uux
                     50: (1) on a remote system, and any work orders created locally which have
                     51: received remote files for which they were waiting.
                     52: 
                     53: If a call fails,
                     54: .I uucico
                     55: will normally refuse to retry the
                     56: call until a certain (configurable) amount of time
                     57: has passed.  This may be overriden by the
                     58: .B -f
                     59: or the
                     60: .B -S
                     61: option.
                     62: 
                     63: The
                     64: .B \-l
                     65: or
                     66: .B \-e
                     67: option may be used to force
                     68: .I uucico
                     69: to produce its own prompts of "login: " and "Password:".  When another
                     70: daemon calls in, it will see these prompts and log in as usual; the
                     71: login name and password will be checked against a separate list kept
                     72: specially for
                     73: .I uucico
                     74: rather than the
                     75: .I /etc/passwd
                     76: file.  The
                     77: .B \-l
                     78: option will prompt once and then exit.  The
                     79: .B \-e
                     80: option will prompt again after the first session is over; in this mode
                     81: .I uucico
                     82: will permanently control a port.
                     83: 
                     84: If
                     85: .I uucico
                     86: receives a SIGQUIT, SIGTERM or SIGPIPE signal, it will cleanly abort
                     87: any current conversation with a remote system and exit.  If it
                     88: receives a SIGHUP signal it will abort any current conversation, but
                     89: will continue to place calls to (if invoked with
                     90: .B \-r1)
                     91: and accept calls from (if invoked with
                     92: .B \-e)
                     93: other systems.  If it receives a
                     94: SIGINT signal it will finish the current conversation, but will not
                     95: place or accept any more calls.
                     96: .SH OPTIONS
                     97: The following options may be given to
                     98: .I uucico.
                     99: .TP 5
                    100: .B \-r1
                    101: Start in master mode (call out to a system); implied by
                    102: .B \-s
                    103: or
                    104: .B \-S.
                    105: If no system is specified, call any system for which work is waiting
                    106: to be done.
                    107: .TP 5
                    108: .B \-r0
                    109: Start in slave mode.  This is the default.
                    110: .TP 5
                    111: .B \-s system
                    112: Call the named system.
                    113: .TP 5
                    114: .B \-S system
                    115: Call the named system, ignoring any required wait.
                    116: .TP 5
                    117: .B \-f
                    118: Ignore any required wait for any systems to be called.
                    119: .TP 5
                    120: .B \-l
                    121: Prompt for login name and password using "login: " and "Password:".
                    122: This allows
                    123: .I uucico
                    124: to be easily run from
                    125: .I inetd
                    126: (8).  The login name and password are checked against the UUCP
                    127: password file, which has no connection to the file
                    128: .I /etc/passwd.
                    129: .TP 5
                    130: .B \-p port
                    131: Specify a port to call out on or to listen to.  In slave mode, this
                    132: implies
                    133: .B \-e.
                    134: .TP 5
                    135: .B \-e
                    136: Enter endless loop of login/password prompts and slave mode daemon
                    137: execution.  The program will not stop by itself; you must use
                    138: .I kill
                    139: (1) to shut it down.
                    140: .TP 5
                    141: .B \-w
                    142: After calling out (to a particular system when
                    143: .B \-s
                    144: or 
                    145: .B \-S
                    146: is specifed, or to all systems which have work when
                    147: .B \-r1
                    148: is specifed), begin an endless loop as with
                    149: .B \-e.
                    150: .TP 5
                    151: .B \-q
                    152: Do not start the
                    153: .I uuxqt
                    154: (8) daemon when finished.
                    155: .TP 5
                    156: .B \-c
                    157: If no calls are permitted at this time, then don't make the call, but
                    158: also do not put an error message in the log file and do not update the
                    159: system status (as reported by
                    160: .I uustat
                    161: (1)).  This can be convenient for automated polling scripts, which may
                    162: want to simply attempt to call every system rather than worry about
                    163: which particular systems may be called at the moment.
                    164: .TP 5
                    165: .B \-D
                    166: Do not detach from the controlling terminal.  Normally
                    167: .I uucico
                    168: detaches from the terminal before each call out to another system and
                    169: before invoking
                    170: .I uuxqt.
                    171: This option prevents this.
                    172: .TP 5
                    173: .B \-x type, \-X type
                    174: Turn on particular debugging types.  The following types are
                    175: recognized: abnormal, chat, handshake, uucp-proto, proto, port,
                    176: config, spooldir, execute, incoming, outgoing.  
                    177: 
                    178: Multiple types may be given, separated by commas, and the
                    179: .B \-x
                    180: option may appear multiple times.  A number may also be given, which
                    181: will turn on that many types from the foregoing list; for example,
                    182: .B \-x 2
                    183: is equivalent to
                    184: .B \-x abnormal,chat.
                    185: 
                    186: The debugging output is sent to the debugging file, usually one of
                    187: /usr/spool/uucp/Debug, /usr/spool/uucp/DEBUG, or
                    188: /usr/spool/uucp/.Admin/audit.local.
                    189: .TP 5
                    190: .B \-I file
                    191: Set configuration file to use.  This option may not be available,
                    192: depending upon how
                    193: .I uucico
                    194: was compiled.
                    195: .TP 5
                    196: .B \-u login
                    197: This option is ignored.  It is only included because some versions of
                    198: uucpd invoke
                    199: .I uucico
                    200: with it.
                    201: .SH FILES
                    202: The file names may be changed at compilation time or by the
                    203: configuration file, so these are only approximations.
                    204: 
                    205: .br
                    206: /usr/lib/uucp/config - Configuration file.
                    207: .br
                    208: /usr/lib/uucp/passwd - Default UUCP password file.
                    209: .br
                    210: /usr/spool/uucp -
                    211: UUCP spool directory.
                    212: .br
                    213: /usr/spool/uucp/Log -
                    214: UUCP log file.
                    215: .br
                    216: /usr/spool/uucppublic -
                    217: Default UUCP public directory.
                    218: .br
                    219: /usr/spool/uucp/Debug -
                    220: Debugging file.
                    221: .SH SEE ALSO
                    222: kill(1), uucp(1), uux(1), uustat(1), uuxqt(8)
                    223: .SH AUTHOR
                    224: Ian Lance Taylor
                    225: ([email protected] or uunet!airs!ian)

unix.superglobalmegacorp.com

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