1
<?xml version="1.0" encoding="UTF-8"?>
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"?>
2
4
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3
5
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4
6
<!ENTITY VERSION "1.0">
5
7
<!ENTITY COMMANDNAME "plugin-runner">
6
<!ENTITY TIMESTAMP "2008-08-31">
8
<!ENTITY TIMESTAMP "2008-08-29">
11
13
<title>Mandos Manual</title>
12
<!-- Nwalsh’s docbook scripts use this to generate the footer: -->
14
<!-- NWalsh's docbook scripts use this to generate the footer: -->
13
15
<productname>Mandos</productname>
14
16
<productnumber>&VERSION;</productnumber>
15
17
<date>&TIMESTAMP;</date>
68
69
<refname><command>&COMMANDNAME;</command></refname>
70
Run Mandos plugins. Pass data from first succesful one.
71
get password for encrypted rootdisk
76
77
<command>&COMMANDNAME;</command>
78
<arg choice="plain"><option>--global-envs=<replaceable
79
>VAR</replaceable><literal>=</literal><replaceable
80
>value</replaceable></option></arg>
81
<arg choice="plain"><option>-e
82
<replaceable>VAR</replaceable><literal>=</literal><replaceable
83
>value</replaceable> </option></arg>
87
<arg choice="plain"><option>--envs-for=<replaceable
88
>PLUGIN</replaceable><literal>:</literal><replaceable
89
>ENV</replaceable><literal>=</literal><replaceable
90
>value</replaceable></option></arg>
91
<arg choice="plain"><option>-f<replaceable>
92
PLUGIN</replaceable><literal>:</literal><replaceable
93
>ENV</replaceable><literal>=</literal><replaceable
94
>value</replaceable> </option></arg>
98
<arg choice="plain"><option>--global-options=<replaceable
99
>OPTIONS</replaceable></option></arg>
100
<arg choice="plain"><option>-g<replaceable>
101
OPTIONS</replaceable> </option></arg>
105
<arg choice="plain"><option>--options-for=<replaceable
106
>PLUGIN</replaceable><literal>:</literal><replaceable
107
>OPTIONS</replaceable></option></arg>
108
<arg choice="plain"><option>-f<replaceable>
109
PLUGIN</replaceable><literal>:</literal><replaceable
110
>OPTIONS</replaceable> </option></arg>
114
<arg choice="plain"><option>--disable=<replaceable
115
>PLUGIN</replaceable></option></arg>
116
<arg choice="plain"><option>-d
117
<replaceable>PLUGIN</replaceable> </option></arg>
120
<arg><option>--groupid=<replaceable
121
>ID</replaceable></option></arg>
123
<arg><option>--userid=<replaceable
124
>ID</replaceable></option></arg>
126
<arg><option>--plugin-dir=<replaceable
127
>DIRECTORY</replaceable></option></arg>
129
<arg><option>--debug</option></arg>
132
<command>&COMMANDNAME;</command>
134
<arg choice="plain"><option>--help</option></arg>
135
<arg choice="plain"><option>-?</option></arg>
139
<command>&COMMANDNAME;</command>
140
<arg choice="plain"><option>--usage</option></arg>
143
<command>&COMMANDNAME;</command>
145
<arg choice="plain"><option>--version</option></arg>
146
<arg choice="plain"><option>-V</option></arg>
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>
151
100
<refsect1 id="description">
171
120
<title>OPTIONS</title>
174
<term><option>--global-options
175
<replaceable>OPTIONS</replaceable></option></term>
177
<replaceable>OPTIONS</replaceable></option></term>
123
<term><literal>-g</literal>,<literal>--global-options
124
<replaceable>OPTIONS</replaceable></literal></term>
180
127
Global options given to all plugins as additional start
181
128
arguments. Options are specified with a -o flag followed
182
129
by a comma separated string of options.
188
<term><option>--options-for
189
<replaceable>PLUGIN</replaceable><literal>:</literal
190
><replaceable>OPTION</replaceable></option></term>
192
<replaceable>PLUGIN</replaceable><literal>:</literal
193
><replaceable>OPTION</replaceable></option></term>
135
<term><literal>-o</literal>,<literal> --options-for
136
<replaceable>PLUGIN</replaceable>:<replaceable>OPTION</replaceable>
196
140
Plugin specific options given to the plugin as additional
197
141
start arguments. Options are specified with a -o flag
198
142
followed by a comma separated string of options.
204
<term><option> --disable
205
<replaceable>PLUGIN</replaceable></option></term>
207
<replaceable>PLUGIN</replaceable></option></term>
148
<term><literal>-d</literal>,<literal> --disable
149
<replaceable>PLUGIN</replaceable>
210
153
Disable a specific plugin
216
<term><option>--groupid
217
<replaceable>ID</replaceable></option></term>
159
<term><literal>--groupid <replaceable>ID</replaceable>
220
163
Group ID the plugins will run as
226
<term><option>--userid
227
<replaceable>ID</replaceable></option></term>
169
<term><literal>--userid <replaceable>ID</replaceable>
230
173
User ID the plugins will run as
236
<term><option>--plugin-dir
237
<replaceable>DIRECTORY</replaceable></option></term>
179
<term><literal>--plugin-dir <replaceable>DIRECTORY</replaceable>
240
183
Specify a different plugin directory
246
<term><option>--debug</option></term>
189
<term><literal>--debug</literal></term>