1 |
If PORTAGE_LOG_FILTER_FILE_CMD fails after exec, then output |
2 |
will be lost. Therefore, suggest to use bash as a supervisor, |
3 |
with fallback to cat. |
4 |
|
5 |
Bug: https://bugs.gentoo.org/781854 |
6 |
Signed-off-by: Zac Medico <zmedico@g.o> |
7 |
--- |
8 |
man/make.conf.5 | 15 +++++++++++++-- |
9 |
1 file changed, 13 insertions(+), 2 deletions(-) |
10 |
|
11 |
diff --git a/man/make.conf.5 b/man/make.conf.5 |
12 |
index 8d551c95e..8a4a2ae30 100644 |
13 |
--- a/man/make.conf.5 |
14 |
+++ b/man/make.conf.5 |
15 |
@@ -1,4 +1,4 @@ |
16 |
-.TH "MAKE.CONF" "5" "Feb 2021" "Portage VERSION" "Portage" |
17 |
+.TH "MAKE.CONF" "5" "Apr 2021" "Portage VERSION" "Portage" |
18 |
.SH "NAME" |
19 |
make.conf \- custom settings for Portage |
20 |
.SH "SYNOPSIS" |
21 |
@@ -998,7 +998,18 @@ will set idle io priority. For more information about ionice, see |
22 |
.B PORTAGE_LOG_FILTER_FILE_CMD |
23 |
This variable specifies a command that filters build log output to a |
24 |
log file. In order to filter ANSI escape codes from build logs, |
25 |
-\fBansifilter\fR(1) is a convenient setting for this variable. |
26 |
+\fBansifilter\fR(1) is a convenient setting for this variable. Generally, |
27 |
+PORTAGE_LOG_FILTER_FILE_CMD should include a supervisor that falls back |
28 |
+to cat if the real filter command fails after exec. For example, a |
29 |
+supervisor is needed for ansifilter, in case it fails after exec due to |
30 |
+a problem resolving libstdc++ during a gcc upgrade. |
31 |
+.br |
32 |
+.I Example: |
33 |
+.nf |
34 |
+# Use bash as a supervisor, for fallback to cat if asifilter fails |
35 |
+# after exec due to a problem resolving libstdc++ during a gcc upgrade. |
36 |
+PORTAGE_LOG_FILTER_FILE_CMD="bash -c \\"ansifilter; exec cat\\"" |
37 |
+.fi |
38 |
.TP |
39 |
.B PORTAGE_LOGDIR |
40 |
This variable defines the directory in which per\-ebuild logs are kept. |
41 |
-- |
42 |
2.26.2 |