From: Todd C. Miller Date: Fri, 28 Jan 2011 21:15:57 +0000 (-0500) Subject: Document that sudoers_locale also affects logging and email. X-Git-Tag: SUDO_1_8_0~52 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=180b31764e670229d039d3f0b135df2bee1e87fe;p=sudo Document that sudoers_locale also affects logging and email. --- diff --git a/doc/sudoers.cat b/doc/sudoers.cat index 406c61c22..b97cf0cc4 100644 --- a/doc/sudoers.cat +++ b/doc/sudoers.cat @@ -61,7 +61,7 @@ DDEESSCCRRIIPPTTIIOONN -1.8.0b3 January 13, 2011 1 +1.8.0b3 January 28, 2011 1 @@ -127,7 +127,7 @@ SSUUDDOOEERRSS FFIILLEE FFOORRMMAATT -1.8.0b3 January 13, 2011 2 +1.8.0b3 January 28, 2011 2 @@ -193,7 +193,7 @@ SUDOERS(4) MAINTENANCE COMMANDS SUDOERS(4) -1.8.0b3 January 13, 2011 3 +1.8.0b3 January 28, 2011 3 @@ -259,7 +259,7 @@ SUDOERS(4) MAINTENANCE COMMANDS SUDOERS(4) -1.8.0b3 January 13, 2011 4 +1.8.0b3 January 28, 2011 4 @@ -325,7 +325,7 @@ SUDOERS(4) MAINTENANCE COMMANDS SUDOERS(4) -1.8.0b3 January 13, 2011 5 +1.8.0b3 January 28, 2011 5 @@ -391,7 +391,7 @@ SUDOERS(4) MAINTENANCE COMMANDS SUDOERS(4) -1.8.0b3 January 13, 2011 6 +1.8.0b3 January 28, 2011 6 @@ -457,7 +457,7 @@ SUDOERS(4) MAINTENANCE COMMANDS SUDOERS(4) -1.8.0b3 January 13, 2011 7 +1.8.0b3 January 28, 2011 7 @@ -523,7 +523,7 @@ SUDOERS(4) MAINTENANCE COMMANDS SUDOERS(4) -1.8.0b3 January 13, 2011 8 +1.8.0b3 January 28, 2011 8 @@ -589,7 +589,7 @@ SUDOERS(4) MAINTENANCE COMMANDS SUDOERS(4) -1.8.0b3 January 13, 2011 9 +1.8.0b3 January 28, 2011 9 @@ -655,7 +655,7 @@ SUDOERS(4) MAINTENANCE COMMANDS SUDOERS(4) -1.8.0b3 January 13, 2011 10 +1.8.0b3 January 28, 2011 10 @@ -721,7 +721,7 @@ SSUUDDOOEERRSS OOPPTTIIOONNSS -1.8.0b3 January 13, 2011 11 +1.8.0b3 January 28, 2011 11 @@ -787,7 +787,7 @@ SUDOERS(4) MAINTENANCE COMMANDS SUDOERS(4) -1.8.0b3 January 13, 2011 12 +1.8.0b3 January 28, 2011 12 @@ -853,7 +853,7 @@ SUDOERS(4) MAINTENANCE COMMANDS SUDOERS(4) -1.8.0b3 January 13, 2011 13 +1.8.0b3 January 28, 2011 13 @@ -919,7 +919,7 @@ SUDOERS(4) MAINTENANCE COMMANDS SUDOERS(4) -1.8.0b3 January 13, 2011 14 +1.8.0b3 January 28, 2011 14 @@ -985,7 +985,7 @@ SUDOERS(4) MAINTENANCE COMMANDS SUDOERS(4) -1.8.0b3 January 13, 2011 15 +1.8.0b3 January 28, 2011 15 @@ -1051,7 +1051,7 @@ SUDOERS(4) MAINTENANCE COMMANDS SUDOERS(4) -1.8.0b3 January 13, 2011 16 +1.8.0b3 January 28, 2011 16 @@ -1117,7 +1117,7 @@ SUDOERS(4) MAINTENANCE COMMANDS SUDOERS(4) -1.8.0b3 January 13, 2011 17 +1.8.0b3 January 28, 2011 17 @@ -1183,7 +1183,7 @@ SUDOERS(4) MAINTENANCE COMMANDS SUDOERS(4) -1.8.0b3 January 13, 2011 18 +1.8.0b3 January 28, 2011 18 @@ -1249,7 +1249,7 @@ SUDOERS(4) MAINTENANCE COMMANDS SUDOERS(4) -1.8.0b3 January 13, 2011 19 +1.8.0b3 January 28, 2011 19 @@ -1301,9 +1301,10 @@ SUDOERS(4) MAINTENANCE COMMANDS SUDOERS(4) syslog_goodpri Syslog priority to use when user authenticates successfully. Defaults to notice. - sudoers_locale Locale to use when parsing the sudoers file. Note that - changing the locale may affect how sudoers is - interpreted. Defaults to "C". + sudoers_locale Locale to use when parsing the sudoers file, logging + commands, and sending email. Note that changing the + locale may affect how sudoers is interpreted. Defaults + to "C". timestampdir The directory in which ssuuddoo stores its timestamp files. The default is _/_v_a_r_/_a_d_m_/_s_u_d_o. @@ -1311,11 +1312,10 @@ SUDOERS(4) MAINTENANCE COMMANDS SUDOERS(4) timestampowner The owner of the timestamp directory and the timestamps stored therein. The default is root. - type The default SELinux type to use when constructing a new -1.8.0b3 January 13, 2011 20 +1.8.0b3 January 28, 2011 20 @@ -1324,6 +1324,7 @@ SUDOERS(4) MAINTENANCE COMMANDS SUDOERS(4) SUDOERS(4) MAINTENANCE COMMANDS SUDOERS(4) + type The default SELinux type to use when constructing a new security context to run the command. The default type may be overridden on a per-command basis in _s_u_d_o_e_r_s or via command line options. This option is only @@ -1377,11 +1378,10 @@ SUDOERS(4) MAINTENANCE COMMANDS SUDOERS(4) always Always lecture the user. - never Never lecture the user. -1.8.0b3 January 13, 2011 21 +1.8.0b3 January 28, 2011 21 @@ -1390,6 +1390,8 @@ SUDOERS(4) MAINTENANCE COMMANDS SUDOERS(4) SUDOERS(4) MAINTENANCE COMMANDS SUDOERS(4) + never Never lecture the user. + once Only lecture the user the first time they run ssuuddoo. If no value is specified, a value of _o_n_c_e is implied. @@ -1442,12 +1444,10 @@ SUDOERS(4) MAINTENANCE COMMANDS SUDOERS(4) ssuuddoo interpreting the @ sign. Defaults to root. secure_path Path used for every command run from ssuuddoo. If you don't - trust the people running ssuuddoo to have a sane PATH - environment variable you may want to use this. Another use -1.8.0b3 January 13, 2011 22 +1.8.0b3 January 28, 2011 22 @@ -1456,6 +1456,8 @@ SUDOERS(4) MAINTENANCE COMMANDS SUDOERS(4) SUDOERS(4) MAINTENANCE COMMANDS SUDOERS(4) + trust the people running ssuuddoo to have a sane PATH + environment variable you may want to use this. Another use is if you want to have the "root path" be separate from the "user path." Users in the group specified by the _e_x_e_m_p_t___g_r_o_u_p option are not affected by _s_e_c_u_r_e___p_a_t_h. This @@ -1508,12 +1510,10 @@ SUDOERS(4) MAINTENANCE COMMANDS SUDOERS(4) The argument may be a double-quoted, space-separated list or a single value without double-quotes. The list can be replaced, added to, deleted from, or disabled by - using the =, +=, -=, and ! operators respectively. The - default list of environment variables to remove is -1.8.0b3 January 13, 2011 23 +1.8.0b3 January 28, 2011 23 @@ -1522,6 +1522,8 @@ SUDOERS(4) MAINTENANCE COMMANDS SUDOERS(4) SUDOERS(4) MAINTENANCE COMMANDS SUDOERS(4) + using the =, +=, -=, and ! operators respectively. The + default list of environment variables to remove is displayed when ssuuddoo is run by root with the _-_V option. Note that many operating systems will remove potentially dangerous variables from the environment of @@ -1575,11 +1577,9 @@ EEXXAAMMPPLLEESS User_Alias PARTTIMERS = bostley, jwfox, crawl User_Alias WEBMASTERS = will, wendy, wim - # Runas alias specification - -1.8.0b3 January 13, 2011 24 +1.8.0b3 January 28, 2011 24 @@ -1588,6 +1588,8 @@ EEXXAAMMPPLLEESS SUDOERS(4) MAINTENANCE COMMANDS SUDOERS(4) + + # Runas alias specification Runas_Alias OP = root, operator Runas_Alias DB = oracle, sybase Runas_Alias ADMINGRP = adm, oper @@ -1641,11 +1643,9 @@ SUDOERS(4) MAINTENANCE COMMANDS SUDOERS(4) root ALL = (ALL) ALL %wheel ALL = (ALL) ALL - We let rroooott and any user in group wwhheeeell run any command on any host as - -1.8.0b3 January 13, 2011 25 +1.8.0b3 January 28, 2011 25 @@ -1654,6 +1654,7 @@ SUDOERS(4) MAINTENANCE COMMANDS SUDOERS(4) SUDOERS(4) MAINTENANCE COMMANDS SUDOERS(4) + We let rroooott and any user in group wwhheeeell run any command on any host as any user. FULLTIMERS ALL = NOPASSWD: ALL @@ -1710,8 +1711,7 @@ SUDOERS(4) MAINTENANCE COMMANDS SUDOERS(4) - -1.8.0b3 January 13, 2011 26 +1.8.0b3 January 28, 2011 26 @@ -1777,7 +1777,7 @@ SUDOERS(4) MAINTENANCE COMMANDS SUDOERS(4) -1.8.0b3 January 13, 2011 27 +1.8.0b3 January 28, 2011 27 @@ -1843,7 +1843,7 @@ PPRREEVVEENNTTIINNGG SSHHEELLLL EESSCCAAPPEESS -1.8.0b3 January 13, 2011 28 +1.8.0b3 January 28, 2011 28 @@ -1909,7 +1909,7 @@ SSEECCUURRIITTYY NNOOTTEESS -1.8.0b3 January 13, 2011 29 +1.8.0b3 January 28, 2011 29 @@ -1975,7 +1975,7 @@ SSUUPPPPOORRTT -1.8.0b3 January 13, 2011 30 +1.8.0b3 January 28, 2011 30 @@ -2041,6 +2041,6 @@ DDIISSCCLLAAIIMMEERR -1.8.0b3 January 13, 2011 31 +1.8.0b3 January 28, 2011 31 diff --git a/doc/sudoers.man.in b/doc/sudoers.man.in index f2464694a..bc53531b1 100644 --- a/doc/sudoers.man.in +++ b/doc/sudoers.man.in @@ -148,7 +148,7 @@ .\" ======================================================================== .\" .IX Title "SUDOERS @mansectform@" -.TH SUDOERS @mansectform@ "January 13, 2011" "1.8.0b3" "MAINTENANCE COMMANDS" +.TH SUDOERS @mansectform@ "January 28, 2011" "1.8.0b3" "MAINTENANCE COMMANDS" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l @@ -1337,9 +1337,9 @@ Syslog priority to use when user authenticates successfully. Defaults to \f(CW\*(C`@goodpri@\*(C'\fR. .IP "sudoers_locale" 16 .IX Item "sudoers_locale" -Locale to use when parsing the sudoers file. Note that changing -the locale may affect how sudoers is interpreted. -Defaults to \f(CW"C"\fR. +Locale to use when parsing the sudoers file, logging commands, and +sending email. Note that changing the locale may affect how sudoers +is interpreted. Defaults to \f(CW"C"\fR. .IP "timestampdir" 16 .IX Item "timestampdir" The directory in which \fBsudo\fR stores its timestamp files. diff --git a/doc/sudoers.pod b/doc/sudoers.pod index f29bd719a..bed3e844b 100644 --- a/doc/sudoers.pod +++ b/doc/sudoers.pod @@ -1264,9 +1264,9 @@ Defaults to C<@goodpri@>. =item sudoers_locale -Locale to use when parsing the sudoers file. Note that changing -the locale may affect how sudoers is interpreted. -Defaults to C<"C">. +Locale to use when parsing the sudoers file, logging commands, and +sending email. Note that changing the locale may affect how sudoers +is interpreted. Defaults to C<"C">. =item timestampdir