


PWSAFE(1)                                               PWSAFE(1)


NAME
       pwsafe - commandline password database utility compatible with Counter-
       pane'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.




Nicolas S. Dade <ndade@nsd.dyn0.2.0rg>                          1





PWSAFE(1)                                               PWSAFE(1)


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



Nicolas S. Dade <ndade@nsd.dyn0.2.0rg>                          2





PWSAFE(1)                                               PWSAFE(1)


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



Nicolas S. Dade <ndade@nsd.dyn0.2.0rg>                          3





PWSAFE(1)                                               PWSAFE(1)


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

COPYRIGHT
       Copyright (C) 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 <ndade@nsd.dyn0.2.0rg>                          4


