usr/src/man/man1m/print-service.1m

   1 '\" te
   2 .\" Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved
   3 .\" 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.
   4 .\" 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.
   5 .\" 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]
   6 .TH PRINT-SERVICE 1M "Mar 18, 2008"
   7 .SH NAME
   8 print-service \- select, report, import, export active print service on a
   9 system
  10 .SH SYNOPSIS
  11 .LP
  12 .nf
  13 \fBprint-service\fR  [\fB-s\fR \fIservice\fR [\fB-m\fR] | \fB-q\fR | \fB-e\fR \fIfile\fR | \fB-i\fR \fIfile\fR]
  14 .fi
  15
  16 .SH DESCRIPTION
  17 .sp
  18 .LP
  19 The \fBprint-service\fR utility manages print service selection, as well as
  20 export and import of basic print queue configuration.
  21 .sp
  22 .LP
  23 Only a user root privileges or with the Printer Management profile can change
  24 the active print service or import print queue configuration.
  25 .SH OPTIONS
  26 .sp
  27 .LP
  28 The following options are supported:
  29 .sp
  30 .ne 2
  31 .na
  32 \fB\fB-s\fR \fIservice\fR\fR
  33 .ad
  34 .sp .6
  35 .RS 4n
  36 Select the active print service for on a host. \fIservice\fR can be one of
  37 \fBlp\fR or \fBcups\fR.
  38 .RE
  39
  40 .sp
  41 .ne 2
  42 .na
  43 \fB\fB-m\fR\fR
  44 .ad
  45 .sp .6
  46 .RS 4n
  47 Migrate print queue configuration during print service selection.
  48 .RE
  49
  50 .sp
  51 .ne 2
  52 .na
  53 \fB\fB-q\fR\fR
  54 .ad
  55 .sp .6
  56 .RS 4n
  57 Report the active print service on a host.
  58 .RE
  59
  60 .sp
  61 .ne 2
  62 .na
  63 \fB\fB-e\fR \fIfile\fR\fR
  64 .ad
  65 .sp .6
  66 .RS 4n
  67 Export basic print queue configuration to a file.
  68 .RE
  69
  70 .sp
  71 .ne 2
  72 .na
  73 \fB\fB-i\fR \fIfile\fR\fR
  74 .ad
  75 .sp .6
  76 .RS 4n
  77 Import basic print queue configuration from a file.
  78 .RE
  79
  80 .SH EXAMPLES
  81 .LP
  82 \fBExample 1 \fRSelecting a Print Service
  83 .sp
  84 .LP
  85 The following command selects the CUPS print service as the active print
  86 service on a host.
  87
  88 .sp
  89 .in +2
  90 .nf
  91 # \fBprint-service -s cups\fR
  92 .fi
  93 .in -2
  94 .sp
  95
  96 .LP
  97 \fBExample 2 \fRReporting the Active Print Service
  98 .sp
  99 .LP
 100 The following command reports the active print service on a host.
 101
 102 .sp
 103 .in +2
 104 .nf
 105 # \fBprint-service -q\fR
 106 .fi
 107 .in -2
 108 .sp
 109
 110 .LP
 111 \fBExample 3 \fRExporting a Print Queue Configuration
 112 .sp
 113 .LP
 114 The following command exports the print queue configuration from the active
 115 print service.
 116
 117 .sp
 118 .in +2
 119 .nf
 120 # \fBprint-service -e /tmp/queues\fR
 121 .fi
 122 .in -2
 123 .sp
 124
 125 .LP
 126 \fBExample 4 \fRImporting a Print Queue Configuration
 127 .sp
 128 .LP
 129 The following command imports the print queue configuration to the active print
 130 service.
 131
 132 .sp
 133 .in +2
 134 .nf
 135 # \fBprint-service -i /tmp/queues\fR
 136 .fi
 137 .in -2
 138 .sp
 139
 140 .SH EXIT STATUS
 141 .sp
 142 .ne 2
 143 .na
 144 \fB\fB0\fR\fR
 145 .ad
 146 .sp .6
 147 .RS 4n
 148 Successful completion.
 149 .RE
 150
 151 .sp
 152 .ne 2
 153 .na
 154 \fB\fBnon-zero\fR\fR
 155 .ad
 156 .sp .6
 157 .RS 4n
 158 An error occurred.
 159 .RE
 160
 161 .SH ATTRIBUTES
 162 .sp
 163 .LP
 164 See \fBattributes\fR(5) for descriptions of the following attributes:
 165 .sp
 166
 167 .sp
 168 .TS
 169 box;
 170 c | c
 171 l | l .
 172 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 173 _
 174 Interface Stability     Obsolete
 175 .TE
 176
 177 .SH SEE ALSO
 178 .sp
 179 .LP
 180 \fBintro\fR(1), \fBattributes\fR(5)
 181 .SH NOTES
 182 .sp
 183 .LP
 184 The print queue configuration saved and restored during export, import, and
 185 migration is limited to queue name and device name. It is likely that further
 186 configuration changes will be required before imported or migrated print queues
 187 become usable.