]> granicus.if.org Git - sudo/commitdiff
Document group_plugin syntax.
authorTodd C. Miller <Todd.Miller@courtesan.com>
Fri, 2 Jul 2010 19:37:47 +0000 (15:37 -0400)
committerTodd C. Miller <Todd.Miller@courtesan.com>
Fri, 2 Jul 2010 19:37:47 +0000 (15:37 -0400)
doc/sudoers.cat
doc/sudoers.man.in
doc/sudoers.pod

index 24112695376d6edd4a8fe422c7a1a64e8e7b825f..b10ed3eb680918f296ff411046659091cc22c413 100644 (file)
@@ -61,7 +61,7 @@ D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
 
 
 
-1.8.0b1                   July  1, 2010                         1
+1.8.0b1                   July  2, 2010                         1
 
 
 
@@ -127,7 +127,7 @@ S\bSU\bUD\bDO\bOE\bER\bRS\bS F\bFI\bIL\bLE\bE F\bFO\bOR\bRM\bMA\bAT\bT
 
 
 
-1.8.0b1                   July  1, 2010                         2
+1.8.0b1                   July  2, 2010                         2
 
 
 
@@ -193,7 +193,7 @@ SUDOERS(4)             MAINTENANCE COMMANDS            SUDOERS(4)
 
 
 
-1.8.0b1                   July  1, 2010                         3
+1.8.0b1                   July  2, 2010                         3
 
 
 
@@ -226,7 +226,7 @@ SUDOERS(4)             MAINTENANCE COMMANDS            SUDOERS(4)
        space.
 
        The nonunix_group syntax depends on the underlying implementation.  For
-       instance, the QAS AD backend supports the following formats:
+       instance, the QAS AD plugin supports the following formats:
 
        +\bo   Group in the same domain: "Group Name"
 
@@ -259,7 +259,7 @@ SUDOERS(4)             MAINTENANCE COMMANDS            SUDOERS(4)
 
 
 
-1.8.0b1                   July  1, 2010                         4
+1.8.0b1                   July  2, 2010                         4
 
 
 
@@ -325,7 +325,7 @@ SUDOERS(4)             MAINTENANCE COMMANDS            SUDOERS(4)
 
 
 
-1.8.0b1                   July  1, 2010                         5
+1.8.0b1                   July  2, 2010                         5
 
 
 
@@ -391,7 +391,7 @@ SUDOERS(4)             MAINTENANCE COMMANDS            SUDOERS(4)
 
 
 
-1.8.0b1                   July  1, 2010                         6
+1.8.0b1                   July  2, 2010                         6
 
 
 
@@ -457,7 +457,7 @@ SUDOERS(4)             MAINTENANCE COMMANDS            SUDOERS(4)
 
 
 
-1.8.0b1                   July  1, 2010                         7
+1.8.0b1                   July  2, 2010                         7
 
 
 
@@ -523,7 +523,7 @@ SUDOERS(4)             MAINTENANCE COMMANDS            SUDOERS(4)
 
 
 
-1.8.0b1                   July  1, 2010                         8
+1.8.0b1                   July  2, 2010                         8
 
 
 
@@ -589,7 +589,7 @@ SUDOERS(4)             MAINTENANCE COMMANDS            SUDOERS(4)
 
 
 
-1.8.0b1                   July  1, 2010                         9
+1.8.0b1                   July  2, 2010                         9
 
 
 
@@ -655,7 +655,7 @@ SUDOERS(4)             MAINTENANCE COMMANDS            SUDOERS(4)
 
 
 
-1.8.0b1                   July  1, 2010                        10
+1.8.0b1                   July  2, 2010                        10
 
 
 
@@ -721,7 +721,7 @@ S\bSU\bUD\bDO\bOE\bER\bRS\bS O\bOP\bPT\bTI\bIO\bON\bNS\bS
 
 
 
-1.8.0b1                   July  1, 2010                        11
+1.8.0b1                   July  2, 2010                        11
 
 
 
@@ -787,7 +787,7 @@ SUDOERS(4)             MAINTENANCE COMMANDS            SUDOERS(4)
 
 
 
-1.8.0b1                   July  1, 2010                        12
+1.8.0b1                   July  2, 2010                        12
 
 
 
@@ -853,7 +853,7 @@ SUDOERS(4)             MAINTENANCE COMMANDS            SUDOERS(4)
 
 
 
-1.8.0b1                   July  1, 2010                        13
+1.8.0b1                   July  2, 2010                        13
 
 
 
@@ -919,7 +919,7 @@ SUDOERS(4)             MAINTENANCE COMMANDS            SUDOERS(4)
 
 
 
-1.8.0b1                   July  1, 2010                        14
+1.8.0b1                   July  2, 2010                        14
 
 
 
@@ -985,7 +985,7 @@ SUDOERS(4)             MAINTENANCE COMMANDS            SUDOERS(4)
 
 
 
-1.8.0b1                   July  1, 2010                        15
+1.8.0b1                   July  2, 2010                        15
 
 
 
@@ -1051,7 +1051,7 @@ SUDOERS(4)             MAINTENANCE COMMANDS            SUDOERS(4)
 
 
 
-1.8.0b1                   July  1, 2010                        16
+1.8.0b1                   July  2, 2010                        16
 
 
 
@@ -1117,7 +1117,7 @@ SUDOERS(4)             MAINTENANCE COMMANDS            SUDOERS(4)
 
 
 
-1.8.0b1                   July  1, 2010                        17
+1.8.0b1                   July  2, 2010                        17
 
 
 
@@ -1183,7 +1183,7 @@ SUDOERS(4)             MAINTENANCE COMMANDS            SUDOERS(4)
 
 
 
-1.8.0b1                   July  1, 2010                        18
+1.8.0b1                   July  2, 2010                        18
 
 
 
@@ -1249,7 +1249,7 @@ SUDOERS(4)             MAINTENANCE COMMANDS            SUDOERS(4)
 
 
 
-1.8.0b1                   July  1, 2010                        19
+1.8.0b1                   July  2, 2010                        19
 
 
 
@@ -1275,6 +1275,24 @@ SUDOERS(4)             MAINTENANCE COMMANDS            SUDOERS(4)
                    Users in this group are exempt from password and PATH
                    requirements.  This is not set by default.
 
+       group_plugin
+                   A string containing a _\bs_\bu_\bd_\bo_\be_\br_\bs group plugin with optional
+                   arguments.  This can be used to implement support for the
+                   nonunix_group syntax described earlier.  The string should
+                   consist of the plugin path, either fully-qualified or
+                   relative to the _\b/_\bu_\bs_\br_\b/_\bl_\bo_\bc_\ba_\bl_\b/_\bl_\bi_\bb_\be_\bx_\be_\bc directory, followed by
+                   any configuration arguments the plugin requires.  These
+                   arguments (if any) will be passed to the plugin's
+                   initialization function.  If arguments are present, the
+                   string must be enclosed in double quotes (").
+
+                   For example, given _\b/_\be_\bt_\bc_\b/_\bs_\bu_\bd_\bo_\b-_\bg_\br_\bo_\bu_\bp, a group file in Unix
+                   group format, the sample group plugin can be used:
+
+                       Defaults sudo_plugin="sample_group.so /etc/sudo-group"
+
+                   For more information see _\bs_\bu_\bd_\bo_\b__\bp_\bl_\bu_\bg_\bi_\bn(4).
+
        lecture     This option controls when a short lecture will be printed
                    along with the password prompt.  It has the following
                    possible values:
@@ -1294,6 +1312,18 @@ SUDOERS(4)             MAINTENANCE COMMANDS            SUDOERS(4)
                    will be used in place of the standard lecture if the named
                    file exists.  By default, s\bsu\bud\bdo\bo uses a built-in lecture.
 
+
+
+
+1.8.0b1                   July  2, 2010                        20
+
+
+
+
+
+SUDOERS(4)             MAINTENANCE COMMANDS            SUDOERS(4)
+
+
        listpw      This option controls when a password will be required when
                    a user runs s\bsu\bud\bdo\bo with the -\b-l\bl option.  It has the following
                    possible values:
@@ -1312,18 +1342,6 @@ SUDOERS(4)             MAINTENANCE COMMANDS            SUDOERS(4)
                    never   The user need never enter a password to use the -\b-l\bl
                            option.
 
-
-
-
-1.8.0b1                   July  1, 2010                        20
-
-
-
-
-
-SUDOERS(4)             MAINTENANCE COMMANDS            SUDOERS(4)
-
-
                    If no value is specified, a value of _\ba_\bn_\by is implied.
                    Negating the option results in a value of _\bn_\be_\bv_\be_\br being used.
                    The default value is _\ba_\bn_\by.
@@ -1361,6 +1379,17 @@ SUDOERS(4)             MAINTENANCE COMMANDS            SUDOERS(4)
                    a user runs s\bsu\bud\bdo\bo with the -\b-v\bv option.  It has the following
                    possible values:
 
+
+
+1.8.0b1                   July  2, 2010                        21
+
+
+
+
+
+SUDOERS(4)             MAINTENANCE COMMANDS            SUDOERS(4)
+
+
                    all     All the user's _\bs_\bu_\bd_\bo_\be_\br_\bs entries for the current host
                            must have the NOPASSWD flag set to avoid entering a
                            password.
@@ -1379,17 +1408,6 @@ SUDOERS(4)             MAINTENANCE COMMANDS            SUDOERS(4)
                    Negating the option results in a value of _\bn_\be_\bv_\be_\br being used.
                    The default value is _\ba_\bl_\bl.
 
-
-
-1.8.0b1                   July  1, 2010                        21
-
-
-
-
-
-SUDOERS(4)             MAINTENANCE COMMANDS            SUDOERS(4)
-
-
        L\bLi\bis\bst\bts\bs t\bth\bha\bat\bt c\bca\ban\bn b\bbe\be u\bus\bse\bed\bd i\bin\bn a\ba b\bbo\boo\bol\ble\bea\ban\bn c\bco\bon\bnt\bte\bex\bxt\bt:
 
        env_check       Environment variables to be removed from the user's
@@ -1426,6 +1444,18 @@ SUDOERS(4)             MAINTENANCE COMMANDS            SUDOERS(4)
                        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 =, +=,
+
+
+
+1.8.0b1                   July  2, 2010                        22
+
+
+
+
+
+SUDOERS(4)             MAINTENANCE COMMANDS            SUDOERS(4)
+
+
                        -=, and ! operators respectively.  The default list of
                        variables to keep is displayed when s\bsu\bud\bdo\bo is run by root
                        with the _\b-_\bV option.
@@ -1444,18 +1474,6 @@ F\bFI\bIL\bLE\bES\bS
 
        _\b/_\be_\bt_\bc_\b/_\bn_\be_\bt_\bg_\br_\bo_\bu_\bp           List of network groups
 
-
-
-
-1.8.0b1                   July  1, 2010                        22
-
-
-
-
-
-SUDOERS(4)             MAINTENANCE COMMANDS            SUDOERS(4)
-
-
        _\b/_\bv_\ba_\br_\b/_\bl_\bo_\bg_\b/_\bs_\bu_\bd_\bo_\b-_\bi_\bo        I/O log files
 
        _\b/_\bv_\ba_\br_\b/_\br_\bu_\bn_\b/_\bs_\bu_\bd_\bo           Directory containing time stamps for the
@@ -1492,6 +1510,18 @@ E\bEX\bXA\bAM\bMP\bPL\bLE\bES\bS
         Cmnd_Alias     DUMPS = /usr/bin/mt, /usr/sbin/dump, /usr/sbin/rdump,\
                                /usr/sbin/restore, /usr/sbin/rrestore
         Cmnd_Alias     KILL = /usr/bin/kill
+
+
+
+1.8.0b1                   July  2, 2010                        23
+
+
+
+
+
+SUDOERS(4)             MAINTENANCE COMMANDS            SUDOERS(4)
+
+
         Cmnd_Alias     PRINTING = /usr/sbin/lpc, /usr/bin/lprm
         Cmnd_Alias     SHUTDOWN = /usr/sbin/shutdown
         Cmnd_Alias     HALT = /usr/sbin/halt
@@ -1510,18 +1540,6 @@ E\bEX\bXA\bAM\bMP\bPL\bLE\bES\bS
        Additionally, on the machines in the _\bS_\bE_\bR_\bV_\bE_\bR_\bS Host_Alias, we keep an
        additional local log file and make sure we log the year in each log
        line since the log entries will be kept around for several years.
-
-
-
-1.8.0b1                   July  1, 2010                        23
-
-
-
-
-
-SUDOERS(4)             MAINTENANCE COMMANDS            SUDOERS(4)
-
-
        Lastly, we disable shell escapes for the commands in the PAGERS
        Cmnd_Alias (_\b/_\bu_\bs_\br_\b/_\bb_\bi_\bn_\b/_\bm_\bo_\br_\be, _\b/_\bu_\bs_\br_\b/_\bb_\bi_\bn_\b/_\bp_\bg and _\b/_\bu_\bs_\br_\b/_\bb_\bi_\bn_\b/_\bl_\be_\bs_\bs).
 
@@ -1558,6 +1576,18 @@ SUDOERS(4)             MAINTENANCE COMMANDS            SUDOERS(4)
        The user j\bja\bac\bck\bk may run any command on the machines in the _\bC_\bS_\bN_\bE_\bT_\bS alias
        (the networks 128.138.243.0, 128.138.204.0, and 128.138.242.0).  Of
        those networks, only 128.138.204.0 has an explicit netmask (in CIDR
+
+
+
+1.8.0b1                   July  2, 2010                        24
+
+
+
+
+
+SUDOERS(4)             MAINTENANCE COMMANDS            SUDOERS(4)
+
+
        notation) indicating it is a class C network.  For the other networks
        in _\bC_\bS_\bN_\bE_\bT_\bS, the local machine's netmask will be used during matching.
 
@@ -1576,18 +1606,6 @@ SUDOERS(4)             MAINTENANCE COMMANDS            SUDOERS(4)
 
         joe            ALL = /usr/bin/su operator
 
-
-
-
-1.8.0b1                   July  1, 2010                        24
-
-
-
-
-
-SUDOERS(4)             MAINTENANCE COMMANDS            SUDOERS(4)
-
-
        The user j\bjo\boe\be may only _\bs_\bu(1) to operator.
 
         pete           HPPA = /usr/bin/passwd [A-Za-z]*, !/usr/bin/passwd root
@@ -1624,6 +1642,18 @@ SUDOERS(4)             MAINTENANCE COMMANDS            SUDOERS(4)
 
         john           ALPHA = /usr/bin/su [!-]*, !/usr/bin/su *root*
 
+
+
+
+1.8.0b1                   July  2, 2010                        25
+
+
+
+
+
+SUDOERS(4)             MAINTENANCE COMMANDS            SUDOERS(4)
+
+
        On the _\bA_\bL_\bP_\bH_\bA machines, user j\bjo\boh\bhn\bn may su to anyone except root but he is
        not allowed to specify any options to the _\bs_\bu(1) command.
 
@@ -1643,17 +1673,6 @@ SUDOERS(4)             MAINTENANCE COMMANDS            SUDOERS(4)
        The user s\bst\bte\bev\bve\be may run any command in the directory
        /usr/local/op_commands/ but only as user operator.
 
-
-
-1.8.0b1                   July  1, 2010                        25
-
-
-
-
-
-SUDOERS(4)             MAINTENANCE COMMANDS            SUDOERS(4)
-
-
         matt           valkyrie = KILL
 
        On his personal workstation, valkyrie, m\bma\bat\btt\bt needs to be able to kill
@@ -1689,6 +1708,18 @@ S\bSE\bEC\bCU\bUR\bRI\bIT\bTY\bY N\bNO\bOT\bTE\bES\bS
 
        Furthermore, if the _\bf_\ba_\bs_\bt_\b__\bg_\bl_\bo_\bb option is in use, it is not possible to
        reliably negate commands where the path name includes globbing (aka
+
+
+
+1.8.0b1                   July  2, 2010                        26
+
+
+
+
+
+SUDOERS(4)             MAINTENANCE COMMANDS            SUDOERS(4)
+
+
        wildcard) characters.  This is because the C library's _\bf_\bn_\bm_\ba_\bt_\bc_\bh(3)
        function cannot resolve relative paths.  While this is typically only
        an inconvenience for rules that grant privileges, it can result in a
@@ -1708,18 +1739,6 @@ P\bPR\bRE\bEV\bVE\bEN\bNT\bTI\bIN\bNG\bG S\bSH\bHE\bEL\bLL\bL E\bES\bSC\bCA\bAP\bPE\bES\bS
        since it is not uncommon for a program to allow shell escapes, which
        lets a user bypass s\bsu\bud\bdo\bo's access control and logging.  Common programs
        that permit shell escapes include shells (obviously), editors,
-
-
-
-1.8.0b1                   July  1, 2010                        26
-
-
-
-
-
-SUDOERS(4)             MAINTENANCE COMMANDS            SUDOERS(4)
-
-
        paginators, mail and terminal programs.
 
        There are two basic approaches to this problem:
@@ -1755,6 +1774,18 @@ SUDOERS(4)             MAINTENANCE COMMANDS            SUDOERS(4)
                  error.  Unfortunately, there is no foolproof way to know
                  whether or not _\bn_\bo_\be_\bx_\be_\bc will work at compile-time.  _\bn_\bo_\be_\bx_\be_\bc
                  should work on SunOS, Solaris, *BSD, Linux, IRIX, Tru64 UNIX,
+
+
+
+1.8.0b1                   July  2, 2010                        27
+
+
+
+
+
+SUDOERS(4)             MAINTENANCE COMMANDS            SUDOERS(4)
+
+
                  MacOS X, and HP-UX 11.x.  It is known n\bno\bot\bt to work on AIX and
                  UnixWare.  _\bn_\bo_\be_\bx_\be_\bc is expected to work on most operating
                  systems that support the LD_PRELOAD environment variable.
@@ -1774,18 +1805,6 @@ SUDOERS(4)             MAINTENANCE COMMANDS            SUDOERS(4)
                  unsure whether or not your system is capable of supporting
                  _\bn_\bo_\be_\bx_\be_\bc you can always just try it out and see if it works.
 
-
-
-
-1.8.0b1                   July  1, 2010                        27
-
-
-
-
-
-SUDOERS(4)             MAINTENANCE COMMANDS            SUDOERS(4)
-
-
        Note that restricting shell escapes is not a panacea.  Programs running
        as root are still capable of many potentially hazardous operations
        (such as changing or overwriting files) that could lead to unintended
@@ -1821,6 +1840,18 @@ S\bSE\bEC\bCU\bUR\bRI\bIT\bTY\bY N\bNO\bOT\bTE\bES\bS
        command with s\bsu\bud\bdo\bo after authenticating, logout, login again, and run
        s\bsu\bud\bdo\bo without authenticating so long as the time stamp file's
        modification time is within 5 minutes (or whatever the timeout is set
+
+
+
+1.8.0b1                   July  2, 2010                        28
+
+
+
+
+
+SUDOERS(4)             MAINTENANCE COMMANDS            SUDOERS(4)
+
+
        to in _\bs_\bu_\bd_\bo_\be_\br_\bs).  When the _\bt_\bt_\by_\b__\bt_\bi_\bc_\bk_\be_\bt_\bs option is enabled, the time stamp
        has per-tty granularity but still may outlive the user's session.  On
        Linux systems where the devpts filesystem is used, Solaris systems with
@@ -1837,20 +1868,8 @@ S\bSE\bEC\bCU\bUR\bRI\bIT\bTY\bY N\bNO\bOT\bTE\bES\bS
        specification.
 
 S\bSE\bEE\bE A\bAL\bLS\bSO\bO
-       _\br_\bs_\bh(1), _\bs_\bu(1), _\bf_\bn_\bm_\ba_\bt_\bc_\bh(3), _\bg_\bl_\bo_\bb(3), _\bs_\bu_\bd_\bo_\be_\br_\bs_\b._\bl_\bd_\ba_\bp(4), _\bs_\bu_\bd_\bo(1m),
-       _\bv_\bi_\bs_\bu_\bd_\bo(1m)
-
-
-
-
-1.8.0b1                   July  1, 2010                        28
-
-
-
-
-
-SUDOERS(4)             MAINTENANCE COMMANDS            SUDOERS(4)
-
+       _\br_\bs_\bh(1), _\bs_\bu(1), _\bf_\bn_\bm_\ba_\bt_\bc_\bh(3), _\bg_\bl_\bo_\bb(3), _\bs_\bu_\bd_\bo_\be_\br_\bs_\b._\bl_\bd_\ba_\bp(4), _\bs_\bu_\bd_\bo_\b__\bp_\bl_\bu_\bg_\bi_\bn(4),
+       _\bs_\bu_\bd_\bo(1m), _\bv_\bi_\bs_\bu_\bd_\bo(1m)
 
 C\bCA\bAV\bVE\bEA\bAT\bTS\bS
        The _\bs_\bu_\bd_\bo_\be_\br_\bs file should a\bal\blw\bwa\bay\bys\bs be edited by the v\bvi\bis\bsu\bud\bdo\bo command which
@@ -1890,25 +1909,6 @@ D\bDI\bIS\bSC\bCL\bLA\bAI\bIM\bME\bER\bR
 
 
 
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-1.8.0b1                   July  1, 2010                        29
+1.8.0b1                   July  2, 2010                        29
 
 
index e90fcc60cc1febae11e0dd7f34f9f39e36e979d9..570d0fa27a932980218c38ea1b2b0b5142a8b764 100644 (file)
 .\" ========================================================================
 .\"
 .IX Title "SUDOERS @mansectform@"
-.TH SUDOERS @mansectform@ "July  1, 2010" "1.8.0b1" "MAINTENANCE COMMANDS"
+.TH SUDOERS @mansectform@ "July  2, 2010" "1.8.0b1" "MAINTENANCE COMMANDS"
 .\" For nroff, turn off justification.  Always turn off hyphenation; it makes
 .\" way too many mistakes in technical documents.
 .if n .ad l
@@ -361,7 +361,7 @@ characters.  Alternately, special characters may be specified in
 escaped hex mode, e.g. \ex20 for space.
 .PP
 The \f(CW\*(C`nonunix_group\*(C'\fR syntax depends on the underlying implementation.
-For instance, the \s-1QAS\s0 \s-1AD\s0 backend supports the following formats:
+For instance, the \s-1QAS\s0 \s-1AD\s0 plugin supports the following formats:
 .IP "\(bu" 4
 Group in the same domain: \*(L"Group Name\*(R"
 .IP "\(bu" 4
@@ -1308,6 +1308,25 @@ as \fIenv_keep\fR and \fIenv_check\fR.
 .IX Item "exempt_group"
 Users in this group are exempt from password and \s-1PATH\s0 requirements.
 This is not set by default.
+.IP "group_plugin" 12
+.IX Item "group_plugin"
+A string containing a \fIsudoers\fR group plugin with optional arguments.
+This can be used to implement support for the \f(CW\*(C`nonunix_group\*(C'\fR
+syntax described earlier.  The string should consist of the plugin
+path, either fully-qualified or relative to the \fI@prefix@/libexec\fR
+directory, followed by any configuration arguments the plugin
+requires.  These arguments (if any) will be passed to the plugin's
+initialization function.  If arguments are present, the string must
+be enclosed in double quotes (\f(CW\*(C`"\*(C'\fR).
+.Sp
+For example, given \fI/etc/sudo\-group\fR, a group file in Unix group
+format, the sample group plugin can be used:
+.Sp
+.Vb 1
+\&    Defaults sudo_plugin="sample_group.so /etc/sudo\-group"
+.Ve
+.Sp
+For more information see \fIsudo_plugin\fR\|(@mansectform@).
 .IP "lecture" 12
 .IX Item "lecture"
 This option controls when a short lecture will be printed along with
@@ -1863,7 +1882,7 @@ user specification.
 .SH "SEE ALSO"
 .IX Header "SEE ALSO"
 \&\fIrsh\fR\|(1), \fIsu\fR\|(1), \fIfnmatch\fR\|(3), \fIglob\fR\|(3), \fIsudoers.ldap\fR\|(@mansectform@),
-\&\fIsudo\fR\|(@mansectsu@), \fIvisudo\fR\|(@mansectsu@)
+\&\fIsudo_plugin\fR\|(@mansectform@), \fIsudo\fR\|(@mansectsu@), \fIvisudo\fR\|(@mansectsu@)
 .SH "CAVEATS"
 .IX Header "CAVEATS"
 The \fIsudoers\fR file should \fBalways\fR be edited by the \fBvisudo\fR
index b0aa084df938484605715d6c0e3aed0dab7b9246..88522d5fc7d0a88cb4821b3f83fa64b9264953a5 100644 (file)
@@ -229,7 +229,7 @@ characters.  Alternately, special characters may be specified in
 escaped hex mode, e.g. \x20 for space.
 
 The C<nonunix_group> syntax depends on the underlying implementation.
-For instance, the QAS AD backend supports the following formats:
+For instance, the QAS AD plugin supports the following formats:
 
 =over 4
 
@@ -1242,6 +1242,24 @@ as I<env_keep> and I<env_check>.
 Users in this group are exempt from password and PATH requirements.
 This is not set by default.
 
+=item group_plugin
+
+A string containing a I<sudoers> group plugin with optional arguments.
+This can be used to implement support for the C<nonunix_group>
+syntax described earlier.  The string should consist of the plugin
+path, either fully-qualified or relative to the F<@prefix@/libexec>
+directory, followed by any configuration arguments the plugin
+requires.  These arguments (if any) will be passed to the plugin's
+initialization function.  If arguments are present, the string must
+be enclosed in double quotes (C<">).
+
+For example, given F</etc/sudo-group>, a group file in Unix group
+format, the sample group plugin can be used:
+
+    Defaults sudo_plugin="sample_group.so /etc/sudo-group"
+
+For more information see L<sudo_plugin(5)>.
+
 =item lecture
 
 This option controls when a short lecture will be printed along with
@@ -1793,7 +1811,7 @@ user specification.
 =head1 SEE ALSO
 
 L<rsh(1)>, L<su(1)>, L<fnmatch(3)>, L<glob(3)>, L<sudoers.ldap(5)>,
-L<sudo(8)>, L<visudo(8)>
+L<sudo_plugin(5)>, L<sudo(8)>, L<visudo(8)>
 
 =head1 CAVEATS