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 databases.

COMMANDS
pwsafe accepts the following commands:

--createdb
    Create a new database.

--passwd
    Change the database's passphrase.

--list[=REGEX]
    List all [matching] entries in database. If no command is given, --list is assumed. 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.

OPTIONS
pwsafe accepts the following options:

-f, --file=DATABASE_FILE
    Specify the database to manipulate. Default is $HOME/.pwsafe.dat

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

-v, --verbose
    Print more information.

-h, --help
    Show summary of options.

-V, --version
    Show version of program.

ENVIRONMENT

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

AUTHOR
Nicolas S. Dade <ndade@nsd.dyndns.org>.

REPORTING BUGS
Report bugs to <ndade@nsd.dyndns.org>.

COPYRIGHT
Copyright © 2004 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/