/mandos/trunk

« back to all changes in this revision

Viewing changes to plugins.d/password-prompt.xml

• browse files at revision 24.1.149
• compare with another revision
• download diff
• download tarball
• view history from revision 24.1.149

• reverse the comparison (24.1.149 to 1244)
• stop comparing with revision 1244

Show diffs side-by-side

added

removed

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

5

 

<!ENTITY TIMESTAMP "2019-07-27">

 

5

<!ENTITY TIMESTAMP "2009-10-30">

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>2008</year>

35

35

      <year>2009</year>

36

 

      <year>2010</year>

37

 

      <year>2011</year>

38

 

      <year>2012</year>

39

 

      <year>2013</year>

40

 

      <year>2014</year>

41

 

      <year>2015</year>

42

 

      <year>2016</year>

43

 

      <year>2017</year>

44

 

      <year>2018</year>

45

 

      <year>2019</year>

46

36

      <holder>Teddy Hogeborn</holder>

47

37

      <holder>Björn Påhlsson</holder>

48

38

    </copyright>

69

59

        >PREFIX</replaceable></arg>

70

60

      </group>

71

61

      <sbr/>

72

 

      <arg choice="opt">

73

 

        <option>--prompt <replaceable>PROMPT</replaceable></option>

74

 

      </arg>

75

62

      <arg choice="opt"><option>--debug</option></arg>

76

63

    </cmdsynopsis>

77

64

    <cmdsynopsis>

113

100

      wrapper, although actual use of that function is not guaranteed

114

101

      or implied.

115

102

    </para>

116

 

    <para>

117

 

      This program tries to detect if a Plymouth daemon

118

 

      (<citerefentry><refentrytitle

119

 

      >plymouthd</refentrytitle><manvolnum>8</manvolnum></citerefentry>)

120

 

      is running, by looking for a

121

 

      <filename>/run/plymouth/pid</filename> file or a process named

122

 

      <quote><literal>plymouthd</literal></quote>.  If it is detected,

123

 

      this process will immediately exit without doing anything.

124

 

    </para>

125

103

  </refsect1>

126

104

  

127

105

  <refsect1 id="options">

150

128

      </varlistentry>

151

129

      

152

130

      <varlistentry>

153

 

        <term><option>--prompt=<replaceable

154

 

        >PROMPT</replaceable></option></term>

155

 

        <listitem>

156

 

          <para>

157

 

            The password prompt.  Using this option will make this

158

 

            program ignore the <envar>CRYPTTAB_SOURCE</envar> and

159

 

            <envar>CRYPTTAB_NAME</envar> environment variables.

160

 

          </para>

161

 

        </listitem>

162

 

      </varlistentry>

163

 

      

164

 

      <varlistentry>

165

131

        <term><option>--debug</option></term>

166

132

        <listitem>

167

133

          <para>

221

187

        <term><envar>CRYPTTAB_NAME</envar></term>

222

188

        <listitem>

223

189

          <para>

224

 

            If set, and if the <option>--prompt</option> option is not

225

 

            used, these environment variables will be assumed to

 

190

            If set, these environment variables will be assumed to

226

191

            contain the source device name and the target device

227

192

            mapper name, respectively, and will be shown as part of

228

193

            the prompt.

230

195

        <para>

231

196

          These variables will normally be inherited from

232

197

          <citerefentry><refentrytitle>plugin-runner</refentrytitle>

233

 

          <manvolnum>8mandos</manvolnum></citerefentry>, which might

234

 

          have in turn inherited them from its calling process.

 

198

          <manvolnum>8mandos</manvolnum></citerefentry>, which will

 

199

          normally have inherited them from

 

200

          <filename>/scripts/local-top/cryptroot</filename> in the

 

201

          initial <acronym>RAM</acronym> disk environment, which will

 

202

          have set them from parsing kernel arguments and

 

203

          <filename>/conf/conf.d/cryptroot</filename> (also in the

 

204

          initial RAM disk environment), which in turn will have been

 

205

          created when the initial RAM disk image was created by

 

206

          <filename

 

207

          >/usr/share/initramfs-tools/hooks/cryptroot</filename>, by

 

208

          extracting the information of the root file system from

 

209

          <filename >/etc/crypttab</filename>.

235

210

        </para>

236

211

        <para>

237

212

          This behavior is meant to exactly mirror the behavior of

238

 

          <command>askpass</command>, the default password prompter

239

 

          from initramfs-tools.

 

213

          <command>askpass</command>, the default password prompter.

240

214

        </para>

241

215

        </listitem>

242

216

      </varlistentry>

245

219

  

246

220

  <refsect1 id="bugs">

247

221

    <title>BUGS</title>

248

 

    <xi:include href="../bugs.xml"/>

 

222

    <para>

 

223

      None are known at this time.

 

224

    </para>

249

225

  </refsect1>

250

226

  

251

227

  <refsect1 id="example">

316

292

  <refsect1 id="see_also">

317

293

    <title>SEE ALSO</title>

318

294

    <para>

319

 

      <citerefentry><refentrytitle>intro</refentrytitle>

320

 

      <manvolnum>8mandos</manvolnum></citerefentry>,

 

295

      <citerefentry><refentrytitle>crypttab</refentrytitle>

 

296

      <manvolnum>5</manvolnum></citerefentry>

321

297

      <citerefentry><refentrytitle>mandos-client</refentrytitle>

322

 

      <manvolnum>8mandos</manvolnum></citerefentry>,

 

298

      <manvolnum>8mandos</manvolnum></citerefentry>

323

299

      <citerefentry><refentrytitle>plugin-runner</refentrytitle>

324

300

      <manvolnum>8mandos</manvolnum></citerefentry>,

325

 

      <citerefentry><refentrytitle>plymouthd</refentrytitle>

326

 

      <manvolnum>8</manvolnum></citerefentry>

327

301

    </para>

328

302

  </refsect1>

329

303

</refentry>

• Older »

Loggerhead is a web-based interface for Breezy
Version: 2.0.2.dev0