pwsafe(1)

1PWSAFE(1)                                                            PWSAFE(1)
2
3
4

NAME

6       pwsafe - commandline password database utility compatible with Counter‐
7       pane's Passwordsafe
8

SYNOPSIS

10       pwsafe [options] command [arg]
11

DESCRIPTION

13       pwsafe manipulates  Counterpane  Passwordsafe  username/password  data‐
14       bases.
15
16       It is compatible with Counterpane Passwordsafe 1.9.x and 2.0 databases.
17

COMMANDS

19       pwsafe accepts the following commands:
20
21       --createdb
22              Create a new database.
23
24       --exportdb
25              Export database as text.
26
27       --mergedb=DATABASE_FILE
28              Merge  DATABASE_FILE  into  database.  Common entries are merged
29              interactively.
30
31       --passwd
32              Change the database's passphrase.
33
34       --list[=REGEX]
35              List all [matching] entries in database.   If -u or -p is  given
36              then  REGEX  must  match  only one entry, and only the requested
37              field(s) are emitted.
38
39       -a, --add[=NAME]
40              Add an entry to database.
41
42       -e, --edit=REGEX
43              Edit an entry.
44
45       --delete=NAME
46              Delete an entry from database.
47
48       If no command is given, an interactive mode is entered.
49

OPTIONS

51       pwsafe accepts the following options:
52
53       -f, --file=DATABASE_FILE
54              Specify the database to manipulate. Default is $HOME/.pwsafe.dat
55
56       --dbversion=[1|2]
57              Specify the database's version. Default is 2.
58
59       -I, --case
60              REGEX  is  case-sensative.  Any  uppercase  character  in  REGEX
61              implies --case.
62
63       -l     Show login and notes in list output.
64
65       -u, --username
66              Show username of listed account(s).
67
68       -p, --password
69              Show password of listed accounts(s).
70
71       -E, --echo
72              Force  echo'ing  of entry to stdout. This is selected by default
73              if $DISPLAY is not set.
74
75       -o, --output=FILE
76              Redirect username and password output to FILE. Implies --echo.
77
78       -x, --xclip
79              Force copying of username and password to X clipboard.  This  is
80              selected by default if $DISPLAY is set.
81
82       -d, --display=XDISPLAY
83              Override $DISPLAY. Implies --xclip.
84
85       -s, --selection={Primary,Secondary,Clipboard,Both}
86              Select  the  X  selection  effected. Default is Both primary and
87              clipboard. Implies --xclip.
88
89       -G, --ignore=NAME@HOST
90              Add NAME to windows or hosts that do not receive the  selection.
91              If  just NAME is given it matches any host, and if just @HOST is
92              given it matches any name.
93
94       -v, --verbose
95              Print more information.
96
97       -q, --quiet
98              Print less information. In fact, print  only  exactly  what  was
99              requested.
100
101       -h, --help
102              Show summary of options.
103
104       -V, --version
105              Show version of program.
106
107

ENVIRONMENT

109       PWSAFE_DATABASE
110              Default  database file. If this is a relative path it is assumed
111              to be relative to $HOME. Defaults to  ".pwsafe.dat".  Overridden
112              by -f.
113
114       PWSAFE_DEFAULT_USER
115              Default user. Defaults to $USER or $LOGNAME.
116
117       PWSAFE_IGNORE
118              Overrides  built-in --ignore list. --ignore overrides. Format is
119              a list of --ignore arguments, seperated by colons (':').
120
121       HOME   Used to locate the default database "~/.pwsafe.dat" and  default
122              RANDFILE "~/.rnd".
123
124       RANDFILE
125              Used  to  locate  the random number generator entropy pool file.
126              Defaults to "$HOME/.rnd".
127

FILES

129       ~/.pwsafe.dat
130              The password database.
131
132       ~/.pwsafe.dat~
133              Backup of database.
134
135       ~/.rnd Random number generator's entropy pool.
136

WARNINGS

138       Use a good password for your database.
139
140       Don't use pwsafe over telnet or from untrusted terminals.
141
142       To seed RANDFILE decently, do something like
143          md5sum /var/log/* >~/.rnd
144

EXAMPLES

146       For those who can't read the rest of this file:
147
148       Create $HOME/.pwsafe.dat.
149
150              pwsafe --createdb
151
152       Add an entry named 'test'.
153
154              pwsafe -a test
155
156       Copy username and password of 'test' to console or X clipboard  &  pri‐
157       mary selection.
158
159              pwsafe -up test
160
161       Upgrade  a version passwordsafe version 1.7 database to version 2.0 (we
162       do this by merging it with itself, but specifying version 2 output)
163
164              pwsafe --mergedb $HOME/.pwsafe.dat --dbversion 2
165

AUTHOR

167       Nicolas S. Dade <ndade@nsd.dyndns.org>.
168

REPORTING BUGS

170       Report bugs to <ndade@nsd.dyndns.org>.
171

COPYRIGHT

173       Copyright © 2004-2005 Nicolas S. Dade.
174
175       This is free software; see the source for copying conditions.  There is
176       NO  warranty; not even for MERCHANTABILITY or FITNESS FOR A  PARTICULAR
177       PURPOSE.
178