1uustat(1)                   General Commands Manual                  uustat(1)
2
3
4

NAME

6       uustat - UUCP status inquiry and control
7

SYNOPSIS

9       uustat -a
10
11       uustat --all
12
13       uustat  [  -eKRiMNQ ] [ -sS system ] [ -uU user ] [ -cC command ] [ -oy
14       hours ] [ -B lines ] [ --executions ] [ --kill-all ] [ --rejuvenate-all
15       ]  [ --prompt ] [ --mail ] [ --notify ] [ --no-list ] [ --system system
16       ] [ --not-system system ] [ --user user ] [ --not-user user ] [  --com‐
17       mand  command  ]  [  --not-command  command  ] [ --older-than hours ] [
18       --younger-than hours ] [ --mail-lines lines ]
19
20       uustat [ -kr jobid ] [ --kill jobid ] [ --rejuvenate jobid ]
21
22       uustat -q [ -sS system ] [ -oy hours ] [ --system system ] [ --not-sys‐
23       tem system ] [ --older-than hours ] [ --younger-than hours ]
24
25       uustat --list [ -sS system ] [ -oy hours ] [ --system system ] [ --not-
26       system system ] [ --older-than hours ] [ --younger-than hours ]
27
28       uustat -m
29
30       uustat --status
31
32       uustat -p
33
34       uustat --ps
35

DESCRIPTION

37       The uustat command can display  various  types  of  status  information
38       about  the  UUCP  system.   It can also be used to cancel or rejuvenate
39       requests made by uucp (1) or uux (1).
40
41       By default uustat displays all jobs queued up for the invoking user, as
42       if given the --user option with the appropriate argument.
43
44       If any of the -a, --all, -e, --executions, -s, --system, -S, --not-sys‐
45       tem, -u, --user, -U, --not-user, -c, --command, -C, --not-command,  -o,
46       --older-than, -y, --younger-than options are given, then all jobs which
47       match the combined specifications are displayed.
48
49       The -K or --kill-all option may be used to kill off a selected group of
50       jobs, such as all jobs more than 7 days old.
51

OPTIONS

53       The following options may be given to uustat.
54
55       -a, --all
56            List all queued file transfer requests.
57
58       -e, --executions
59            List  queued  execution  requests rather than queued file transfer
60            requests.  Queued execution requests are processed  by  uuxqt  (8)
61            rather  than uucico (8).  Queued execution requests may be waiting
62            for some file to be transferred from a remote  system.   They  are
63            created by an invocation of uux (1).
64
65       -s system, --system system
66            List  all  jobs queued up for the named system.  These options may
67            be specified multiple times, in which case all jobs  for  all  the
68            systems  will  be  listed.   If  used with --list only the systems
69            named will be listed.
70
71       -S system, --not-system system
72            List all jobs queued for systems other than the one named.   These
73            options  may  be  specified  multiple times, in which case no jobs
74            from any of the specified systems will be listed.   If  used  with
75            --list  only  the systems not named will be listed.  These options
76            may not be used with -s or --system.
77
78       -u user, --user user
79            List all jobs queued up for the named user.  These options may  be
80            specified multiple times, in which case all jobs for all the users
81            will be listed.
82
83       -U user, --not-user user
84            List all jobs queued up for users other than the one named.  These
85            options  may  be  specified  multiple times, in which case no jobs
86            from any of the specified users will be listed.  These options may
87            not be used with -u or --user.
88
89       -c command, --command command
90            List  all  jobs requesting the execution of the named command.  If
91            command is ALL this will list all jobs requesting the execution of
92            some  command  (as  opposed to simply requesting a file transfer).
93            These options may be specified multiple times, in which  case  all
94            jobs requesting any of the commands will be listed.
95
96       -C command, --not-command command
97            List  all jobs requesting execution of some command other than the
98            named command, or, if command is ALL, list all  jobs  that  simply
99            request a file transfer (as opposed to requesting the execution of
100            some command).  These options may be specified multiple times,  in
101            which case no job requesting one of the specified commands will be
102            listed.  These options may not be used with -c or --command.
103
104       -o hours, --older-than hours
105            List all queued jobs older than the given  number  of  hours.   If
106            used  with  --list only systems whose oldest job is older than the
107            given number of hours will be listed.
108
109       -y hours, --younger-than hours
110            List all queued jobs younger than the given number of  hours.   If
111            used with --list only systems whose oldest job is younger than the
112            given number of hours will be listed.
113
114       -k jobid, --kill jobid
115            Kill the named job.  The job id is shown  by  the  default  output
116            format,  as well as by the -j or --jobid option to uucp (1) or uux
117            (1).  A job may only be killed by the user who created the job, or
118            by  the  UUCP  administrator  or  the superuser.  The -k or --kill
119            options may be used multiple times on the  command  line  to  kill
120            several jobs.
121
122       -r jobid, --rejuvenate jobid
123            Rejuvenate  the  named  job.   This  will  mark  it as having been
124            invoked at the current time,  affecting  the  output  of  the  -o,
125            --older-than, -y, or --younger-than options and preserving it from
126            any automated cleanup daemon.  The job id is shown by the  default
127            output format, as well as by the -j or --jobid options to uucp (1)
128            or uux (1).  A job may only be rejuvenated by the user who created
129            the job, or by the UUCP administrator or the superuser.  The -r or
130            --rejuvenate options may be used multiple  times  on  the  command
131            line to rejuvenate several jobs.
132
133       -q, --list
134            Display  the  status of commands, executions and conversations for
135            all remote systems for which commands or  executions  are  queued.
136            The  -s,  --system,  -S,  --not-system,  -o, --older-than, -y, and
137            --younger-than options may be used to restrict the  systems  which
138            are  listed.   Systems  for  which  no  commands or executions are
139            queued will never be listed.
140
141       -m, --status
142            Display the status of conversations for all remote systems.
143
144       -p, --ps
145            Display the status of all processes holding UUCP locks on  systems
146            or ports.
147
148       -i, --prompt
149            For  each  listed  job, prompt whether to kill the job or not.  If
150            the first character of the input line is y or Y the  job  will  be
151            killed.
152
153       -K, --kill-all
154            Automatically  kill each listed job.  This can be useful for auto‐
155            matic cleanup scripts, in conjunction with the --mail and --notify
156            options.
157
158       -R, --rejuvenate-all
159            Automatically  rejuvenate  each  listed job.  This may not be used
160            with --kill-all.
161
162       -M, --mail
163            For each listed job, send mail to the UUCP administrator.  If  the
164            job  is  killed (due to --kill-all or --prompt with an affirmative
165            response) the mail will indicate that.  A comment specified by the
166            --comment option may be included.  If the job is an execution, the
167            initial portion of its standard input will be included in the mail
168            message;  the  number  of  lines  to  include  may be set with the
169            --mail-lines option (the default is 100).  If the  standard  input
170            contains null characters, it is assumed to be a binary file and is
171            not included.
172
173       -N, --notify
174            For each listed job, send mail to the user who requested the  job.
175            The mail is identical to that sent by the -M or --mail options.
176
177       -W comment, --comment comment
178            Specify a comment to be included in mail sent with the -M, --mail,
179            -N, or --notify options.
180
181       -B lines, --mail-lines lines
182            When the -M, --mail, -N, or --notify options are used to send mail
183            about  an  execution with standard input, this option controls the
184            number of lines of standard input to include in the message.   The
185            default is 100.
186
187       -Q, --no-list
188            Do  not actually list the job, but only take any actions indicated
189            by the -i, --prompt, -K, --kill-all, -M, --mail,  -N  or  --notify
190            options.
191
192       -x type, --debug type
193            Turn  on particular debugging types.  The following types are rec‐
194            ognized: abnormal, chat, handshake, uucp-proto, proto, port,  con‐
195            fig,  spooldir,  execute, incoming, outgoing.  Only abnormal, con‐
196            fig, spooldir and execute are meaningful for uustat.
197
198            Multiple types may be given, separated by commas, and the  --debug
199            option  may  appear  multiple  times.  A number may also be given,
200            which will turn on that many types from the  foregoing  list;  for
201            example, --debug 2 is equivalent to --debug abnormal,chat.
202
203       -I file, --config file
204            Set  configuration file to use.  This option may not be available,
205            depending upon how uustat was compiled.
206
207       -v, --version
208            Report version information and exit.
209
210       --help
211            Print a help message and exit.
212

EXAMPLES

214       uustat --all
215       Display status of all jobs.  A sample output line is as follows:
216            bugsA027h bugs ian 04-01 13:50 Executing rmail ian@airs.com (sending 1283 bytes)
217       The format is
218            jobid system user queue-date command (size)
219       The jobid may be passed to the --kill  or  --rejuvenate  options.   The
220       size indicates how much data is to be transferred to the remote system,
221       and is absent for a file receive request.  The --system,  --not-system,
222       --user,   --not-user,   --command,   --not-command,  --older-than,  and
223       --younger-than options may be used to control which jobs are listed.
224
225       uustat --executions
226       Display status of queued up execution requests.  A sample  output  line
227       is as follows:
228            bugs bugs!ian 05-20 12:51 rmail ian
229       The format is
230            system requestor queue-date command
231       The  --system,  --not-system, --user, --not-user, --command, --not-com‐
232       mand, --older-than, and --younger-than options may be used  to  control
233       which requests are listed.
234
235       uustat --list
236       Display  status for all systems with queued up commands.  A sample out‐
237       put line is as follows:
238            bugs            4C (1 hour)   0X (0 secs) 04-01 14:45 Dial failed
239       This indicates the system, the number of queued commands,  the  age  of
240       the  oldest  queued command, the number of queued local executions, the
241       age of the oldest queued execution, the date of the last  conversation,
242       and the status of that conversation.
243
244       uustat --status
245       Display  conversation  status  for all remote systems.  A sample output
246       line is as follows:
247            bugs           04-01 15:51 Conversation complete
248       This indicates the system, the date of the last conversation,  and  the
249       status  of  that conversation.  If the last conversation failed, uustat
250       will indicate how many attempts have been made to call the system.   If
251       the  retry  period is currently preventing calls to that system, uustat
252       also displays the time when the next call will be permitted.
253
254       uustat --ps
255       Display the status of all processes holding  UUCP  locks.   The  output
256       format  is  system  dependent,  as uustat simply invokes ps (1) on each
257       process holding a lock.
258
259            uustat --command rmail --older-than 168 --kill-all --no-list --mail --notify --comment "Queued for over 1 week"
260       This will kill all rmail commands that have been queued up waiting  for
261       delivery for over 1 week (168 hours).  For each such command, mail will
262       be sent both to the UUCP administrator and to the  user  who  requested
263       the  rmail  execution.   The  mail message sent will include the string
264       given by the --comment option.  The --no-list option  prevents  any  of
265       the jobs from being listed on the terminal, so any output from the pro‐
266       gram will be error messages.
267

SEE ALSO

269       ps(1), rmail(1), uucp(1), uux(1), uucico(8), uuxqt(8)
270

AUTHOR

272       Ian Lance Taylor (ian@airs.com)
273
274
275
276                               Taylor UUCP 1.07                      uustat(1)
Impressum