[prev in list] [next in list] [prev in thread] [next in thread]
List: linux-man
Subject: Re: [PATCH] syslog: document new return values
From: Michael Kerrisk <mtk.manpages () googlemail ! com>
Date: 2008-02-14 18:54:14
Message-ID: 47B48E56.20001 () gmail ! com
[Download RAW message or body]
Jeremy Kerr wrote:
> .. also, add entries for type==9 and type==10 to the RETURN VALUES
> section.
>
> Signed-off-by: Jeremy Kerr <jk@ozlabs.org>
>
> ---
>
> man2/syslog.2 | 7 ++++++-
> 1 file changed, 6 insertions(+), 1 deletion(-)
>
> Index: man-pages-2.77/man2/syslog.2
> ===================================================================
> --- man-pages-2.77.orig/man2/syslog.2
> +++ man-pages-2.77/man2/syslog.2
> @@ -195,7 +195,12 @@ Otherwise,
> for \fItype\fP equal to 2, 3 or 4,
> .BR syslog ()
> returns the number
> -of bytes read, and otherwise 0.
> +of bytes read,
> +for \fItype\fP equal to 9,
> +the number of number of unread characters in the log buffer,
> +for \fItype\fP equal to 10,
> +the total size of the log buffer,
> +and otherwise 0.
> .SH ERRORS
> .TP
> .B EINVAL
Hi Jeremy,
Thanks. I applied something like this (did a little reworking of that
section) for man-pages-2.79.
Cheers,
Michael
.SH "RETURN VALUE"
-In case of error, \-1 is returned, and \fIerrno\fP is set.
-Otherwise,
-for \fItype\fP equal to 2, 3 or 4,
+For \fItype\fP equal to 2, 3, or 4, a successful call to
.BR syslog ()
returns the number
-of bytes read, and otherwise 0.
+of bytes read.
+For \fItype\fP 9,
+.BR syslog ()
+returns the number of bytes currently
+available to be read on the kernel log buffer.
+For \fItype\fP 10,
+.BR syslog ()
+returns the total size of the kernel log buffer.
+For other values of \fItype\fP, 0 is returned on success.
+
+In case of error, \-1 is returned,
+and \fIerrno\fP is set to indicate the error.
--
Michael Kerrisk
Maintainer of the Linux man-pages project
http://www.kernel.org/doc/man-pages/
Want to report a man-pages bug? Look here:
http://www.kernel.org/doc/man-pages/reporting_bugs.html
-
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at http://vger.kernel.org/majordomo-info.html
[prev in list] [next in list] [prev in thread] [next in thread]
Configure |
About |
News |
Add a list |
Sponsored by KoreLogic