lpmove(1M)

Name | Synopsis | Description | Operands | Exit Status | Files | Attributes | See Also | Notes

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

printers.org_dir

NIS+ version of /etc/printers.conf

Attributes

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWlp-cmds
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: Printing

Notes

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

SunOS 5.10  Last Revised 6 Jun 2006

Name | Synopsis | Description | Operands | Exit Status | Files | Attributes | See Also | Notes