LPMOVE(8) Maintenance Commands and Procedures LPMOVE(8)

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(8)). 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(8)) 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(5) for information regarding the naming conventions
for atomic names and standards(7) 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(7) for descriptions of the following attributes:


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

SEE ALSO

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


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(8)