File: access_list.5

package info (click to toggle)
gridengine 6.2-4
  • links: PTS, VCS
  • area: main
  • in suites: lenny
  • size: 51,532 kB
  • ctags: 51,172
  • sloc: ansic: 418,155; java: 37,080; sh: 22,593; jsp: 7,699; makefile: 5,292; csh: 4,244; xml: 2,901; cpp: 2,086; perl: 1,895; tcl: 1,188; lisp: 669; ruby: 642; yacc: 393; lex: 266
file content (106 lines) | stat: -rw-r--r-- 3,216 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
'\" t
.\"___INFO__MARK_BEGIN__
.\"
.\" Copyright: 2004 by Sun Microsystems, Inc.
.\"
.\"___INFO__MARK_END__
.\" $RCSfile$     Last Update: $Date$     Revision: $Revision$
.\"
.\"
.\" Some handy macro definitions [from Tom Christensen's man(1) manual page].
.\"
.de SB		\" small and bold
.if !"\\$1"" \\s-2\\fB\&\\$1\\s0\\fR\\$2 \\$3 \\$4 \\$5
..
.\"
.de T		\" switch to typewriter font
.ft CW		\" probably want CW if you don't have TA font
..
.\"
.de TY		\" put $1 in typewriter font
.if t .T
.if n ``\c
\\$1\c
.if t .ft P
.if n \&''\c
\\$2
..
.\"
.de M		\" man page reference
\\fI\\$1\\fR\\|(\\$2)\\$3
..
.TH ACCESS_LIST 5 "$Date$" "xxRELxx" "xxQS_NAMExx File Formats"
.\"
.SH NAME
access_list \- xxQS_NAMExx access list file format
.\"
.SH DESCRIPTION
Access lists are used in xxQS_NAMExx to define access permissions of users
to queues (see
.M queue_conf 5 )
or parallel environments (see
.M xxqs_name_sxx_pe 5 ). 
A list of currently configured 
access lists can be displayed via the
.M qconf 1
\fB\-sul\fP option. The contents of each enlisted access list can
shown via the \fB\-su\fP switch. The output follows the
.I access_list
format description. New access lists can be created and existing can be
modified via the \fB\-au\fP and \fB\-du\fP options to
.M qconf 1 .
.PP
Departments are a special form of access list that additionally allow
assignment of functional shares and override tickets. 
.PP
Note, xxQS_NAMExx allows backslashes (\\) be used to escape newline
(\\newline) characters. The backslash and the newline are replaced with a
space (" ") character before any interpretation.
.\"
.\"
.SH FORMAT
The following list of \fIaccess_list\fP parameters specifies the
.I access_list
content:
.SS "\fBname\fP"
The name of the access list as defined for \fIuserset_name\fP in
.M sge_types 1 .
.SS "\fBtype\fP"
The type of the access list, currently  one  of 
.I ACL,
or 
.I 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. 
.SS "\fBoticket\fP"
The amount of override tickets currently assigned to the department.
.SS "\fBfshare\fP"
The current functional share of the department.
.SS "\fBentries\fP"
The entries parameter contains the comma separated list of 
those UNIX users (see \fIuser_name\fP in
.M 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.  
.PP
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 
.I defaultdepartment 
is assigned, if existing. 
.\"
.\"
.SH "SEE ALSO"
.M xxqs_name_sxx_intro 1 ,
.M sge_types 1 ,
.M qconf 1 ,
.M xxqs_name_sxx_pe 5 ,
.M queue_conf 5 .
.\"
.SH "COPYRIGHT"
See
.M xxqs_name_sxx_intro 1
for a full statement of rights and permissions.