/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-ctl.xml

  • Committer: teddy at bsnet
  • Date: 2010-09-21 19:16:41 UTC
  • Revision ID: teddy@fukt.bsnet.se-20100921191641-yetps84gvjo7hrrc
* mandos-ctl.xml: New.
* Makefile (DOCS): Added "mandos-ctl.8".
  (mandos-ctl.8): New.

Show diffs side-by-side

added added

removed removed

Lines of Context:
mandos-ctl.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 "mandos-ctl">
5
 
<!ENTITY TIMESTAMP "2012-06-22">
 
5
<!ENTITY TIMESTAMP "2010-09-21">
6
6
<!ENTITY % common SYSTEM "common.ent">
7
7
%common;
8
8
]>
19
19
        <firstname>Björn</firstname>
20
20
        <surname>Påhlsson</surname>
21
21
        <address>
22
 
          <email>belorn@recompile.se</email>
 
22
          <email>belorn@fukt.bsnet.se</email>
23
23
        </address>
24
24
      </author>
25
25
      <author>
26
26
        <firstname>Teddy</firstname>
27
27
        <surname>Hogeborn</surname>
28
28
        <address>
29
 
          <email>teddy@recompile.se</email>
 
29
          <email>teddy@fukt.bsnet.se</email>
30
30
        </address>
31
31
      </author>
32
32
    </authorgroup>
33
33
    <copyright>
34
34
      <year>2010</year>
35
 
      <year>2011</year>
36
 
      <year>2012</year>
37
35
      <holder>Teddy Hogeborn</holder>
38
36
      <holder>Björn Påhlsson</holder>
39
37
    </copyright>
96
94
      </group>
97
95
      <sbr/>
98
96
      <group>
99
 
        <arg choice="plain"><option>--extended-timeout
100
 
        <replaceable>TIME</replaceable></option></arg>
101
 
      </group>
102
 
      <sbr/>
103
 
      <group>
104
 
        <arg choice="plain"><option>--interval
105
 
        <replaceable>TIME</replaceable></option></arg>
106
 
        <arg choice="plain"><option>-i
107
 
        <replaceable>TIME</replaceable></option></arg>
108
 
      </group>
109
 
      <sbr/>
110
 
      <group>
111
 
        <arg choice="plain"><option>--approve-by-default</option
112
 
        ></arg>
113
 
        <sbr/>
114
 
        <arg choice="plain"><option>--deny-by-default</option></arg>
115
 
      </group>
116
 
      <sbr/>
117
 
      <group>
118
 
        <arg choice="plain"><option>--approval-delay
119
 
        <replaceable>TIME</replaceable></option></arg>
120
 
      </group>
121
 
      <sbr/>
122
 
      <group>
123
 
        <arg choice="plain"><option>--approval-duration
124
 
        <replaceable>TIME</replaceable></option></arg>
125
 
      </group>
126
 
      <sbr/>
127
 
      <group>
128
97
        <arg choice="plain"><option>--interval
129
98
        <replaceable>TIME</replaceable></option></arg>
130
99
        <arg choice="plain"><option>-i
195
164
        <arg choice="plain"><option>-v</option></arg>
196
165
      </group>
197
166
    </cmdsynopsis>
198
 
    <cmdsynopsis>
199
 
      <command>&COMMANDNAME;</command>
200
 
      <arg choice="plain"><option>--check</option></arg>
201
 
    </cmdsynopsis>
202
167
  </refsynopsisdiv>
203
168
  
204
169
  <refsect1 id="description">
308
273
          <para>
309
274
            Set the <varname>checker</varname> option of the specified
310
275
            client(s); see <citerefentry><refentrytitle
311
 
            >mandos-clients.conf</refentrytitle><manvolnum
312
 
            >5</manvolnum></citerefentry>.
 
276
            >mandos-client.conf</refentrytitle><manvolnum>5</manvolnum
 
277
            ></citerefentry>.
313
278
          </para>
314
279
        </listitem>
315
280
      </varlistentry>
323
288
          <para>
324
289
            Set the <varname>timeout</varname> option of the specified
325
290
            client(s); see <citerefentry><refentrytitle
326
 
            >mandos-clients.conf</refentrytitle><manvolnum
327
 
            >5</manvolnum></citerefentry>.
328
 
          </para>
329
 
        </listitem>
330
 
      </varlistentry>
331
 
 
332
 
      <varlistentry>
333
 
        <term><option>--extended-timeout
334
 
        <replaceable>TIME</replaceable></option></term>
335
 
        <listitem>
336
 
          <para>
337
 
            Set the <varname>extended_timeout</varname> option of the
338
 
            specified client(s); see <citerefentry><refentrytitle
339
 
            >mandos-clients.conf</refentrytitle><manvolnum
340
 
            >5</manvolnum></citerefentry>.
 
291
            >mandos-client.conf</refentrytitle><manvolnum>5</manvolnum
 
292
            ></citerefentry>.
341
293
          </para>
342
294
        </listitem>
343
295
      </varlistentry>
349
301
        <replaceable>TIME</replaceable></option></term>
350
302
        <listitem>
351
303
          <para>
352
 
            Set the <varname>interval</varname> option of the
353
 
            specified client(s); see <citerefentry><refentrytitle
354
 
            >mandos-clients.conf</refentrytitle><manvolnum
355
 
            >5</manvolnum></citerefentry>.
356
 
          </para>
357
 
        </listitem>
358
 
      </varlistentry>
359
 
      
360
 
      <varlistentry>
361
 
        <term><option>--approve-by-default</option></term>
362
 
        <term><option>--deny-by-default</option></term>
363
 
        <listitem>
364
 
          <para>
365
 
            Set the <varname>approved_by_default</varname> option of
366
 
            the specified client(s) to <literal>True</literal> or
367
 
            <literal>False</literal>, respectively; see
368
 
            <citerefentry><refentrytitle
369
 
            >mandos-clients.conf</refentrytitle><manvolnum
370
 
            >5</manvolnum></citerefentry>.
371
 
          </para>
372
 
        </listitem>
373
 
      </varlistentry>
374
 
      
375
 
      <varlistentry>
376
 
        <term><option>--approval-delay
377
 
        <replaceable>TIME</replaceable></option></term>
378
 
        <listitem>
379
 
          <para>
380
 
            Set the <varname>approval_delay</varname> option of the
381
 
            specified client(s); see <citerefentry><refentrytitle
382
 
            >mandos-clients.conf</refentrytitle><manvolnum
383
 
            >5</manvolnum></citerefentry>.
384
 
          </para>
385
 
        </listitem>
386
 
      </varlistentry>
387
 
      
388
 
      <varlistentry>
389
 
        <term><option>--approval-duration
390
 
        <replaceable>TIME</replaceable></option></term>
391
 
        <listitem>
392
 
          <para>
393
 
            Set the <varname>approval_duration</varname> option of the
394
 
            specified client(s); see <citerefentry><refentrytitle
395
 
            >mandos-clients.conf</refentrytitle><manvolnum
396
 
            >5</manvolnum></citerefentry>.
 
304
            Set the <varname>interval</varname> option of the specified
 
305
            client(s); see <citerefentry><refentrytitle
 
306
            >mandos-client.conf</refentrytitle><manvolnum>5</manvolnum
 
307
            ></citerefentry>.
397
308
          </para>
398
309
        </listitem>
399
310
      </varlistentry>
407
318
          <para>
408
319
            Set the <varname>host</varname> option of the specified
409
320
            client(s); see <citerefentry><refentrytitle
410
 
            >mandos-clients.conf</refentrytitle><manvolnum
411
 
            >5</manvolnum></citerefentry>.
 
321
            >mandos-client.conf</refentrytitle><manvolnum>5</manvolnum
 
322
            ></citerefentry>.
412
323
          </para>
413
324
        </listitem>
414
325
      </varlistentry>
422
333
          <para>
423
334
            Set the <varname>secfile</varname> option of the specified
424
335
            client(s); see <citerefentry><refentrytitle
425
 
            >mandos-clients.conf</refentrytitle><manvolnum
426
 
            >5</manvolnum></citerefentry>.
 
336
            >mandos-client.conf</refentrytitle><manvolnum>5</manvolnum
 
337
            ></citerefentry>.
427
338
          </para>
428
339
        </listitem>
429
340
      </varlistentry>
480
391
        </listitem>
481
392
      </varlistentry>
482
393
      
483
 
      <varlistentry>
484
 
        <term><option>--check</option></term>
485
 
        <listitem>
486
 
          <para>
487
 
            Run self-tests.  This includes any unit tests, etc.
488
 
          </para>
489
 
        </listitem>
490
 
      </varlistentry>
491
 
      
492
394
    </variablelist>
493
395
  </refsect1>
494
396
  
520
422
    <title>EXAMPLE</title>
521
423
    <informalexample>
522
424
      <para>
523
 
        To list all clients:
 
425
        List all clients with some of their settings:
524
426
      </para>
525
427
      <para>
526
428
        <userinput>&COMMANDNAME;</userinput>
527
429
      </para>
528
430
    </informalexample>
529
 
    
530
 
    <informalexample>
531
 
      <para>
532
 
        To list <emphasis>all</emphasis> settings for the clients
533
 
        named <quote>foo1.example.org</quote> and <quote
534
 
        >foo2.example.org</quote>:
535
 
      </para>
536
 
      <para>
537
 
 
538
 
<!-- do not wrap this line -->
539
 
<userinput>&COMMANDNAME; --verbose foo1.example.org foo2.example.org</userinput>
540
 
 
541
 
      </para>
542
 
    </informalexample>
543
 
    
544
 
    <informalexample>
545
 
      <para>
546
 
        To enable all clients:
547
 
      </para>
548
 
      <para>
549
 
        <userinput>&COMMANDNAME; --enable --all</userinput>
550
 
      </para>
551
 
    </informalexample>
552
 
    
553
 
    <informalexample>
554
 
      <para>
555
 
        To change timeout and interval value for the clients
556
 
        named <quote>foo1.example.org</quote> and <quote
557
 
        >foo2.example.org</quote>:
558
 
      </para>
559
 
      <para>
560
 
 
561
 
<!-- do not wrap this line -->
562
 
<userinput>&COMMANDNAME; --timeout="5m" --interval="1m" foo1.example.org foo2.example.org</userinput>
563
 
 
564
 
      </para>
565
 
    </informalexample>
566
 
    
567
 
    <informalexample>
568
 
      <para>
569
 
        To approve all clients currently waiting for it:
570
 
      </para>
571
 
      <para>
572
 
        <userinput>&COMMANDNAME; --approve --all</userinput>
 
431
    <informalexample>
 
432
      <para>
 
433
        Show all settings for the clients named <quote>foo</quote> and
 
434
        <quote>bar</quote>:
 
435
      </para>
 
436
      <para>
 
437
 
 
438
<!-- do not wrap this line -->
 
439
<userinput>&COMMANDNAME; --verbose foo bar</userinput>
 
440
 
573
441
      </para>
574
442
    </informalexample>
575
443
  </refsect1>
586
454
  <refsect1 id="see_also">
587
455
    <title>SEE ALSO</title>
588
456
    <para>
589
 
      <citerefentry><refentrytitle>intro</refentrytitle>
590
 
      <manvolnum>8mandos</manvolnum></citerefentry>,
591
457
      <citerefentry><refentrytitle>mandos</refentrytitle>
592
458
      <manvolnum>8</manvolnum></citerefentry>,
593
459
      <citerefentry><refentrytitle>mandos-clients.conf</refentrytitle>