From 4bdbc6b2906c1a7c96cf74a293319342df026153 Mon Sep 17 00:00:00 2001 From: "Todd C. Miller" Date: Tue, 14 Mar 2017 09:11:56 -0600 Subject: [PATCH] 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. --- doc/sudoers.cat | 8 +++++--- doc/sudoers.man.in | 8 +++++--- doc/sudoers.mdoc.in | 8 +++++--- 3 files changed, 15 insertions(+), 9 deletions(-) diff --git a/doc/sudoers.cat b/doc/sudoers.cat index 871573422..84ed7f8a8 100644 --- a/doc/sudoers.cat +++ b/doc/sudoers.cat @@ -2240,8 +2240,10 @@ II//OO LLOOGG FFIILLEESS _s_t_d_e_r_r standard error to a pipe or redirected to a file All files other than _l_o_g are compressed in gzip format unless the - _c_o_m_p_r_e_s_s___i_o option has been disabled. Due to buffering, the I/O log data - will not be complete until the ssuuddoo command has completed. The output + _c_o_m_p_r_e_s_s___i_o 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 ssuuddoo 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 @@ DDIISSCCLLAAIIMMEERR file distributed with ssuuddoo 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 bad6c9169..91a834280 100644 --- 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 03f378b81..9c72c6f37 100644 --- 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. -- 2.40.0