/mandos/release

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

« back to all changes in this revision

Viewing changes to plugin-runner.xml

merge

Show diffs side-by-side

added added

removed removed

Lines of Context:
plugin-runner.xml
3
3
        "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4
4
<!ENTITY VERSION "1.0">
5
5
<!ENTITY COMMANDNAME "plugin-runner">
6
 
<!ENTITY TIMESTAMP "2008-09-05">
 
6
<!ENTITY TIMESTAMP "2008-09-04">
7
7
]>
8
8
 
9
9
<refentry xmlns:xi="http://www.w3.org/2001/XInclude">
510
510
    </para>
511
511
  </refsect1>
512
512
  
513
 
  <refsect1 id="bugs">
514
 
    <title>BUGS</title>
515
 
    <para>
516
 
      The <option>--config-file</option> option is ignored when
517
 
      specified from within a configuration file.
518
 
    </para>
519
 
  </refsect1>
 
513
<!--   <refsect1 id="bugs"> -->
 
514
<!--     <title>BUGS</title> -->
 
515
<!--     <para> -->
 
516
<!--     </para> -->
 
517
<!--   </refsect1> -->
520
518
  
521
519
  <refsect1 id="examples">
522
520
    <title>EXAMPLE</title>
564
562
    </informalexample>
565
563
    <informalexample>
566
564
      <para>
567
 
        Run plugins from a different directory, read a different
568
 
        configuration file, and add two options to the
569
 
        <citerefentry><refentrytitle >password-request</refentrytitle>
 
565
        Run plugins from a different directory and add two
 
566
        options to the <citerefentry><refentrytitle
 
567
        >password-request</refentrytitle>
570
568
        <manvolnum>8mandos</manvolnum></citerefentry> plugin:
571
569
      </para>
572
570
      <para>
573
571
 
574
572
<!-- do not wrap this line -->
575
 
<userinput>&COMMANDNAME;  --config-file=/etc/mandos/plugin-runner.conf --plugin-dir /usr/lib/mandos/plugins.d --options-for=password-request:--pubkey=/etc/keys/mandos/pubkey.txt,--seckey=/etc/keys/mandos/seckey.txt</userinput>
 
573
<userinput>&COMMANDNAME;  --plugin-dir=plugins.d --options-for=password-request:--pubkey=keydir/pubkey.txt,--seckey=keydir/seckey.txt</userinput>
576
574
 
577
575
      </para>
578
576
    </informalexample>
586
584
      non-privileged.  This user and group is then what all plugins
587
585
      will be started as.  Therefore, the only way to run a plugin as
588
586
      a privileged user is to have the set-user-ID or set-group-ID bit
589
 
      set on the plugin executable file (see <citerefentry>
 
587
      set on the plugin executable files (see <citerefentry>
590
588
      <refentrytitle>execve</refentrytitle><manvolnum>2</manvolnum>
591
589
      </citerefentry>).
592
590
    </para>