tizen 2.0
[external/shadow.git] / man / pl / suauth.5
1 '\" t
2 .\"     Title: suauth
3 .\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
4 .\" Generator: DocBook XSL Stylesheets v1.75.1 <http://docbook.sf.net/>
5 .\"      Date: 07/24/2009
6 .\"    Manual: File Formats and Conversions
7 .\"    Source: File Formats and Conversions
8 .\"  Language: Polish
9 .\"
10 .TH "SUAUTH" "5" "07/24/2009" "File Formats and Conversions" "File Formats and Conversions"
11 .\" -----------------------------------------------------------------
12 .\" * set default formatting
13 .\" -----------------------------------------------------------------
14 .\" disable hyphenation
15 .nh
16 .\" disable justification (adjust text to left margin only)
17 .ad l
18 .\" -----------------------------------------------------------------
19 .\" * MAIN CONTENT STARTS HERE *
20 .\" -----------------------------------------------------------------
21 .SH "NAZWA"
22 suauth \- detailed su control file
23 .SH "SK\(/LADNIA"
24 .HP \w'\fB/etc/suauth\fR\ 'u
25 \fB/etc/suauth\fR
26 .SH "OPIS"
27 .PP
28 The file
29 /etc/suauth
30 is referenced whenever the su command is called\&. It can change the behaviour of the su command, based upon:
31 .sp
32 .if n \{\
33 .RS 4
34 .\}
35 .nf
36       1) the user su is targetting
37     
38 .fi
39 .if n \{\
40 .RE
41 .\}
42 .PP
43 2) the user executing the su command (or any groups he might be a member of)
44 .PP
45 The file is formatted like this, with lines starting with a # being treated as comment lines and ignored;
46 .sp
47 .if n \{\
48 .RS 4
49 .\}
50 .nf
51       to\-id:from\-id:ACTION
52     
53 .fi
54 .if n \{\
55 .RE
56 .\}
57 .PP
58 Where to\-id is either the word
59 \fIALL\fR, a list of usernames delimited by "," or the words
60 \fIALL EXCEPT\fR
61 followed by a list of usernames delimited by ","
62 .PP
63 from\-id is formatted the same as to\-id except the extra word
64 \fIGROUP\fR
65 is recognised\&.
66 \fIALL EXCEPT GROUP\fR
67 is perfectly valid too\&. Following
68 \fIGROUP\fR
69 appears one or more group names, delimited by ","\&. It is not sufficient to have primary group id of the relevant group, an entry in
70 \fB/etc/group\fR(5)
71 is neccessary\&.
72 .PP
73 Action can be one only of the following currently supported options\&.
74 .PP
75 \fIDENY\fR
76 .RS 4
77 The attempt to su is stopped before a password is even asked for\&.
78 .RE
79 .PP
80 \fINOPASS\fR
81 .RS 4
82 The attempt to su is automatically successful; no password is asked for\&.
83 .RE
84 .PP
85 \fIOWNPASS\fR
86 .RS 4
87 For the su command to be successful, the user must enter his or her own password\&. They are told this\&.
88 .RE
89 .PP
90 Note there are three separate fields delimited by a colon\&. No whitespace must surround this colon\&. Also note that the file is examined sequentially line by line, and the first applicable rule is used without examining the file further\&. This makes it possible for a system administrator to exercise as fine control as he or she wishes\&.
91 .SH "EXAMPLE"
92 .sp
93 .if n \{\
94 .RS 4
95 .\}
96 .nf
97       # sample /etc/suauth file
98       #
99       # A couple of privileged usernames may
100       # su to root with their own password\&.
101       #
102       root:chris,birddog:OWNPASS
103       #
104       # Anyone else may not su to root unless in
105       # group wheel\&. This is how BSD does things\&.
106       #
107       root:ALL EXCEPT GROUP wheel:DENY
108       #
109       # Perhaps terry and birddog are accounts
110       # owned by the same person\&.
111       # Access can be arranged between them
112       # with no password\&.
113       #
114       terry:birddog:NOPASS
115       birddog:terry:NOPASS
116       #
117     
118 .fi
119 .if n \{\
120 .RE
121 .\}
122 .SH "PLIKI"
123 .PP
124 /etc/suauth
125 .RS 4
126 .RE
127 .SH "B\(/LĘDY"
128 .PP
129 There could be plenty lurking\&. The file parser is particularly unforgiving about syntax errors, expecting no spurious whitespace (apart from beginning and end of lines), and a specific token delimiting different things\&.
130 .SH "DIAGNOSTYKA"
131 .PP
132 An error parsing the file is reported using
133 \fBsyslogd\fR(8)
134 as level ERR on facility AUTH\&.
135 .SH "ZOBACZ TAKŻE"
136 .PP
137 \fBsu\fR(1)\&.