]>
git.ipfire.org Git - thirdparty/systemd.git/blob - src/shared/pager.c
1 /* SPDX-License-Identifier: LGPL-2.1+ */
10 #include <sys/prctl.h>
17 #include "locale-util.h"
21 #include "process-util.h"
22 #include "rlimit-util.h"
23 #include "signal-util.h"
24 #include "string-util.h"
26 #include "terminal-util.h"
28 static pid_t pager_pid
= 0;
30 static int stored_stdout
= -1;
31 static int stored_stderr
= -1;
32 static bool stdout_redirected
= false;
33 static bool stderr_redirected
= false;
35 _noreturn_
static void pager_fallback(void) {
38 r
= copy_bytes(STDIN_FILENO
, STDOUT_FILENO
, (uint64_t) -1, 0);
40 log_error_errno(r
, "Internal pager failed: %m");
47 static int no_quit_on_interrupt(int exe_name_fd
, const char *less_opts
) {
48 _cleanup_fclose_
FILE *file
= NULL
;
49 _cleanup_free_
char *line
= NULL
;
52 assert(exe_name_fd
>= 0);
55 /* This takes ownership of exe_name_fd */
56 file
= fdopen(exe_name_fd
, "r");
58 safe_close(exe_name_fd
);
59 return log_debug_errno(errno
, "Failed to create FILE object: %m");
62 /* Find the last line */
64 _cleanup_free_
char *t
= NULL
;
66 r
= read_line(file
, LONG_LINE_MAX
, &t
);
72 free_and_replace(line
, t
);
75 /* We only treat "less" specially.
76 * Return true whenever option K is *not* set. */
77 r
= streq_ptr(line
, "less") && !strchr(less_opts
, 'K');
79 log_debug("Pager executable is \"%s\", options \"%s\", quit_on_interrupt: %s",
80 strnull(line
), less_opts
, yes_no(!r
));
84 int pager_open(PagerFlags flags
) {
85 _cleanup_close_pair_
int fd
[2] = { -1, -1 }, exe_name_pipe
[2] = { -1, -1 };
86 _cleanup_strv_free_
char **pager_args
= NULL
;
87 const char *pager
, *less_opts
;
90 if (flags
& PAGER_DISABLE
)
96 if (terminal_is_dumb())
99 if (!is_main_thread())
102 pager
= getenv("SYSTEMD_PAGER");
104 pager
= getenv("PAGER");
107 pager_args
= strv_split(pager
, WHITESPACE
);
111 /* If the pager is explicitly turned off, honour it */
112 if (strv_isempty(pager_args
) || strv_equal(pager_args
, STRV_MAKE("cat")))
116 /* Determine and cache number of columns/lines before we spawn the pager so that we get the value from the
121 if (pipe2(fd
, O_CLOEXEC
) < 0)
122 return log_error_errno(errno
, "Failed to create pager pipe: %m");
124 /* This is a pipe to feed the name of the executed pager binary into the parent */
125 if (pipe2(exe_name_pipe
, O_CLOEXEC
) < 0)
126 return log_error_errno(errno
, "Failed to create exe_name pipe: %m");
128 /* Initialize a good set of less options */
129 less_opts
= getenv("SYSTEMD_LESS");
131 less_opts
= "FRSXMK";
132 if (flags
& PAGER_JUMP_TO_END
)
133 less_opts
= strjoina(less_opts
, " +G");
135 r
= safe_fork("(pager)", FORK_RESET_SIGNALS
|FORK_DEATHSIG
|FORK_LOG
, &pager_pid
);
139 const char *less_charset
, *exe
;
141 /* In the child start the pager */
143 (void) dup2(fd
[0], STDIN_FILENO
);
146 if (setenv("LESS", less_opts
, 1) < 0)
149 /* Initialize a good charset for less. This is
150 * particularly important if we output UTF-8
152 less_charset
= getenv("SYSTEMD_LESSCHARSET");
153 if (!less_charset
&& is_locale_utf8())
154 less_charset
= "utf-8";
156 setenv("LESSCHARSET", less_charset
, 1) < 0)
160 if (loop_write(exe_name_pipe
[1], pager_args
[0], strlen(pager_args
[0]) + 1, false) < 0)
163 execvp(pager_args
[0], pager_args
);
166 /* Debian's alternatives command for pagers is
167 * called 'pager'. Note that we do not call
168 * sensible-pagers here, since that is just a
169 * shell script that implements a logic that
170 * is similar to this one anyway, but is
171 * Debian-specific. */
172 FOREACH_STRING(exe
, "pager", "less", "more") {
173 if (loop_write(exe_name_pipe
[1], exe
, strlen(exe
) + 1, false) < 0)
175 execlp(exe
, exe
, NULL
);
178 if (loop_write(exe_name_pipe
[1], "(built-in)", strlen("(built-in") + 1, false) < 0)
184 /* Return in the parent */
185 stored_stdout
= fcntl(STDOUT_FILENO
, F_DUPFD_CLOEXEC
, 3);
186 if (dup2(fd
[1], STDOUT_FILENO
) < 0) {
187 stored_stdout
= safe_close(stored_stdout
);
188 return log_error_errno(errno
, "Failed to duplicate pager pipe: %m");
190 stdout_redirected
= true;
192 stored_stderr
= fcntl(STDERR_FILENO
, F_DUPFD_CLOEXEC
, 3);
193 if (dup2(fd
[1], STDERR_FILENO
) < 0) {
194 stored_stderr
= safe_close(stored_stderr
);
195 return log_error_errno(errno
, "Failed to duplicate pager pipe: %m");
197 stderr_redirected
= true;
199 exe_name_pipe
[1] = safe_close(exe_name_pipe
[1]);
201 r
= no_quit_on_interrupt(TAKE_FD(exe_name_pipe
[0]), less_opts
);
205 (void) ignore_signals(SIGINT
, -1);
210 void pager_close(void) {
215 /* Inform pager that we are done */
216 (void) fflush(stdout
);
217 if (stdout_redirected
)
218 if (stored_stdout
< 0 || dup2(stored_stdout
, STDOUT_FILENO
) < 0)
219 (void) close(STDOUT_FILENO
);
220 stored_stdout
= safe_close(stored_stdout
);
221 (void) fflush(stderr
);
222 if (stderr_redirected
)
223 if (stored_stderr
< 0 || dup2(stored_stderr
, STDERR_FILENO
) < 0)
224 (void) close(STDERR_FILENO
);
225 stored_stderr
= safe_close(stored_stderr
);
226 stdout_redirected
= stderr_redirected
= false;
228 (void) kill(pager_pid
, SIGCONT
);
229 (void) wait_for_terminate(pager_pid
, NULL
);
233 bool pager_have(void) {
234 return pager_pid
> 0;
237 int show_man_page(const char *desc
, bool null_stdio
) {
238 const char *args
[4] = { "man", NULL
, NULL
, NULL
};
246 if (desc
[k
-1] == ')')
247 e
= strrchr(desc
, '(');
250 char *page
= NULL
, *section
= NULL
;
252 page
= strndupa(desc
, e
- desc
);
253 section
= strndupa(e
+ 1, desc
+ k
- e
- 2);
260 r
= safe_fork("(man)", FORK_RESET_SIGNALS
|FORK_DEATHSIG
|(null_stdio
? FORK_NULL_STDIO
: 0)|FORK_LOG
, &pid
);
265 execvp(args
[0], (char**) args
);
266 log_error_errno(errno
, "Failed to execute man: %m");
270 return wait_for_terminate_and_check(NULL
, pid
, 0);