pwsafe

Package: WA2L/edrc 1.5.57
Section: Library Commands (3)
Updated: 25 June 2020
Index Return to Main Contents

 

NAME

pwsafe - query the password safe for a password

 

SYNOPSIS

edrc/lib/pwsafe [ -h ]

pwsafe [ -c config_file ] user@system

 

AVAILABILITY

WA2L/edrc

 

DESCRIPTION

The pwsafe(3) command provides the possibility to access the password safe maintained by the contributed edrc command contrib.pwsafe(1m) in read only mode from outside of an edrc session.

 

OPTIONS

-h
print usage message.

-c config_file
edrc configuration file, see edrc.cfg(4) for more information.

This is to locate the password safe file within the related recovery tree.

user@system
the user on the related system or application to be queried.

 

ENVIRONMENT

$PWSAFE_MASTERPASSWORD
This environment variable must be set to the master password of the password safe to be able to query an encrypted password safe.

Be careful on how to handle the master password:

When writing a script accessing the pwsafe never supply the master password thru a command line option due to the fact that any user on the system would be able to see the password using the ps -ef command.

Therefore only use environment variables to pass the password around.

In addition the password shall not be saved in clear text.

 

EXIT STATUS

0
no error.

1
wrong master password.

2
operating system not supported.

4
usage message printed.

5
pwsafe aborted.

6
the given config_file does not exist in the edrc/etc/ directory.

7
the SCRIPTS_BASEDIR as defined in config_file does not exist.

8
permission denied to read password safe file.

9
CRYPT_MODE as defined for contrib.pwsafe(1m) is not supported on the system.

11
temporary directory could not be claimed or created in /var/tmp. Check the system temporary directory /var/tmp if you get this error, it is an indicator of system intrusion.

99
the CRYPT_MODE as defined for contrib.pwsafe(1m) is not implemented, yet.

 

FILES

pwsafe.dat
password safe file in a recovery script tree referenced by the config_file.

edrc/etc/contrib.edrc.pwsafe.cfg
optional configuration file of the contributed command contrib.pwsafe(1m).

 

EXAMPLES

1) using pwsafe in a script

A simple script sniplet to show how to use the pwsafe usage:

  #!/bin/ksh

  :
  :
  PWSAFE_MASTERPASSWORD=enigma
  export PWSAFE_MASTERPASSWORD

  appadm_password=`~edrc/lib/pwsafe appadmin@WEBAPP`
  appsys_password=`~edrc/lib/pwsafe system@acme007`
  :
  :

 

SEE ALSO

edrcintro(1), contrib.edrc(1m), contrib.pwsafe(1m)

 

NOTES

-

 

BUGS

-

 

AUTHOR

pwsafe was developed by Christian Walther. Send suggestions and bug reports to wa2l@users.sourceforge.net . 

 

COPYRIGHT

Copyright © 2020 Christian Walther

This is free software; see edrc/doc/COPYING for copying conditions. There is ABSOLUTELY NO WARRANTY; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.


 

Index

NAME
SYNOPSIS
AVAILABILITY
DESCRIPTION
OPTIONS
ENVIRONMENT
EXIT STATUS
FILES
EXAMPLES
SEE ALSO
NOTES
BUGS
AUTHOR
COPYRIGHT

This document was created by man2html using the manual pages.
Time: 16:54:08 GMT, August 28, 2024