From d86bb993d8a5e7ea23ead49cc079c80140fbebb5 Mon Sep 17 00:00:00 2001 From: Eisuke Kawashima Date: Tue, 17 Feb 2026 01:02:19 +0900 Subject: [PATCH] docs: fix man iolog_flush and iolog_mode are boolean and integer options, respectively. --- docs/sudoers.man.in | 52 ++++++++++++++++++++++---------------------- docs/sudoers.mdoc.in | 48 ++++++++++++++++++++-------------------- 2 files changed, 50 insertions(+), 50 deletions(-) diff --git a/docs/sudoers.man.in b/docs/sudoers.man.in index 2d4c85d7cf..a1faf8b895 100644 --- a/docs/sudoers.man.in +++ b/docs/sudoers.man.in @@ -3195,6 +3195,19 @@ This flag is \fI@insults@\fR by default. .TP 18n +iolog_flush +If set, +\fBsudo\fR +will flush I/O log data to disk after each write instead of buffering it. +This makes it possible to view the logs in real-time as the program +is executing but may significantly reduce the effectiveness of I/O +log compression. +This flag is +\fIoff\fR +by default. +.sp +This setting is only supported by version 1.8.20 or higher. +.TP 18n log_allowed If set, \fBsudoers\fR @@ -4534,6 +4547,19 @@ the umask specified by PAM or login.conf will take precedence. The umask setting in PAM is not used for \fBsudoedit\fR, which does not create a new PAM session. +.TP 18n +iolog_mode +The file mode to use when creating I/O log files. +Mode bits for read and write permissions for owner, group, or other +are honored, everything else is ignored. +The file permissions will always include the owner read and +write bits, even if they are not present in the specified mode. +When creating I/O log directories, search (execute) bits are added +to match the read and write bits specified by +\fIiolog_mode\fR. +Defaults to 0600 (read and write by user only). +.sp +This setting is only supported by version 1.8.19 or higher. .PP \fBStrings\fR: .if \n(AA \{\ @@ -4790,19 +4816,6 @@ ends in six or more \fIX\fRs. .TP 18n -iolog_flush -If set, -\fBsudo\fR -will flush I/O log data to disk after each write instead of buffering it. -This makes it possible to view the logs in real-time as the program -is executing but may significantly reduce the effectiveness of I/O -log compression. -This flag is -\fIoff\fR -by default. -.sp -This setting is only supported by version 1.8.20 or higher. -.TP 18n iolog_group The group name to look up when setting the group-ID on new I/O log files and directories. @@ -4820,19 +4833,6 @@ are set, I/O log files and directories are created with group-ID 0. .sp This setting is only supported by version 1.8.19 or higher. .TP 18n -iolog_mode -The file mode to use when creating I/O log files. -Mode bits for read and write permissions for owner, group, or other -are honored, everything else is ignored. -The file permissions will always include the owner read and -write bits, even if they are not present in the specified mode. -When creating I/O log directories, search (execute) bits are added -to match the read and write bits specified by -\fIiolog_mode\fR. -Defaults to 0600 (read and write by user only). -.sp -This setting is only supported by version 1.8.19 or higher. -.TP 18n iolog_user The user name to look up when setting the user and group-IDs on new I/O log files and directories. diff --git a/docs/sudoers.mdoc.in b/docs/sudoers.mdoc.in index aee0388800..e164eddaf2 100644 --- a/docs/sudoers.mdoc.in +++ b/docs/sudoers.mdoc.in @@ -3017,6 +3017,18 @@ will insult users when they enter an incorrect password. This flag is .Em @insults@ by default. +.It iolog_flush +If set, +.Nm sudo +will flush I/O log data to disk after each write instead of buffering it. +This makes it possible to view the logs in real-time as the program +is executing but may significantly reduce the effectiveness of I/O +log compression. +This flag is +.Em off +by default. +.Pp +This setting is only supported by version 1.8.20 or higher. .It log_allowed If set, .Nm @@ -4282,6 +4294,18 @@ the umask specified by PAM or login.conf will take precedence. The umask setting in PAM is not used for .Nm sudoedit , which does not create a new PAM session. +.It iolog_mode +The file mode to use when creating I/O log files. +Mode bits for read and write permissions for owner, group, or other +are honored, everything else is ignored. +The file permissions will always include the owner read and +write bits, even if they are not present in the specified mode. +When creating I/O log directories, search (execute) bits are added +to match the read and write bits specified by +.Em iolog_mode . +Defaults to 0600 (read and write by user only). +.Pp +This setting is only supported by version 1.8.19 or higher. .El .Pp .Sy Strings : @@ -4515,18 +4539,6 @@ overwritten unless ends in six or more .Em X Ns s . -.It iolog_flush -If set, -.Nm sudo -will flush I/O log data to disk after each write instead of buffering it. -This makes it possible to view the logs in real-time as the program -is executing but may significantly reduce the effectiveness of I/O -log compression. -This flag is -.Em off -by default. -.Pp -This setting is only supported by version 1.8.20 or higher. .It iolog_group The group name to look up when setting the group-ID on new I/O log files and directories. @@ -4543,18 +4555,6 @@ nor are set, I/O log files and directories are created with group-ID 0. .Pp This setting is only supported by version 1.8.19 or higher. -.It iolog_mode -The file mode to use when creating I/O log files. -Mode bits for read and write permissions for owner, group, or other -are honored, everything else is ignored. -The file permissions will always include the owner read and -write bits, even if they are not present in the specified mode. -When creating I/O log directories, search (execute) bits are added -to match the read and write bits specified by -.Em iolog_mode . -Defaults to 0600 (read and write by user only). -.Pp -This setting is only supported by version 1.8.19 or higher. .It iolog_user The user name to look up when setting the user and group-IDs on new I/O log files and directories.