Copyright 1989 AT&T Copyright (c) 1996 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]
lpusers -d priority-level
lpusers -q priority-level -u login-ID-list
lpusers -u login-ID-list
lpusers -q priority-level
lpusers -l
The lpusers command sets limits to the queue priority level that can be assigned to jobs submitted by users of the LP print service.
The first form of the command (with -d) sets the system-wide priority default to priority-level, where priority-level is a value of 0 to 39, with 0 being the highest priority. If a user does not specify a priority level with a print request (see lp(1)), the default priority level is used. Initially, the default priority level is 20.
The second form of the command (with -q and -u) sets the default highest priority-level (\|0-39\|) that the users in login-ID-list can request when submitting a print request. The login-ID-list argument may include any or all of the following constructs:
login-ID
A user on any system
system_name!login-ID
A user on the system system_name
system_name!all
All users on system system_name
all!login-ID
A user on all systems
all
All users on all systems
Users that have been given a limit cannot submit a print request with a higher priority level than the one assigned, nor can they change a request that has already been submitted to have a higher priority. Any print requests submitted with priority levels higher than allowed will be given the highest priority allowed.
The third form of the command (with -u) removes any explicit priority level for the specified users.
The fourth form of the command (with -q) sets the default highest priority level for all users not explicitly covered by the use of the second form of this command.
The last form of the command (with -l) lists the default priority level and the priority limits assigned to users.
The following options are supported:
-d priority-level
Set the system-wide priority default to priority-level.
-l
List the default priority level and the priority limits assigned to users.
-q priority-level
Set the default highest priority level for all users not explicitly covered.
-q priority-level -u login-ID-list
Set the default highest priority-level that the users in login-ID-list can request when submitting a print request.
-u login-ID-list
Remove any explicit priority level for the specified users.
The following exit values are returned:
0
Successful completion.
non-zero
An error occurred.
lp(1), attributes(5)