aboutsummaryrefslogtreecommitdiffstats
path: root/man3/syslog.3
diff options
context:
space:
mode:
Diffstat (limited to 'man3/syslog.3')
-rw-r--r--man3/syslog.338
1 files changed, 19 insertions, 19 deletions
diff --git a/man3/syslog.3 b/man3/syslog.3
index cb5cf09a04..3a7c3d22c5 100644
--- a/man3/syslog.3
+++ b/man3/syslog.3
@@ -48,12 +48,12 @@ closelog, openlog, syslog \- send messages to the system logger
.BI "void vsyslog(int " priority ", const char *" format ", va_list " ap );
.br
.SH DESCRIPTION
-.B closelog()
+.BR closelog ()
closes the descriptor being used to write to the system logger. The use of
-.B closelog()
+.BR closelog ()
is optional.
.sp
-.B openlog()
+.BR openlog ()
opens a connection to the system logger for a program. The string pointed
to by
.I ident
@@ -61,27 +61,27 @@ is prepended to every message, and is typically set to the program name.
The
.I option
argument specifies flags which control the operation of
-.B openlog()
+.BR openlog ()
and subsequent calls to
-.BR syslog() .
+.BR syslog ().
The
.I facility
argument establishes a default to be used if
none is specified in subsequent calls to
-.BR syslog() .
+.BR syslog ().
Values for
.I option
and
.I facility
are given below. The use of
-.B openlog()
+.BR openlog ()
is optional; it will automatically be called by
-.B syslog()
+.BR syslog ()
if necessary, in which case
.I ident
will default to NULL.
.sp
-.B syslog()
+.BR syslog ()
generates a log message, which will be distributed by
.BR syslogd (8).
The
@@ -103,9 +103,9 @@ the error message string
A trailing newline is added when needed.
The function
-.B vsyslog()
+.BR vsyslog ()
performs the same task as
-.B syslog()
+.BR syslog ()
with the difference that it takes a set of arguments which have
been obtained using the
.BR stdarg (3)
@@ -117,7 +117,7 @@ This section lists the parameters used to set the values of
The
.I option
argument to
-.B openlog()
+.BR openlog ()
is an OR of any of these:
.TP
.B LOG_CONS
@@ -137,7 +137,7 @@ option has no effect on Linux.)
The converse of
.BR LOG_NDELAY ;
opening of the connection is delayed until
-.B syslog()
+.BR syslog ()
is called. (This is the default, and need not be specified.)
.TP
.B LOG_PERROR
@@ -228,12 +228,12 @@ The function
can be used to restrict logging to specified levels only.
.SH "CONFORMING TO"
The functions
-.BR openlog() ,
-.BR closelog() ,
+.BR openlog (),
+.BR closelog (),
and
-.BR syslog()
+.BR syslog ()
(but not
-.BR vsyslog() )
+.BR vsyslog ())
are specified in SUSv2 and POSIX 1003.1-2001.
POSIX 1003.1-2001 specifies only the
.B LOG_USER
@@ -274,10 +274,10 @@ mechanism, which is not compatible with
The parameter
.I ident
in the call of
-.B openlog()
+.BR openlog ()
is probably stored as-is. Thus, if the string it points to
is changed,
-.B syslog()
+.BR syslog ()
may start prepending the changed string, and if the string
it points to ceases to exist, the results are undefined.
Most portable is to use a string constant.