diff options
Diffstat (limited to 'man3/syslog.3')
| -rw-r--r-- | man3/syslog.3 | 38 |
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. |
