usr/src/man/man1m/lpusers.1m

   1 '\" te
   2 .\"  Copyright 1989 AT&T  Copyright (c) 1996 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 LPUSERS 1M "Aug 19, 1996"
   7 .SH NAME
   8 lpusers \- set printing queue priorities
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fBlpusers\fR \fB-d\fR \fIpriority-level\fR
  13 .fi
  14
  15 .LP
  16 .nf
  17 \fBlpusers\fR \fB-q\fR \fIpriority-level\fR \fB-u\fR \fIlogin-ID-list\fR
  18 .fi
  19
  20 .LP
  21 .nf
  22 \fBlpusers\fR \fB-u\fR \fIlogin-ID-list\fR
  23 .fi
  24
  25 .LP
  26 .nf
  27 \fBlpusers\fR \fB-q\fR \fIpriority-level\fR
  28 .fi
  29
  30 .LP
  31 .nf
  32 \fBlpusers\fR \fB-l\fR
  33 .fi
  34
  35 .SH DESCRIPTION
  36 .sp
  37 .LP
  38 The \fBlpusers\fR command  sets limits to the queue priority level that can be
  39 assigned to  jobs submitted by users of the LP print service.
  40 .sp
  41 .LP
  42 The first form of the command (with \fB-d\fR) sets the system-wide priority
  43 default to \fIpriority-level\fR, where \fIpriority-level\fR is a value of 0 to
  44 39, with 0 being the highest priority. If a user does not specify a priority
  45 level with a print request (see \fBlp\fR(1)), the default priority level is
  46 used. Initially, the default priority level is 20.
  47 .sp
  48 .LP
  49 The second form of the command (with \fB-q\fR and \fB-u\fR) sets the default
  50 highest \fIpriority-level\fR (\|0-39\|) that the users in \fIlogin-ID-list\fR
  51 can request when submitting a print request. The \fIlogin-ID-list\fR argument
  52 may include  any or all of the following constructs:
  53 .sp
  54 .ne 2
  55 .na
  56 \fB\fIlogin-ID\fR\fR
  57 .ad
  58 .RS 24n
  59 A user on any system
  60 .RE
  61
  62 .sp
  63 .ne 2
  64 .na
  65 \fB\fIsystem_name\fR\fB!\fR\fIlogin-ID\fR\fR
  66 .ad
  67 .RS 24n
  68 A user on the system \fIsystem_name\fR
  69 .RE
  70
  71 .sp
  72 .ne 2
  73 .na
  74 \fB\fIsystem_name\fR\fB!all\fR\fR
  75 .ad
  76 .RS 24n
  77 All users on system \fIsystem_name\fR
  78 .RE
  79
  80 .sp
  81 .ne 2
  82 .na
  83 \fB\fBall!\fR\fIlogin-ID\fR\fR
  84 .ad
  85 .RS 24n
  86 A user on all systems
  87 .RE
  88
  89 .sp
  90 .ne 2
  91 .na
  92 \fB\fBall\fR\fR
  93 .ad
  94 .RS 24n
  95 All users on all systems
  96 .RE
  97
  98 .sp
  99 .LP
 100 Users that have been given a limit cannot submit a print request with a higher
 101 priority level than the one assigned, nor can they change a request that has
 102 already been submitted to have a higher priority. Any print requests submitted
 103 with priority levels higher than allowed will be given the highest priority
 104 allowed.
 105 .sp
 106 .LP
 107 The third form of the command (with \fB-u\fR)  removes any explicit priority
 108 level for the specified users.
 109 .sp
 110 .LP
 111 The fourth form of the command (with \fB-q\fR) sets the default highest
 112 priority level for all users not explicitly covered by the use of the second
 113 form of this command.
 114 .sp
 115 .LP
 116 The last form of the command (with \fB-l\fR)  lists the default priority level
 117 and the priority limits assigned to users.
 118 .SH OPTIONS
 119 .sp
 120 .LP
 121 The following options are supported:
 122 .sp
 123 .ne 2
 124 .na
 125 \fB\fB-d\fR\fI priority-level\fR\fR
 126 .ad
 127 .sp .6
 128 .RS 4n
 129 Set the system-wide priority default to \fIpriority-level\fR.
 130 .RE
 131
 132 .sp
 133 .ne 2
 134 .na
 135 \fB\fB-l\fR\fR
 136 .ad
 137 .sp .6
 138 .RS 4n
 139 List the default priority level and the priority limits assigned to users.
 140 .RE
 141
 142 .sp
 143 .ne 2
 144 .na
 145 \fB\fB-q\fR\fI priority-level\fR\fR
 146 .ad
 147 .sp .6
 148 .RS 4n
 149 Set the default highest priority level for all users not explicitly covered.
 150 .RE
 151
 152 .sp
 153 .ne 2
 154 .na
 155 \fB\fB-q\fR\fI priority-level\fR \fB-u\fR\fI login-ID-list\fR\fR
 156 .ad
 157 .sp .6
 158 .RS 4n
 159 Set the default highest \fIpriority-level\fR that the users in
 160 \fIlogin-ID-list\fR can request when submitting a print request.
 161 .RE
 162
 163 .sp
 164 .ne 2
 165 .na
 166 \fB\fB-u\fR\fI login-ID-list\fR\fR
 167 .ad
 168 .sp .6
 169 .RS 4n
 170 Remove any explicit priority level for the specified users.
 171 .RE
 172
 173 .SH EXIT STATUS
 174 .sp
 175 .LP
 176 The following exit values are returned:
 177 .sp
 178 .ne 2
 179 .na
 180 \fB\fB0\fR\fR
 181 .ad
 182 .RS 12n
 183 Successful completion.
 184 .RE
 185
 186 .sp
 187 .ne 2
 188 .na
 189 \fBnon-zero\fR
 190 .ad
 191 .RS 12n
 192 An error occurred.
 193 .RE
 194
 195 .SH SEE ALSO
 196 .sp
 197 .LP
 198 \fBlp\fR(1), \fBattributes\fR(5)