NAME
access_list - Sun Grid Engine access list file format
DESCRIPTION
Access lists are used in Sun Grid Engine to define access permissions
of users to queues (see queue_conf(5)) or parallel environments (see
sge_pe(5)). A list of currently configured access lists can be
displayed via the qconf(1) -sul option. The contents of each enlisted
access list can shown via the -su switch. The output follows the
access_list format description. New access lists can be created and
existing 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, Sun Grid Engine allows backslashes (\) be used to escape newline
(\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 as defined for userset_name in
sge_types(1).
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 access list only or as a
department.
oticket
The amount of override tickets currently assigned to the department.
fshare
The current functional share of the department.
entries
The entries parameter contains the comma separated list of those UNIX
users (see user_name in sge_types(1)) 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
enlisting any user or group in any access list.
When using departments, each user or group enlisted may only be
enlisted in one department, in order to ensure a unique assignment of
jobs to departments. To jobs whose users do not match with any of the
users or groups enlisted under entries the defaultdepartment is
assigned, if existing.
SEE ALSO
sge_intro(1), sge_types(1), qconf(1), sge_pe(5), queue_conf(5).
COPYRIGHT
See sge_intro(1) for a full statement of rights and permissions.