REQUEST-KEY(8) Linux Key Management Utilities REQUEST-KEY(8)
NAME
request-key - handle key instantiation callback requests from the ker-
nel
SYNOPSIS
/sbin/request-key <op> <key> <uid> <gid> <threadring> <processring>
<sessionring> [<info>]
DESCRIPTION
This program is invoked by the kernel when the kernel is asked for a
key that it doesn't have immediately available. The kernel creates a
partially set up key and then calls out to this program to instantiate
it. It is not intended to be called directly.
However, for debugging purposes, it can be given some options on the
command line:
-d Turn on debugging mode. In this mode, no attempts are made to
access any keys and, if a handler program is selected, it won't
be executed; instead, this program will print a message and exit
0.
-D <description>
In debugging mode, use the proposed key description specified
with this rather than the sample ("user;0;0;1f0000;debug:1234")
built into the program.
-l Use configuration from the current directory. The program will
use request-key.d/* and request-key.conf from the current direc-
tory rather than from /etc.
-n Don't log to the system log. Ordinarily, error messages and de-
bugging messages will be copied to the system log - this will
prevent that.
-v Turn on debugging output. This may be specified multiple times
to produce increasing levels of verbosity.
--version
Print the program version and exit.
ERRORS
All errors will be logged to the syslog.
FILES
/etc/request-key.d/*.conf Individual configuration files.
/etc/request-key.conf Fallback configuration file.
SEE ALSO
keyctl(1), request-key.conf(5), keyrings(7)
Linux 15 Nov 2011 REQUEST-KEY(8)