usr/src/cmd/bnu/Grades

   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 #
  69 high    F       Any     User    Any
  70 medium  S       Any     User    Any
  71 low     n       Any     User    Any