![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to uustat.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [MW Coherent from dump] / coherent / g / usr / lib / uucp / tay104|
Return to uustat.1 CVS log | Up to [MW Coherent from dump] / coherent / g / usr / lib / uucp / tay104 |
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.