/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 plugin-runner.xml

  • Committer: Teddy Hogeborn
  • Date: 2026-05-17 23:56:03 UTC
  • Revision ID: teddy@recompile.se-20260517235603-5ygymkxkh32rxjkf
Remove white space at end of most lines

Remove white space at end of most lines.  Except for where it is
significant, like in shell script "here documents" where the delimiter
word is prefixed by "-", in block comments, and in config file example
settings.  Also not in README files, the INSTALL file, the DBUS-API
file, or the COPYING file (the last of which was copied verbatim from
FSF).

* dbus-mandos.conf: Remove white space at end of lines.
* debian/mandos-client.postinst: - '' -
* debian/mandos-client.templates: - '' -
* debian/mandos.postinst: - '' -
* dracut-module/password-agent.c: - '' -
* dracut-module/password-agent.xml: - '' -
* intro.xml: - '' -
* legalnotice.xml: - '' -
* mandos-clients.conf.xml: - '' -
* mandos-ctl.xml: - '' -
* mandos-keygen: - '' -
* mandos-keygen.xml: - '' -
* mandos-monitor.xml: - '' -
* mandos-options.xml: - '' -
* mandos.conf.xml: - '' -
* mandos.xml: - '' -
* network-hooks.d/wireless: - '' -
* plugin-helpers/mandos-client-iprouteadddel.c: - '' -
* plugin-runner.c: - '' -
* plugin-runner.xml: - '' -
* plugins.d/askpass-fifo.c: - '' -
* plugins.d/askpass-fifo.xml: - '' -
* plugins.d/mandos-client.c: - '' -
* plugins.d/mandos-client.xml: - '' -
* plugins.d/password-prompt.c: - '' -
* plugins.d/password-prompt.xml: - '' -
* plugins.d/plymouth.c: - '' -
* plugins.d/plymouth.xml: - '' -
* plugins.d/splashy.c: - '' -
* plugins.d/splashy.xml: - '' -
* plugins.d/usplash.c: - '' -
* plugins.d/usplash.xml: - '' -

Show diffs side-by-side

added added

removed removed

Lines of Context:
plugin-runner.xml
2
2
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3
3
        "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4
4
<!ENTITY COMMANDNAME "plugin-runner">
5
 
<!ENTITY TIMESTAMP "2025-06-27">
 
5
<!ENTITY TIMESTAMP "2026-05-18">
6
6
<!ENTITY % common SYSTEM "common.ent">
7
7
%common;
8
8
]>
53
53
    </copyright>
54
54
    <xi:include href="legalnotice.xml"/>
55
55
  </refentryinfo>
56
 
  
 
56
 
57
57
  <refmeta>
58
58
    <refentrytitle>&COMMANDNAME;</refentrytitle>
59
59
    <manvolnum>8mandos</manvolnum>
60
60
  </refmeta>
61
 
  
 
61
 
62
62
  <refnamediv>
63
63
    <refname><command>&COMMANDNAME;</command></refname>
64
64
    <refpurpose>
65
65
      Run Mandos plugins, pass data from first to succeed.
66
66
    </refpurpose>
67
67
  </refnamediv>
68
 
  
 
68
 
69
69
  <refsynopsisdiv>
70
70
    <cmdsynopsis>
71
71
      <command>&COMMANDNAME;</command>
155
155
      </group>
156
156
    </cmdsynopsis>
157
157
  </refsynopsisdiv>
158
 
  
 
158
 
159
159
  <refsect1 id="description">
160
160
    <title>DESCRIPTION</title>
161
161
    <para>
174
174
      be output on standard output.
175
175
    </para>
176
176
  </refsect1>
177
 
  
 
177
 
178
178
  <refsect1 id="purpose">
179
179
    <title>PURPOSE</title>
180
180
    <para>
184
184
      linkend="overview"/> for details.
185
185
    </para>
186
186
  </refsect1>
187
 
  
 
187
 
188
188
  <refsect1>
189
189
    <title>OPTIONS</title>
190
190
    <variablelist>
203
203
          </para>
204
204
        </listitem>
205
205
      </varlistentry>
206
 
      
 
206
 
207
207
      <varlistentry>
208
208
        <term><option>--env-for
209
209
        <replaceable>PLUGIN</replaceable><literal>:</literal
223
223
          </para>
224
224
        </listitem>
225
225
      </varlistentry>
226
 
      
 
226
 
227
227
      <varlistentry>
228
228
        <term><option>--global-options
229
229
        <replaceable>OPTIONS</replaceable></option></term>
239
239
          </para>
240
240
        </listitem>
241
241
      </varlistentry>
242
 
      
 
242
 
243
243
      <varlistentry>
244
244
        <term><option>--options-for
245
245
        <replaceable>PLUGIN</replaceable><literal>:</literal
267
267
          </para>
268
268
        </listitem>
269
269
      </varlistentry>
270
 
      
 
270
 
271
271
      <varlistentry>
272
272
        <term><option>--disable
273
273
        <replaceable>PLUGIN</replaceable></option></term>
281
281
          </para>
282
282
        </listitem>
283
283
      </varlistentry>
284
 
      
 
284
 
285
285
      <varlistentry>
286
286
        <term><option>--enable
287
287
        <replaceable>PLUGIN</replaceable></option></term>
296
296
          </para>
297
297
        </listitem>
298
298
      </varlistentry>
299
 
      
 
299
 
300
300
      <varlistentry>
301
301
        <term><option>--groupid
302
302
        <replaceable>ID</replaceable></option></term>
309
309
          </para>
310
310
        </listitem>
311
311
      </varlistentry>
312
 
      
 
312
 
313
313
      <varlistentry>
314
314
        <term><option>--userid
315
315
        <replaceable>ID</replaceable></option></term>
322
322
          </para>
323
323
        </listitem>
324
324
      </varlistentry>
325
 
      
 
325
 
326
326
      <varlistentry>
327
327
        <term><option>--plugin-dir
328
328
        <replaceable>DIRECTORY</replaceable></option></term>
335
335
          </para>
336
336
        </listitem>
337
337
      </varlistentry>
338
 
      
 
338
 
339
339
      <varlistentry>
340
340
        <term><option>--plugin-helper-dir
341
341
        <replaceable>DIRECTORY</replaceable></option></term>
350
350
          </para>
351
351
        </listitem>
352
352
      </varlistentry>
353
 
      
 
353
 
354
354
      <varlistentry>
355
355
        <term><option>--config-file
356
356
        <replaceable>FILE</replaceable></option></term>
362
362
          </para>
363
363
        </listitem>
364
364
      </varlistentry>
365
 
      
 
365
 
366
366
      <varlistentry>
367
367
        <term><option>--debug</option></term>
368
368
        <listitem>
381
381
          </para>
382
382
        </listitem>
383
383
      </varlistentry>
384
 
      
 
384
 
385
385
      <varlistentry>
386
386
        <term><option>--help</option></term>
387
387
        <term><option>-?</option></term>
391
391
          </para>
392
392
        </listitem>
393
393
      </varlistentry>
394
 
      
 
394
 
395
395
      <varlistentry>
396
396
        <term><option>--usage</option></term>
397
397
        <listitem>
400
400
          </para>
401
401
        </listitem>
402
402
      </varlistentry>
403
 
      
 
403
 
404
404
      <varlistentry>
405
405
        <term><option>--version</option></term>
406
406
        <term><option>-V</option></term>
412
412
      </varlistentry>
413
413
    </variablelist>
414
414
  </refsect1>
415
 
  
 
415
 
416
416
  <refsect1 id="overview">
417
417
    <title>OVERVIEW</title>
418
418
    <xi:include href="overview.xml"/>
438
438
      code will make this plugin-runner output the password from that
439
439
      plugin, stop any other plugins, and exit.
440
440
    </para>
441
 
    
 
441
 
442
442
    <refsect2 id="writing_plugins">
443
443
      <title>WRITING PLUGINS</title>
444
444
      <para>
481
481
      </para>
482
482
    </refsect2>
483
483
  </refsect1>
484
 
  
 
484
 
485
485
  <refsect1 id="fallback">
486
486
    <title>FALLBACK</title>
487
487
    <para>
493
493
      from the console.
494
494
    </para>
495
495
  </refsect1>
496
 
  
 
496
 
497
497
  <refsect1 id="exit_status">
498
498
    <title>EXIT STATUS</title>
499
499
    <para>
503
503
      case.
504
504
    </para>
505
505
  </refsect1>
506
 
  
 
506
 
507
507
  <refsect1 id="environment">
508
508
    <title>ENVIRONMENT</title>
509
509
    <para>
516
516
      <envar>MANDOSPLUGINHELPERDIR</envar> for the plugins.
517
517
    </para>
518
518
  </refsect1>
519
 
  
 
519
 
520
520
  <refsect1 id="files">
521
521
    <title>FILES</title>
522
522
    <para>
575
575
      </variablelist>
576
576
    </para>
577
577
  </refsect1>
578
 
  
 
578
 
579
579
  <refsect1 id="bugs">
580
580
    <title>BUGS</title>
581
581
    <para>
584
584
    </para>
585
585
    <xi:include href="bugs.xml"/>
586
586
  </refsect1>
587
 
  
 
587
 
588
588
  <refsect1 id="examples">
589
589
    <title>EXAMPLE</title>
590
590
    <informalexample>
600
600
        Run the program, but not the plugins, in debug mode:
601
601
      </para>
602
602
      <para>
603
 
        
 
603
 
604
604
        <!-- do not wrap this line -->
605
605
        <userinput>&COMMANDNAME; --debug</userinput>
606
 
        
 
606
 
607
607
      </para>
608
608
    </informalexample>
609
609
    <informalexample>
612
612
        debug mode:
613
613
      </para>
614
614
      <para>
615
 
        
 
615
 
616
616
        <!-- do not wrap this line -->
617
617
        <userinput>&COMMANDNAME; --options-for=foo:--debug</userinput>
618
 
        
 
618
 
619
619
      </para>
620
620
    </informalexample>
621
621
    <informalexample>
623
623
        Run all plugins, but not the program, in debug mode:
624
624
      </para>
625
625
      <para>
626
 
        
 
626
 
627
627
        <!-- do not wrap this line -->
628
628
        <userinput>&COMMANDNAME; --global-options=--debug</userinput>
629
 
        
 
629
 
630
630
      </para>
631
631
    </informalexample>
632
632
    <informalexample>
674
674
      linkend="fallback"/>).
675
675
    </para>
676
676
  </refsect1>
677
 
  
 
677
 
678
678
  <refsect1 id="see_also">
679
679
    <title>SEE ALSO</title>
680
680
    <para>
694
694
      <manvolnum>8mandos</manvolnum></citerefentry>
695
695
    </para>
696
696
  </refsect1>
697
 
  
 
697
 
698
698
</refentry>
699
699
<!-- Local Variables: -->
700
700
<!-- time-stamp-start: "<!ENTITY TIMESTAMP [\"']" -->