aboutsummaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
authorZac Medico <zmedico@gentoo.org>2021-04-09 11:26:49 -0700
committerZac Medico <zmedico@gentoo.org>2021-05-23 23:44:57 -0700
commit1f3bfcb357c3f262730175f4d59c11e1ed4f8dc3 (patch)
tree06a1378fba22bfa1db0c7f3f5a6bab4294497ba9 /man
parentlib/portage/_sets/dbapi.py: add glob support to exclude-files parameter cnf/s... (diff)
downloadportage-1f3bfcb357c3f262730175f4d59c11e1ed4f8dc3.tar.gz
portage-1f3bfcb357c3f262730175f4d59c11e1ed4f8dc3.tar.bz2
portage-1f3bfcb357c3f262730175f4d59c11e1ed4f8dc3.zip
make.conf.5: Suggest PORTAGE_LOG_FILTER_FILE_CMD supervisor for cat fallback (bug 781854)
If PORTAGE_LOG_FILTER_FILE_CMD fails after exec, then output will be lost. Therefore, suggest to use bash as a supervisor, with fallback to cat. Bug: https://bugs.gentoo.org/781854 Signed-off-by: Zac Medico <zmedico@gentoo.org>
Diffstat (limited to 'man')
-rw-r--r--man/make.conf.513
1 files changed, 12 insertions, 1 deletions
diff --git a/man/make.conf.5 b/man/make.conf.5
index badaea18e..1c72109ad 100644
--- a/man/make.conf.5
+++ b/man/make.conf.5
@@ -998,7 +998,18 @@ will set idle io priority. For more information about ionice, see
.B PORTAGE_LOG_FILTER_FILE_CMD
This variable specifies a command that filters build log output to a
log file. In order to filter ANSI escape codes from build logs,
-\fBansifilter\fR(1) is a convenient setting for this variable.
+\fBansifilter\fR(1) is a convenient setting for this variable. Generally,
+PORTAGE_LOG_FILTER_FILE_CMD should include a supervisor that falls back
+to cat if the real filter command fails after exec. For example, a
+supervisor is needed for ansifilter, in case it fails after exec due to
+a problem resolving libstdc++ during a gcc upgrade.
+.br
+.I Example:
+.nf
+# Use bash as a supervisor, for fallback to cat if ansifilter fails
+# after exec due to a problem resolving libstdc++ during a gcc upgrade.
+PORTAGE_LOG_FILTER_FILE_CMD="bash -c \\"ansifilter; exec cat\\""
+.fi
.TP
.B PORTAGE_LOGDIR
This variable defines the directory in which per\-ebuild logs are kept.