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

  • Committer: Teddy Hogeborn
  • Date: 2019-07-18 00:02:43 UTC
  • mto: This revision was merged to the branch mainline in revision 384.
  • Revision ID: teddy@recompile.se-20190718000243-okz4s9xao1r1tfnx
Document bug in mandos-keygen which strips white space from passwords

Passwords, as read by mandos-keygen when given the --password or -p
options, are stripped of white space from the start and from the end
of the password.  This is because mandos-keygen is a shell script, and
the Bourne Shell "read" builtin does not seem to have a way to avoid
this.  Document this bug.

* manods-keygen.xml (OPTIONS): Document the white space-stripping
                               nature of the --password/-p option, and
                               also note in the description of
                               --passfile and -F that they avoid this
                               behavior.
  (BUGS): Again mention the problem with the --password and -p
          options, and suggest --passfile as a possible workaround.

Show diffs side-by-side

added added

removed removed

Lines of Context:
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 "2019-03-07">
 
5
<!ENTITY TIMESTAMP "2019-03-09">
6
6
<!ENTITY % common SYSTEM "common.ent">
7
7
%common;
8
8
]>
62
62
  <refsynopsisdiv>
63
63
    <cmdsynopsis>
64
64
      <command>&COMMANDNAME;</command>
 
65
      <group>
 
66
          <arg choice="plain"><option>--verbose</option></arg>
 
67
          <arg choice="plain"><option>-v</option></arg>
 
68
          <sbr/>
 
69
          <arg choice="plain"><option>--dump-json</option></arg>
 
70
          <arg choice="plain"><option>-j</option></arg>
 
71
      </group>
 
72
      <arg><option>--debug</option></arg>
 
73
      <group>
 
74
        <arg rep='repeat' choice='plain'>
 
75
          <replaceable>CLIENT</replaceable>
 
76
        </arg>
 
77
      </group>
 
78
    </cmdsynopsis>
 
79
    <cmdsynopsis>
 
80
      <command>&COMMANDNAME;</command>
65
81
      <group choice="req">
66
82
        <group>
67
83
          <arg choice="plain"><option>--enable</option></arg>
147
163
        </group>
148
164
      </group>
149
165
      <sbr/>
 
166
      <arg><option>--debug</option></arg>
150
167
      <group choice="req">
151
168
        <arg choice="plain"><option>--all</option></arg>
152
169
        <arg choice="plain"><option>-a</option></arg>
165
182
          <arg choice="plain"><option>--remove</option></arg>
166
183
          <arg choice="plain"><option>-r</option></arg>
167
184
      </group>
 
185
      <sbr/>
 
186
      <arg><option>--debug</option></arg>
168
187
      <group choice="req">
169
188
        <arg choice="plain"><option>--all</option></arg>
170
189
        <arg choice="plain"><option>-a</option></arg>
175
194
    </cmdsynopsis>
176
195
    <cmdsynopsis>
177
196
      <command>&COMMANDNAME;</command>
178
 
      <group>
179
 
          <arg choice="plain"><option>--verbose</option></arg>
180
 
          <arg choice="plain"><option>-v</option></arg>
181
 
          <sbr/>
182
 
          <arg choice="plain"><option>--dump-json</option></arg>
183
 
          <arg choice="plain"><option>-j</option></arg>
184
 
      </group>
185
 
      <group>
186
 
        <arg rep='repeat' choice='plain'>
187
 
          <replaceable>CLIENT</replaceable>
188
 
        </arg>
189
 
      </group>
190
 
    </cmdsynopsis>
191
 
    <cmdsynopsis>
192
 
      <command>&COMMANDNAME;</command>
193
197
      <group choice="req">
194
198
        <arg choice="plain"><option>--is-enabled</option></arg>
195
199
        <arg choice="plain"><option>-V</option></arg>
196
200
      </group>
 
201
      <arg><option>--debug</option></arg>
197
202
      <arg choice='plain'><replaceable>CLIENT</replaceable></arg>
198
203
    </cmdsynopsis>
199
204
    <cmdsynopsis>
507
512
      </varlistentry>
508
513
      
509
514
      <varlistentry>
 
515
        <term><option>--debug</option></term>
 
516
        <listitem>
 
517
          <para>
 
518
            Show debug output; currently, this means show D-Bus calls.
 
519
          </para>
 
520
        </listitem>
 
521
      </varlistentry>
 
522
      
 
523
      <varlistentry>
510
524
        <term><option>--check</option></term>
511
525
        <listitem>
512
526
          <para>
584
598
      <para>
585
599
 
586
600
<!-- do not wrap this line -->
587
 
<userinput>&COMMANDNAME; --timeout="5m" --interval="1m" foo1.example.org foo2.example.org</userinput>
 
601
<userinput>&COMMANDNAME; --timeout="PT5M" --interval="PT1M" foo1.example.org foo2.example.org</userinput>
588
602
 
589
603
      </para>
590
604
    </informalexample>