From: Todd C. Miller Date: Sun, 8 Dec 2013 18:22:30 +0000 (-0700) Subject: Make -c option description more accurate (merged from sudo 1.8). X-Git-Tag: SUDO_1_7_10p8~19 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=8ffa11dc118714786c959c68deffbd81854ec4b6;p=sudo Make -c option description more accurate (merged from sudo 1.8). --HG-- branch : 1.7 --- diff --git a/sudo.cat b/sudo.cat index 7d7ad7ef1..ee9c075a4 100644 --- a/sudo.cat +++ b/sudo.cat @@ -64,15 +64,16 @@ DDEESSCCRRIIPPTTIIOONN only available when the administrator has enabled the _c_l_o_s_e_f_r_o_m___o_v_e_r_r_i_d_e option in sudoers(4). - --cc _c_l_a_s_s The --cc (_c_l_a_s_s) option causes ssuuddoo to run the specified - command with resources limited by the specified login class. - The _c_l_a_s_s argument can be either a class name as defined in - _/_e_t_c_/_l_o_g_i_n_._c_o_n_f, or a single `-' character. Specifying a - _c_l_a_s_s of - indicates that the command should be run - restricted by the default login capabilities for the user the - command is run as. If the _c_l_a_s_s argument specifies an - existing user class, the command must be run as root, or the - ssuuddoo command must be run from a shell that is already root. + --cc _c_l_a_s_s The --cc (_c_l_a_s_s) option causes ssuuddoo to run the command with + resource limits and scheduling priority of the specified + login _c_l_a_s_s. The _c_l_a_s_s argument can be either a class name + as defined in _/_e_t_c_/_l_o_g_i_n_._c_o_n_f, or a single `-' character. If + _c_l_a_s_s is -, the default login class of the target user will + be used. Otherwise, the command must be run as the superuser + (user ID 0), or ssuuddoo must be run from a shell that is already + running as the superuser. If the command is being run as a + login shell, additional _/_e_t_c_/_l_o_g_i_n_._c_o_n_f settings, such as the + umask and environment variables, will be applied, if present. This option is only available on systems with BSD login classes. @@ -815,4 +816,4 @@ DDIISSCCLLAAIIMMEERR file distributed with ssuuddoo or http://www.sudo.ws/sudo/license.html for complete details. -Sudo 1.7.10 July 10, 2012 Sudo 1.7.10 +Sudo 1.7.10 December 8, 2013 Sudo 1.7.10 diff --git a/sudo.man.in b/sudo.man.in index ee41822c8..43f52ba02 100644 --- a/sudo.man.in +++ b/sudo.man.in @@ -21,7 +21,7 @@ .\" Agency (DARPA) and Air Force Research Laboratory, Air Force .\" Materiel Command, USAF, under agreement number F39502-99-1-0512. .\" -.TH "SUDO" "@mansectsu@" "July 10, 2012" "Sudo @PACKAGE_VERSION@" "System Manager's Manual" +.TH "SUDO" "@mansectsu@" "December 8, 2013" "Sudo @PACKAGE_VERSION@" "System Manager's Manual" .nh .if n .ad l .SH "NAME" @@ -184,8 +184,9 @@ The \fB\-c\fR (\fIclass\fR) option causes \fBsudo\fR -to run the specified command with resources limited by the specified -login class. +to run the command with resource limits and scheduling priority of +the specified login +\fIclass\fR. The \fIclass\fR argument can be either a class name as defined in @@ -193,18 +194,18 @@ argument can be either a class name as defined in or a single `\-' character. -Specifying a -\fIclass\fR -of -\fR-\fR -indicates that the command should be run restricted by the default -login capabilities for the user the command is run as. -If the +If \fIclass\fR -argument specifies an existing user class, the command must be run -as root, or the +is +\fR-\fR, +the default login class of the target user will be used. +Otherwise, the command must be run as the superuser (user ID 0), or \fBsudo\fR -command must be run from a shell that is already root. +must be run from a shell that is already running as the superuser. +If the command is being run as a login shell, additional +\fI/etc/login.conf\fR +settings, such as the umask and environment variables, will +be applied, if present. This option is only available on systems with BSD login classes. .TP 12n \fB\-E\fR diff --git a/sudo.mdoc.in b/sudo.mdoc.in index 325040a10..11ee8e06c 100644 --- a/sudo.mdoc.in +++ b/sudo.mdoc.in @@ -19,7 +19,7 @@ .\" Agency (DARPA) and Air Force Research Laboratory, Air Force .\" Materiel Command, USAF, under agreement number F39502-99-1-0512. .\" -.Dd July 10, 2012 +.Dd December 8, 2013 .Dt SUDO @mansectsu@ .Os Sudo @PACKAGE_VERSION@ .Sh NAME @@ -220,8 +220,9 @@ The .Fl c No ( Em class Ns No ) option causes .Nm sudo -to run the specified command with resources limited by the specified -login class. +to run the command with resource limits and scheduling priority of +the specified login +.Ar class . The .Em class argument can be either a class name as defined in @@ -229,18 +230,18 @@ argument can be either a class name as defined in or a single .Ql \- character. -Specifying a -.Ar class -of -.Li - -indicates that the command should be run restricted by the default -login capabilities for the user the command is run as. -If the +If .Ar class -argument specifies an existing user class, the command must be run -as root, or the +is +.Li - , +the default login class of the target user will be used. +Otherwise, the command must be run as the superuser (user ID 0), or .Nm sudo -command must be run from a shell that is already root. +must be run from a shell that is already running as the superuser. +If the command is being run as a login shell, additional +.Pa /etc/login.conf +settings, such as the umask and environment variables, will +be applied, if present. This option is only available on systems with BSD login classes. .It Fl E The