jpayne@68: .\" jpayne@68: .\" Copyright (C) 2004 Red Hat, Inc. All Rights Reserved. jpayne@68: .\" Written by David Howells (dhowells@redhat.com) jpayne@68: .\" jpayne@68: .\" This program is free software; you can redistribute it and/or jpayne@68: .\" modify it under the terms of the GNU General Public License jpayne@68: .\" as published by the Free Software Foundation; either version jpayne@68: .\" 2 of the License, or (at your option) any later version. jpayne@68: .\" jpayne@68: .TH REQUEST-KEY 8 "15 Nov 2011" Linux "Linux Key Management Utilities" jpayne@68: .SH NAME jpayne@68: request\-key \- handle key instantiation callback requests from the kernel jpayne@68: .SH SYNOPSIS jpayne@68: \fB/sbin/request\-key \fR jpayne@68: [] jpayne@68: .SH DESCRIPTION jpayne@68: This program is invoked by the kernel when the kernel is asked for a key that jpayne@68: it doesn't have immediately available. The kernel creates a partially set up jpayne@68: key and then calls out to this program to instantiate it. It is not intended jpayne@68: to be called directly. jpayne@68: .PP jpayne@68: However, for debugging purposes, it can be given some options on the command jpayne@68: line: jpayne@68: .IP \fB-d\fP jpayne@68: Turn on debugging mode. In this mode, no attempts are made to access any keys jpayne@68: and, if a handler program is selected, it won't be executed; instead, this jpayne@68: program will print a message and exit 0. jpayne@68: .IP \fB-D \fP jpayne@68: In debugging mode, use the proposed key description specified with this rather jpayne@68: than the sample ("user;0;0;1f0000;debug:1234") built into the program. jpayne@68: .IP \fB-l\fP jpayne@68: Use configuration from the current directory. The program will use jpayne@68: .IR request-key.d/* " and " request-key.conf jpayne@68: from the current directory rather than from jpayne@68: .IR /etc . jpayne@68: .IP \fB-n\fP jpayne@68: Don't log to the system log. Ordinarily, error messages and debugging messages jpayne@68: will be copied to the system log - this will prevent that. jpayne@68: .IP \fB-v\fP jpayne@68: Turn on debugging output. This may be specified multiple times to produce jpayne@68: increasing levels of verbosity. jpayne@68: .IP \fB--version\fP jpayne@68: Print the program version and exit. jpayne@68: .SH ERRORS jpayne@68: All errors will be logged to the syslog. jpayne@68: .SH FILES jpayne@68: .ul jpayne@68: /etc/request\-key.d/*.conf jpayne@68: .ul 0 jpayne@68: Individual configuration files. jpayne@68: .P jpayne@68: .ul jpayne@68: /etc/request\-key.conf jpayne@68: .ul 0 jpayne@68: Fallback configuration file. jpayne@68: .SH SEE ALSO jpayne@68: .ad l jpayne@68: .nh jpayne@68: .BR keyctl (1), jpayne@68: .BR request\-key.conf (5), jpayne@68: .BR keyrings (7)