LPMOVE(1M) Maintenance Commands LPMOVE(1M)


NAME


lpmove - move print requests

SYNOPSIS


lpmove [request-ID] destination


lpmove source destination


DESCRIPTION


The lpmove command moves print requests queued by lp(1) or lpr(1B)
between destinations.


The first form of lpmove moves specific print requests (request-ID) to a
specific destination.


The second form of the lpmove command moves all print requests from one
destination (destination1) to another (destination2). This form of lpmove
also rejects new print requests for destination1.


lpmove moves individual requests or entire queues only within an instance
of a print service, not between a local and a remote queues or local
queues on different instances of a print service. Requests can only be
moved if the print service or protocol supports it. The LP print server
and IPP print protocol both support moving requests between queues. The
BSD print protocol does not.


When moving requests, lpmove does not check the acceptance status of the
destination to which the print requests are being moved (see accept(1M)).
lpmove does not move requests that have options (for example, content
type or requiring a special form) that cannot be handled by the new
destination.

OPERANDS


The following operands are supported:

request-ID
The specific print request to be moved. Specify request-ID
as the identifier associated with a print request as
reported by lpstat. See lpstat(1).


destination
The name of the printer or class of printers (see
lpadmin(1M)) to which lpmove moves a specified print
request. Specify destination using atomic, URI-style
(scheme://endpoint), POSIX-style (server:destination)
syntax.


source
The name of the destination from which lpmove moves all
print requests. Specify destination using atomic, URI-
style (scheme://endpoint), POSIX-style
(server:destination) syntax.


See printers.conf(4) for information regarding the naming conventions for
atomic names and standards(5) for information regarding POSIX.

EXIT STATUS


The following exit values are returned:

0
Successful completion.


non-zero
An error occurred.


FILES


/etc/printers.conf
System printer configuration database


$HOME/.printers
User-configurable printer database


ou=printers
LDAP version of /etc/printers.conf


printers.conf.byname
NIS version of /etc/printers.conf


ATTRIBUTES


See attributes(5) for descriptions of the following attributes:


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Obsolete |
+--------------------+-----------------+

SEE ALSO


lp(1), lpr(1B), lpstat(1), accept(1M), lpadmin(1M), lpsched(1M),
printers.conf(4), attributes(5), standards(5)


System Administration Guide: Solaris Printing

NOTES


When IPP is in use, the user is prompted for a passphrase if the remote
print service is configured to require authentication.


February 25, 2017 LPMOVE(1M)