Hi, there are several improvements for the sendsyslog(2) man page floating around. I have put them into a single diff. Do we want all of them?
bluhm Index: lib/libc/sys/sendsyslog.2 =================================================================== RCS file: /data/mirror/openbsd/cvs/src/lib/libc/sys/sendsyslog.2,v retrieving revision 1.6 diff -u -p -r1.6 sendsyslog.2 --- lib/libc/sys/sendsyslog.2 21 Mar 2016 22:41:28 -0000 1.6 +++ lib/libc/sys/sendsyslog.2 21 Mar 2016 23:54:55 -0000 @@ -28,34 +28,42 @@ .Sh DESCRIPTION The .Fn sendsyslog -functions is used to transmit a +function is used to transmit a .Xr syslog 3 -formatted message direct to +formatted message directly to .Xr syslogd 8 without requiring the allocation of a socket. -.Pp -The -.Fa flags -argument of -.Fn sendsyslog -accepts the -.Dv LOG_CONS -flag. If .Dv LOG_CONS -is specified, and +is specified in the +.Fa flags +argument, and .Xr syslogd 8 is not accepting messages, the message will be sent directly to the console. This is used internally by .Xr syslog_r 3 , so that messages can be sent during difficult situations. +If sending to +.Xr syslogd 8 +fails, dropped messages are counted. +When +.Xr syslogd 8 +works again, a warning with the counter and error number is logged. .Sh RETURN VALUES .Rv -std .Sh ERRORS .Fn sendsyslog can fail if: .Bl -tag -width Er +.It Bq Er EFAULT +An invalid user space address was specified for a parameter. +.It Bq Er EMSGSIZE +The socket requires that message be sent atomically, and the size +of the message to be sent made this impossible. +.It Bq Er ENOBUFS +The system was unable to allocate an internal buffer. +The operation may succeed when buffers become available. .It Bq Er ENOTCONN The message cannot be sent, likely because .Xr syslogd 8 @@ -69,3 +77,7 @@ The .Fn sendsyslog function call appeared in .Ox 5.6 . +The +.Fa flags +argument was added in +.Ox 6.0 .
