xref: /illumos-gate/usr/src/cmd/bnu/Grades (revision 7c478bd9)
1#ident	"%Z%%M%	%I%	%E% SMI"	/* from SVR4 bnu:Grades 1.1 */
2#
3# CDDL HEADER START
4#
5# The contents of this file are subject to the terms of the
6# Common Development and Distribution License, Version 1.0 only
7# (the "License").  You may not use this file except in compliance
8# with the License.
9#
10# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
11# or http://www.opensolaris.org/os/licensing.
12# See the License for the specific language governing permissions
13# and limitations under the License.
14#
15# When distributing Covered Code, include this CDDL HEADER in each
16# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
17# If applicable, add the following below this CDDL HEADER, with the
18# fields enclosed by brackets "[]" replaced with your own identifying
19# information: Portions Copyright [yyyy] [name of copyright owner]
20#
21# CDDL HEADER END
22#
23#
24#	Grades provides a orderly means of partitioning queued jobs into
25#	workloads that compete amongst its own type. Workloads can be partioned
26#	according to size of the jobs, on a priority basis or a combination
27#	of both. Along with each grades is a list of users or groups that can
28#	use the grade, so that only select users can use the job grade.
29#	Partitioning of workloads is to be set by the uucp or system administrator.
30#
31#	Format:
32#
33#	user_job_grade			an ascii string that defines a
34#					grade for a workload partition.
35#	system_job_grade		an ascii character, A-Z, a-z,
36#					with A having the higest priority
37#					and z with the lowest priority.
38#	job_size			a number which is the maximum limit
39#					of bytes that a job can have to
40#					be placed in the queue. There are
41#					shorthand expressions that can be used
42#					to code the job_size field. K, M, and
43#					Any can used and have the meaning kilo-
44#					byte, megabyte, and no maximum,
45#					respectively. K and M must have an
46#					integer prefix.
47#	permit_type			a keyword that denotes how to interpret
48#					the id_list is contained in this field.
49#					User, non-user, group, non-group are
50#					the only valid arguments of this field.
51#	id_list				a list of login names or group names
52#					that are permitted or denied to queue
53#					jobs to this job grade. The list is to
54#					be seperated by whitespace and terminated
55#					by a newline character. The reserved word
56#					Any is used permit anyone to queue to
57#					a job grade if User is the permit_type.
58#
59#	Since the user job grade may be bound to more than one system job grade,
60#	it is important to note that the Grades file will be searched
61#	sequentially for occurences of a user job grade. Since the names of
62#	user job grades may not be the same from system to system, we have
63#	reserved the names of three job grades so that the user may see some
64#	similiarity across different systems.
65#
66#	If the Grades file does not exist or it is unreadable, then user defined
67#	grades will not be allowed on the system.
68#
69high	F	Any	User	Any
70medium	S	Any	User	Any
71low	n	Any	User	Any
72