xref: /original-bsd/usr.bin/uucp/uuq/uuq.1 (revision a1c2194a)
1.\" Copyright (c) 1988, 1991 Regents of the University of California.
2.\" All rights reserved.
3.\"
4.\" %sccs.include.redist.roff%
5.\"
6.\"     @(#)uuq.1	6.6 (Berkeley) 04/23/91
7.\"
8.Dd
9.Dt UUQ 1
10.Os BSD 4.3
11.Sh NAME
12.Nm uuq
13.Nd examine or manipulate the uucp queue
14.Sh SYNOPSIS
15.Nm uuq
16.Op Fl l
17.Op Fl h
18.Op Fl s Ns Ar system
19.Op Fl u Ns Ar user
20.Op Fl d Ns Ar jobno
21.Op Fl r Ns Ar sdir
22.Op Fl b Ns Ar baud
23.Sh DESCRIPTION
24.Nm Uuq
25is used to examine (and possibly delete) entries in the uucp queue.
26.Pp
27When listing jobs,
28.Nm uuq
29uses a format reminiscent of
30.Xr ls .
31For the long format,
32information for each job listed includes
33job number, number of files to transfer, user who
34spooled the job, number of bytes to send, type of command requested
35(S for sending files, R for receiving files, X for remote uucp),
36and file or command desired.
37.Pp
38Several options are available:
39.Bl -tag -width Ar
40.It Fl h
41Print only the summary lines for each system.  Summary lines give system
42name, number of jobs for the system, and total number of bytes to send.
43.It Fl l
44Specifies a long format listing.  The default is to list only the
45job numbers sorted across the page.
46.It Fl s Ns Ar system
47Limit output to jobs for systems whose system names begin with
48.Ar system .
49.It Fl u Ns Ar user
50Limit output to jobs for users whose login names begin with
51.Ar user .
52.It Fl d Ns Ar jobno
53Delete job number
54.Ar jobno
55(as obtained from a previous
56.Nm uuq
57command)
58from the uucp queue.
59Only the
60.Tn UUCP
61Administrator is permitted to delete jobs.
62.It Fl r Ns Ar sdir
63Look for files in the spooling directory
64.Ar sdir
65instead of the default
66directory.
67.It Fl b Ns Ar baud
68Use
69.Ar baud
70to compute the transfer time instead of the default
711200 baud.
72.El
73.Sh FILES
74.Bl -tag -width /usr/spool/uucp/Dhostname./D.x -compact
75.It Pa /usr/spool/uucp/
76Default spool directory
77.It Pa /usr/spool/uucp/C./C.*
78Control files
79.It Pa /usr/spool/uucp/D Ns Em hostname ./D.*
80Outgoing data files
81.It Pa /usr/spool/uucp/X./X.*
82Outgoing execution files
83.El
84.Sh SEE ALSO
85.Xr uucp 1 ,
86.Xr uux 1 ,
87.Xr uulog 1 ,
88.Xr uusnap 8
89.Sh BUGS
90No information is available on work requested by the remote machine.
91.Pp
92The user who requests a remote uucp command is unknown.
93.Pp
94.Dq Li uq \-l
95can be horrendously slow.
96.Sh HISTORY
97The
98.Nm
99command appeared in
100.Bx 4.3 .
101