SYNOPSIS

       pwsafe [options] command [arg]

DESCRIPTION

       pwsafe manipulates  Counterpane  Passwordsafe  username/password  data-
       bases.

       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

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

       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  &  pri-
       mary 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@nsd.dyndns.org>.

REPORTING BUGS

       Report bugs to <ndade@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/

Nicolas S. Dade

---

Man(1) output converted with man2html