diff options
| author | Alejandro Colomar <alx@kernel.org> | 2024-11-17 18:47:53 +0100 |
|---|---|---|
| committer | Alejandro Colomar <alx@kernel.org> | 2024-11-17 21:51:23 +0100 |
| commit | 18e7c4597c4e72fa5210c7887273e363c456c9ee (patch) | |
| tree | 97cfd22e731a4c859ae71783d70943ff72e6cb60 /man/man2/syslog.2 | |
| parent | 8fc6fdd8291d906e58a175b5e1b20da680aaeb4a (diff) | |
| download | man-pages-18e7c4597c4e.tar.gz | |
man/: Terminology consistency reforms (n, size, length)
Use 'length' for the lenght of a string.
Use 'n' for the number of elements.
Use 'size' for the number of bytes. (And in wide-character string
functions, 'size' also refers to the number of wide characters.)
The change is quite large, and I might have made some mistakes.
But overall, this should improve consistency in use of these terms.
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Diffstat (limited to 'man/man2/syslog.2')
| -rw-r--r-- | man/man2/syslog.2 | 22 |
1 files changed, 11 insertions, 11 deletions
diff --git a/man/man2/syslog.2 b/man/man2/syslog.2 index 3c9b37a03d..5f5bd34ef1 100644 --- a/man/man2/syslog.2 +++ b/man/man2/syslog.2 @@ -23,12 +23,12 @@ Standard C library .BR "#include <sys/syscall.h>" " /* Definition of " SYS_* " constants */" .B #include <unistd.h> .P -.BI "int syscall(SYS_syslog, int " type ", char *" bufp ", int " len ); +.BI "int syscall(SYS_syslog, int " type ", char *" bufp ", int " size ); .P /* The glibc interface */ .B #include <sys/klog.h> .P -.BI "int klogctl(int " type ", char *" bufp ", int " len ); +.BI "int klogctl(int " type ", char *" bufp ", int " size ); .fi .SH DESCRIPTION .IR Note : @@ -47,7 +47,7 @@ system call, which is used to control the kernel buffer; the glibc wrapper function for the system call is called .BR klogctl (). .SS The kernel log buffer -The kernel has a cyclic buffer of length +The kernel has a cyclic buffer of size .B LOG_BUF_LEN in which messages given as arguments to the kernel function .BR printk () @@ -112,7 +112,7 @@ The call executes just the "clear ring buffer" command. The .I bufp and -.I len +.I size arguments are ignored. .IP This command does not really clear the ring buffer. @@ -147,7 +147,7 @@ below. The .I bufp and -.I len +.I size arguments are ignored. .TP .BR SYSLOG_ACTION_CONSOLE_ON " (7)" @@ -170,19 +170,19 @@ below. The .I bufp and -.I len +.I size arguments are ignored. .TP .BR SYSLOG_ACTION_CONSOLE_LEVEL " (8)" The call sets .I console_loglevel to the value given in -.IR len , +.IR size , which must be an integer between 1 and 8 (inclusive). The kernel silently enforces a minimum value of .I minimum_console_loglevel for -.IR len . +.IR size . See the .I log level section for details. @@ -198,7 +198,7 @@ from the kernel log buffer via command 2 The .I bufp and -.I len +.I size arguments are ignored. .TP .BR SYSLOG_ACTION_SIZE_BUFFER " (10) (since Linux 2.6.6)" @@ -206,7 +206,7 @@ This command returns the total size of the kernel log buffer. The .I bufp and -.I len +.I size arguments are ignored. .P All commands except 3 and 10 require privilege. @@ -334,7 +334,7 @@ or for .I buf is NULL, or -.I len +.I size is less than zero; or for .I type 8, the |