Return to uustat.1 CVS log

Up to [MW Coherent from dump] / coherent / g / usr / lib / uucp / tay104

Annotation of coherent/g/usr/lib/uucp/tay104/uustat.1, revision 1.1

1.1     ! root        1: ''' $Id: uustat.1,v 1.1 93/07/30 07:59:47 bin Exp Locker: bin $
        !             2: .TH uustat 1 "Taylor UUCP 1.04"
        !             3: .SH NAME
        !             4: uustat \- UUCP status inquiry and control
        !             5: .SH SYNOPSIS
        !             6: .B uustat \-a
        !             7: .PP
        !             8: .B uustat
        !             9: [
        !            10: .B \-eKiMNQ ] [
        !            11: .B \-sS
        !            12: system ] [
        !            13: .B \-uU
        !            14: user ] [
        !            15: .B \-cC
        !            16: command ] [
        !            17: .B \-o
        !            18: hours ] [
        !            19: .B \-y
        !            20: hours ] [
        !            21: .B \-B
        !            22: lines ]
        !            23: .PP
        !            24: .B uustat
        !            25: [
        !            26: .B \-k
        !            27: jobid ] [
        !            28: .B \-r
        !            29: jobid ]
        !            30: .PP
        !            31: .B uustat \-q
        !            32: .PP
        !            33: .B uustat \-m
        !            34: .PP
        !            35: .B uustat \-p
        !            36: .SH DESCRIPTION
        !            37: The
        !            38: .I uustat
        !            39: command can display various types of status information about the UUCP
        !            40: system.  It can also be used to cancel or rejuvenate requests made by
        !            41: .I uucp
        !            42: (1) or
        !            43: .I uux
        !            44: (1).
        !            45: 
        !            46: By default
        !            47: .I uustat
        !            48: displays all jobs queued up for the invoking user, as if given the
        !            49: .B \-u
        !            50: option with the appropriate argument.
        !            51: 
        !            52: If any of the
        !            53: .B \-a,
        !            54: .B \-e,
        !            55: .B \-s,
        !            56: .B \-S,
        !            57: .B \-u,
        !            58: .B \-U,
        !            59: .B \-c,
        !            60: .B \-C,
        !            61: .B \-o,
        !            62: .B \-y
        !            63: options are given, then all jobs which match the combined
        !            64: specifications are displayed.
        !            65: 
        !            66: The 
        !            67: .B \-K
        !            68: option may be used to kill off a selected group of jobs, such as all
        !            69: jobs more than 7 days old.
        !            70: .SH OPTIONS
        !            71: The following options may be given to
        !            72: .I uustat.
        !            73: .TP 5
        !            74: .B \-a
        !            75: List all queued file transfer requests.
        !            76: .TP 5
        !            77: .B \-e
        !            78: List queued execution requests rather than queued file transfer
        !            79: requests.  Queued execution requests are processed by
        !            80: .I uuxqt
        !            81: (8) rather than
        !            82: .I uucico
        !            83: (8).  Queued execution requests may be waiting for some file to be
        !            84: transferred from a remote system.  They are created by an invocation
        !            85: of
        !            86: .I uux
        !            87: (1).
        !            88: .TP 5
        !            89: .B \-s system
        !            90: List all jobs queued up for the named system.  This option may be
        !            91: specified multiple times, in which case all jobs for all the systems
        !            92: will be listed.
        !            93: .TP 5
        !            94: .B \-S system
        !            95: List all jobs queued for systems other than the one named.  This
        !            96: option may be specified multiple times, in which case no jobs from any
        !            97: of the specified systems will be listed.  This option may not be used
        !            98: with
        !            99: .B \-s.
        !           100: .TP 5
        !           101: .B \-u user
        !           102: List all jobs queued up for the named user.  This option may be
        !           103: specified multiple times, in which case all jobs for all the users
        !           104: will be listed.
        !           105: .TP 5
        !           106: .B \-U user
        !           107: List all jobs queued up for users other than the one named.  This
        !           108: option may be specified multiple times, in which case no jobs from any
        !           109: of the specified users will be listed.  This option may not be used
        !           110: with
        !           111: .B \-u.
        !           112: .TP 5
        !           113: .B \-c command
        !           114: List all jobs requesting the execution of the named command.  If
        !           115: .B command
        !           116: is
        !           117: .I ALL
        !           118: this will list all jobs requesting the execution of some command (as
        !           119: opposed to simply requesting a file transfer).  This option may be
        !           120: specified multiple times, in which case all jobs requesting any of the
        !           121: commands will be listed.
        !           122: .TP 5
        !           123: .B \-C command
        !           124: List all jobs requesting execution of some command other than the
        !           125: named command, or, if
        !           126: .B command
        !           127: is
        !           128: .I ALL,
        !           129: list all jobs that simply request a file transfer (as opposed to
        !           130: requesting the execution of some command).  This option may be
        !           131: specified multiple times, in which case no job requesting one of the
        !           132: specified commands will be listed.  This option may not be used with
        !           133: .B \-c.
        !           134: .TP 5
        !           135: .B \-o hours
        !           136: List all queued jobs older than the given number of hours.
        !           137: .TP 5
        !           138: .B \-y hours
        !           139: List all queued jobs younger than the given number of hours.
        !           140: .TP 5
        !           141: .B \-k jobid
        !           142: Kill the named job.  The job id is shown by the default output format,
        !           143: as well as by the
        !           144: .B \-j
        !           145: option to
        !           146: .I uucp
        !           147: (1) or
        !           148: .I uux
        !           149: (1).  A job may only be killed by the user who created the job, or by
        !           150: the UUCP administrator or the superuser.  The
        !           151: .B \-k
        !           152: option may be used multiple times on the command line to kill several
        !           153: jobs.
        !           154: .TP 5
        !           155: .B \-r jobid
        !           156: Rejuvenate the named job.  This will mark it as having been invoked at
        !           157: the current time, affecting the output of the
        !           158: .B \-o
        !           159: or
        !           160: .B \-y
        !           161: options and preserving it from any automated cleanup daemon.  The job
        !           162: id is shown by the default output format, as well as by the
        !           163: .B \-j
        !           164: option to
        !           165: .I uucp
        !           166: (1) or
        !           167: .I uux
        !           168: (1).  A job may only be rejuvenated by the user who created the job,
        !           169: or by the UUCP administrator or the superuser.  The
        !           170: .B \-r
        !           171: option may be used multiple times on the command line to rejuvenate
        !           172: several jobs.
        !           173: .TP 5
        !           174: .B \-q
        !           175: Display the status of commands, executions and conversations for all
        !           176: remote systems for which commands or executions are queued.
        !           177: .TP 5
        !           178: .B \-m
        !           179: Display the status of conversations for all remote systems.
        !           180: .TP 5
        !           181: .B \-p
        !           182: Display the status of all processes holding UUCP locks on systems or
        !           183: ports.
        !           184: .TP 5
        !           185: .B \-i
        !           186: For each listed job, prompt whether to kill the job or not.  If the
        !           187: first character of the input line is
        !           188: .I y
        !           189: or
        !           190: .I Y
        !           191: the job will be killed.
        !           192: .TP 5
        !           193: .B \-K
        !           194: Automatically kill each listed job.  This can be useful for automatic
        !           195: cleanup scripts, in conjunction with the
        !           196: .B \-M
        !           197: and
        !           198: .B \-N
        !           199: options.
        !           200: .TP 5
        !           201: .B \-M
        !           202: For each listed job, send mail to the UUCP administrator.  If the job
        !           203: is killed (due to
        !           204: .B \-K
        !           205: or
        !           206: .B \-i
        !           207: with an affirmative response) the mail will indicate that.  A comment
        !           208: specified by the
        !           209: .B \-W
        !           210: option may be included.  If the job is an execution, the initial
        !           211: portion of its standard input will be included in the mail message;
        !           212: the number of lines to include may be set with the
        !           213: .B \-B
        !           214: option (the default is 100).  If the standard input contains null
        !           215: characters, it is assumed to be a binary file and is not included.
        !           216: .TP 5
        !           217: .B \-N
        !           218: For each listed job, send mail to the user who requested the job.  The
        !           219: mail is identical to that sent by the
        !           220: .B \-M
        !           221: option.
        !           222: .TP 5
        !           223: .B \-W
        !           224: Specify a comment to be included in mail sent with the
        !           225: .B \-M
        !           226: or
        !           227: .B \-N
        !           228: options.
        !           229: .TP 5
        !           230: .B \-Q
        !           231: Do not actually list the job, but only take any actions indicated by
        !           232: the
        !           233: .B \-i,
        !           234: .B \-K,
        !           235: .B \-M,
        !           236: .B \-N
        !           237: options.
        !           238: .TP 5
        !           239: .B \-x type
        !           240: Turn on particular debugging types.  The following types are
        !           241: recognized: abnormal, chat, handshake, uucp-proto, proto, port,
        !           242: config, spooldir, execute, incoming, outgoing.  Only abnormal, config,
        !           243: spooldir and execute are meaningful for
        !           244: .I uustat.
        !           245: 
        !           246: Multiple types may be given, separated by commas, and the
        !           247: .B \-x
        !           248: option may appear multiple times.  A number may also be given, which
        !           249: will turn on that many types from the foregoing list; for example,
        !           250: .B \-x 2
        !           251: is equivalent to
        !           252: .B \-x abnormal,chat.
        !           253: .TP 5
        !           254: .B \-I file
        !           255: Set configuration file to use.  This option may not be available,
        !           256: depending upon how
        !           257: .I uustat
        !           258: was compiled.
        !           259: .SH EXAMPLES
        !           260: .EX
        !           261: uustat -a
        !           262: .EE
        !           263: Display status of all jobs.  A sample output line is as follows:
        !           264: .EX
        !           265: bugsA027h bugs ian 04-01 13:50 Executing rmail [email protected] (sending 1283 bytes)
        !           266: .EE
        !           267: The format is
        !           268: .EX
        !           269: jobid system user queue-date command (size)
        !           270: .EE
        !           271: The jobid may be passed to the
        !           272: .B \-k
        !           273: or
        !           274: .B \-r
        !           275: options.
        !           276: The size indicates how much data is to be transferred to the remote
        !           277: system, and is absent for a file receive request.
        !           278: The
        !           279: .B \-s,
        !           280: .B \-S,
        !           281: .B \-u,
        !           282: .B \-U,
        !           283: .B \-c,
        !           284: .B \-C,
        !           285: .B \-o,
        !           286: and
        !           287: .B \-y
        !           288: options may be used to control which jobs are listed.
        !           289: 
        !           290: .EX
        !           291: uustat -e
        !           292: .EE
        !           293: Display status of queued up execution requests.  A sample output line
        !           294: is as follows:
        !           295: .EX
        !           296: bugs bugs!ian 05-20 12:51 rmail ian
        !           297: .EE
        !           298: The format is
        !           299: .EX
        !           300: system requestor queue-date command
        !           301: .EE
        !           302: The
        !           303: .B \-s,
        !           304: .B \-S,
        !           305: .B \-u,
        !           306: .B \-U,
        !           307: .B \-c,
        !           308: .B \-C,
        !           309: .B \-o,
        !           310: and
        !           311: .B \-y
        !           312: options may be used to control which requests are listed.
        !           313: 
        !           314: .EX
        !           315: uustat -q
        !           316: .EE
        !           317: Display status for all systems with queued up commands.  A sample
        !           318: output line is as follows:
        !           319: .EX
        !           320: bugs            4C (1 hour)   0X (0 secs) 04-01 14:45 Dial failed
        !           321: .EE
        !           322: This indicates the system, the number of queued commands, the age of
        !           323: the oldest queued command, the number of queued local executions, the
        !           324: age of the oldest queued execution, the date of the last conversation,
        !           325: and the status of that conversation.
        !           326: 
        !           327: .EX
        !           328: uustat -m
        !           329: .EE
        !           330: Display conversation status for all remote systems.  A sample output
        !           331: line is as follows:
        !           332: .EX
        !           333: bugs           04-01 15:51 Conversation complete
        !           334: .EE
        !           335: This indicates the system, the date of the last conversation, and the
        !           336: status of that conversation.  If the last conversation failed,
        !           337: .I uustat
        !           338: will indicate how many attempts have been made to call the system.  If
        !           339: the retry period is currently preventing calls to that system,
        !           340: .I uustat
        !           341: also displays the time when the next call will be permitted.
        !           342: 
        !           343: .EX
        !           344: uustat -p
        !           345: .EE
        !           346: Display the status of all processes holding UUCP locks.  The output
        !           347: format is system dependent, as
        !           348: .I uustat
        !           349: simply invokes
        !           350: .I ps
        !           351: (1) on each process holding a lock.
        !           352: 
        !           353: .EX
        !           354: uustat -c rmail -o 168 -K -Q -M -N -W"Queued for over 1 week"
        !           355: .EE
        !           356: This will kill all
        !           357: .I rmail
        !           358: commands that have been queued up waiting for delivery for over 1 week
        !           359: (168 hours).  For each such command, mail will be sent both to the
        !           360: UUCP administrator and to the user who requested the rmail execution.
        !           361: The mail message sent will include the string given by the
        !           362: .B \-W
        !           363: option.  The
        !           364: .B \-Q
        !           365: option prevents any of the jobs from being listed on the terminal, so
        !           366: any output from the program will be error messages.
        !           367: .SH FILES
        !           368: The file names may be changed at compilation time or by the
        !           369: configuration file, so these are only approximations.
        !           370: 
        !           371: .br
        !           372: /usr/lib/uucp/config - Configuration file.
        !           373: .br
        !           374: /usr/spool/uucp -
        !           375: UUCP spool directory.
        !           376: .SH SEE ALSO
        !           377: ps(1), rmail(1), uucp(1), uux(1), uucico(8), uuxqt(8)
        !           378: .SH AUTHOR
        !           379: Ian Lance Taylor
        !           380: ([email protected] or uunet!airs!ian)

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