/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 plugins.d/password-prompt.xml

  • Committer: Teddy Hogeborn
  • Date: 2008-09-19 20:54:58 UTC
  • Revision ID: teddy@fukt.bsnet.se-20080919205458-f90xsypwa6k7fby1
* debian/control (mandos-client): Depend on "cryptsetup".

* debian/mandos-client.README.Debian: Add the text from
                                      "etc-plugins.d-README".

* debian/mandos-client.postrm (purge): Hide failures.

* etc-plugins.d-README: Removed.

Show diffs side-by-side

added added

removed removed

Lines of Context:
plugins.d/password-prompt.xml
3
3
        "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4
4
<!ENTITY VERSION "1.0">
5
5
<!ENTITY COMMANDNAME "password-prompt">
6
 
<!ENTITY TIMESTAMP "2008-08-31">
 
6
<!ENTITY TIMESTAMP "2008-09-06">
7
7
]>
8
8
 
9
 
<refentry>
 
9
<refentry xmlns:xi="http://www.w3.org/2001/XInclude">
10
10
  <refentryinfo>
11
11
    <title>Mandos Manual</title>
12
12
    <!-- NWalsh’s docbook scripts use this to generate the footer: -->
34
34
      <holder>Teddy Hogeborn</holder>
35
35
      <holder>Björn Påhlsson</holder>
36
36
    </copyright>
37
 
    <legalnotice>
38
 
      <para>
39
 
        This manual page is free software: you can redistribute it
40
 
        and/or modify it under the terms of the GNU General Public
41
 
        License as published by the Free Software Foundation,
42
 
        either version 3 of the License, or (at your option) any
43
 
        later version.
44
 
      </para>
45
 
      
46
 
      <para>
47
 
        This manual page is distributed in the hope that it will
48
 
        be useful, but WITHOUT ANY WARRANTY; without even the
49
 
        implied warranty of MERCHANTABILITY or FITNESS FOR A
50
 
        PARTICULAR PURPOSE.  See the GNU General Public License
51
 
        for more details.
52
 
      </para>
53
 
      
54
 
      <para>
55
 
        You should have received a copy of the GNU General Public
56
 
        License along with this program; If not, see
57
 
        <ulink url="http://www.gnu.org/licenses/"/>.
58
 
      </para>
59
 
    </legalnotice>
 
37
    <xi:include href="../legalnotice.xml"/>
60
38
  </refentryinfo>
61
39
  
62
40
  <refmeta>
109
87
      is not very useful on its own.  This program is really meant to
110
88
      run as a plugin in the <application>Mandos</application>
111
89
      client-side system, where it is used as a fallback and
112
 
      alternative to retriving passwords from a <application
 
90
      alternative to retrieving passwords from a <application
113
91
      >Mandos</application> server.
114
92
    </para>
115
93
    <para>
134
112
    
135
113
    <variablelist>
136
114
      <varlistentry>
137
 
        <term><option>-p</option> <replaceable>PREFIX</replaceable
138
 
        ></term>
139
 
        <term><option>--prefix=</option><replaceable
140
 
        >PREFIX</replaceable></term>
 
115
        <term><option>--prefix=<replaceable
 
116
        >PREFIX</replaceable></option></term>
 
117
        <term><option>-p
 
118
        <replaceable>PREFIX</replaceable></option></term>
141
119
        <listitem>
142
120
          <para>
143
121
            Prefix string shown before the password prompt.
157
135
      </varlistentry>
158
136
      
159
137
      <varlistentry>
 
138
        <term><option>--help</option></term>
160
139
        <term><option>-?</option></term>
161
 
        <term><option>--help</option></term>
162
140
        <listitem>
163
141
          <para>
164
142
            Gives a help message about options and their meanings.
176
154
      </varlistentry>
177
155
      
178
156
      <varlistentry>
 
157
        <term><option>--version</option></term>
179
158
        <term><option>-V</option></term>
180
 
        <term><option>--version</option></term>
181
159
        <listitem>
182
160
          <para>
183
161
            Prints the program version.
216
194
          <manvolnum>8mandos</manvolnum></citerefentry>, which will
217
195
          normally have inherited them from
218
196
          <filename>/scripts/local-top/cryptroot</filename> in the
219
 
          initial RAM disk environment, which will have set them from
220
 
          parsing kernel arguments and
 
197
          initial <acronym>RAM</acronym> disk environment, which will
 
198
          have set them from parsing kernel arguments and
221
199
          <filename>/conf/conf.d/cryptroot</filename> (also in the
222
200
          initial RAM disk environment), which in turn will have been
223
201
          created when the initial RAM disk image was created by
262
240
      <para>
263
241
        Show a prefix before the prompt; in this case, a host name.
264
242
        It might be useful to be reminded of which host needs a
265
 
        password, in case of KVM switches, etc.
 
243
        password, in case of <acronym>KVM</acronym> switches, etc.
266
244
      </para>
267
245
      <para>
268
246
 
292
270
      >plugin-runner</refentrytitle><manvolnum>8mandos</manvolnum>
293
271
      </citerefentry>, and will, when run standalone, outside, in a
294
272
      normal environment, immediately output on its standard output
295
 
      any presumably secret password it just recieved.  Therefore,
 
273
      any presumably secret password it just received.  Therefore,
296
274
      when running this program standalone (which should never
297
275
      normally be done), take care not to type in any real secret
298
276
      password by force of habit, since it would then immediately be
312
290
    <para>
313
291
      <citerefentry><refentrytitle>crypttab</refentrytitle>
314
292
      <manvolnum>5</manvolnum></citerefentry>
315
 
      <citerefentry><refentrytitle>password-request</refentrytitle>
 
293
      <citerefentry><refentrytitle>mandos-client</refentrytitle>
316
294
      <manvolnum>8mandos</manvolnum></citerefentry>
317
295
      <citerefentry><refentrytitle>plugin-runner</refentrytitle>
318
296
      <manvolnum>8mandos</manvolnum></citerefentry>,