man/man8/print-service.8

         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.