aboutsummaryrefslogtreecommitdiffstats
path: root/man3/syslog.3
diff options
context:
space:
mode:
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