SysTutorials

Linux Manual Pages › Section 1

pwsafe(1)

NAME

pwsafe – commandline password database utility compatible with Counterpane’s Passwordsafe

SYNOPSIS

pwsafe [options] command [arg]

DESCRIPTION

pwsafe manipulates Counterpane Passwordsafe username/password databases.

It is compatible with Counterpane Passwordsafe 1.9.x and 2.0 databases.

COMMANDS

pwsafe accepts the following commands:

–createdb
Create a new database.
–exportdb
Export database as text.
–mergedb=DATABASE_FILE
Merge DATABASE_FILE into database. Common entries are merged interactively.
–passwd
Change the database’s passphrase.
–list[=REGEX]
List all [matching] entries in database. If -u or -p is given then REGEX must match only one entry, and only the requested field(s) are emitted.
-a, –add[=NAME]
Add an entry to database.
-e, –edit=REGEX
Edit an entry.
–delete=NAME
Delete an entry from database.
If no command is given, an interactive mode is entered.

OPTIONS

pwsafe accepts the following options:

-f, –file=DATABASE_FILE
Specify the database to manipulate. Default is $HOME/.pwsafe.dat
–dbversion=[1|2]
Specify the database’s version. Default is 2.
-I, –case
REGEX is case-sensative. Any uppercase character in REGEX implies –case.
-l
Show login and notes in list output.
-u, –username
Show username of listed account(s).
-p, –password
Show password of listed accounts(s).
-E, –echo
Force echo’ing of entry to stdout. This is selected by default if $DISPLAY is not set.
-o, –output=FILE
Redirect username and password output to FILE. Implies –echo.
-x, –xclip
Force copying of username and password to X clipboard. This is selected by default if $DISPLAY is set.
-d, –display=XDISPLAY
Override $DISPLAY. Implies –xclip.
-s, –selection={Primary,Secondary,Clipboard,Both}
Select the X selection effected. Default is Both primary and clipboard. Implies –xclip.
-G, –ignore=NAME [at] HOST
Add NAME to windows or hosts that do not receive the selection. If just NAME is given it matches any host, and if just @HOST is given it matches any name.
-v, –verbose
Print more information.
-q, –quiet
Print less information. In fact, print only exactly what was requested.
-h, –help
Show summary of options.
-V, –version
Show version of program.

ENVIRONMENT

PWSAFE_DATABASE
Default database file. If this is a relative path it is assumed to be relative to $HOME. Defaults to ".pwsafe.dat". Overridden by -f.
PWSAFE_DEFAULT_USER
Default user. Defaults to $USER or $LOGNAME.
PWSAFE_IGNORE
Overrides built-in –ignore list. –ignore overrides. Format is a list of –ignore arguments, seperated by colons (‘:’).
HOME
Used to locate the default database "~/.pwsafe.dat" and default RANDFILE "~/.rnd".
RANDFILE
Used to locate the random number generator entropy pool file. Defaults to "$HOME/.rnd".

FILES

~/.pwsafe.dat
The password database.
~/.pwsafe.dat~
Backup of database.
~/.rnd
Random number generator’s entropy pool.

WARNINGS

Use a good password for your database.

Don’t use pwsafe over telnet or from untrusted terminals.

To seed RANDFILE decently, do something like

md5sum /var/log/* >~/.rnd

EXAMPLES

For those who can’t read the rest of this file:

Create $HOME/.pwsafe.dat.

pwsafe –createdb

Add an entry named ‘test’.

pwsafe -a test

Copy username and password of ‘test’ to console or X clipboard & primary selection.

pwsafe -up test

Upgrade a version passwordsafe version 1.7 database to version 2.0 (we do this by merging it with itself, but specifying version 2 output)

pwsafe –mergedb $HOME/.pwsafe.dat –dbversion 2

AUTHOR

Nicolas S. Dade <ndade [at] nsd.dyndns.org>.

REPORTING BUGS

Report bugs to <ndade [at] nsd.dyndns.org>.

COPYRIGHT

Copyright © 2004-2005 Nicolas S. Dade.

This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

SEE ALSO

http://nsd.dyndns.org/pwsafe/
http://passwordsafe.sourceforge.net/, http://www.counterpane.com/