sudo_logsrvd.conf(5) — Linux manual page

NAME | DESCRIPTION | FILES | EXAMPLES | SEE ALSO | AUTHORS | BUGS | SUPPORT | DISCLAIMER | COLOPHON

SUDO_LOGSRVD.CONF(5)       File Formats Manual      SUDO_LOGSRVD.CONF(5)

NAME         top

       sudo_logsrvd.conf — configuration for sudo_logsrvd

DESCRIPTION         top

       The sudo_logsrvd.conf file is used to configure the sudo_logsrvd
       log server.  It uses an INI-style format made up of sections in
       square brackets and “key = value” pairs specific to each section
       below the section name.  Depending on the key, values may be
       integers, booleans, or strings.  Section and key names are not
       case sensitive, but values are.

       The pound sign (‘#’) is used to indicate a comment.  Both the
       comment character and any text after it, up to the end of the
       line, are ignored.  Lines beginning with a semi-colon (‘;’) are
       also ignored.

       Long lines can be continued with a backslash (‘\’) as the last
       character on the line.  Leading white space is removed from the
       beginning of lines even when the continuation character is used.

       The “EXAMPLES” section contains a copy of the default
       sudo_logsrvd.conf file.

       The following configuration sections are recognized:

        server
        relay
        iolog
        eventlog
        syslog
        logfile

       Each section is described in detail below.

   server
       The server section configures the address and port the server
       will listen on.  The following keys are recognized:

       listen_address = host[:port][(tls)]
             The host name or IP address, optional port to listen on and
             an optional Transport Layer Security (TLS) flag in
             parentheses.

             The host may be a host name, an IPv4 address, an IPv6
             address in square brackets or the wild card entry ‘*’.  A
             host setting of ‘*’ will cause sudo_logsrvd to listen on
             all configured network interfaces.

             If the optional tls flag is present, sudo_logsrvd will
             secure the connection with TLS version 1.2 or 1.3.
             Versions of TLS prior to 1.2 are not supported.  See
             sudo_logsrvd(8) for details on generating TLS keys and
             certificates.

             If a port is specified, it may either be a port number or a
             known service name as defined by the system service name
             database.  If no port is specified, port 30343 will be used
             for plaintext connections and port 30344 will be used for
             TLS connections.

             The default value is:
                   listen_address = *:30343
                   listen_address = *:30344(tls)
             which will listen on all configured network interfaces for
             both plaintext and TLS connections.  Multiple
             listen_address lines may be specified to listen on more
             than one port or interface.

       server_log = string
             Where to log server warning and error messages.  Supported
             values are none, stderr, syslog, or a path name beginning
             with the ‘/’ character.  A value of stderr is only
             effective when used in conjunction with the -n option.  The
             default value is syslog.

       pid_file = path
             The path to the file containing the process ID of the
             running sudo_logsrvd.  If set to an empty value, or if
             sudo_logsrvd is run with the -n option, no pid_file will be
             created.  If pid_file refers to a symbolic link, it will be
             ignored.  The default value is /run/sudo/sudo_logsrvd.pid.

       tcp_keepalive = boolean
             If true, sudo_logsrvd will enable the TCP keepalive socket
             option on the client connection.  This enables the periodic
             transmission of keepalive messages to the client.  If the
             client does not respond to a message in time, the
             connection will be closed.  Defaults to true.

       timeout = number
             The amount of time, in seconds, sudo_logsrvd will wait for
             the client to respond.  A value of 0 will disable the
             timeout.  The default value is 30.

       tls_cacert = path
             The path to a certificate authority bundle file, in PEM
             format, to use instead of the system's default certificate
             authority database when authenticating clients.  The
             default is to use /etc/ssl/sudo/cacert.pem if it exists,
             otherwise the system's default certificate authority
             database is used.

       tls_cert = path
             The path to the server's certificate file, in PEM format.
             The default value is /etc/ssl/sudo/certs/logsrvd_cert.pem.

       tls_checkpeer = bool
             If true, client certificates will be validated by
             sudo_logsrvd; clients without a valid certificate will be
             unable to connect.  If false, no validation of client
             certificates will be performed.  It true and client
             certificates are created using a private certificate
             authority, the tls_cacert setting must be set to a CA
             bundle that contains the CA certificate used to generate
             the client certificate.  The default value is false.

       tls_ciphers_v12 = string
             A list of ciphers to use for connections secured by TLS
             version 1.2 only, separated by a colon ‘:’.  See the
             “CIPHER LIST FORMAT” section in openssl-ciphers(1) for full
             details.  The default value is “HIGH:!aNULL” which consists
             of encryption cipher suites with key lengths larger than
             128 bits, and some cipher suites with 128-bit keys.  Cipher
             suites that offer no authentication are excluded.

       tls_ciphers_v13 = string
             A list of ciphers to use for connections secured by TLS
             version 1.3 only, separated by a colon ‘:’.  Supported
             cipher suites depend on the version of OpenSSL used, but
             should include the following:

                   TLS_AES_128_GCM_SHA256
                   TLS_AES_256_GCM_SHA384
                   TLS_CHACHA20_POLY1305_SHA256
                   TLS_AES_128_CCM_SHA256
                   TLS_AES_128_CCM_8_SHA256

             The default cipher suite is “TLS_AES_256_GCM_SHA384”.

       tls_dhparams = path
             The path to a file containing custom Diffie-Hellman
             parameters in PEM format.  This file can be created with
             the following command:

             openssl dhparam -out /etc/sudo_logsrvd_dhparams.pem 2048

             By default, sudo_logsrvd will use the OpenSSL defaults for
             Diffie-Hellman key generation.

       tls_key = path
             The path to the server's private key file, in PEM format.
             The default value is /etc/ssl/sudo/private/logsrvd_key.pem.

       tls_verify = bool
             If true, sudo_logsrvd will validate its own certificate at
             startup time or when the configuration is changed.  If
             false, no verification is performed of the server
             certificate.  When using self-signed certificates without a
             certificate authority, this setting should be set to false.
             The default value is true.

   relay
       The relay section configures the optional logsrv relay host and
       port the server will connect to.  The TLS configuration keys are
       optional, by default the corresponding keys in the “server”
       section will be used.  They are only present in this section to
       make it possible for the relay connection to use a different set
       of TLS parameters from the client-facing server.  The following
       keys are recognized:

       connect_timeout = number
             The amount of time, in seconds, sudo_logsrvd will wait for
             the connection to a relay_host (see below) to complete.
             Once the connection is complete, the timeout setting
             controls the amount of time sudo_logsrvd will wait for the
             relay to respond.  A value of 0 will disable the timeout.
             The default value is 30.

       relay_dir = path
             The directory in which log messages are temporarily stored
             before they are sent to the relay host.  Messages are
             stored in the wire format specified by sudo_logsrv.proto(5)
             The default value is /var/log/sudo_logsrvd.

       relay_host = host[:port][(tls)]
             The relay host name or IP address, optional port to connect
             to and an optional Transport Layer Security (TLS) flag in
             parentheses.  The syntax is identical to listen_address in
             the “server” section with one exception: the wild card ‘*’
             syntax is not supported.

             When this setting is enabled, messages from the client will
             be forwarded to one of the specified relay hosts instead of
             being stored locally.  The host could be running an
             instance of sudo_logsrvd or another server that supports
             the sudo_logsrv.proto(5) protocol.

             If multiple relay_host lines are specified, the first
             available relay host will be used.

       retry_interval = number
             The number of seconds to wait after a connection error
             before making a new attempt to forward a message to a relay
             host.  The default value is 30.

       store_first = boolean
             If true, sudo_logsrvd will store logs locally before
             relaying them.  Once the log is complete, a connection to
             the relay host is opened and the log is relayed.  If the
             network connection is interrupted before the log can be
             fully transferred, it will be retransmitted later.  The
             default is to relay logs in real-time.

       tcp_keepalive = boolean
             If true, sudo_logsrvd will enable the TCP keepalive socket
             option on the relay connection.  This enables the periodic
             transmission of keepalive messages to the relay server.  If
             the relay does not respond to a message in time, the
             connection will be closed.

       timeout = number
             The amount of time, in seconds, sudo_logsrvd will wait for
             the relay server to respond after a connection has
             succeeded.  A value of 0 will disable the timeout.  The
             default value is 30.

       tls_cacert = path
             The path to a certificate authority bundle file, in PEM
             format, to use instead of the system's default certificate
             authority database when authenticating clients.  The
             default is to use the value specified in the “server”
             section, or the system's default certificate authority
             database if no value is set.

       tls_cert = path
             The path to the server's certificate file, in PEM format.
             The default is to use the value specified in the “server”
             section.

       tls_checkpeer = bool
             If true, the relay host's certificate will be validated by
             sudo_logsrvd; connections to a relay without a valid
             certificate will fail.  If false, no validation of relay
             certificates will be performed.  It true and relay
             certificates are created using a private certificate
             authority, the tls_cacert setting must be set to a CA
             bundle that contains the CA certificate used to generate
             the relay certificate.  The default is to use the value
             specified in the “server” section.

       tls_ciphers_v12 = string
             A list of ciphers to use for connections secured by TLS
             version 1.2 only, separated by a colon ‘:’.  See the
             “CIPHER LIST FORMAT” section in openssl-ciphers(1) for full
             details.  The default is to use the value specified in the
             “server” section.

       tls_ciphers_v13 = string
             A list of ciphers to use for connections secured by TLS
             version 1.3 only, separated by a colon ‘:’.  Supported
             cipher suites depend on the version of OpenSSL used, see
             the “server” section for more information.  The default is
             to use the value specified in the “server” section.

       tls_dhparams = path
             The path to a file containing custom Diffie-Hellman
             parameters in PEM format.  The default is to use the value
             specified in the “server” section.

       tls_key = path
             The path to the server's private key file, in PEM format.
             The default is to use the value specified in the “server”
             section.

       tls_verify = bool
             If true, the server's certificate used for relaying will be
             verified at startup.  If false, no verification is
             performed of the server certificate.  When using self-
             signed certificates without a certificate authority, this
             setting should be set to false.  The default is to use the
             value specified in the “server” section.

   iolog
       The iolog section configures I/O log parameters.  These settings
       are identical to the I/O configuration in sudoers(5).  The
       following keys are recognized:

       iolog_compress = boolean
             If set, I/O logs will be compressed using zlib.  Enabling
             compression can make it harder to view the logs in real-
             time as the program is executing due to buffering.  The
             default value is false.

       iolog_dir = path
             The top-level directory to use when constructing the path
             name for the I/O log directory.  The session sequence
             number, if any, is stored in the directory.  The default
             value is /var/log/sudo-io.

             The following percent (‘%’) escape sequences are supported:

             %{seq}
                   expanded to a monotonically increasing base-36
                   sequence number, such as 0100A5, where every two
                   digits are used to form a new directory, e.g.,
                   01/00/A5

             %{user}
                   expanded to the invoking user's login name

             %{group}
                   expanded to the name of the invoking user's real
                   group-ID

             %{runas_user}
                   expanded to the login name of the user the command
                   will be run as (e.g., root)

             %{runas_group}
                   expanded to the group name of the user the command
                   will be run as (e.g., wheel)

             %{hostname}
                   expanded to the local host name without the domain
                   name

             %{command}
                   expanded to the base name of the command being run

             In addition, any escape sequences supported by the system's
             strftime(3) function will be expanded.

             To include a literal ‘%’ character, the string ‘%%’ should
             be used.

       iolog_file = path
             The path name, relative to iolog_dir, in which to store I/O
             logs.  It is possible for iolog_file to contain directory
             components.  The default value is “%{seq}”.

             See the iolog_dir setting above for a list of supported
             percent (‘%’) escape sequences.

             In addition to the escape sequences, path names that end in
             six or more Xs will have the Xs replaced with a unique
             combination of digits and letters, similar to the mktemp(3)
             function.

             If the path created by concatenating iolog_dir and
             iolog_file already exists, the existing I/O log file will
             be truncated and overwritten unless iolog_file ends in six
             or more Xs.

       iolog_flush = boolean
             If set, I/O log data is flushed to disk after each write
             instead of buffering it.  This makes it possible to view
             the logs in real-time as the program is executing but may
             significantly reduce the effectiveness of I/O log
             compression.  I/O logs are always flushed before sending a
             commit point to the client regardless of this setting.  The
             default value is true.

       iolog_group = name
             The group name to look up when setting the group-ID on new
             I/O log files and directories.  If iolog_group is not set,
             the primary group-ID of the user specified by iolog_user is
             used. If neither iolog_group nor iolog_user are set, I/O
             log files and directories are created with group-ID 0.

       iolog_mode = mode
             The file mode to use when creating I/O log files.  Mode
             bits for read and write permissions for owner, group, or
             other are honored, everything else is ignored.  The file
             permissions will always include the owner read and write
             bits, even if they are not present in the specified mode.
             When creating I/O log directories, search (execute) bits
             are added to match the read and write bits specified by
             iolog_mode.  The default value is 0600.

       iolog_user = name
             The user name to look up when setting the owner of new I/O
             log files and directories.  If iolog_group is set, it will
             be used instead of the user's primary group-ID.  By
             default, I/O log files and directories are created with
             user and group-ID 0.

       log_passwords = bool
             Most programs that require a user's password will disable
             echo before reading the password to avoid displaying the
             plaintext password on the screen.  However, if terminal
             input is being logged, the password will still be present
             in the I/O log.  If log_passwords is set to false,
             sudo_logsrvd will attempt to prevent passwords from being
             logged.  It does this by using the regular expressions in
             passprompt_regex to match a password prompt in the terminal
             output buffer.  When a match is found, input characters in
             the I/O log will be replaced with ‘*’ until either a line
             feed or carriage return is found in the terminal input or a
             new terminal output buffer is received.  If, however, a
             program displays characters as the user types them (such as
             sudo when the pwfeedback option is set), only the first
             character of the password will be replaced in the I/O log.
             The default value is true.

       maxseq = number
             The maximum sequence number that will be substituted for
             the “%{seq}” escape in the I/O log file (see the iolog_dir
             description above for more information).  While the value
             substituted for “%{seq}” is in base 36, maxseq itself
             should be expressed in decimal.  Values larger than
             2176782336 (which corresponds to the base 36 sequence
             number “ZZZZZZ”) will be silently truncated to 2176782336.
             The default value is 2176782336.

       passprompt_regex = string
             One or more POSIX extended regular expressions used to
             match password prompts in the terminal output when
             log_passwords is disabled.  As an extension, if the regular
             expression begins with “(?i)”, it will be matched in a
             case-insensitive manner.  Multiple passprompt_regex
             settings may be specified.  Each regular expression is
             limited to 1024 characters.  The default value is
             “[Pp]assword[: ]*”.

   eventlog
       The eventlog section configures how (and if) security policy
       events are logged.

       log_type = string
             Where to log accept, reject, and alert events reported by
             the policy.  Supported values are syslog, logfile, and
             none.  The default value is syslog.

       log_exit = boolean
             If true, sudo_logsrvd will log an event when a command
             exits or is terminated by a signal.  Defaults to false.

       log_format = string
             The event log format.  Supported log formats are:

             json  Currently, this is an alias for json_pretty.  In a
                   future version of sudo_logsrvd, json will be
                   equivalent to json_compact.  JSON log entries contain
                   the full contents of the accept, reject, exit and
                   alert messages.

             json_compact
                   Log events in “compact” (minified) JSON format.  Each
                   event is written as a separate JSON object on single
                   line without extraneous white space.  Due to
                   limitations of the protocol, JSON events sent via
                   syslog may be truncated.

             json_pretty
                   Log events in “pretty” JSON format.  When logging to
                   a file, the entire file is treated as a single JSON
                   object consisting of multiple events, each event
                   spanning multiple lines.  When logging via syslog,
                   there is no difference between the json_pretty and
                   json_compact formats.

             sudo  Log events in traditional sudo-style log format.  See
                   the EVENT LOGGING section in sudoers(5) for details.

             The default value is sudo.

   syslog
       The syslog section configures how events are logged via
       syslog(3).

       facility = string
             Syslog facility if syslog is being used for logging.
             Defaults to authpriv.

             The following syslog facilities are supported: authpriv (if
             your OS supports it), auth, daemon, user, local0, local1,
             local2, local3, local4, local5, local6, and local7.

       accept_priority = string
             Syslog priority to use when the user is allowed to run a
             command and authentication is successful.  Defaults to
             notice.

             The following syslog priorities are supported: alert, crit,
             debug, emerg, err, info, notice, warning, and none.
             Setting it to a value of none will disable logging of
             successful commands.

       reject_priority = string
             Syslog priority to use when the user is not allowed to run
             a command or when authentication is unsuccessful.  Defaults
             to alert.

             See accept_priority for the list of supported syslog
             priorities.

       alert_priority = string
             Syslog priority to use for event log alert messages
             received from the client.  Defaults to alert.

             See accept_priority for the list of supported syslog
             priorities.

       maxlen = number
             On many systems, syslog(3) has a relatively small log
             buffer.  IETF RFC 5424 states that syslog servers must
             support messages of at least 480 bytes and should support
             messages up to 2048 bytes.  By default, sudo_logsrvd
             creates log messages up to 960 bytes which corresponds to
             the historic BSD syslog implementation which used a 1024
             byte buffer to store the message, date, hostname, and
             program name.

             To prevent syslog messages from being truncated,
             sudo_logsrvd will split up sudo-style log messages that are
             larger than maxlen bytes.  When a message is split,
             additional parts will include the string “(command
             continued)” after the user name and before the continued
             command line arguments.  JSON-format log entries are never
             split and are not affected by maxlen.

       server_facility = string
             Syslog facility if syslog is being used for server warning
             messages.  See above for a list of supported facilities.
             Defaults to daemon

   logfile
       The logfile section consists of settings related to logging to a
       plain file (not syslog).

       path = string
             The path to the file-based event log.  This path must be
             fully-qualified and start with a ‘/’ character.  The
             default value is /var/log/sudo.log.

       time_format = string
             The string used when formatting the date and time for file-
             based event logs.  Formatting is performed via the system's
             strftime(3) function so any escape sequences supported by
             that function will be expanded.  The default value is “%h
             %e %T” which produces dates like “Oct 3 07:15:24” in the
             ‘C’ locale.

FILES         top

       /etc/sudo_logsrvd.conf    Sudo log server configuration file

EXAMPLES         top

       #
       # sudo logsrv daemon configuration
       #

       [server]
       # The host name or IP address and port to listen on with an optional TLS
       # flag.  If no port is specified, port 30343 will be used for plaintext
       # connections and port 30344 will be used to TLS connections.
       # The following forms are accepted:
       #   listen_address = hostname(tls)
       #   listen_address = hostname:port(tls)
       #   listen_address = IPv4_address(tls)
       #   listen_address = IPv4_address:port(tls)
       #   listen_address = [IPv6_address](tls)
       #   listen_address = [IPv6_address]:port(tls)
       #
       # The (tls) suffix should be omitted for plaintext connections.
       #
       # Multiple listen_address settings may be specified.
       # The default is to listen on all addresses.
       #listen_address = *:30343
       #listen_address = *:30344(tls)

       # The file containing the ID of the running sudo_logsrvd process.
       #pid_file = /run/sudo/sudo_logsrvd.pid

       # Where to log server warnings: none, stderr, syslog, or a path name.
       #server_log = syslog

       # If true, enable the SO_KEEPALIVE socket option on client connections.
       # Defaults to true.
       #tcp_keepalive = true

       # The amount of time, in seconds, the server will wait for the client to
       # respond.  A value of 0 will disable the timeout.  The default value is 30.
       #timeout = 30

       # If true, the server will validate its own certificate at startup.
       # Defaults to true.
       #tls_verify = true

       # If true, client certificates will be validated by the server;
       # clients without a valid certificate will be unable to connect.
       # By default, client certs are not checked.
       #tls_checkpeer = false

       # Path to a certificate authority bundle file in PEM format to use
       # instead of the system's default certificate authority database.
       #tls_cacert = /etc/ssl/sudo/cacert.pem

       # Path to the server's certificate file in PEM format.
       # Required for TLS connections.
       #tls_cert = /etc/ssl/sudo/certs/logsrvd_cert.pem

       # Path to the server's private key file in PEM format.
       # Required for TLS connections.
       #tls_key = /etc/ssl/sudo/private/logsrvd_key.pem

       # TLS cipher list (see "CIPHER LIST FORMAT" in the openssl-ciphers manual).
       # This setting is only effective if the negotiated protocol is TLS version
       # 1.2.  The default cipher list is HIGH:!aNULL.
       #tls_ciphers_v12 = HIGH:!aNULL

       # TLS cipher list if the negotiated protocol is TLS version 1.3.
       # The default cipher list is TLS_AES_256_GCM_SHA384.
       #tls_ciphers_v13 = TLS_AES_256_GCM_SHA384

       # Path to the Diffie-Hellman parameter file in PEM format.
       # If not set, the server will use the OpenSSL defaults.
       #tls_dhparams = /etc/ssl/sudo/logsrvd_dhparams.pem

       [relay]
       # The host name or IP address and port to send logs to in relay mode.
       # The syntax is identical to listen_address with the exception of
       # the wild card ('*') syntax.  When this setting is enabled, logs will
       # be relayed to the specified host instead of being stored locally.
       # This setting is not enabled by default.
       #relay_host = relayhost.dom.ain
       #relay_host = relayhost.dom.ain(tls)

       # The amount of time, in seconds, the server will wait for a connection
       # to the relay server to complete.  A value of 0 will disable the timeout.
       # The default value is 30.
       #connect_timeout = 30

       # The directory to store messages in before they are sent to the relay.
       # Messages are stored in wire format.
       # The default value is /var/log/sudo_logsrvd.
       #relay_dir = /var/log/sudo_logsrvd

       # The number of seconds to wait after a connection error before
       # making a new attempt to forward a message to a relay host.
       # The default value is 30.
       #retry_interval = 30

       # Whether to store the log before relaying it.  If true, enable store
       # and forward mode.  If false, the client connection is immediately
       # relayed.  Defaults to false.
       #store_first = true

       # If true, enable the SO_KEEPALIVE socket option on relay connections.
       # Defaults to true.
       #tcp_keepalive = true

       # The amount of time, in seconds, the server will wait for the relay to
       # respond.  A value of 0 will disable the timeout.  The default value is 30.
       #timeout = 30

       # If true, the server's relay certificate will be verified at startup.
       # The default is to use the value in the [server] section.
       #tls_verify = true

       # Whether to verify the relay's certificate for TLS connections.
       # The default is to use the value in the [server] section.
       #tls_checkpeer = false

       # Path to a certificate authority bundle file in PEM format to use
       # instead of the system's default certificate authority database.
       # The default is to use the value in the [server] section.
       #tls_cacert = /etc/ssl/sudo/cacert.pem

       # Path to the server's certificate file in PEM format.
       # The default is to use the certificate in the [server] section.
       #tls_cert = /etc/ssl/sudo/certs/logsrvd_cert.pem

       # Path to the server's private key file in PEM format.
       # The default is to use the key in the [server] section.
       #tls_key = /etc/ssl/sudo/private/logsrvd_key.pem

       # TLS cipher list (see "CIPHER LIST FORMAT" in the openssl-ciphers manual).
       # this setting is only effective if the negotiated protocol is TLS version
       # 1.2.  The default is to use the value in the [server] section.
       #tls_ciphers_v12 = HIGH:!aNULL

       # TLS cipher list if the negotiated protocol is TLS version 1.3.
       # The default is to use the value in the [server] section.
       #tls_ciphers_v13 = TLS_AES_256_GCM_SHA384

       # Path to the Diffie-Hellman parameter file in PEM format.
       # The default is to use the value in the [server] section.
       #tls_dhparams = /etc/ssl/sudo/logsrvd_dhparams.pem

       [iolog]
       # The top-level directory to use when constructing the path name for the
       # I/O log directory.  The session sequence number, if any, is stored here.
       #iolog_dir = /var/log/sudo-io

       # The path name, relative to iolog_dir, in which to store I/O logs.
       # It is possible for iolog_file to contain directory components.
       #iolog_file = %{seq}

       # If set, I/O logs will be compressed using zlib.  Enabling compression can
       # make it harder to view the logs in real-time as the program is executing.
       #iolog_compress = false

       # If set, I/O log data is flushed to disk after each write instead of
       # buffering it.  This makes it possible to view the logs in real-time
       # as the program is executing but reduces the effectiveness of compression.
       #iolog_flush = true

       # The group to use when creating new I/O log files and directories.
       # If iolog_group is not set, the primary group-ID of the user specified
       # by iolog_user is used.  If neither iolog_group nor iolog_user
       # are set, I/O log files and directories are created with group-ID 0.
       #iolog_group = wheel

       # The user to use when setting the user-ID and group-ID of new I/O
       # log files and directories.  If iolog_group is set, it will be used
       # instead of the user's primary group-ID.  By default, I/O log files
       # and directories are created with user and group-ID 0.
       #iolog_user = root

       # The file mode to use when creating I/O log files.  The file permissions
       # will always include the owner read and write bits, even if they are
       # not present in the specified mode.  When creating I/O log directories,
       # search (execute) bits are added to match the read and write bits
       # specified by iolog_mode.
       #iolog_mode = 0600

       # If disabled, sudo_logsrvd will attempt to avoid logging plaintext
       # password in the terminal input using passprompt_regex.
       #log_passwords = true

       # The maximum sequence number that will be substituted for the "%{seq}"
       # escape in the I/O log file.  While the value substituted for "%{seq}"
       # is in base 36, maxseq itself should be expressed in decimal.  Values
       # larger than 2176782336 (which corresponds to the base 36 sequence
       # number "ZZZZZZ") will be silently truncated to 2176782336.
       #maxseq = 2176782336

       # One or more POSIX extended regular expressions used to match
       # password prompts in the terminal output when log_passwords is
       # disabled.  Multiple passprompt_regex settings may be specified.
       #passprompt_regex = [Pp]assword[: ]*
       #passprompt_regex = [Pp]assword for [a-z0-9]+: *

       [eventlog]
       # Where to log accept, reject, exit, and alert events.
       # Accepted values are syslog, logfile, or none.
       # Defaults to syslog
       #log_type = syslog

       # Whether to log an event when a command exits or is terminated by a signal.
       # Defaults to false
       #log_exit = true

       # Event log format.
       # Currently only sudo-style event logs are supported.
       #log_format = sudo

       [syslog]
       # The maximum length of a syslog payload.
       # On many systems, syslog(3) has a relatively small log buffer.
       # IETF RFC 5424 states that syslog servers must support messages
       # of at least 480 bytes and should support messages up to 2048 bytes.
       # Messages larger than this value will be split into multiple messages.
       #maxlen = 960

       # The syslog facility to use for event log messages.
       # The following syslog facilities are supported: authpriv (if your OS
       # supports it), auth, daemon, user, local0, local1, local2, local3,
       # local4, local5, local6, and local7.
       #facility = authpriv

       # Syslog priority to use for event log accept messages, when the command
       # is allowed by the security policy.  The following syslog priorities are
       # supported: alert, crit, debug, emerg, err, info, notice, warning, none.
       #accept_priority = notice

       # Syslog priority to use for event log reject messages, when the command
       # is not allowed by the security policy.
       #reject_priority = alert

       # Syslog priority to use for event log alert messages reported by the
       # client.
       #alert_priority = alert

       # The syslog facility to use for server warning messages.
       # Defaults to daemon.
       #server_facility = daemon

       [logfile]
       # The path to the file-based event log.
       # This path must be fully-qualified and start with a '/' character.
       #path = /var/log/sudo.log

       # The format string used when formatting the date and time for
       # file-based event logs.  Formatting is performed via strftime(3) so
       # any format string supported by that function is allowed.
       #time_format = %h %e %T

SEE ALSO         top

       strftime(3), sudo.conf(5), sudoers(5), sudo(8), sudo_logsrvd(8)

AUTHORS         top

       Many people have worked on sudo over the years; this version
       consists of code written primarily by:

             Todd C. Miller

       See the CONTRIBUTORS.md file in the sudo distribution
       (https://www.sudo.ws/about/contributors/) for an exhaustive list
       of people who have contributed to sudo.

BUGS         top

       If you believe you have found a bug in sudo_logsrvd.conf, you can
       either file a bug report in the sudo bug database,
       https://bugzilla.sudo.ws/, or open an issue at
       https://github.com/sudo-project/sudo/issues.  If you would prefer
       to use email, messages may be sent to the sudo-workers mailing
       list, https://www.sudo.ws/mailman/listinfo/sudo-workers (public)
       or <[email protected]> (private).

       Please not report security vulnerabilities through public GitHub
       issues, Bugzilla or mailing lists.  Instead, report them via
       email to <[email protected]>.  You may encrypt your message
       with PGP if you would like, using the key found at
       https://www.sudo.ws/dist/PGPKEYS.

SUPPORT         top

       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.

DISCLAIMER         top

       sudo is provided “AS IS” 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.md file distributed with sudo or
       https://www.sudo.ws/about/license/ for complete details.

COLOPHON         top

       This page is part of the sudo (execute a command as another user)
       project.  Information about the project can be found at
       https://www.sudo.ws/.  If you have a bug report for this manual
       page, see ⟨https://bugzilla.sudo.ws/⟩.  This page was obtained
       from the project's upstream Git repository
       ⟨https://github.com/sudo-project/sudo⟩ on 2024-06-14.  (At that
       time, the date of the most recent commit that was found in the
       repository was 2024-06-08.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there
       is a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       [email protected]

Sudo 1.9.16                   March 9, 2024         SUDO_LOGSRVD.CONF(5)