From 9a6ff5bc53dedbaa601a1a76cbaf8a76afd60c9f Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Mon, 15 Apr 2024 21:41:06 +0200 Subject: Adding upstream version 6.7. Signed-off-by: Daniel Baumann --- man3/syslog.3 | 33 ++++++++++++++++----------------- 1 file changed, 16 insertions(+), 17 deletions(-) (limited to 'man3/syslog.3') diff --git a/man3/syslog.3 b/man3/syslog.3 index e8c9dc4..7b3c663 100644 --- a/man3/syslog.3 +++ b/man3/syslog.3 @@ -15,7 +15,7 @@ .\" Modified 13 Dec 2001, Martin Schulze .\" Modified 3 Jan 2002, Michael Kerrisk .\" -.TH syslog 3 2023-07-20 "Linux man-pages 6.05.01" +.TH syslog 3 2023-10-31 "Linux man-pages 6.7" .SH NAME closelog, openlog, syslog, vsyslog \- send messages to the system logger .SH LIBRARY @@ -24,19 +24,19 @@ Standard C library .SH SYNOPSIS .nf .B #include -.PP +.P .BI "void openlog(const char *" ident ", int " option ", int " facility ); .BI "void syslog(int " priority ", const char *" format ", ...);" .B "void closelog(void);" -.PP +.P .BI "void vsyslog(int " priority ", const char *" format ", va_list " ap ); .fi -.PP +.P .RS -4 Feature Test Macro Requirements for glibc (see .BR feature_test_macros (7)): .RE -.PP +.P .BR vsyslog (): .nf Since glibc 2.19: @@ -48,7 +48,7 @@ Feature Test Macro Requirements for glibc (see .SS openlog() .BR openlog () opens a connection to the system logger for a program. -.PP +.P The string pointed to by .I ident is prepended to every message, and is typically set to the program name. @@ -58,7 +58,7 @@ is NULL, the program name is used. (POSIX.1-2008 does not specify the behavior when .I ident is NULL.) -.PP +.P The .I option argument specifies flags which control the operation of @@ -75,7 +75,7 @@ The values that may be specified for and .I facility are described below. -.PP +.P The use of .BR openlog () is optional; it will automatically be called by @@ -88,7 +88,7 @@ will default to NULL. .BR syslog () generates a log message, which will be distributed by .BR syslogd (8). -.PP +.P The .I priority argument is formed by ORing together a @@ -107,7 +107,7 @@ is used, or, if there was no preceding call, a default of .B LOG_USER is employed. -.PP +.P The remaining arguments are a .IR format , as in @@ -120,7 +120,7 @@ will be replaced by the error message string .IR strerror ( errno ). The format string need not include a terminating newline character. -.PP +.P The function .BR vsyslog () performs the same task as @@ -254,7 +254,7 @@ informational message .TP .B LOG_DEBUG debug-level message -.PP +.P The function .BR setlogmask (3) can be used to restrict logging to specified levels only. @@ -279,7 +279,6 @@ T{ .BR vsyslog () T} Thread safety MT-Safe env locale .TE -.sp 1 .SH STANDARDS .TP .BR syslog () @@ -310,7 +309,7 @@ None. .\" .I .\" mechanism, which is not compatible with .\" .IR . -.PP +.P POSIX.1-2001 specifies only the .B LOG_USER and @@ -324,7 +323,7 @@ and the other .I facility values appear on most UNIX systems. -.PP +.P The .B LOG_PERROR value for @@ -343,10 +342,10 @@ is changed, 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. -.PP +.P Never pass a string with user-supplied data as a format, use the following instead: -.PP +.P .in +4n .EX syslog(priority, "%s", string); -- cgit v1.2.3