Make it clear that I/O logs will be complete even if the command

run by sudo is terminated by a signal.  The I/O log buffering just
prevents the logs from being displayed in real-time as the command
is running.

diff --git a/doc/sudoers.cat b/doc/sudoers.cat
index 871573422f1699c5326e649323be2518e4346504..84ed7f8a8bd6dc407c842fd55956c7f7b94f4639 100644 (file)
--- a/doc/sudoers.cat
+++ b/doc/sudoers.cat
@@ -2240,8 +2240,10 @@ I\bI/\b/O\bO L\bLO\bOG\bG F\bFI\bIL\bLE\bES\bS
      _\bs_\bt_\bd_\be_\br_\br    standard error to a pipe or redirected to a file
 
      All files other than _\bl_\bo_\bg are compressed in gzip format unless the
-     _\bc_\bo_\bm_\bp_\br_\be_\bs_\bs_\b__\bi_\bo option has been disabled.  Due to buffering, the I/O log data
-     will not be complete until the s\bsu\bud\bdo\bo command has completed.  The output
+     _\bc_\bo_\bm_\bp_\br_\be_\bs_\bs_\b__\bi_\bo option has been disabled.  Due to buffering, it is not
+     possible to display the I/O logs in real-time as the program is
+     executing.  The I/O log data will not be complete until the program run
+     by s\bsu\bud\bdo\bo has exited or has been terminated by a signal.  The output
      portion of an I/O log file can be viewed with the sudoreplay(1m) utility,
      which can also be used to list or search the available logs.
 
@@ -2745,4 +2747,4 @@ D\bDI\bIS\bSC\bCL\bLA\bAI\bIM\bME\bER\bR
      file distributed with s\bsu\bud\bdo\bo or https://www.sudo.ws/license.html for
      complete details.
 
-Sudo 1.8.20                    February 16, 2017                   Sudo 1.8.20
+Sudo 1.8.20                     March 14, 2017                     Sudo 1.8.20

diff --git a/doc/sudoers.man.in b/doc/sudoers.man.in
index bad6c91690c156ce647a4111a7b3fd369202df61..91a834280239ad496c9291018d1a2572527dce50 100644 (file)
--- a/doc/sudoers.man.in
+++ b/doc/sudoers.man.in
@@ -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" "February 16, 2017" "Sudo @PACKAGE_VERSION@" "File Formats Manual"
+.TH "SUDOERS" "5" "March 14, 2017" "Sudo @PACKAGE_VERSION@" "File Formats Manual"
 .nh
 .if n .ad l
 .SH "NAME"
@@ -4465,9 +4465,11 @@ All files other than
 are compressed in gzip format unless the
 \fIcompress_io\fR
 option has been disabled.
-Due to buffering, the I/O log data will not be complete until the
+Due to buffering, it is not possible to display the I/O logs in
+real-time as the program is executing.
+The I/O log data will not be complete until the program run by
 \fBsudo\fR
-command has completed.
+has exited or has been terminated by a signal.
 The output portion of an I/O log file can be viewed with the
 sudoreplay(@mansectsu@)
 utility, which can also be used to list or search the available logs.

diff --git a/doc/sudoers.mdoc.in b/doc/sudoers.mdoc.in
index 03f378b810360fb6c84dbf87e2e94dfec76cffd9..9c72c6f37f14066db7dbe10b8a080f707cec6c61 100644 (file)
--- a/doc/sudoers.mdoc.in
+++ b/doc/sudoers.mdoc.in
@@ -19,7 +19,7 @@
 .\" Agency (DARPA) and Air Force Research Laboratory, Air Force
 .\" Materiel Command, USAF, under agreement number F39502-99-1-0512.
 .\"
-.Dd February 16, 2017
+.Dd March 14, 2017
 .Dt SUDOERS @mansectform@
 .Os Sudo @PACKAGE_VERSION@
 .Sh NAME
@@ -4146,9 +4146,11 @@ All files other than
 are compressed in gzip format unless the
 .Em compress_io
 option has been disabled.
-Due to buffering, the I/O log data will not be complete until the
+Due to buffering, it is not possible to display the I/O logs in
+real-time as the program is executing.
+The I/O log data will not be complete until the program run by
 .Nm sudo
-command has completed.
+has exited or has been terminated by a signal.
 The output portion of an I/O log file can be viewed with the
 .Xr sudoreplay @mansectsu@
 utility, which can also be used to list or search the available logs.