]> granicus.if.org Git - sudo/commitdiff
Add explicit mention of sudo's netgroup semantics since they differ
authorTodd C. Miller <Todd.Miller@courtesan.com>
Mon, 21 Sep 2015 22:04:59 +0000 (16:04 -0600)
committerTodd C. Miller <Todd.Miller@courtesan.com>
Mon, 21 Sep 2015 22:04:59 +0000 (16:04 -0600)
from most other netgroup consumers.

doc/sudoers.cat
doc/sudoers.ldap.cat
doc/sudoers.ldap.man.in
doc/sudoers.ldap.mdoc.in
doc/sudoers.man.in
doc/sudoers.mdoc.in

index a3864c131bf4363bbf496f6372947c6884053bf0..889f1b02de095bd9f2e07a037631d5766d03caff 100644 (file)
@@ -276,7 +276,8 @@ S\bSU\bUD\bDO\bOE\bER\bRS\bS F\bFI\bIL\bLE\bE F\bFO\bOR\bRM\bMA\bAT\bT
      IDs (prefixed with `%:' and `%:#' respectively) and User_Aliases. Each
      list item may be prefixed with zero or more `!' operators.  An odd number
      of `!' operators negate the value of the item; an even number just cancel
-     each other out.
+     each other out.  User netgroups are matched using the user and domain
+     members only; the host member is not used when matching.
 
      A user name, uid, group, gid, netgroup, nonunix_group or nonunix_gid may
      be enclosed in double quotes to avoid the need for escaping special
@@ -331,17 +332,19 @@ S\bSU\bUD\bDO\bOE\bER\bRS\bS F\bFI\bIL\bLE\bE F\bFO\bOR\bRM\bMA\bAT\bT
 
      A Host_List is made up of one or more host names, IP addresses, network
      numbers, netgroups (prefixed with `+') and other aliases.  Again, the
-     value of an item may be negated with the `!' operator.  If you do not
-     specify a netmask along with the network number, s\bsu\bud\bdo\bo will query each of
-     the local host's network interfaces and, if the network number
-     corresponds to one of the hosts's network interfaces, the corresponding
-     netmask will be used.  The netmask may be specified either in standard IP
-     address notation (e.g. 255.255.255.0 or ffff:ffff:ffff:ffff::), or CIDR
-     notation (number of bits, e.g. 24 or 64).  A host name may include shell-
-     style wildcards (see the _\bW_\bi_\bl_\bd_\bc_\ba_\br_\bd_\bs section below), but unless the host
-     name command on your machine returns the fully qualified host name,
-     you'll need to use the _\bf_\bq_\bd_\bn option for wildcards to be useful.  Note that
-     s\bsu\bud\bdo\bo only inspects actual network interfaces; this means that IP address
+     value of an item may be negated with the `!' operator.  Host netgroups
+     are matched using the host (both qualified and unqualified) and domain
+     members only; the user member is not used when matching.  If you specify
+     a network number without a netmask, s\bsu\bud\bdo\bo will query each of the local
+     host's network interfaces and, if the network number corresponds to one
+     of the hosts's network interfaces, will use the netmask of that
+     interface.  The netmask may be specified either in standard IP address
+     notation (e.g. 255.255.255.0 or ffff:ffff:ffff:ffff::), or CIDR notation
+     (number of bits, e.g. 24 or 64).  A host name may include shell-style
+     wildcards (see the _\bW_\bi_\bl_\bd_\bc_\ba_\br_\bd_\bs section below), but unless the host name
+     command on your machine returns the fully qualified host name, you'll
+     need to use the _\bf_\bq_\bd_\bn option for wildcards to be useful.  Note that s\bsu\bud\bdo\bo
+     only inspects actual network interfaces; this means that IP address
      127.0.0.1 (localhost) will never match.  Also, the host name
      ``localhost'' will only match if that is the actual host name, which is
      usually only the case for non-networked systems.
@@ -878,9 +881,10 @@ S\bSU\bUD\bDO\bOE\bER\bRS\bS O\bOP\bPT\bTI\bIO\bON\bNS\bS
      use_netgroups     If set, netgroups (prefixed with `+'), may be used in
                        place of a user or host.  For LDAP-based sudoers,
                        netgroup support requires an expensive substring match
-                       on the server.  If netgroups are not needed, this
-                       option can be disabled to reduce the load on the LDAP
-                       server.  This flag is _\bo_\bn by default.
+                       on the server unless the N\bNE\bET\bTG\bGR\bRO\bOU\bUP\bP_\b_B\bBA\bAS\bSE\bE directive is
+                       present in the _\b/_\be_\bt_\bc_\b/_\bl_\bd_\ba_\bp_\b._\bc_\bo_\bn_\bf file.  If netgroups are
+                       not needed, this option can be disabled to reduce the
+                       load on the LDAP server.  This flag is _\bo_\bn by default.
 
      exec_background   By default, s\bsu\bud\bdo\bo runs a command as the foreground
                        process as long as s\bsu\bud\bdo\bo itself is running in the
@@ -2459,4 +2463,4 @@ D\bDI\bIS\bSC\bCL\bLA\bAI\bIM\bME\bER\bR
      file distributed with s\bsu\bud\bdo\bo or http://www.sudo.ws/license.html for
      complete details.
 
-Sudo 1.8.15                     August 7, 2015                     Sudo 1.8.15
+Sudo 1.8.15                   September 21, 2015                   Sudo 1.8.15
index 0203c364b77c0502cb72b91408713acfe65cd26d..0afda9249184f380d2433eba273e3dac02f2568e 100644 (file)
@@ -70,13 +70,17 @@ D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
            A user name, user ID (prefixed with `#'), Unix group name or ID
            (prefixed with `%' or `%#' respectively), user netgroup (prefixed
            with `+'), or non-Unix group name or ID (prefixed with `%:' or
-           `%:#' respectively).  Non-Unix group support is only available when
-           an appropriate _\bg_\br_\bo_\bu_\bp_\b__\bp_\bl_\bu_\bg_\bi_\bn is defined in the global _\bd_\be_\bf_\ba_\bu_\bl_\bt_\bs
-           sudoRole object.
+           `%:#' respectively).  User netgroups are matched using the user and
+           domain members only; the host member is not used when matching.
+           Non-Unix group support is only available when an appropriate
+           _\bg_\br_\bo_\bu_\bp_\b__\bp_\bl_\bu_\bg_\bi_\bn is defined in the global _\bd_\be_\bf_\ba_\bu_\bl_\bt_\bs sudoRole object.
 
      s\bsu\bud\bdo\boH\bHo\bos\bst\bt
            A host name, IP address, IP network, or host netgroup (prefixed
-           with a `+').  The special value ALL will match any host.
+           with a `+').  The special value ALL will match any host.  Host
+           netgroups are matched using the host (both qualified and
+           unqualified) and domain members only; the user member is not used
+           when matching.
 
      s\bsu\bud\bdo\boC\bCo\bom\bmm\bma\ban\bnd\bd
            A fully-qualified Unix command name with optional command line
@@ -902,4 +906,4 @@ D\bDI\bIS\bSC\bCL\bLA\bAI\bIM\bME\bER\bR
      file distributed with s\bsu\bud\bdo\bo or http://www.sudo.ws/license.html for
      complete details.
 
-Sudo 1.8.15                    January 30, 2015                    Sudo 1.8.15
+Sudo 1.8.15                   September 21, 2015                   Sudo 1.8.15
index 0e13aae22066ec525d0cfa8999c950420778de16..f6f95d043e6494e19474f5d33d0667545ebc1aeb 100644 (file)
@@ -16,7 +16,7 @@
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\" ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.TH "SUDOERS.LDAP" "8" "January 30, 2015" "Sudo @PACKAGE_VERSION@" "System Manager's Manual"
+.TH "SUDOERS.LDAP" "8" "September 21, 2015" "Sudo @PACKAGE_VERSION@" "System Manager's Manual"
 .nh
 .if n .ad l
 .SH "NAME"
@@ -150,6 +150,8 @@ or non-Unix group name or ID (prefixed with
 or
 \(oq%:#\(cq
 respectively).
+User netgroups are matched using the user and domain members only;
+the host member is not used when matching.
 Non-Unix group support is only available when an appropriate
 \fIgroup_plugin\fR
 is defined in the global
@@ -163,6 +165,8 @@ A host name, IP address, IP network, or host netgroup (prefixed with a
 The special value
 \fRALL\fR
 will match any host.
+Host netgroups are matched using the host (both qualified and unqualified)
+and domain members only; the user member is not used when matching.
 .TP 6n
 \fBsudoCommand\fR
 A fully-qualified Unix command name with optional command line arguments,
index ec0cb7a6714c8d58226133162bbbda8c9a92c48e..e7aa7718ebd6c102e4606ae93fa13f4f69cc34ac 100644 (file)
@@ -14,7 +14,7 @@
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\" ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd January 30, 2015
+.Dd September 21, 2015
 .Dt SUDOERS.LDAP @mansectsu@
 .Os Sudo @PACKAGE_VERSION@
 .Sh NAME
@@ -143,6 +143,8 @@ or non-Unix group name or ID (prefixed with
 or
 .Ql %:#
 respectively).
+User netgroups are matched using the user and domain members only;
+the host member is not used when matching.
 Non-Unix group support is only available when an appropriate
 .Em group_plugin
 is defined in the global
@@ -155,6 +157,8 @@ A host name, IP address, IP network, or host netgroup (prefixed with a
 The special value
 .Li ALL
 will match any host.
+Host netgroups are matched using the host (both qualified and unqualified)
+and domain members only; the user member is not used when matching.
 .It Sy sudoCommand
 A fully-qualified Unix command name with optional command line arguments,
 potentially including globbing characters (aka wild cards).
index c0c137f1d05417f79e8309faa6a34b737c83be3c..dec03593825ac85ec5f54b38d010af062a227205 100644 (file)
@@ -21,7 +21,7 @@
 .\" Agency (DARPA) and Air Force Research Laboratory, Air Force
 .\" Materiel Command, USAF, under agreement number F39502-99-1-0512.
 .\"
-.TH "SUDOERS" "5" "August 7, 2015" "Sudo @PACKAGE_VERSION@" "File Formats Manual"
+.TH "SUDOERS" "5" "September 21, 2015" "Sudo @PACKAGE_VERSION@" "File Formats Manual"
 .nh
 .if n .ad l
 .SH "NAME"
@@ -632,6 +632,8 @@ An odd number of
 \(oq\&!\(cq
 operators negate the value of
 the item; an even number just cancel each other out.
+User netgroups are matched using the user and domain members only;
+the host member is not used when matching.
 .PP
 A
 \fRuser name\fR,
@@ -734,13 +736,14 @@ and other aliases.
 Again, the value of an item may be negated with the
 \(oq\&!\(cq
 operator.
-If you do not specify a netmask along with the network number,
+Host netgroups are matched using the host (both qualified and unqualified)
+and domain members only; the user member is not used when matching.
+If you specify a network number without a netmask,
 \fBsudo\fR
 will query each of the local host's network interfaces and,
 if the network number corresponds to one of the hosts's network
-interfaces, the corresponding netmask will be used.
-The netmask
-may be specified either in standard IP address notation
+interfaces, will use the netmask of that interface.
+The netmask may be specified either in standard IP address notation
 (e.g.\& 255.255.255.0 or ffff:ffff:ffff:ffff::),
 or CIDR notation (number of bits, e.g.\& 24 or 64).
 A host name may include shell-style wildcards (see the
@@ -1911,7 +1914,11 @@ If set, netgroups (prefixed with
 \(oq+\(cq),
 may be used in place of a user or host.
 For LDAP-based sudoers, netgroup support requires an expensive
-substring match on the server.
+substring match on the server unless the
+\fBNETGROUP_BASE\fR
+directive is present in the
+\fI@ldap_conf@\fR
+file.
 If netgroups are not needed, this option can be disabled to reduce the
 load on the LDAP server.
 This flag is
index f315290f61c96a70b64e9b44fcc791e36433e153..2dd8b2368271c4c5620ff8a806269f37c32fd727 100644 (file)
@@ -19,7 +19,7 @@
 .\" Agency (DARPA) and Air Force Research Laboratory, Air Force
 .\" Materiel Command, USAF, under agreement number F39502-99-1-0512.
 .\"
-.Dd August 7, 2015
+.Dd September 21, 2015
 .Dt SUDOERS @mansectform@
 .Os Sudo @PACKAGE_VERSION@
 .Sh NAME
@@ -605,6 +605,8 @@ An odd number of
 .Ql \&!
 operators negate the value of
 the item; an even number just cancel each other out.
+User netgroups are matched using the user and domain members only;
+the host member is not used when matching.
 .Pp
 A
 .Li user name ,
@@ -700,13 +702,14 @@ and other aliases.
 Again, the value of an item may be negated with the
 .Ql \&!
 operator.
-If you do not specify a netmask along with the network number,
+Host netgroups are matched using the host (both qualified and unqualified)
+and domain members only; the user member is not used when matching.
+If you specify a network number without a netmask,
 .Nm sudo
 will query each of the local host's network interfaces and,
 if the network number corresponds to one of the hosts's network
-interfaces, the corresponding netmask will be used.
-The netmask
-may be specified either in standard IP address notation
+interfaces, will use the netmask of that interface.
+The netmask may be specified either in standard IP address notation
 (e.g.\& 255.255.255.0 or ffff:ffff:ffff:ffff::),
 or CIDR notation (number of bits, e.g.\& 24 or 64).
 A host name may include shell-style wildcards (see the
@@ -1782,7 +1785,11 @@ If set, netgroups (prefixed with
 .Ql + ) ,
 may be used in place of a user or host.
 For LDAP-based sudoers, netgroup support requires an expensive
-substring match on the server.
+substring match on the server unless the
+.Sy NETGROUP_BASE
+directive is present in the
+.Pa @ldap_conf@
+file.
 If netgroups are not needed, this option can be disabled to reduce the
 load on the LDAP server.
 This flag is