]> granicus.if.org Git - sudo/commitdiff
Mention line continuation
authorTodd C. Miller <Todd.Miller@courtesan.com>
Thu, 7 Feb 2013 19:08:54 +0000 (14:08 -0500)
committerTodd C. Miller <Todd.Miller@courtesan.com>
Thu, 7 Feb 2013 19:08:54 +0000 (14:08 -0500)
doc/sudo.conf.cat
doc/sudo.conf.man.in
doc/sudo.conf.mdoc.in
doc/sudoers.cat
doc/sudoers.ldap.cat
doc/sudoers.ldap.man.in
doc/sudoers.ldap.mdoc.in

index fa52c8b2d5621ed6b6a020edbb7712db938065f0..c71b33ac2f2135b830270a78efc4aa26789d62af 100644 (file)
@@ -23,6 +23,10 @@ D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
      The pound sign (`#') is used to indicate a comment.  Both the comment
      character and any text after it, up to the end of the line, are ignored.
 
+     Long lines can be continued with a backslash (`\') as the last character
+     on the line.  Note that leading white space is removed from the beginning
+     of lines even when the continuation character is used.
+
      Non-comment lines that don't begin with Plugin, Path, Debug, or Set are
      silently ignored.
 
@@ -38,14 +42,14 @@ D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
      and the _\bp_\ba_\bt_\bh to the shared object containing the plugin.  The _\bs_\by_\bm_\bb_\bo_\bl_\b__\bn_\ba_\bm_\be
      is the name of the struct policy_plugin or struct io_plugin in the plugin
      shared object.  The _\bp_\ba_\bt_\bh may be fully qualified or relative.  If not
-     fully qualified, it is relative to the _\b/_\bu_\bs_\br_\b/_\bl_\bo_\bc_\ba_\bl_\b/_\bl_\bi_\bb_\be_\bx_\be_\bc directory.  In
-     other words:
+     fully qualified, it is relative to the _\b/_\bu_\bs_\br_\b/_\bl_\bo_\bc_\ba_\bl_\b/_\bl_\bi_\bb_\be_\bx_\be_\bc_\b/_\bs_\bu_\bd_\bo directory.
+     In other words:
 
            Plugin sudoers_policy sudoers.so
 
      is equivalent to:
 
-           Plugin sudoers_policy /usr/local/libexec/sudoers.so
+           Plugin sudoers_policy /usr/local/libexec/sudo/sudoers.so
 
      Starting with s\bsu\bud\bdo\bo 1.8.5, any additional parameters after the _\bp_\ba_\bt_\bh are
      passed as arguments to the plugin's _\bo_\bp_\be_\bn function.  For example, to
@@ -73,7 +77,7 @@ D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
      A Path line consists of the Path keyword, followed by the name of the
      path to set and its value.  For example:
 
-           Path noexec /usr/local/libexec/sudo_noexec.so
+           Path noexec /usr/local/libexec/sudo/sudo_noexec.so
            Path askpass /usr/X11R6/bin/ssh-askpass
 
      The following plugin-agnostic paths may be set in the _\b/_\be_\bt_\bc_\b/_\bs_\bu_\bd_\bo_\b._\bc_\bo_\bn_\bf
@@ -93,7 +97,7 @@ D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
                functions that just return an error.  This is used to implement
                the _\bn_\bo_\be_\bx_\be_\bc functionality on systems that support LD_PRELOAD or
                its equivalent.  The default value is:
-               _\b/_\bu_\bs_\br_\b/_\bl_\bo_\bc_\ba_\bl_\b/_\bl_\bi_\bb_\be_\bx_\be_\bc_\b/_\bs_\bu_\bd_\bo_\b__\bn_\bo_\be_\bx_\be_\bc_\b._\bs_\bo.
+               _\b/_\bu_\bs_\br_\b/_\bl_\bo_\bc_\ba_\bl_\b/_\bl_\bi_\bb_\be_\bx_\be_\bc_\b/_\bs_\bu_\bd_\bo_\b/_\bs_\bu_\bd_\bo_\b__\bn_\bo_\be_\bx_\be_\bc_\b._\bs_\bo.
 
    O\bOt\bth\bhe\ber\br s\bse\bet\btt\bti\bin\bng\bgs\bs
      The s\bsu\bud\bdo\bo.\b.c\bco\bon\bnf\bf file also supports the following front end settings:
@@ -242,7 +246,7 @@ E\bEX\bXA\bAM\bMP\bPL\bLE\bES\bS
      #   Debug sudo /var/log/sudo_debug all@warn
      #   Set disable_coredump true
      #
-     # The plugin_path is relative to /usr/local/libexec unless
+     # The plugin_path is relative to /usr/local/libexec/sudo unless
      #   fully qualified.
      # The plugin_name corresponds to a global symbol in the plugin
      #   that contains the plugin interface structure.
@@ -276,7 +280,7 @@ E\bEX\bXA\bAM\bMP\bPL\bLE\bES\bS
      # The compiled-in value is usually sufficient and should only be
      # changed if you rename or move the sudo_noexec.so file.
      #
-     #Path noexec /usr/local/libexec/sudo_noexec.so
+     #Path noexec /usr/local/libexec/sudo/sudo_noexec.so
 
      #
      # Core dumps:
@@ -338,4 +342,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/sudo/license.html for
      complete details.
 
-Sudo 1.8.7                     February 6, 2013                     Sudo 1.8.7
+Sudo 1.8.7                     February 7, 2013                     Sudo 1.8.7
index 333e7bf9bf92c9816be60dce2160cff482e1799b..ac76e7cbb3e581ab2964da811b1d0697041e5690 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 "SUDO" "5" "February 6, 2013" "Sudo @PACKAGE_VERSION@" "OpenBSD Programmer's Manual"
+.TH "SUDO" "5" "February 7, 2013" "Sudo @PACKAGE_VERSION@" "OpenBSD Programmer's Manual"
 .nh
 .if n .ad l
 .SH "NAME"
@@ -62,6 +62,12 @@ is used to indicate a comment.
 Both the comment character and any text after it, up to the end of
 the line, are ignored.
 .PP
+Long lines can be continued with a backslash
+(`\e')
+as the last character on the line.
+Note that leading white space is removed from the beginning of lines
+even when the continuation character is used.
+.PP
 Non-comment lines that don't begin with
 \fRPlugin\fR,
 \fRPath\fR,
index b040cd54d12348969179ed0bba9dc77df6118124..6e536f90ec4a25b48018cd944234317bbba10d27 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 February 6, 2013
+.Dd February 7, 2013
 .Dt SUDO @mansectform@
 .Os Sudo @PACKAGE_VERSION@
 .Sh NAME
@@ -58,6 +58,12 @@ is used to indicate a comment.
 Both the comment character and any text after it, up to the end of
 the line, are ignored.
 .Pp
+Long lines can be continued with a backslash
+.Pq Ql \e
+as the last character on the line.
+Note that leading white space is removed from the beginning of lines
+even when the continuation character is used.
+.Pp
 Non-comment lines that don't begin with
 .Li Plugin ,
 .Li Path ,
index c505d80dfab8749a88b1580138c8386ff9bfa1df..431ee25ca793e5b4d1d53c6e30dbbab123f568d0 100644 (file)
@@ -1393,8 +1393,8 @@ S\bSU\bUD\bDO\bOE\bER\bRS\bS O\bOP\bPT\bTI\bIO\bON\bNS\bS
                    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
+                   relative to the _\b/_\bu_\bs_\br_\b/_\bl_\bo_\bc_\ba_\bl_\b/_\bl_\bi_\bb_\be_\bx_\be_\bc_\b/_\bs_\bu_\bd_\bo 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 ("").
index 8c9d40ff2e8b6b9ad1d3ca37926f3f9a2c436782..ffcb48ba77f3f56b6181fa9d45fdf5ffb371a7d4 100644 (file)
@@ -262,6 +262,10 @@ D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
      by s\bsu\bud\bdo\bo are honored.  Configuration options are listed below in upper
      case but are parsed in a case-independent manner.
 
+     Long lines can be continued with a backslash (`\') as the last character
+     on the line.  Note that leading white space is removed from the beginning
+     of lines even when the continuation character is used.
+
      U\bUR\bRI\bI _\bl_\bd_\ba_\bp_\b[_\bs_\b]_\b:_\b/_\b/_\b[_\bh_\bo_\bs_\bt_\bn_\ba_\bm_\be_\b[_\b:_\bp_\bo_\br_\bt_\b]_\b] _\b._\b._\b.
            Specifies a white space-delimited list of one or more URIs
            describing the LDAP server(s) to connect to.  The _\bp_\br_\bo_\bt_\bo_\bc_\bo_\bl may be
@@ -765,4 +769,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/sudo/license.html for
      complete details.
 
-Sudo 1.8.7                     February 5, 2013                     Sudo 1.8.7
+Sudo 1.8.7                     February 7, 2013                     Sudo 1.8.7
index 011055b1ab8a999d1bc5564637b515da04842735..7de100c62db899678909a3ceae5e1351c733d060 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" "February 5, 2013" "Sudo @PACKAGE_VERSION@" "OpenBSD System Manager's Manual"
+.TH "SUDOERS.LDAP" "8" "February 7, 2013" "Sudo @PACKAGE_VERSION@" "OpenBSD System Manager's Manual"
 .nh
 .if n .ad l
 .SH "NAME"
@@ -463,6 +463,12 @@ as being supported by
 are honored.
 Configuration options are listed below in upper case but are parsed
 in a case-independent manner.
+.PP
+Long lines can be continued with a backslash
+(`\e')
+as the last character on the line.
+Note that leading white space is removed from the beginning of lines
+even when the continuation character is used.
 .TP 6n
 \fBURI\fR \fIldap[s]://[hostname[:port]] ...\fR
 Specifies a white space-delimited list of one or more URIs describing
index c45e766ccd0f26e847fb45ebde4c3e0d3b0984c5..83c46e627c0eb1f7564322d79af400d14f307434 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 February 5, 2013
+.Dd February 7, 2013
 .Dt SUDOERS.LDAP @mansectsu@
 .Os Sudo @PACKAGE_VERSION@
 .Sh NAME
@@ -440,6 +440,12 @@ as being supported by
 are honored.
 Configuration options are listed below in upper case but are parsed
 in a case-independent manner.
+.Pp
+Long lines can be continued with a backslash
+.Pq Ql \e
+as the last character on the line.
+Note that leading white space is removed from the beginning of lines
+even when the continuation character is used.
 .Bl -tag -width 4n
 .It Sy URI Ar ldap[s]://[hostname[:port]] ...
 Specifies a white space-delimited list of one or more URIs describing