Document special cases for AIX-style shared libraries.

The shared object is a member of an archive file that is specified in parentheses.
sudo-project · Nov 6, 2023 · 3686c9f · 3686c9f
1 parent e772479
commit 3686c9f
Show file tree

Hide file tree

Showing 4 changed files with 56 additions and 6 deletions.
diff --git a/docs/sudo.conf.man.in b/docs/sudo.conf.man.in
@@ -17,7 +17,7 @@
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
 .nr SL @SEMAN@
-.TH "SUDO.CONF" "@mansectform@" "November 4, 2023" "Sudo @PACKAGE_VERSION@" "File Formats Manual"
+.TH "SUDO.CONF" "@mansectform@" "November 6, 2023" "Sudo @PACKAGE_VERSION@" "File Formats Manual"
 .nh
 .if n .ad l
 .SH "NAME"
@@ -153,6 +153,13 @@ Plugin sudoers_policy @sudoers_plugin@
 .RE
 .fi
 .PP
+On AIX systems, the plugin may be either a shared object
+ending in
+\(oq.so\(cq
+or an archive file containing a shared object ending in
+\(oq.a\(cq
+with the name of the shared object in parentheses at the end.
+.PP
 Starting with
 \fBsudo\fR
 1.8.5, any additional parameters after the
@@ -577,6 +584,17 @@ but a third-party plugin is free to use a different format so long
 as it does not include a comma
 (\(oq\&,\(cq).
 .PP
+On AIX systems, a
+\fIDebug\fR
+line will match a plugin specified as either the name of an
+SVR4-style shared object file ending in
+\(oq.so\(cq,
+an archive file ending in
+\(oq.a\(cq,
+or an archive file ending in
+\(oq.a\(cq
+with the name of the shared object in parentheses.
+.PP
 Examples:
 .nf
 .sp

diff --git a/docs/sudo.conf.mdoc.in b/docs/sudo.conf.mdoc.in
@@ -16,7 +16,7 @@
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
 .nr SL @SEMAN@
-.Dd November 4, 2023
+.Dd November 6, 2023
 .Dt SUDO.CONF @mansectform@
 .Os Sudo @PACKAGE_VERSION@
 .Sh NAME
@@ -141,6 +141,13 @@ For example:
 Plugin sudoers_policy @sudoers_plugin@
 .Ed
 .Pp
+On AIX systems, the plugin may be either a shared object
+ending in
+.Ql .so
+or an archive file containing a shared object ending in
+.Ql .a
+with the name of the shared object in parentheses at the end.
+.Pp
 Starting with
 .Nm sudo
 1.8.5, any additional parameters after the
@@ -533,6 +540,17 @@ but a third-party plugin is free to use a different format so long
 as it does not include a comma
 .Pq Ql \&, .
 .Pp
+On AIX systems, a
+.Em Debug
+line will match a plugin specified as either the name of an
+SVR4-style shared object file ending in
+.Ql .so ,
+an archive file ending in
+.Ql .a ,
+or an archive file ending in
+.Ql .a
+with the name of the shared object in parentheses.
+.Pp
 Examples:
 .Bd -literal -offset 4n
 Debug sudo @log_dir@/sudo_debug all@warn,plugin@info

diff --git a/docs/sudoers.man.in b/docs/sudoers.man.in
@@ -25,7 +25,7 @@
 .nr BA @BAMAN@
 .nr LC @LCMAN@
 .nr PS @PSMAN@
-.TH "SUDOERS" "@mansectform@" "September 28, 2023" "Sudo @PACKAGE_VERSION@" "File Formats Manual"
+.TH "SUDOERS" "@mansectform@" "November 6, 2023" "Sudo @PACKAGE_VERSION@" "File Formats Manual"
 .nh
 .if n .ad l
 .SH "NAME"
@@ -5247,6 +5247,13 @@ before the file extension;
 becomes
 \fIgroup_plugin64.so\fR.
 .sp
+On AIX systems, the plugin may be either a shared object
+ending in
+\(oq.so\(cq
+or an archive file containing a shared object ending in
+\(oq.a\(cq
+with the name of the shared object in parentheses at the end.
+.sp
 For more information see
 \fIGROUP PROVIDER PLUGINS\fR.
 .TP 14n

diff --git a/docs/sudoers.mdoc.in b/docs/sudoers.mdoc.in
@@ -25,7 +25,7 @@
 .nr BA @BAMAN@
 .nr LC @LCMAN@
 .nr PS @PSMAN@
-.Dd September 28, 2023
+.Dd November 6, 2023
 .Dt SUDOERS @mansectform@
 .Os Sudo @PACKAGE_VERSION@
 .Sh NAME
@@ -2355,7 +2355,7 @@ to include the file
 .Pa /etc/sudoers.xerxes .
 Any path name separator characters
 .Pq Ql /
-present in the host name will be replaced with an underbar 
+present in the host name will be replaced with an underbar
 .Pq Ql _
 during expansion.
 .Pp
@@ -4422,7 +4422,7 @@ should be used.
 .Pp
 Any path name separator characters
 .Pq Ql /
-present in the user, group or host name will be replaced with an underbar 
+present in the user, group or host name will be replaced with an underbar
 .Pq Ql _
 during expansion.
 .It iolog_file
@@ -4943,6 +4943,13 @@ before the file extension;
 becomes
 .Pa group_plugin64.so .
 .Pp
+On AIX systems, the plugin may be either a shared object
+ending in
+.Ql .so
+or an archive file containing a shared object ending in
+.Ql .a
+with the name of the shared object in parentheses at the end.
+.Pp
 For more information see
 .Sx "GROUP PROVIDER PLUGINS" .
 .It lecture