syslog.2: Add kernel symbolic 'type' names

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

diff --git a/man2/syslog.2 b/man2/syslog.2
index 3612b543c627aa2ab6430c1608fa78af8eb2ac58..6ebc3d2a0247ab4417d437610e6f91970f3c569d 100644 (file)
--- a/man2/syslog.2
+++ b/man2/syslog.2
@@ -53,23 +53,47 @@ The system call of this name is about controlling the kernel
 buffer, and the glibc wrapper function is called
 .BR klogctl ().
 
-The \fItype\fP argument determines the action taken by this function,
-as follows:
-
-.nf
-      0 \-\- Close the log.  Currently a NOP.
-      1 \-\- Open the log. Currently a NOP.
-      2 \-\- Read from the log.
-      3 \-\- Read all messages remaining in the ring buffer.
-      4 \-\- Read and clear all messages remaining in the ring buffer
-      5 \-\- Clear ring buffer.
-      6 \-\- Disable printk to console
-      7 \-\- Enable printk to console
-      8 \-\- Set level of messages printed to console
-      9 \-\- Return number of unread characters in the log buffer
-     10 \-\- Return size of the log buffer
+The \fItype\fP argument determines the action taken by this function.
+The list below specifies the values for
+.IR type .
+The symbolic names are defined in the kernel source,
+but are not exported to user space;
+you will either need to use the numbers, or define the names yourself.)
+.TP
+.BR SYSLOG_ACTION_CLOSE " (0)"
+Close the log.  Currently a NOP.
+.TP
+.BR SYSLOG_ACTION_OPEN " (1)"
+Open the log. Currently a NOP.
+.TP
+.BR SYSLOG_ACTION_READ " (2)"
+Read from the log.
+.TP
+.BR SYSLOG_ACTION_READ_ALL " (3)"
+Read all messages remaining in the ring buffer.
+.TP
+.BR SYSLOG_ACTION_READ_CLEAR " (4)"
+Read and clear all messages remaining in the ring buffer
+.TP
+.BR SYSLOG_ACTION_CLEAR " (5)"
+Clear ring buffer.
+.TP
+.BR SYSLOG_ACTION_CONSOLE_OFF " (6)"
+Disable printk to console
+.TP
+.BR SYSLOG_ACTION_CONSOLE_ON " (7)"
+Enable printk to console
+.TP
+.BR SYSLOG_ACTION_CONSOLE_LEVEL " (8)"
+Set level of messages printed to console
+.TP
+.BR SYSLOG_ACTION_SIZE_UNREAD " (9)"
+Return number of unread characters in the log buffer
+.TP
+.BR SYSLOG_ACTION_SIZE_BUFFER " (10)"
+Return size of the log buffer
 .fi
-
+.PP
 Type 9 was added in Linux 2.4.10; type 10 in Linux 2.6.6.
 
 In Linux kernels before 2.6.37,