3 .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
4 .\" Generator: DocBook XSL Stylesheets v1.75.1 <http://docbook.sf.net/>
6 .\" Manual: File Formats and Conversions
7 .\" Source: File Formats and Conversions
10 .TH "SUAUTH" "5" "07/24/2009" "File Formats and Conversions" "File Formats and Conversions"
11 .\" -----------------------------------------------------------------
12 .\" * set default formatting
13 .\" -----------------------------------------------------------------
14 .\" disable hyphenation
16 .\" disable justification (adjust text to left margin only)
18 .\" -----------------------------------------------------------------
19 .\" * MAIN CONTENT STARTS HERE *
20 .\" -----------------------------------------------------------------
22 suauth \- detailed su control file
24 .HP \w'\fB/etc/suauth\fR\ 'u
30 is referenced whenever the su command is called\&. It can change the behaviour of the su command, based upon:
36 1) the user su is targetting
43 2) the user executing the su command (or any groups he might be a member of)
45 The file is formatted like this, with lines starting with a # being treated as comment lines and ignored;
51 to\-id:from\-id:ACTION
58 Where to\-id is either the word
59 \fIALL\fR, a list of usernames delimited by "," or the words
61 followed by a list of usernames delimited by ","
63 from\-id is formatted the same as to\-id except the extra word
66 \fIALL EXCEPT GROUP\fR
67 is perfectly valid too\&. Following
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
73 Action can be one only of the following currently supported options\&.
77 The attempt to su is stopped before a password is even asked for\&.
82 The attempt to su is automatically successful; no password is asked for\&.
87 For the su command to be successful, the user must enter his or her own password\&. They are told this\&.
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\&.
97 # sample /etc/suauth file
99 # A couple of privileged usernames may
100 # su to root with their own password\&.
102 root:chris,birddog:OWNPASS
104 # Anyone else may not su to root unless in
105 # group wheel\&. This is how BSD does things\&.
107 root:ALL EXCEPT GROUP wheel:DENY
109 # Perhaps terry and birddog are accounts
110 # owned by the same person\&.
111 # Access can be arranged between them
112 # with no password\&.
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\&.
132 An error parsing the file is reported using
134 as level ERR on facility AUTH\&.