usr/src/man/man1b/lprm.1b

   1 '\" te
   2 .\" Copyright (c) 1983 Regents of the University of California.  All rights reserved.  The Berkeley software License Agreement  specifies the terms and conditions for redistribution.
   3 .\" Copyright (C) 2006, Sun Microsystems, Inc. All Rights Reserved
   4 .TH LPRM 1B "Jun 2, 2006"
   5 .SH NAME
   6 lprm \- remove print requests from the print queue
   7 .SH SYNOPSIS
   8 .LP
   9 .nf
  10 \fB/usr/ucb/lprm\fR [\fB-P\fR \fIdestination\fR] [\fB-\fR] [\fIrequest-ID\fR]...
  11      [\fIuser\fR]...
  12 .fi
  13
  14 .SH DESCRIPTION
  15 .sp
  16 .LP
  17 The  \fBlprm\fR utility removes print requests  (\fIrequest-ID\fR) from the
  18 print queue.
  19 .sp
  20 .LP
  21 Without arguments, \fBlprm\fR deletes the current print request. \fBlprm\fR
  22 reports the  name of the file associated with print requests that it removes.
  23 \fBlprm\fR is silent if there are no applicable print requests to remove.
  24 .sp
  25 .LP
  26 Users can only remove print requests associated with their user name. See
  27 Notes. If a superuser executes \fBlprm\fR and specifies the \fIuser\fR operand,
  28 \fBlprm\fR removes all print requests belonging to the specified user.
  29 .sp
  30 .LP
  31 The print client commands locate destination information using the "printers"
  32 database in the name service switch. See \fBnsswitch.conf\fR(4),
  33 \fBprinters\fR(4), and \fBprinters.conf\fR(4) for details.
  34 .SH OPTIONS
  35 .sp
  36 .LP
  37 The following options are supported:
  38 .sp
  39 .ne 2
  40 .na
  41 \fB\fB-P\fR \fIdestination\fR\fR
  42 .ad
  43 .RS 18n
  44 The name of the printer or class of printers (see \fBlpadmin\fR(1M)) from which
  45 to remove print requests. Specify destination using atomic, URI-style
  46 (\fIscheme\fR\fB://\fR\fBendpoint\fR), or POSIX-style
  47 (\fIserver\fR\fB:\fR\fIdestination\fR) names. See \fBprinters.conf\fR(4) for
  48 information regarding the naming naming conventions for destination names.
  49 .RE
  50
  51 .sp
  52 .ne 2
  53 .na
  54 \fB\fB\(mi\fR\fR
  55 .ad
  56 .RS 18n
  57 If a user specifies this option,  removes all print requests owned by that
  58 user. If a superuser specifies this option, removes all requests in the print
  59 queue.  Job ownership is determined by the user's login name and host name on
  60 the machine from which \fBlpr\fR was executed. See Notes.
  61 .RE
  62
  63 .SH OPERANDS
  64 .sp
  65 .LP
  66 The following operands are supported.
  67 .sp
  68 .ne 2
  69 .na
  70 \fB\fIrequest-ID\fR\fR
  71 .ad
  72 .RS 14n
  73 Removes a specific print request. Specify  \fIrequest-ID\fR as the job number
  74 (\fBJob\fR) associated with a print request and  reported by \fBlpq\fR. See
  75 \fBlpq\fR(1B).
  76 .RE
  77
  78 .sp
  79 .ne 2
  80 .na
  81 \fB\fIuser\fR\fR
  82 .ad
  83 .RS 14n
  84 Removes print requests associated with  a specific user. Specify \fIuser\fR as
  85 a valid user name. This option can only be used by a superuser.
  86 .RE
  87
  88 .SH EXAMPLES
  89 .LP
  90 \fBExample 1 \fRRemoving a Print Request
  91 .sp
  92 .LP
  93 The following example removes request-ID \fB385\fR from destination
  94 \fBkilltree\fR:
  95
  96 .sp
  97 .in +2
  98 .nf
  99 example% \fBlprm \(miP killtree 385\fR
 100 .fi
 101 .in -2
 102 .sp
 103
 104 .SH EXIT STATUS
 105 .sp
 106 .LP
 107 The following exit values are returned:
 108 .sp
 109 .ne 2
 110 .na
 111 \fB\fB0\fR\fR
 112 .ad
 113 .RS 12n
 114 Successful completion.
 115 .RE
 116
 117 .sp
 118 .ne 2
 119 .na
 120 \fBnon-zero\fR
 121 .ad
 122 .RS 12n
 123 An error occurred.
 124 .RE
 125
 126 .SH FILES
 127 .sp
 128 .ne 2
 129 .na
 130 \fB\fB$HOME/.printers\fR\fR
 131 .ad
 132 .RS 24n
 133 User-configurable printer database
 134 .RE
 135
 136 .sp
 137 .ne 2
 138 .na
 139 \fB\fB/etc/printers.conf\fR\fR
 140 .ad
 141 .RS 24n
 142 System printer configuration database
 143 .RE
 144
 145 .sp
 146 .ne 2
 147 .na
 148 \fB\fBprinters.conf.byname\fR\fR
 149 .ad
 150 .RS 24n
 151 NIS version of \fB/etc/printers.conf\fR
 152 .RE
 153
 154 .sp
 155 .ne 2
 156 .na
 157 \fB\fBprinters.org_dir\fR\fR
 158 .ad
 159 .RS 24n
 160 NIS+ version of \fB/etc/printers.conf\fR
 161 .RE
 162
 163 .sp
 164 .ne 2
 165 .na
 166 \fB\fBou=printers\fR\fR
 167 .ad
 168 .RS 24n
 169 LDAP version of \fB/etc/printers.conf\fR
 170 .RE
 171
 172 .SH ATTRIBUTES
 173 .sp
 174 .LP
 175 See \fBattributes\fR(5) for descriptions of the following attributes:
 176 .sp
 177
 178 .sp
 179 .TS
 180 box;
 181 c | c
 182 l | l .
 183 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 184 _
 185 Interface Stability     Standard
 186 .TE
 187
 188 .SH SEE ALSO
 189 .sp
 190 .LP
 191 \fBlp\fR(1), \fBlpc\fR(1B), \fBlpq\fR(1B), \fBlpr\fR(1B), \fBlpstat\fR(1),
 192 \fBlpadmin\fR(1M), \fBnsswitch.conf\fR(4), \fBprinters\fR(4),
 193 \fBprinters.conf\fR(4), \fBattributes\fR(5), \fBstandards\fR(5)
 194 .SH NOTES
 195 .sp
 196 .LP
 197 Users can only remove print requests associated with their user name. By
 198 default, users can only remove print requests on the host from which the print
 199 request was submitted. If a superuser has set \fBuser-equivalence=true\fR in
 200 \fB/etc/printers.conf\fR on the print server, users can remove print requests
 201 associated with their user name on any host. Superusers can remove print
 202 requests on the host from which the print request was submitted. Superusers can
 203 also remove print requests from the print server.
 204 .sp
 205 .LP
 206 Some print servers send cancelation notification to job owners when their print
 207 jobs have been cancelled. This notification usually comes in the form of an
 208 email message. Cancelation notices cannot be disabled on a Solaris server.
 209 .SH NOTES
 210 .sp
 211 .LP
 212 When IPP is in use, the user is prompted for a passphrase if the remote print
 213 service is configured to require authentication.