lpq(1b) - osol9

1lpq(1B)            SunOS/BSD Compatibility Package Commands            lpq(1B)
2
3
4

NAME

6       lpq - display the content of a print queue
7

SYNOPSIS

9       /usr/ucb/lpq [-P destination] [-l] [+ [interval]]
10            [request-ID...] [user]...
11
12

DESCRIPTION

14       The  lpq utility displays the information about the contents of a print
15       queue. A print queue is comprised of print requests  that  are  waiting
16       in the process of being printed.
17
18
19       lpq displays the following information to the standard output:
20
21           o      the username of the person associated with a print request,
22
23           o      the position of a print request in the print queue,
24
25           o      the name of file or files comprising a print request,
26
27           o      the job number of a print request, and
28
29           o      the size of the file requested by a print request. File size
30                  is reported in bytes.
31
32
33       Normally, only as much information as will fit  on  one  line  is  dis‐
34       played.  If  the name of the input file associated with a print request
35       is not available, the input file field indicates the standard input.
36
37
38       The print client commands  locate  destination  information  using  the
39       printers  database  in  the  name service switch. See nsswitch.conf(4),
40       printers(4), and printers.conf(4) for details.
41

OPTIONS

43       The following options are supported:
44
45       -l                Displays information  in  long  format.  Long  format
46                         includes  the  name  of  the  host from which a print
47                         request originated in the display.
48
49
50       -P destination    Displays information about printer or class of print‐
51                         ers  (see  lpadmin(1M))  .  Specify destination using
52                         atomic, URI-style (scheme://endpoint), or POSIX-style
53                         (server:destination)  names. See printers.conf(4) for
54                         information regarding destination names.
55
56
57       + [interval]      Displays  information  at  specific  time  intervals.
58                         Stops  displaying information when the print queue is
59                         empty. Clears the screen before reporting  displaying
60                         the  print  queue.  Specify interval as the number of
61                         seconds between displays. If  interval is not  speci‐
62                         fied only executes once.
63
64

OPERANDS

66       The following operands are supported:
67
68       request-ID    The job number associated with a print request.
69
70
71       user          The name of the user about whose jobs  lpq reports infor‐
72                     mation. Specify user as a valid username.
73
74

EXIT STATUS

76       The following exit values are returned:
77
78       0           Successful completion.
79
80
81       non-zero    An error occurred.
82
83

FILES

85       $HOME/.printers         User-configurable printer database
86
87
88       /etc/printers.conf      System printer configuration database
89
90
91       printers.conf.byname    NIS version of /etc/printers.conf
92
93
94       printers.org_dir        NIS+ version of /etc/printers.conf
95
96
97       ou=printers             LDAP version of /etc/printers.conf
98
99

ATTRIBUTES

101       See attributes(5) for descriptions of the following attributes:
102
103
104
105
106       ┌─────────────────────────────┬─────────────────────────────┐
107       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
108       ├─────────────────────────────┼─────────────────────────────┤
109       │Availability                 │SUNWlpr-cmds                 │
110       ├─────────────────────────────┼─────────────────────────────┤
111       │Interface Stability          │Standard                     │
112       └─────────────────────────────┴─────────────────────────────┘
113

NOTES

120       When IPP is in use, the user is prompted for a passphrase if the remote
121       print service is configured to require authentication.
122
123
124
125SunOS 5.11                        2 Jun 2006                           lpq(1B)