8. System administration commands (usually only for root)
REQUEST-KEYSection: Linux Key Management Utilities (8)
Updated: 15 Nov 2011
Index | Return to Main Contents
NAMErequest-key - handle key instantiation callback requests from the kernel
SYNOPSIS/sbin/request-key <op> <key> <uid> <gid> <threadring> <processring> <sessionring> [<info>]
DESCRIPTIONThis 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:
- 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.
- Use configuration from the current directory. The program will use request-key.d/* and request-key.conf from the current directory rather than from /etc.
- Don't log to the system log. Ordinarily, error messages and debugging messages will be copied to the system log - this will prevent that.
- Turn on debugging output. This may be specified multiple times to produce increasing levels of verbosity.
- Print the program version and exit.
ERRORSAll errors will be logged to the syslog.
FILES/etc/request-key.d/*.conf Individual configuration files.
/etc/request-key.conf Fallback configuration file.
SEE ALSOkeyctl(1), request-key.conf(5), keyrings(7)
Return to Main Contents
All content on this site is copyright ©2004-2023 and is not to be reproduced without prior permission.