/mandos/release

« back to all changes in this revision

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

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

• reverse the comparison (237.7.531 to 127)
• stop comparing with revision 127

Show diffs side-by-side

added

removed

plugins.d/password-prompt.xml

1

1

<?xml version="1.0" encoding="UTF-8"?>

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

 

<!ENTITY VERSION "1.0">

5

4

<!ENTITY COMMANDNAME "password-prompt">

6

 

<!ENTITY TIMESTAMP "2008-08-31">

 

5

<!ENTITY TIMESTAMP "2019-02-10">

 

6

<!ENTITY % common SYSTEM "../common.ent">

 

7

%common;

7

8

]>

8

9

 

9

 

<refentry>

 

10

<refentry xmlns:xi="http://www.w3.org/2001/XInclude">

10

11

  <refentryinfo>

11

12

    <title>Mandos Manual</title>

12

13

    <!-- NWalsh’s docbook scripts use this to generate the footer: -->

13

14

    <productname>Mandos</productname>

14

 

    <productnumber>&VERSION;</productnumber>

 

15

    <productnumber>&version;</productnumber>

15

16

    <date>&TIMESTAMP;</date>

16

17

    <authorgroup>

17

18

      <author>

18

19

        <firstname>Björn</firstname>

19

20

        <surname>Påhlsson</surname>

20

21

        <address>

21

 

          <email>belorn@fukt.bsnet.se</email>

 

22

          <email>belorn@recompile.se</email>

22

23

        </address>

23

24

      </author>

24

25

      <author>

25

26

        <firstname>Teddy</firstname>

26

27

        <surname>Hogeborn</surname>

27

28

        <address>

28

 

          <email>teddy@fukt.bsnet.se</email>

 

29

          <email>teddy@recompile.se</email>

29

30

        </address>

30

31

      </author>

31

32

    </authorgroup>

32

33

    <copyright>

33

34

      <year>2008</year>

 

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>

34

46

      <holder>Teddy Hogeborn</holder>

35

47

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

36

48

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

 

49

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

60

50

  </refentryinfo>

61

51

  

62

52

  <refmeta>

105

95

    <title>DESCRIPTION</title>

106

96

    <para>

107

97

      All <command>&COMMANDNAME;</command> does is prompt for a

108

 

      password and output any given password to standard output.  This

109

 

      is not very useful on its own.  This program is really meant to

110

 

      run as a plugin in the <application>Mandos</application>

111

 

      client-side system, where it is used as a fallback and

112

 

      alternative to retriving passwords from a <application

113

 

      >Mandos</application> server.

 

98

      password and output any given password to standard output.

 

99

    </para>

 

100

    <para>

 

101

      This program is not very useful on its own.  This program is

 

102

      really meant to run as a plugin in the <application

 

103

      >Mandos</application> client-side system, where it is used as a

 

104

      fallback and alternative to retrieving passwords from a

 

105

      <application >Mandos</application> server.

114

106

    </para>

115

107

    <para>

116

108

      This program is little more than a <citerefentry><refentrytitle

201

193

    <title>ENVIRONMENT</title>

202

194

    <variablelist>

203

195

      <varlistentry>

204

 

        <term><envar>cryptsource</envar></term>

205

 

        <term><envar>crypttarget</envar></term>

 

196

        <term><envar>CRYPTTAB_SOURCE</envar></term>

 

197

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

206

198

        <listitem>

207

199

          <para>

208

200

            If set, these environment variables will be assumed to

216

208

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

217

209

          normally have inherited them from

218

210

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

219

 

          initial RAM disk environment, which will have set them from

220

 

          parsing kernel arguments and

 

211

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

 

212

          have set them from parsing kernel arguments and

221

213

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

222

214

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

223

215

          created when the initial RAM disk image was created by

237

229

  

238

230

  <refsect1 id="bugs">

239

231

    <title>BUGS</title>

240

 

    <para>

241

 

      None are known at this time.

242

 

    </para>

 

232

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

243

233

  </refsect1>

244

234

  

245

235

  <refsect1 id="example">

262

252

      <para>

263

253

        Show a prefix before the prompt; in this case, a host name.

264

254

        It might be useful to be reminded of which host needs a

265

 

        password, in case of KVM switches, etc.

 

255

        password, in case of <acronym>KVM</acronym> switches, etc.

266

256

      </para>

267

257

      <para>

268

258

 

292

282

      >plugin-runner</refentrytitle><manvolnum>8mandos</manvolnum>

293

283

      </citerefentry>, and will, when run standalone, outside, in a

294

284

      normal environment, immediately output on its standard output

295

 

      any presumably secret password it just recieved.  Therefore,

 

285

      any presumably secret password it just received.  Therefore,

296

286

      when running this program standalone (which should never

297

287

      normally be done), take care not to type in any real secret

298

288

      password by force of habit, since it would then immediately be

310

300

  <refsect1 id="see_also">

311

301

    <title>SEE ALSO</title>

312

302

    <para>

 

303

      <citerefentry><refentrytitle>intro</refentrytitle>

 

304

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

313

305

      <citerefentry><refentrytitle>crypttab</refentrytitle>

314

306

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

315

 

      <citerefentry><refentrytitle>password-request</refentrytitle>

 

307

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

316

308

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

317

309

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

318

310

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

• Older »

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