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