62 lines
2.1 KiB
Plaintext
62 lines
2.1 KiB
Plaintext
.\"
|
|
.\" 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)
|