.\"
.\" Copyright (C) 2004 Red Hat, Inc. All Rights Reserved.
.\" Written by David Howells (dhowells@redhat.com)
.\"
.\" This program is free software; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License
.\" as published by the Free Software Foundation; either version
.\" 2 of the License, or (at your option) any later version.
.\"
.TH REQUEST-KEY 8 "15 Nov 2011" Linux "Linux Key Management Utilities"
.SH NAME
request\-key \- handle key instantiation callback requests from the kernel
.SH SYNOPSIS
\fB/sbin/request\-key \fR<op> <key> <uid> <gid> <threadring> <processring>
	<sessionring> [<info>]
.SH 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.
.PP
However, for debugging purposes, it can be given some options on the command
line:
.IP \fB-d\fP
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.
.IP \fB-D <description>\fP
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.
.IP \fB-l\fP
Use configuration from the current directory.  The program will use
.IR request-key.d/* " and " request-key.conf
from the current directory rather than from
.IR /etc .
.IP \fB-n\fP
Don't log to the system log.  Ordinarily, error messages and debugging messages
will be copied to the system log - this will prevent that.
.IP \fB-v\fP
Turn on debugging output.  This may be specified multiple times to produce
increasing levels of verbosity.
.IP \fB--version\fP
Print the program version and exit.
.SH ERRORS
All errors will be logged to the syslog.
.SH FILES
.ul
/etc/request\-key.d/*.conf
.ul 0
Individual configuration files.
.P
.ul
/etc/request\-key.conf
.ul 0
Fallback configuration file.
.SH SEE ALSO
.ad l
.nh
.BR keyctl (1),
.BR request\-key.conf (5),
.BR keyrings (7)