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 "plymouth">
5
<!ENTITY TIMESTAMP "2011-02-27">
5
<!ENTITY TIMESTAMP "2019-07-27">
6
6
<!ENTITY % common SYSTEM "../common.ent">
19
19
<firstname>Björn</firstname>
20
20
<surname>Påhlsson</surname>
22
<email>belorn@fukt.bsnet.se</email>
22
<email>belorn@recompile.se</email>
26
26
<firstname>Teddy</firstname>
27
27
<surname>Hogeborn</surname>
29
<email>teddy@fukt.bsnet.se</email>
29
<email>teddy@recompile.se</email>
36
44
<holder>Teddy Hogeborn</holder>
37
45
<holder>Björn Påhlsson</holder>
55
63
<command>&COMMANDNAME;</command>
65
<option>--prompt <replaceable>PROMPT</replaceable></option>
67
<arg><option>--debug</option></arg>
70
<command>&COMMANDNAME;</command>
72
<arg choice="plain"><option>--help</option></arg>
73
<arg choice="plain"><option>-?</option></arg>
77
<command>&COMMANDNAME;</command>
78
<arg choice="plain"><option>--usage</option></arg>
81
<command>&COMMANDNAME;</command>
83
<arg choice="plain"><option>--version</option></arg>
84
<arg choice="plain"><option>-V</option></arg>
94
124
<refsect1 id="options">
95
125
<title>OPTIONS</title>
97
This program takes no options.
127
This program is commonly not invoked from the command line; it
128
is normally started by the <application>Mandos</application>
129
plugin runner, see <citerefentry><refentrytitle
130
>plugin-runner</refentrytitle><manvolnum>8mandos</manvolnum>
131
</citerefentry>. Any command line options this program accepts
132
are therefore normally provided by the plugin runner, and not
138
<term><option>--prompt=<replaceable
139
>PROMPT</replaceable></option></term>
142
The password prompt. Note that using this option will
143
make this program ignore the <envar>cryptsource</envar>
144
and <envar>crypttarget</envar> environment variables.
150
<term><option>--debug</option></term>
153
Enable debug mode. This will enable a lot of output to
154
standard error about what the program is doing. The
155
program will still perform all other functions normally.
161
<term><option>--help</option></term>
162
<term><option>-?</option></term>
165
Gives a help message about options and their meanings.
171
<term><option>--usage</option></term>
174
Gives a short usage message.
180
<term><option>--version</option></term>
181
<term><option>-V</option></term>
184
Prints the program version.
101
191
<refsect1 id="exit_status">
117
207
<term><envar>crypttarget</envar></term>
120
If set, these environment variables will be assumed to
210
If set, and if the <option>--prompt</option> option is not
211
used, these environment variables will be assumed to
121
212
contain the source device name and the target device
122
213
mapper name, respectively, and will be shown as part of
126
217
These variables will normally be inherited from
127
218
<citerefentry><refentrytitle>plugin-runner</refentrytitle>
128
<manvolnum>8mandos</manvolnum></citerefentry>, which will
129
normally have inherited them from
130
<filename>/scripts/local-top/cryptroot</filename> in the
131
initial <acronym>RAM</acronym> disk environment, which will
132
have set them from parsing kernel arguments and
133
<filename>/conf/conf.d/cryptroot</filename> (also in the
134
initial RAM disk environment), which in turn will have been
135
created when the initial RAM disk image was created by
137
>/usr/share/initramfs-tools/hooks/cryptroot</filename>, by
138
extracting the information of the root file system from
139
<filename >/etc/crypttab</filename>.
219
<manvolnum>8mandos</manvolnum></citerefentry>, which might
220
have in turn inherited them from its calling process.
142
223
This behavior is meant to exactly mirror the behavior of
143
<command>askpass</command>, the default password prompter.
224
<command>askpass</command>, the default password prompter
225
from initramfs-tools.
261
352
<refsect1 id="see_also">
262
353
<title>SEE ALSO</title>
264
<citerefentry><refentrytitle>crypttab</refentrytitle>
265
<manvolnum>5</manvolnum></citerefentry>,
355
<citerefentry><refentrytitle>intro</refentrytitle>
356
<manvolnum>8mandos</manvolnum></citerefentry>,
266
357
<citerefentry><refentrytitle>plugin-runner</refentrytitle>
267
358
<manvolnum>8mandos</manvolnum></citerefentry>,
268
359
<citerefentry><refentrytitle>proc</refentrytitle>