]> git.ipfire.org Git - thirdparty/util-linux.git/commitdiff
logger man page: update --size doc
authorRainer Gerhards <rgerhards@adiscon.com>
Sat, 7 Mar 2015 11:04:43 +0000 (12:04 +0100)
committerKarel Zak <kzak@redhat.com>
Thu, 12 Mar 2015 09:20:53 +0000 (10:20 +0100)
now we have strict sizes

Signed-off-by: Karel Zak <kzak@redhat.com>
misc-utils/logger.1

index b73f46a9a1e458f541e34852ab79ef96f3dbf040..164c5f49c1ee82c9ba4e9d6cbc86561e823bc4f4 100644 (file)
@@ -97,10 +97,13 @@ Most receivers accept larger than 1KiB message over any type of syslog
 protocol. As such, the \fB\-\-size\fR option affects logger in
 all cases (not only when \fB\-\-rfc5424\fR was used).
 
-Note: the message size limit is not totally strict. It limits only
-the user data, the size of the syslog header is not considered. While
-this can lead to some truncation at the receiver level, a consistent limit
-based on the user data size is generally wanted.
+Note: the message size limit limits the overall message size, including
+the syslog header. Header sizes vary depending on options selected and hostname
+length. As a rule of thumb, headers are usually not longer than 50 to 80
+characters. When selecting maximum message size, it is important to ensure
+that the receiver supports the max size as well, otherwise messages may
+become truncated. Again, as a rule of thumb two to four KiB message size
+should generally be OK, whereas anything larger should be verified to work.
 
 .TP
 .BR \-n , " \-\-server " \fIserver