man-pages/man8/request-key.8.html
2021-03-31 01:06:50 +01:00

100 lines
3.0 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of REQUEST-KEY</TITLE>
</HEAD><BODY>
<H1>REQUEST-KEY</H1>
Section: Linux Key Management Utilities (8)<BR>Updated: 15 Nov 2011<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
request-key - handle key instantiation callback requests from the kernel
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>/sbin/request-key </B>&lt;op&gt; &lt;key&gt; &lt;uid&gt; &lt;gid&gt; &lt;threadring&gt; &lt;processring&gt;
<TT>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TT>&lt;sessionring&gt; [&lt;info&gt;]<BR>
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
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.
<P>
However, for debugging purposes, it can be given some options on the command
line:
<DL COMPACT>
<DT id="1"><B>-d</B><DD>
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.
<DT id="2"><B>-D &lt;description&gt;</B><DD>
In debugging mode, use the proposed key description specified with this rather
than the sample (&quot;user;0;0;1f0000;debug:1234&quot;) built into the program.
<DT id="3"><B>-l</B><DD>
Use configuration from the current directory. The program will use
<I>request-key.d/*</I> and <I>request-key.conf</I>
from the current directory rather than from
<I>/etc</I>.
<DT id="4"><B>-n</B><DD>
Don't log to the system log. Ordinarily, error messages and debugging messages
will be copied to the system log - this will prevent that.
<DT id="5"><B>-v</B><DD>
Turn on debugging output. This may be specified multiple times to produce
increasing levels of verbosity.
<DT id="6"><B>--version</B><DD>
Print the program version and exit.
</DL>
<A NAME="lbAE">&nbsp;</A>
<H2>ERRORS</H2>
All errors will be logged to the syslog.
<A NAME="lbAF">&nbsp;</A>
<H2>FILES</H2>
/etc/request-key.d/*.conf
Individual configuration files.
<P>
/etc/request-key.conf
Fallback configuration file.
<A NAME="lbAG">&nbsp;</A>
<H2>SEE ALSO</H2>
<B><A HREF="/cgi-bin/man/man2html?1+keyctl">keyctl</A></B>(1),
<B><A HREF="/cgi-bin/man/man2html?5+request-key.conf">request-key.conf</A></B>(5),
<B><A HREF="/cgi-bin/man/man2html?7+keyrings">keyrings</A></B>(7)
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="7"><A HREF="#lbAB">NAME</A><DD>
<DT id="8"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="9"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="10"><A HREF="#lbAE">ERRORS</A><DD>
<DT id="11"><A HREF="#lbAF">FILES</A><DD>
<DT id="12"><A HREF="#lbAG">SEE ALSO</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:06:15 GMT, March 31, 2021
</BODY>
</HTML>