access_list.5

NAME

       access_list - Grid Engine access list file format

DESCRIPTION

       Access lists are used in Grid Engine to define access permissions of
       users to queues (see queue_conf(5)), parallel environments (see
       sge_pe(5)), execution hosts (see host_conf(5)), or the whole cluster (
       see sge_conf(5)).  A list of currently configured access lists can be
       displayed via the qconf(1) -sul option. The contents of each access
       list can shown via the -su switch. The output follows the access_list
       format description. New access lists can be created and existing ones
       can be modified via the -au and -du options to qconf(1).

       Departments are a special form of access list that additionally allow
       assignment of functional shares and override tickets.

       Note, Grid Engine allows backslashes (\) be used to escape newline
       characters. The backslash and the newline are replaced with a space
       character before any interpretation.

FORMAT

       The following list of access_list parameters specifies the access_list
       content:

   name
       The name of the access list in the format for userset_name in
       sge_types(5).

   type
       The type of the access list, currently one of ACL, or DEPT or a
       combination of both in a comma-separated list. Depending on this
       parameter, the access list can be used as an access list only, or as a
       department.

   oticket
       The number of override tickets currently assigned to the department.

   fshare
       The current functional share of the department.

   entries
       A comma-separated list of those UNIX users (see user_name in
       sge_types(5)) or those primary UNIX groups that are assigned to the
       access list or the department. Only a user's primary UNIX group is
       used; secondary groups are ignored. Only symbolic names are allowed.  A
       group is differentiated from a user name by prefixing the group name
       with a '@' sign.  Pure access lists allow listing any user or group in
       any access list.

       When using departments, each user or group may only be listed in one
       department, in order to ensure a unique assignment of jobs to
       departments.  If the defaultdepartment is defined, it is assigned to
       jobs whose users do not match with any of the users or groups listed
       under entries.

SEE ALSO

       sge_intro(1), sge_types(5), qconf(1), sge_pe(5), queue_conf(5).

COPYRIGHT

       See sge_intro(1) for a full statement of rights and permissions.



SGE 8.1.3pre                      2011-05-19                    ACCESS_LIST(5)