1
<?xml version='1.0' encoding='UTF-8'?>
2
<?xml-stylesheet type="text/xsl"
3
href="http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl"?>
4
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
5
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
6
<!ENTITY VERSION "1.0">
7
<!ENTITY COMMANDNAME "plugin-runner">
8
<!ENTITY TIMESTAMP "2008-08-30">
13
<title>Mandos Manual</title>
14
<!-- NWalsh's docbook scripts use this to generate the footer: -->
15
<productname>Mandos</productname>
16
<productnumber>&VERSION;</productnumber>
17
<date>&TIMESTAMP;</date>
20
<firstname>Björn</firstname>
21
<surname>Påhlsson</surname>
23
<email>belorn@fukt.bsnet.se</email>
27
<firstname>Teddy</firstname>
28
<surname>Hogeborn</surname>
30
<email>teddy@fukt.bsnet.se</email>
36
<holder>Teddy Hogeborn & Björn Påhlsson</holder>
40
This manual page is free software: you can redistribute it
41
and/or modify it under the terms of the GNU General Public
42
License as published by the Free Software Foundation,
43
either version 3 of the License, or (at your option) any
48
This manual page is distributed in the hope that it will
49
be useful, but WITHOUT ANY WARRANTY; without even the
50
implied warranty of MERCHANTABILITY or FITNESS FOR A
51
PARTICULAR PURPOSE. See the GNU General Public License
56
You should have received a copy of the GNU General Public
57
License along with this program; If not, see
58
<ulink url="http://www.gnu.org/licenses/"/>.
64
<refentrytitle>&COMMANDNAME;</refentrytitle>
65
<manvolnum>8mandos</manvolnum>
69
<refname><command>&COMMANDNAME;</command></refname>
71
get password for encrypted rootdisk
77
<command>&COMMANDNAME;</command>
78
<arg choice='opt'>--global-options<arg choice='plain'>OPTIONS</arg></arg>
79
<arg choice='opt'>--options-for<arg choice='plain'>PLUGIN:OPTIONS</arg></arg>
80
<arg choice='opt'>--disable<arg choice='plain'>PLUGIN</arg></arg>
81
<arg choice='opt'>--groupid<arg choice='plain'>ID</arg></arg>
82
<arg choice='opt'>--userid<arg choice='plain'>ID</arg></arg>
83
<arg choice='opt'>--plugin-dir<arg choice='plain'>DIRECTORY</arg></arg>
84
<arg choice='opt'>--debug</arg>
87
<command>&COMMANDNAME;</command>
88
<arg choice='plain'>--help</arg>
91
<command>&COMMANDNAME;</command>
92
<arg choice='plain'>--usage</arg>
95
<command>&COMMANDNAME;</command>
96
<arg choice='plain'>--version</arg>
100
<refsect1 id="description">
101
<title>DESCRIPTION</title>
103
<command>&COMMANDNAME;</command> is a plugin runner that waits
104
for any of its plugins to return sucessfull with a password, and
105
passes it to cryptsetup as stdout message. This command is not
106
meant to be invoked directly, but is instead meant to be run by
107
cryptsetup by being specified in /etc/crypttab as a keyscript
108
and subsequlently started in the initrd environment. See
109
<citerefentry><refentrytitle>crypttab</refentrytitle>
110
<manvolnum>5</manvolnum></citerefentry> for more information on
115
plugins is looked for in the plugins directory which by default will be
116
/conf/conf.d/mandos/plugins.d if not changed by option --plugin-dir.
120
<title>OPTIONS</title>
123
<term><literal>-g</literal>,<literal>--global-options
124
<replaceable>OPTIONS</replaceable></literal></term>
127
Global options given to all plugins as additional start
128
arguments. Options are specified with a -o flag followed
129
by a comma separated string of options.
135
<term><literal>-o</literal>,<literal> --options-for
136
<replaceable>PLUGIN</replaceable>:<replaceable>OPTION</replaceable>
140
Plugin specific options given to the plugin as additional
141
start arguments. Options are specified with a -o flag
142
followed by a comma separated string of options.
148
<term><literal>-d</literal>,<literal> --disable
149
<replaceable>PLUGIN</replaceable>
153
Disable a specific plugin
159
<term><literal>--groupid <replaceable>ID</replaceable>
163
Group ID the plugins will run as
169
<term><literal>--userid <replaceable>ID</replaceable>
173
User ID the plugins will run as
179
<term><literal>--plugin-dir <replaceable>DIRECTORY</replaceable>
183
Specify a different plugin directory
189
<term><literal>--debug</literal></term>
198
<term><literal>-?</literal>, <literal>--help</literal></term>
207
<term><literal>--usage</literal></term>
210
Gives a short usage message
216
<term><literal>-V</literal>, <literal>--version</literal></term>
219
Prints the program version
226
<refsect1 id="exit_status">
227
<title>EXIT STATUS</title>
238
<refsect1 id="notes">
250
<refsect1 id="examples">
251
<title>EXAMPLE</title>
256
<refsect1 id="security">
257
<title>SECURITY</title>
262
<refsect1 id="see_also">
263
<title>SEE ALSO</title>
265
<citerefentry><refentrytitle>cryptsetup</refentrytitle>
266
<manvolnum>8</manvolnum></citerefentry>,
267
<citerefentry><refentrytitle>mandos</refentrytitle>
268
<manvolnum>8</manvolnum></citerefentry>,
269
<citerefentry><refentrytitle>password-prompt</refentrytitle>
270
<manvolnum>8mandos</manvolnum></citerefentry>,
271
<citerefentry><refentrytitle>password-request</refentrytitle>
272
<manvolnum>8mandos</manvolnum></citerefentry>
277
<!-- Local Variables: -->
278
<!-- time-stamp-start: "<!ENTITY TIMESTAMP [\"']" -->
279
<!-- time-stamp-end: "[\"']>" -->
280
<!-- time-stamp-format: "%:y-%02m-%02d" -->