aboutsummaryrefslogtreecommitdiffstats
path: root/man3/syslog.3
diff options
context:
space:
mode:
authorMichael Kerrisk <mtk.manpages@gmail.com>2017-03-26 14:08:42 +0200
committerMichael Kerrisk <mtk.manpages@gmail.com>2017-03-26 14:19:54 +0200
commit1d8ee5b8ff48fb4dbb287600ad24b3aa9db1aead (patch)
tree493831196d1cace68cbf3e43a48b9ace7e6579f0 /man3/syslog.3
parent6b5652c1aa893f0ac2873d1a4ee0e85276146f8d (diff)
downloadman-pages-1d8ee5b8ff48fb4dbb287600ad24b3aa9db1aead.tar.gz
syslog.3: Various rewordings and improvements
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Diffstat (limited to 'man3/syslog.3')
-rw-r--r--man3/syslog.324
1 files changed, 14 insertions, 10 deletions
diff --git a/man3/syslog.3 b/man3/syslog.3
index 5851c8856a..6e198dbdd3 100644
--- a/man3/syslog.3
+++ b/man3/syslog.3
@@ -84,11 +84,11 @@ The
argument establishes a default to be used if
none is specified in subsequent calls to
.BR syslog ().
-Values for
+The values that may be specified for
.I option
and
.I facility
-are given below.
+are described below.
The use of
.BR openlog ()
@@ -105,11 +105,11 @@ generates a log message, which will be distributed by
The
.I priority
-argument is formed by ORing the
+argument is formed by ORing together a
.I facility
-and the
+value and a
.I level
-values (explained below).
+value (described below).
If no
.I facility
value is ORed into
@@ -156,15 +156,18 @@ The
.I option
argument to
.BR openlog ()
-is an OR of any of these:
+is a bit mask constructed by ORing together any of the following values:
.TP 15
.B LOG_CONS
-Write directly to system console if there is an error while sending to
-system logger.
+Write directly to the system console if there is an error while sending to
+the system logger.
.TP
.B LOG_NDELAY
Open the connection immediately (normally, the connection is opened when
the first message is logged).
+This may be useful, for example, if a subsequent
+.BR chroot (2)
+would make the pathname used internally by the logging facility unreachable.
.TP
.B LOG_NOWAIT
Don't wait for child processes that may have been created while logging
@@ -182,10 +185,11 @@ is called.
.TP
.B LOG_PERROR
(Not in POSIX.1-2001 or POSIX.1-2008.)
-Print to \fIstderr\fP as well.
+Also log the message to
+.IR stderr .
.TP
.B LOG_PID
-Include PID with each message.
+Include the caller's PID with each message.
.\"
.SS Values for \fIfacility\fP
The