xref: /illumos-gate/usr/src/man/man8/print-service.8 (revision bbf21555)
te
Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved
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.
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.
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]
PRINT-SERVICE 8 "Mar 18, 2008"
NAME
print-service - select, report, import, export active print service on a system
SYNOPSIS

print-service [-s service [-m] | -q | -e file | -i file]
DESCRIPTION

The print-service utility manages print service selection, as well as export and import of basic print queue configuration.

Only a user root privileges or with the Printer Management profile can change the active print service or import print queue configuration.

OPTIONS

The following options are supported: -s service

Select the active print service for on a host. service can be one of lp or cups.

-m

Migrate print queue configuration during print service selection.

-q

Report the active print service on a host.

-e file

Export basic print queue configuration to a file.

-i file

Import basic print queue configuration from a file.

EXAMPLES

Example 1 Selecting a Print Service

The following command selects the CUPS print service as the active print service on a host.

# print-service -s cups

Example 2 Reporting the Active Print Service

The following command reports the active print service on a host.

# print-service -q

Example 3 Exporting a Print Queue Configuration

The following command exports the print queue configuration from the active print service.

# print-service -e /tmp/queues

Example 4 Importing a Print Queue Configuration

The following command imports the print queue configuration to the active print service.

# print-service -i /tmp/queues
EXIT STATUS
0

Successful completion.

non-zero

An error occurred.

ATTRIBUTES

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

ATTRIBUTE TYPE ATTRIBUTE VALUE
Interface Stability Obsolete
SEE ALSO

Intro (1), attributes (7)

NOTES

The print queue configuration saved and restored during export, import, and migration is limited to queue name and device name. It is likely that further configuration changes will be required before imported or migrated print queues become usable.