add a note about nsswitch.conf entry required for sudo-ldap
[debian/sudo] / debian / README.Debian
1 The version of sudo that ships with Debian by default resets the
2 environment, as described by the "env_reset" flag in the sudoers file.
3
4 This implies that all environment variables are removed, except for
5 HOME, LOGNAME, PATH, SHELL, TERM, DISPLAY, XAUTHORITY, XAUTHORIZATION,
6 XAPPLRESDIR, XFILESEARCHPATH, XUSERFILESEARCHPATH, LANG, LANGUAGE, LC_*, 
7 and USER.
8
9 In case you want sudo to preserve more environment variables, you must
10 specify the env_keep variable in the sudoers file. You should edit the
11 sudoers file using the visudo tool.
12
13 Examples:
14 Preserve the default variables plus the EDITOR variable:
15
16     Defaults env_keep+="EDITOR"
17
18 Preserve the default variables plus all variables starting with LC_:
19
20     Defaults env_keep+="LC_*"
21
22         - - - - -
23
24 If you're using the sudo-ldap package, note that it is now configured to 
25 look for /etc/sudo-ldap.conf.  Depending on your system configuration, it
26 probably makes sense for this to be a symlink to /etc/ldap.conf, or perhaps
27 to /etc/libnss-ldap.conf or /etc/pam_ldap.conf.  By default, no symlink or
28 file is provided, you'll need to decide what to do and create a suitable
29 file before sudo-ldap will work.
30
31         - - - - -
32
33 As of version 1.7, sudo-ldap now requires the LDAP source to be specified
34 in /etc/nsswitch.conf with a line like:
35
36   sudoers:      ldap
37
38         - - - - -
39
40 See the file OPTIONS in this directory for more information on the sudo
41 build options used in building the Debian package.
42
43         - - - - -
44
45 If you're having trouble grasping the fundamental idea of what sudo is all
46 about, here's a succinct and humorous take on it...   
47
48         http://www.xkcd.com/c149.html
49