Annotation of coherent/g/usr/lib/uucp/tay104/uucico.8, revision 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.