147 lines
4.1 KiB
Groff
147 lines
4.1 KiB
Groff
.\" Automatically generated from an mdoc input file. Do not edit.
|
|
.\"
|
|
.\" SPDX-License-Identifier: ISC
|
|
.\"
|
|
.\" Copyright (c) 2019 Todd C. Miller <Todd.Miller@sudo.ws>
|
|
.\"
|
|
.\" Permission to use, copy, modify, and distribute this software for any
|
|
.\" purpose with or without fee is hereby granted, provided that the above
|
|
.\" copyright notice and this permission notice appear in all copies.
|
|
.\"
|
|
.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
|
|
.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
|
|
.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
|
|
.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
|
.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
|
|
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
|
|
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
|
.\"
|
|
.TH "SUDO_LOGSRVD" "@mansectsu@" "October 16, 2019" "Sudo @PACKAGE_VERSION@" "System Manager's Manual"
|
|
.nh
|
|
.if n .ad l
|
|
.SH "NAME"
|
|
\fBsudo_logsrvd\fR
|
|
\- sudo event and I/O log server
|
|
.SH "SYNOPSIS"
|
|
.HP 13n
|
|
\fBsudo_logsrvd\fR
|
|
[\fB\-hnV\fR]
|
|
[\fB\-f\fR\ \fIfile\fR]
|
|
[\fB\-R\fR\ \fIpercentage\fR]
|
|
.SH "DESCRIPTION"
|
|
\fBsudo_logsrvd\fR
|
|
is a high-performance log server that accepts event and I/O logs from
|
|
\fBsudo\fR.
|
|
It can be used to implement centralized logging of
|
|
\fBsudo\fR
|
|
logs.
|
|
Event log entries may be logged either via
|
|
syslog(3)
|
|
or to a file.
|
|
I/O Logs created by
|
|
\fBsudo_logsrvd\fR
|
|
can be replayed via the
|
|
sudoreplay(@mansectsu@)
|
|
utility in the same way as logs generated directly by the
|
|
\fBsudoers\fR
|
|
plugin.
|
|
.PP
|
|
The server also supports restarting interrupted log transfers.
|
|
To distinguish completed I/O logs from incomplete ones, the
|
|
I/O log timing file is set to be read-only when the log is complete.
|
|
.PP
|
|
Configuration parameters for
|
|
\fBsudo_logsrvd\fR
|
|
may be specified in the
|
|
sudo_logsrvd.conf(@mansectform@)
|
|
file.
|
|
.PP
|
|
The options are as follows:
|
|
.TP 12n
|
|
\fB\-f\fR, \fB\--file\fR
|
|
Read configuration from
|
|
\fIfile\fR
|
|
instead of the default,
|
|
\fI@sysconfdir@/sudo_logsrvd.conf\fR.
|
|
.TP 12n
|
|
\fB\-h\fR, \fB\--help\fR
|
|
Display a short help message to the standard output and exit.
|
|
.TP 12n
|
|
\fB\-n\fR, \fB\--no-fork\fR
|
|
Run
|
|
\fBsudo_logsrvd\fR
|
|
in the foreground instead of detaching from the terminal and becoming
|
|
a daemon.
|
|
.TP 12n
|
|
\fB\-R\fR, \fB\--random-drop\fR
|
|
For each message, there is a
|
|
\fIpercentage\fR
|
|
chance that the server will drop the connection.
|
|
This is only intended for debugging the ability of a
|
|
client to restart a connection.
|
|
.TP 12n
|
|
\fB\-V\fR, \fB\--version\fR
|
|
Print the
|
|
\fBsudo_logsrvd\fR
|
|
version and exit.
|
|
.SS "Debugging sudo_logsrvd"
|
|
\fBsudo_logsrvd\fR
|
|
supports a flexible debugging framework that is configured via
|
|
\fRDebug\fR
|
|
lines in the
|
|
sudo.conf(@mansectform@)
|
|
file.
|
|
.PP
|
|
For more information on configuring
|
|
sudo.conf(@mansectform@),
|
|
please refer to its manual.
|
|
.SH "FILES"
|
|
.TP 26n
|
|
\fI@sysconfdir@/sudo.conf\fR
|
|
Sudo front end configuration
|
|
.TP 26n
|
|
\fI@sysconfdir@/sudo_logsrvd.conf\fR
|
|
Sudo log server configuration file
|
|
.TP 26n
|
|
\fI@iolog_dir@\fR
|
|
Default I/O log file location
|
|
.SH "SEE ALSO"
|
|
sudo.conf(@mansectform@),
|
|
sudo_logsrvd.conf(@mansectform@),
|
|
sudoers(@mansectform@),
|
|
sudo(@mansectsu@),
|
|
sudo_sendlog(@mansectsu@),
|
|
sudoreplay(@mansectsu@)
|
|
.SH "AUTHORS"
|
|
Many people have worked on
|
|
\fBsudo\fR
|
|
over the years; this version consists of code written primarily by:
|
|
.sp
|
|
.RS 6n
|
|
Todd C. Miller
|
|
.RE
|
|
.PP
|
|
See the CONTRIBUTORS file in the
|
|
\fBsudo\fR
|
|
distribution (https://www.sudo.ws/contributors.html) for an
|
|
exhaustive list of people who have contributed to
|
|
\fBsudo\fR.
|
|
.SH "BUGS"
|
|
If you feel you have found a bug in
|
|
\fBsudo_logsrvd\fR,
|
|
please submit a bug report at https://bugzilla.sudo.ws/
|
|
.SH "SUPPORT"
|
|
Limited free support is available via the sudo-users mailing list,
|
|
see https://www.sudo.ws/mailman/listinfo/sudo-users to subscribe or
|
|
search the archives.
|
|
.SH "DISCLAIMER"
|
|
\fBsudo_logsrvd\fR
|
|
is provided
|
|
\(lqAS IS\(rq
|
|
and any express or implied warranties, including, but not limited
|
|
to, the implied warranties of merchantability and fitness for a
|
|
particular purpose are disclaimed.
|
|
See the LICENSE file distributed with
|
|
\fBsudo\fR
|
|
or https://www.sudo.ws/license.html for complete details.
|