Document iolog_file and supported escape sequences for sudoers.
Clarify that iolog_file can contain directories.
This commit is contained in:
@@ -576,7 +576,8 @@ no effect.
|
|||||||
|
|
||||||
=item iolog_file=string
|
=item iolog_file=string
|
||||||
|
|
||||||
File name to use when I/O logging is enabled, relative to I<iolog_dir>.
|
File name to use when I/O logging is enabled, relative to I<iolog_dir>
|
||||||
|
(may also contain directory components).
|
||||||
This is a hint to the I/O logging plugin which may choose to ignore
|
This is a hint to the I/O logging plugin which may choose to ignore
|
||||||
it. If no I/O logging plugin is loaded, this setting has no effect.
|
it. If no I/O logging plugin is loaded, this setting has no effect.
|
||||||
|
|
||||||
|
@@ -1123,11 +1123,64 @@ list that exists and is executable. The default is C<"@editor@">.
|
|||||||
|
|
||||||
=item iolog_dir
|
=item iolog_dir
|
||||||
|
|
||||||
The directory in which to store input/output logs when the I<log_input>
|
The top-level directory to use when constructing the path name for
|
||||||
or I<log_output> options are enabled or when the <LOG_INPUT> or
|
the input/output log directory. Only used if the I<log_input> or
|
||||||
C<LOG_OUTPUT> tags are present for a command.
|
I<log_output> options are enabled or when the <LOG_INPUT> or
|
||||||
|
C<LOG_OUTPUT> tags are present for a command. The session sequence
|
||||||
|
number, if any, is stored in the directory.
|
||||||
The default is C<"@iolog_dir@">.
|
The default is C<"@iolog_dir@">.
|
||||||
|
|
||||||
|
The following percent (`C<%>') escape sequences are supported:
|
||||||
|
|
||||||
|
=over 4
|
||||||
|
|
||||||
|
=item C<%{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. F<01/00/A5>
|
||||||
|
|
||||||
|
=item C<%{user}>
|
||||||
|
|
||||||
|
expanded to the invoking user's login name
|
||||||
|
|
||||||
|
=item C<%{group}>
|
||||||
|
|
||||||
|
expanded to the name of the invoking user's real group ID
|
||||||
|
|
||||||
|
=item C<%{runas_user}>
|
||||||
|
|
||||||
|
expanded to the login name of the user the command will
|
||||||
|
be run as (e.g. root)
|
||||||
|
|
||||||
|
=item C<%{runas_group}>
|
||||||
|
|
||||||
|
expanded to the group name of the user the command will
|
||||||
|
be run as (e.g. wheel)
|
||||||
|
|
||||||
|
=item C<%{hostname}>
|
||||||
|
|
||||||
|
expanded to the local host name without the domain name
|
||||||
|
|
||||||
|
=item C<%{command}>
|
||||||
|
|
||||||
|
expanded to the base name of the command being run
|
||||||
|
|
||||||
|
=back
|
||||||
|
|
||||||
|
In addition, any escape sequences supported by the system's strftime()
|
||||||
|
function will be expanded.
|
||||||
|
|
||||||
|
=item iolog_file
|
||||||
|
|
||||||
|
The path name, relative to I<iolog_dir>, in which to store input/output
|
||||||
|
logs when the I<log_input> or I<log_output> options are enabled or
|
||||||
|
when the <LOG_INPUT> or C<LOG_OUTPUT> tags are present for a command.
|
||||||
|
Note that I<iolog_file> may contain directory components.
|
||||||
|
The default is C<"%{seq}">.
|
||||||
|
|
||||||
|
See the I<iolog_dir> option above for a list of supported percent
|
||||||
|
(`C<%>') escape sequences.
|
||||||
|
|
||||||
=item mailsub
|
=item mailsub
|
||||||
|
|
||||||
Subject of the mail sent to the I<mailto> user. The escape C<%h>
|
Subject of the mail sent to the I<mailto> user. The escape C<%h>
|
||||||
@@ -1145,7 +1198,7 @@ support C<LD_PRELOAD> or its equivalent. Defaults to F<@noexec_file@>.
|
|||||||
|
|
||||||
The default prompt to use when asking for a password; can be overridden
|
The default prompt to use when asking for a password; can be overridden
|
||||||
via the B<-p> option or the C<SUDO_PROMPT> environment variable.
|
via the B<-p> option or the C<SUDO_PROMPT> environment variable.
|
||||||
The following percent (`C<%>') escapes are supported:
|
The following percent (`C<%>') escape sequences are supported:
|
||||||
|
|
||||||
=over 4
|
=over 4
|
||||||
|
|
||||||
@@ -1834,8 +1887,8 @@ user specification.
|
|||||||
|
|
||||||
=head1 SEE ALSO
|
=head1 SEE ALSO
|
||||||
|
|
||||||
L<rsh(1)>, L<su(1)>, L<fnmatch(3)>, L<glob(3)>, L<sudoers.ldap(5)>,
|
L<rsh(1)>, L<su(1)>, L<fnmatch(3)>, L<glob(3)>, L<strftime(3)>,
|
||||||
L<sudo_plugin(8)>, L<sudo(8)>, L<visudo(8)>
|
L<sudoers.ldap(5)>, L<sudo_plugin(8)>, L<sudo(8)>, L<visudo(8)>
|
||||||
|
|
||||||
=head1 CAVEATS
|
=head1 CAVEATS
|
||||||
|
|
||||||
|
Reference in New Issue
Block a user