diff options
| author | Stefano Brivio <sbrivio@redhat.com> | 2022-10-06 14:51:04 +0200 |
|---|---|---|
| committer | Stefano Brivio <sbrivio@redhat.com> | 2022-10-14 17:38:28 +0200 |
| commit | 01efc71ddd2523594b94e8be00d9e51d6cdd6130 (patch) | |
| tree | e95bd46620cd1669b02fafbfda0b9da40fd35268 /passt.1 | |
| parent | f4e1e88e1dce3a25f3cdd8d52a1f097236911e70 (diff) | |
| download | passt-01efc71ddd2523594b94e8be00d9e51d6cdd6130.tar passt-01efc71ddd2523594b94e8be00d9e51d6cdd6130.tar.gz passt-01efc71ddd2523594b94e8be00d9e51d6cdd6130.tar.bz2 passt-01efc71ddd2523594b94e8be00d9e51d6cdd6130.tar.lz passt-01efc71ddd2523594b94e8be00d9e51d6cdd6130.tar.xz passt-01efc71ddd2523594b94e8be00d9e51d6cdd6130.tar.zst passt-01efc71ddd2523594b94e8be00d9e51d6cdd6130.zip | |
log, conf: Add support for logging to file
In some environments, such as KubeVirt pods, we might not have a
system logger available. We could choose to run in foreground, but
this takes away the convenient synchronisation mechanism derived from
forking to background when interfaces are ready.
Add optional logging to file with -l/--log-file and --log-size.
Unfortunately, this means we need to duplicate features that are more
appropriately implemented by a system logger, such as rotation. Keep
that reasonably simple, by using fallocate() with range collapsing
where supported (Linux kernel >= 3.15, extent-based ext4 and XFS) and
falling back to an unsophisticated block-by-block moving of entries
toward the beginning of the file once we reach the (mandatory) size
limit.
While at it, clarify the role of LOG_EMERG in passt.c.
Signed-off-by: Stefano Brivio <sbrivio@redhat.com>
Reviewed-by: David Gibson <david@gibson.dropbear.id.au>
Diffstat (limited to 'passt.1')
| -rw-r--r-- | passt.1 | 14 |
1 files changed, 12 insertions, 2 deletions
@@ -79,7 +79,7 @@ for performance reasons. .TP .BR \-d ", " \-\-debug -Be verbose, don't run in background. +Be verbose, don't run in background, don't log to the system logger. .TP .BR \-\-trace @@ -99,10 +99,20 @@ Default is to fork into background. .TP .BR \-e ", " \-\-stderr Log to standard error too. -Default is to log to system logger only, if started from an interactive +Default is to log to the system logger only, if started from an interactive terminal, and to both system logger and standard error otherwise. .TP +.BR \-l ", " \-\-log-file " " \fIPATH\fR +Log to file \fIPATH\fR, not to standard error, and not to the system logger. + +.TP +.BR \-\-log-size " " \fISIZE\fR +Limit log file size to \fISIZE\fR bytes. When the log file is full, make room +for new entries by removing old ones at the beginning. This limit is mandatory. +Default is 1048576 (1 MiB). + +.TP .BR \-\-runas " " \fIUID\fR|\fIUID:GID\fR|\fILOGIN\fR|\fILOGIN:GROUP\fR Attempt to change to given UID and corresponding group if UID is given, or to given UID and given GID if both are given. Alternatively, login name, or |