diff options
Diffstat (limited to 'misc-utils/logger.1')
-rw-r--r-- | misc-utils/logger.1 | 35 |
1 files changed, 31 insertions, 4 deletions
diff --git a/misc-utils/logger.1 b/misc-utils/logger.1 index 9e83a0b53..3530cd9e8 100644 --- a/misc-utils/logger.1 +++ b/misc-utils/logger.1 @@ -50,6 +50,8 @@ given either, then standard input is logged. .BR \-d , " \-\-udp" Use datagrams (UDP) only. By default the connection is tried to the syslog port defined in /etc/services, which is often 514 . +.sp +See also \fB\-\-server\fR and \fB\-\-socket\fR to specify where to connect. .TP .BR \-e , " \-\-skip-empty" Ignore empty lines when processing files. An empty line @@ -108,6 +110,10 @@ execution of will display MESSAGE field. Use .B journalctl \-\-output json-pretty to see rest of the fields. +.sp +To include newlines in MESSAGE, specify MESSAGE several times. This is +handled as a special case, other fields will be stored as an array in +the journal if they appear multiple times. .TP .BR \-\-msgid " \fImsgid Sets the RFC5424 MSGID field. Note that the space character is not permitted @@ -224,7 +230,7 @@ produces: .fi .IP .TP -.BR \-\-size " \fIsize +.BR \-S , " -\-size " \fIsize Sets the maximum permitted message size to \fIsize\fR. The default is 1KiB characters, which is the limit traditionally used and specified in RFC 3164. With RFC 5424, this limit has become flexible. A good assumption @@ -265,6 +271,8 @@ Use stream (TCP) only. By default the connection is tried to the .I syslog-conn port defined in /etc/services, which is often .IR 601 . +.sp +See also \fB\-\-server\fR and \fB\-\-socket\fR to specify where to connect. .TP .BR \-t , " \-\-tag " \fItag Mark every line to be logged with the specified @@ -293,15 +301,18 @@ utility exits 0 on success, and >0 if an error occurs. .SH FACILITIES AND LEVELS Valid facility names are: .IP +.nr WI \n(.lu-\n(.iu-\w'\fBauthpriv\fR'u-3n .TS tab(:); -left l l. +l lw(\n(WIu). \fBauth \fBauthpriv\fR:for security information of a sensitive nature \fBcron \fBdaemon \fBftp -\fBkern\fR:cannot be generated from userspace process, automatically converted to \fBuser +\fBkern\fR:T{ +cannot be generated from userspace process, automatically converted to \fBuser +T} \fBlpr \fBmail \fBnews @@ -318,7 +329,7 @@ Valid level names are: .IP .TS tab(:); -left l l. +l l. \fBemerg \fBalert \fBcrit @@ -348,6 +359,22 @@ For the priority order and intended purposes of these facilities and levels, see The .B logger command is expected to be IEEE Std 1003.2 ("POSIX.2") compatible. +.SH AUTHORS +The +.B logger +command +was originally written by University of California in 1983-1993 and later +rewritten by +.MT kzak@redhat.com +Karel Zak +.ME , +.MT rgerhards@adiscon.com +Rainer Gerhards +.ME +and +.MT kerolasa@iki.fi +Sami Kerola +.ME . .SH AVAILABILITY The logger command is part of the util-linux package and is available from .UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util-linux/ |