Re: [PATCH] syslog: document new return values

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Jeremy Kerr wrote:
> .. also, add entries for type==9 and type==10 to the RETURN VALUES
> section.
> 
> Signed-off-by: Jeremy Kerr <jk@xxxxxxxxxx>
> 
> ---
> 
>  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@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux