usr/src/man/man1m/lpmove.1m

   1 '\" te
   2 .\" Copyright (c) 2006 Sun Microsystems, Inc. All Rights Reserved.
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH LPMOVE 1M "Jun 6, 2006"
   7 .SH NAME
   8 lpmove \- move print requests
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fBlpmove\fR [\fIrequest-ID\fR] \fIdestination\fR
  13 .fi
  14
  15 .LP
  16 .nf
  17 \fBlpmove\fR \fIsource\fR \fIdestination\fR
  18 .fi
  19
  20 .SH DESCRIPTION
  21 .sp
  22 .LP
  23 The \fBlpmove\fR command moves print requests queued by \fBlp\fR(1) or
  24 \fBlpr\fR(1B) between destinations.
  25 .sp
  26 .LP
  27 The first form of \fBlpmove\fR moves specific print requests (\fIrequest-ID\fR)
  28 to a specific \fIdestination\fR.
  29 .sp
  30 .LP
  31 The second form of the \fBlpmove\fR command moves all print requests from one
  32 destination (\fIdestination1\fR) to another (\fIdestination2\fR). This form of
  33 \fBlpmove\fR also rejects new print requests for \fIdestination1\fR.
  34 .sp
  35 .LP
  36 \fBlpmove\fR moves individual requests or entire queues only within an instance
  37 of a print service, not between a local and a remote queues or local queues on
  38 different instances of a print service. Requests can only be moved if the print
  39 service or protocol supports it. The LP print server and IPP print protocol
  40 both support moving requests between queues. The BSD print protocol does not.
  41 .sp
  42 .LP
  43 When moving requests, \fBlpmove\fR does not check the acceptance status of the
  44 destination to which the print requests are being moved (see \fBaccept\fR(1M)).
  45 \fBlpmove\fR does not move requests that have options (for example, content
  46 type or requiring a special form) that cannot be handled by the new
  47 destination.
  48 .SH OPERANDS
  49 .sp
  50 .LP
  51 The following operands are supported:
  52 .sp
  53 .ne 2
  54 .na
  55 \fB\fIrequest-ID\fR\fR
  56 .ad
  57 .RS 15n
  58 The specific print request to be moved. Specify \fIrequest-ID\fR as the
  59 identifier associated with a print request as reported by \fBlpstat\fR. See
  60 \fBlpstat\fR(1).
  61 .RE
  62
  63 .sp
  64 .ne 2
  65 .na
  66 \fB\fIdestination\fR\fR
  67 .ad
  68 .RS 15n
  69 The name of the printer or class of printers (see \fBlpadmin\fR(1M)) to which
  70 \fBlpmove\fR moves a \fIspecified\fR print request. Specify \fIdestination\fR
  71 using atomic, URI-style (\fIscheme\fR://\fIendpoint\fR), POSIX-style
  72 (\fIserver\fR\fB:\fR\fIdestination\fR) syntax.
  73 .RE
  74
  75 .sp
  76 .ne 2
  77 .na
  78 \fB\fIsource\fR\fR
  79 .ad
  80 .RS 15n
  81 The name of the destination from which \fBlpmove\fR moves \fIall\fR print
  82 requests. Specify \fIdestination\fR using atomic, URI-style
  83 (\fIscheme\fR\fB://\fR\fIendpoint\fR), POSIX-style
  84 (\fIserver\fR\fB:\fR\fIdestination\fR) syntax.
  85 .RE
  86
  87 .sp
  88 .LP
  89 See \fBprinters.conf\fR(4) for information regarding the naming conventions for
  90 atomic names and \fBstandards\fR(5) for information regarding POSIX.
  91 .SH EXIT STATUS
  92 .sp
  93 .LP
  94 The following exit values are returned:
  95 .sp
  96 .ne 2
  97 .na
  98 \fB\fB0\fR\fR
  99 .ad
 100 .RS 12n
 101 Successful completion.
 102 .RE
 103
 104 .sp
 105 .ne 2
 106 .na
 107 \fBnon-zero\fR
 108 .ad
 109 .RS 12n
 110 An error occurred.
 111 .RE
 112
 113 .SH FILES
 114 .sp
 115 .ne 2
 116 .na
 117 \fB\fB/etc/printers.conf\fR\fR
 118 .ad
 119 .RS 24n
 120 System printer configuration database
 121 .RE
 122
 123 .sp
 124 .ne 2
 125 .na
 126 \fB\fB$HOME/.printers\fR\fR
 127 .ad
 128 .RS 24n
 129 User-configurable printer database
 130 .RE
 131
 132 .sp
 133 .ne 2
 134 .na
 135 \fB\fBou=printers\fR\fR
 136 .ad
 137 .RS 24n
 138 LDAP version of \fB/etc/printers.conf\fR
 139 .RE
 140
 141 .sp
 142 .ne 2
 143 .na
 144 \fB\fBprinters.conf.byname\fR\fR
 145 .ad
 146 .RS 24n
 147 \fBNIS\fR version of \fB/etc/printers.conf\fR
 148 .RE
 149
 150 .sp
 151 .ne 2
 152 .na
 153 \fB\fBprinters.org_dir\fR\fR
 154 .ad
 155 .RS 24n
 156 \fBNIS+\fR version of \fB/etc/printers.conf\fR
 157 .RE
 158
 159 .SH ATTRIBUTES
 160 .sp
 161 .LP
 162 See \fBattributes\fR(5) for descriptions of the following attributes:
 163 .sp
 164
 165 .sp
 166 .TS
 167 box;
 168 c | c
 169 l | l .
 170 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 171 _
 172 Interface Stability     Obsolete
 173 .TE
 174
 175 .SH SEE ALSO
 176 .sp
 177 .LP
 178 \fBlp\fR(1), \fBlpr\fR(1B), \fBlpstat\fR(1), \fBaccept\fR(1M),
 179 \fBlpadmin\fR(1M), \fBlpsched\fR(1M), \fBprinters.conf\fR(4),
 180 \fBattributes\fR(5), \fBstandards\fR(5)
 181 .sp
 182 .LP
 183 \fISystem Administration Guide: Solaris Printing\fR
 184 .SH NOTES
 185 .sp
 186 .LP
 187 When IPP is in use, the user is prompted for a passphsrase if the remote print
 188 service is configured to require authentication.