/mandos/trunk

To get this branch, use:
bzr branch http://bzr.recompile.se/loggerhead/mandos/trunk

« back to all changes in this revision

Viewing changes to mandos-client.xml

version 1.0

Show diffs side-by-side

added added

removed removed

Lines of Context:
mandos-client.xml
4
4
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
5
5
        "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
6
6
<!ENTITY VERSION "1.0">
7
 
<!ENTITY COMMANDNAME "plugin-runner">
8
 
<!ENTITY TIMESTAMP "2008-08-31">
 
7
<!ENTITY COMMANDNAME "mandos-client">
9
8
]>
10
9
 
11
10
<refentry>
12
11
  <refentryinfo>
13
 
    <title>Mandos Manual</title>
 
12
    <title>&COMMANDNAME;</title>
14
13
    <!-- NWalsh's docbook scripts use this to generate the footer: -->
15
 
    <productname>Mandos</productname>
 
14
    <productname>&COMMANDNAME;</productname>
16
15
    <productnumber>&VERSION;</productnumber>
17
 
    <date>&TIMESTAMP;</date>
18
16
    <authorgroup>
19
17
      <author>
20
18
        <firstname>Björn</firstname>
68
66
  <refnamediv>
69
67
    <refname><command>&COMMANDNAME;</command></refname>
70
68
    <refpurpose>
71
 
      Run Mandos plugins.  Pass data from first succesful one.
 
69
      get password for encrypted rootdisk
72
70
    </refpurpose>
73
71
  </refnamediv>
74
72
 
75
73
  <refsynopsisdiv>
76
74
    <cmdsynopsis>
77
75
      <command>&COMMANDNAME;</command>
78
 
      <group rep="repeat">
79
 
        <arg choice="plain"><option>--global-envs=<replaceable
80
 
        >VAR</replaceable><literal>=</literal><replaceable
81
 
        >value</replaceable></option></arg>
82
 
        <arg choice="plain"><option>-e
83
 
        <replaceable>VAR</replaceable><literal>=</literal><replaceable
84
 
        >value</replaceable> </option></arg>
85
 
      </group>
86
 
      <sbr/>
87
 
      <group rep="repeat">
88
 
        <arg choice="plain"><option>--envs-for=<replaceable
89
 
        >PLUGIN</replaceable><literal>:</literal><replaceable
90
 
        >ENV</replaceable><literal>=</literal><replaceable
91
 
        >value</replaceable></option></arg>
92
 
        <arg choice="plain"><option>-f<replaceable>
93
 
        PLUGIN</replaceable><literal>:</literal><replaceable
94
 
        >ENV</replaceable><literal>=</literal><replaceable
95
 
        >value</replaceable> </option></arg>
96
 
      </group>
97
 
      <sbr/>
98
 
      <group rep="repeat">
99
 
        <arg choice="plain"><option>--global-options=<replaceable
100
 
        >OPTIONS</replaceable></option></arg>
101
 
        <arg choice="plain"><option>-g<replaceable>
102
 
        OPTIONS</replaceable> </option></arg>
103
 
      </group>
104
 
      <sbr/>
105
 
      <group rep="repeat">
106
 
        <arg choice="plain"><option>--options-for=<replaceable
107
 
        >PLUGIN</replaceable><literal>:</literal><replaceable
108
 
        >OPTIONS</replaceable></option></arg>
109
 
        <arg choice="plain"><option>-f<replaceable>
110
 
        PLUGIN</replaceable><literal>:</literal><replaceable
111
 
        >OPTIONS</replaceable> </option></arg>
112
 
      </group>
113
 
      <sbr/>
114
 
      <group rep="repeat">
115
 
        <arg choice="plain"><option>--disable=<replaceable
116
 
        >PLUGIN</replaceable></option></arg>
117
 
        <arg choice="plain"><option>-d
118
 
        <replaceable>PLUGIN</replaceable> </option></arg>
119
 
      </group>
120
 
      <sbr/>
121
 
      <arg><option>--groupid=<replaceable
122
 
      >ID</replaceable></option></arg>
123
 
      <sbr/>
124
 
      <arg><option>--userid=<replaceable
125
 
      >ID</replaceable></option></arg>
126
 
      <sbr/>
127
 
      <arg><option>--plugin-dir=<replaceable
128
 
      >DIRECTORY</replaceable></option></arg>
129
 
      <sbr/>
130
 
      <arg><option>--debug</option></arg>
131
 
    </cmdsynopsis>
132
 
    <cmdsynopsis>
133
 
      <command>&COMMANDNAME;</command>
134
 
      <group choice="req">
135
 
        <arg choice='plain'><option>--help</option></arg>
136
 
        <arg choice='plain'><option>-?</option></arg>
137
 
      </group>
138
 
    </cmdsynopsis>
139
 
    <cmdsynopsis>
140
 
      <command>&COMMANDNAME;</command>
141
 
      <arg choice='plain'><option>--usage</option></arg>
142
 
    </cmdsynopsis>
143
 
    <cmdsynopsis>
144
 
      <command>&COMMANDNAME;</command>
145
 
      <group choice="req">
146
 
        <arg choice='plain'><option>--version</option></arg>
147
 
        <arg choice='plain'><option>-V</option></arg>
148
 
      </group>
149
 
    </cmdsynopsis>
 
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>
 
83
    </cmdsynopsis>
 
84
    <cmdsynopsis>
 
85
      <command>&COMMANDNAME;</command>
 
86
      <arg choice='plain'>--help</arg>
 
87
    </cmdsynopsis>
 
88
    <cmdsynopsis>
 
89
      <command>&COMMANDNAME;</command>
 
90
      <arg choice='plain'>--usage</arg>
 
91
    </cmdsynopsis>
 
92
    <cmdsynopsis>
 
93
      <command>&COMMANDNAME;</command>
 
94
      <arg choice='plain'>--version</arg>
 
95
    </cmdsynopsis>    
150
96
  </refsynopsisdiv>
151
97
 
152
98
  <refsect1 id="description">
154
100
    <para>
155
101
      <command>&COMMANDNAME;</command> is a plugin runner that waits
156
102
      for any of its plugins to return sucessfull with a password, and
157
 
      passes it to cryptsetup as stdout message. This command is not
158
 
      meant to be invoked directly, but is instead meant to be run by
159
 
      cryptsetup by being specified in /etc/crypttab as a keyscript
160
 
      and subsequlently started in the initrd environment. See
161
 
      <citerefentry><refentrytitle>crypttab</refentrytitle>
162
 
      <manvolnum>5</manvolnum></citerefentry> for more information on
163
 
      keyscripts.
 
103
      passes it to cryptsetup. plugins is defined as any executables
 
104
      in the plugins directory will by default will be
 
105
      /conf/conf.d/mandos/plugins.d.  to stdout.
164
106
    </para>
165
107
 
166
 
    <para>
167
 
      plugins is looked for in the plugins directory which by default will be
168
 
      /conf/conf.d/mandos/plugins.d if not changed by option --plugin-dir.
169
 
    </para>
170
 
  </refsect1>
171
 
  <refsect1>
172
 
    <title>OPTIONS</title>
173
108
    <variablelist>
174
109
      <varlistentry>
175
 
        <term><option>--global-options
176
 
        <replaceable>OPTIONS</replaceable></option></term>
177
 
        <term><option>-g
178
 
        <replaceable>OPTIONS</replaceable></option></term>
 
110
        <term><literal>-g</literal>,<literal>--global-options
 
111
        <replaceable>OPTIONS</replaceable></literal></term>
179
112
        <listitem>
180
113
          <para>
181
114
            Global options given to all plugins as additional start
182
115
            arguments.  Options are specified with a -o flag followed
183
116
            by a comma separated string of options.
184
 
          </para>       
 
117
          </para>         
185
118
        </listitem>
186
119
      </varlistentry>
187
120
 
188
121
      <varlistentry>
189
 
        <term><option>--options-for
190
 
        <replaceable>PLUGIN</replaceable><literal>:</literal
191
 
        ><replaceable>OPTION</replaceable></option></term>
192
 
        <term><option>-o
193
 
        <replaceable>PLUGIN</replaceable><literal>:</literal
194
 
        ><replaceable>OPTION</replaceable></option></term>
 
122
        <term><literal>-o</literal>,<literal> --options-for
 
123
        <replaceable>PLUGIN</replaceable>:<replaceable>OPTION</replaceable>
 
124
        </literal></term>
195
125
        <listitem>
196
126
          <para>
197
127
            Plugin specific options given to the plugin as additional
198
128
            start arguments.  Options are specified with a -o flag
199
129
            followed by a comma separated string of options.
200
 
          </para>       
 
130
          </para>         
201
131
        </listitem>
202
 
      </varlistentry>
 
132
      </varlistentry>      
203
133
 
204
134
      <varlistentry>
205
 
        <term><option> --disable
206
 
        <replaceable>PLUGIN</replaceable></option></term>
207
 
        <term><option>-d
208
 
        <replaceable>PLUGIN</replaceable></option></term>
 
135
        <term><literal>-d</literal>,<literal> --disable
 
136
        <replaceable>PLUGIN</replaceable>
 
137
        </literal></term>
209
138
        <listitem>
210
139
          <para>
211
140
            Disable a specific plugin
212
 
          </para>       
 
141
          </para>         
213
142
        </listitem>
214
143
      </varlistentry>
215
144
 
216
145
      <varlistentry>
217
 
        <term><option>--groupid
218
 
        <replaceable>ID</replaceable></option></term>
 
146
        <term><literal>--groupid <replaceable>ID</replaceable>
 
147
        </literal></term>
219
148
        <listitem>
220
149
          <para>
221
150
            Group ID the plugins will run as
222
151
          </para>
223
152
        </listitem>
224
 
      </varlistentry>
 
153
      </varlistentry>      
225
154
 
226
155
      <varlistentry>
227
 
        <term><option>--userid
228
 
        <replaceable>ID</replaceable></option></term>
 
156
        <term><literal>--userid <replaceable>ID</replaceable>
 
157
        </literal></term>
229
158
        <listitem>
230
159
          <para>
231
160
            User ID the plugins will run as
232
161
          </para>
233
162
        </listitem>
234
 
      </varlistentry>
 
163
      </varlistentry>      
235
164
 
236
165
      <varlistentry>
237
 
        <term><option>--plugin-dir
238
 
        <replaceable>DIRECTORY</replaceable></option></term>
 
166
        <term><literal>--plugin-dir <replaceable>DIRECTORY</replaceable>
 
167
        </literal></term>
239
168
        <listitem>
240
169
          <para>
241
170
            Specify a different plugin directory
242
171
          </para>
243
172
        </listitem>
244
 
      </varlistentry>
 
173
      </varlistentry>       
245
174
      
246
175
      <varlistentry>
247
 
        <term><option>--debug</option></term>
 
176
        <term><literal>--debug</literal></term>
248
177
        <listitem>
249
178
          <para>
250
179
            Debug mode
253
182
      </varlistentry>
254
183
      
255
184
      <varlistentry>
256
 
        <term><option>--help</option></term>
257
 
        <term><option>-?</option></term>
 
185
        <term><literal>-?</literal>, <literal>--help</literal></term>
258
186
        <listitem>
259
187
          <para>
260
188
            Gives a help message
263
191
      </varlistentry>
264
192
      
265
193
      <varlistentry>
266
 
        <term><option>--usage</option></term>
 
194
        <term><literal>--usage</literal></term>
267
195
        <listitem>
268
196
          <para>
269
197
            Gives a short usage message
272
200
      </varlistentry>
273
201
 
274
202
      <varlistentry>
275
 
        <term><option>--version</option></term>
276
 
        <term><option>-V</option></term>
 
203
        <term><literal>-V</literal>, <literal>--version</literal></term>
277
204
        <listitem>
278
205
          <para>
279
206
            Prints the program version
280
207
          </para>
281
208
        </listitem>
282
 
      </varlistentry>
 
209
      </varlistentry>            
283
210
    </variablelist>
284
211
  </refsect1>
285
 
 
286
 
  <refsect1 id="exit_status">
287
 
    <title>EXIT STATUS</title>
288
 
    <para>
289
 
    </para>
290
 
  </refsect1>
291
 
 
292
 
  <refsect1 id="file">
293
 
    <title>FILES</title>
294
 
    <para>
295
 
    </para>
296
 
  </refsect1>
297
 
 
298
 
  <refsect1 id="notes">
299
 
    <title>NOTES</title>
300
 
    <para>
301
 
    </para>
302
 
  </refsect1>
303
 
  
304
 
  <refsect1 id="bugs">
305
 
    <title>BUGS</title>
306
 
    <para>
307
 
    </para>
308
 
  </refsect1>
309
 
 
310
 
  <refsect1 id="examples">
311
 
    <title>EXAMPLE</title>
312
 
    <para>
313
 
    </para>
314
 
  </refsect1>
315
 
 
316
 
  <refsect1 id="security">
317
 
    <title>SECURITY</title>
318
 
    <para>
319
 
    </para>
320
 
  </refsect1>
321
 
 
322
 
  <refsect1 id="see_also">
323
 
    <title>SEE ALSO</title>
324
 
    <para>
325
 
      <citerefentry><refentrytitle>cryptsetup</refentrytitle>
326
 
      <manvolnum>8</manvolnum></citerefentry>,
327
 
      <citerefentry><refentrytitle>mandos</refentrytitle>
328
 
      <manvolnum>8</manvolnum></citerefentry>,
329
 
      <citerefentry><refentrytitle>password-prompt</refentrytitle>
330
 
      <manvolnum>8mandos</manvolnum></citerefentry>,
331
 
      <citerefentry><refentrytitle>password-request</refentrytitle>
332
 
      <manvolnum>8mandos</manvolnum></citerefentry>
333
 
    </para>
334
 
  </refsect1>
335
 
 
336
212
</refentry>
337
 
<!-- Local Variables: -->
338
 
<!-- time-stamp-start: "<!ENTITY TIMESTAMP [\"']" -->
339
 
<!-- time-stamp-end: "[\"']>" -->
340
 
<!-- time-stamp-format: "%:y-%02m-%02d" -->
341
 
<!-- End: -->