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"?>
1
<?xml version="1.0" encoding="UTF-8"?>
4
2
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
5
3
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
6
4
<!ENTITY VERSION "1.0">
7
<!ENTITY COMMANDNAME "mandos-client">
5
<!ENTITY COMMANDNAME "plugin-runner">
6
<!ENTITY TIMESTAMP "2008-08-31">
9
<refentry xmlns:xi="http://www.w3.org/2001/XInclude">
12
<title>&COMMANDNAME;</title>
13
<!-- NWalsh's docbook scripts use this to generate the footer: -->
14
<productname>&COMMANDNAME;</productname>
11
<title>Mandos Manual</title>
12
<!-- Nwalsh’s docbook scripts use this to generate the footer: -->
13
<productname>Mandos</productname>
15
14
<productnumber>&VERSION;</productnumber>
15
<date>&TIMESTAMP;</date>
18
18
<firstname>Björn</firstname>
34
<holder>Teddy Hogeborn & Björn Påhlsson</holder>
34
<holder>Teddy Hogeborn</holder>
35
<holder>Björn Påhlsson</holder>
38
This manual page is free software: you can redistribute it
39
and/or modify it under the terms of the GNU General Public
40
License as published by the Free Software Foundation,
41
either version 3 of the License, or (at your option) any
46
This manual page is distributed in the hope that it will
47
be useful, but WITHOUT ANY WARRANTY; without even the
48
implied warranty of MERCHANTABILITY or FITNESS FOR A
49
PARTICULAR PURPOSE. See the GNU General Public License
54
You should have received a copy of the GNU General Public
55
License along with this program; If not, see
56
<ulink url="http://www.gnu.org/licenses/"/>.
37
<xi:include href="legalnotice.xml"/>
67
46
<refname><command>&COMMANDNAME;</command></refname>
69
get password for encrypted rootdisk
48
Run Mandos plugins. Pass data from first succesful one.
75
54
<command>&COMMANDNAME;</command>
76
<arg choice='opt'>--global-options<arg choice='plain'>OPTIONS</arg></arg>
77
<arg choice='opt'>--options-for<arg choice='plain'>PLUGIN:OPTIONS</arg></arg>
78
<arg choice='opt'>--disable<arg choice='plain'>PLUGIN</arg></arg>
79
<arg choice='opt'>--groupid<arg choice='plain'>ID</arg></arg>
80
<arg choice='opt'>--userid<arg choice='plain'>ID</arg></arg>
81
<arg choice='opt'>--plugin-dir<arg choice='plain'>DIRECTORY</arg></arg>
82
<arg choice='opt'>--debug</arg>
85
<command>&COMMANDNAME;</command>
86
<arg choice='plain'>--help</arg>
89
<command>&COMMANDNAME;</command>
90
<arg choice='plain'>--usage</arg>
93
<command>&COMMANDNAME;</command>
94
<arg choice='plain'>--version</arg>
56
<arg choice="plain"><option>--global-envs=<replaceable
57
>VAR</replaceable><literal>=</literal><replaceable
58
>value</replaceable></option></arg>
59
<arg choice="plain"><option>-e
60
<replaceable>VAR</replaceable><literal>=</literal><replaceable
61
>value</replaceable> </option></arg>
65
<arg choice="plain"><option>--envs-for=<replaceable
66
>PLUGIN</replaceable><literal>:</literal><replaceable
67
>ENV</replaceable><literal>=</literal><replaceable
68
>value</replaceable></option></arg>
69
<arg choice="plain"><option>-f<replaceable>
70
PLUGIN</replaceable><literal>:</literal><replaceable
71
>ENV</replaceable><literal>=</literal><replaceable
72
>value</replaceable> </option></arg>
76
<arg choice="plain"><option>--global-options=<replaceable
77
>OPTIONS</replaceable></option></arg>
78
<arg choice="plain"><option>-g<replaceable>
79
OPTIONS</replaceable> </option></arg>
83
<arg choice="plain"><option>--options-for=<replaceable
84
>PLUGIN</replaceable><literal>:</literal><replaceable
85
>OPTIONS</replaceable></option></arg>
86
<arg choice="plain"><option>-f<replaceable>
87
PLUGIN</replaceable><literal>:</literal><replaceable
88
>OPTIONS</replaceable> </option></arg>
92
<arg choice="plain"><option>--disable=<replaceable
93
>PLUGIN</replaceable></option></arg>
94
<arg choice="plain"><option>-d
95
<replaceable>PLUGIN</replaceable> </option></arg>
98
<arg><option>--groupid=<replaceable
99
>ID</replaceable></option></arg>
101
<arg><option>--userid=<replaceable
102
>ID</replaceable></option></arg>
104
<arg><option>--plugin-dir=<replaceable
105
>DIRECTORY</replaceable></option></arg>
107
<arg><option>--debug</option></arg>
110
<command>&COMMANDNAME;</command>
112
<arg choice="plain"><option>--help</option></arg>
113
<arg choice="plain"><option>-?</option></arg>
117
<command>&COMMANDNAME;</command>
118
<arg choice="plain"><option>--usage</option></arg>
121
<command>&COMMANDNAME;</command>
123
<arg choice="plain"><option>--version</option></arg>
124
<arg choice="plain"><option>-V</option></arg>
98
129
<refsect1 id="description">
118
149
<title>OPTIONS</title>
121
<term><literal>-g</literal>,<literal>--global-options
122
<replaceable>OPTIONS</replaceable></literal></term>
152
<term><option>--global-options
153
<replaceable>OPTIONS</replaceable></option></term>
155
<replaceable>OPTIONS</replaceable></option></term>
125
158
Global options given to all plugins as additional start
126
159
arguments. Options are specified with a -o flag followed
127
160
by a comma separated string of options.
133
<term><literal>-o</literal>,<literal> --options-for
134
<replaceable>PLUGIN</replaceable>:<replaceable>OPTION</replaceable>
166
<term><option>--options-for
167
<replaceable>PLUGIN</replaceable><literal>:</literal
168
><replaceable>OPTION</replaceable></option></term>
170
<replaceable>PLUGIN</replaceable><literal>:</literal
171
><replaceable>OPTION</replaceable></option></term>
138
174
Plugin specific options given to the plugin as additional
139
175
start arguments. Options are specified with a -o flag
140
176
followed by a comma separated string of options.
146
<term><literal>-d</literal>,<literal> --disable
147
<replaceable>PLUGIN</replaceable>
182
<term><option> --disable
183
<replaceable>PLUGIN</replaceable></option></term>
185
<replaceable>PLUGIN</replaceable></option></term>
151
188
Disable a specific plugin
157
<term><literal>--groupid <replaceable>ID</replaceable>
194
<term><option>--groupid
195
<replaceable>ID</replaceable></option></term>
161
198
Group ID the plugins will run as
167
<term><literal>--userid <replaceable>ID</replaceable>
204
<term><option>--userid
205
<replaceable>ID</replaceable></option></term>
171
208
User ID the plugins will run as
177
<term><literal>--plugin-dir <replaceable>DIRECTORY</replaceable>
214
<term><option>--plugin-dir
215
<replaceable>DIRECTORY</replaceable></option></term>
181
218
Specify a different plugin directory
187
<term><literal>--debug</literal></term>
224
<term><option>--debug</option></term>
230
269
<refsect1 id="file">
231
270
<title>FILES</title>
236
275
<refsect1 id="notes">
237
276
<title>NOTES</title>
242
281
<refsect1 id="bugs">
243
282
<title>BUGS</title>
248
287
<refsect1 id="examples">
249
<title>EXAMPLES</title>
288
<title>EXAMPLE</title>
254
293
<refsect1 id="security">
255
294
<title>SECURITY</title>
260
299
<refsect1 id="see_also">
261
300
<title>SEE ALSO</title>
302
<citerefentry><refentrytitle>cryptsetup</refentrytitle>
303
<manvolnum>8</manvolnum></citerefentry>,
304
<citerefentry><refentrytitle>mandos</refentrytitle>
305
<manvolnum>8</manvolnum></citerefentry>,
306
<citerefentry><refentrytitle>password-prompt</refentrytitle>
307
<manvolnum>8mandos</manvolnum></citerefentry>,
308
<citerefentry><refentrytitle>password-request</refentrytitle>
309
<manvolnum>8mandos</manvolnum></citerefentry>
314
<!-- Local Variables: -->
315
<!-- time-stamp-start: "<!ENTITY TIMESTAMP [\"']" -->
316
<!-- time-stamp-end: "[\"']>" -->
317
<!-- time-stamp-format: "%:y-%02m-%02d" -->