diff options
| author | Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl> | 2014-02-14 22:00:06 -0500 |
|---|---|---|
| committer | Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl> | 2014-02-14 22:03:40 -0500 |
| commit | 6db2742802b70938f0f2d373110ed734d4fb9813 (patch) | |
| tree | 23bc9071b9a3029f5e4ffa7a530c5129adfff729 /man/daemon.xml | |
| parent | bcddd5bf8033b0c9cb15a9d017b7714ebe21473a (diff) | |
man: replace STDOUT with standard output, etc.
Actually 'STDOUT' is something that doesn't appear anywhere: in the
stdlib we have 'stdin', and there's only the constant STDOUT_FILENO,
so there's no reason to use capitals. When refering to code,
STDOUT/STDOUT/STDERR are replaced with stdin/stdout/stderr, and in
other places they are replaced with normal phrases like standard
output, etc.
Diffstat (limited to 'man/daemon.xml')
| -rw-r--r-- | man/daemon.xml | 21 |
1 files changed, 11 insertions, 10 deletions
diff --git a/man/daemon.xml b/man/daemon.xml index 17d9dd6a22..26ba600521 100644 --- a/man/daemon.xml +++ b/man/daemon.xml @@ -74,8 +74,8 @@ <orderedlist> <listitem><para>Close all open file - descriptors except STDIN, STDOUT, - STDERR (i.e. the first three file + descriptors except stdin, stdout, + stderr (i.e. the first three file descriptors 0, 1, 2). This ensures that no accidentally passed file descriptor stays around in the daemon @@ -128,8 +128,8 @@ <listitem><para>In the daemon process, connect <filename>/dev/null</filename> - to STDIN, STDOUT, - STDERR.</para></listitem> + to standard input, output, and error. + </para></listitem> <listitem><para>In the daemon process, reset the umask to 0, so that the file @@ -223,15 +223,16 @@ service.</para> <para>Note that new-style init systems - guarantee execution of daemon processes in - a clean process context: it is guaranteed that + guarantee execution of daemon processes in a + clean process context: it is guaranteed that the environment block is sanitized, that the signal handlers and mask is reset and that no left-over file descriptors are passed. Daemons - will be executed in their own session, and - STDIN/STDOUT/STDERR connected to + will be executed in their own session, with + standard input/output/error connected to <filename>/dev/null</filename> unless - otherwise configured. The umask is reset.</para> + otherwise configured. The umask is reset. + </para> <para>It is recommended for new-style daemons to implement the following:</para> @@ -324,7 +325,7 @@ <listitem><para>Instead of using the <function>syslog()</function> call to log directly to the system syslog service, a new-style daemon may - choose to simply log to STDERR via + choose to simply log to standard error via <function>fprintf()</function>, which is then forwarded to syslog by the init system. If log priorities are necessary, these can be |