tpm

 1=head1 NAME
 2
 3tpm - tiny password manager
 4
 5=head1 SYNOPSIS
 6
 7B<tpm> I<COMMAND> I<ENTRY>
 8
 9=head1 DESCRIPTION
10
11tpm is a tiny shell script which is heavily inspired and largely
12compatible with pass(1). Just like pass it uses gpg2(1) to securely
13store your passwords, the major difference between pass and tpm is that
14the latter is a lot more minimal. Furthermore, tpm is written entirely
15in POSIX shell.
16
17Invoking tpm consists of specifying a command either I<insert> or
18I<show> and supplying one entry as a target. If I<insert> is specified
19as a command tpm will create a new entry and prompt for the
20corresponding password. If you specify I<show> as a command tpm will
21write the password for the given entry to standard output.
22
23=head1 ENVIRONMENT
24
25=over 4
26
27=item B<PASSWORD_STORE_DIR>
28
29The storage directory (default: ~/.password-store).
30
31=item B<PASSWORD_STORE_KEY>
32
33GPG key to encrypt files with (default: self).
34
35=back
36
37=head1 FILES
38
39=over 4
40
41=item I<~/.password-store>
42
43The default storage directory.
44
45=item I<~/.password-store/.gpg-id>
46
47Provided for compatibility with pass(1).
48
49=back
50
51=head1 EXAMPLES
52
53Create a new entry with a random password using pwgen(1):
54
55	$ pwgen -1 | tpm insert system/new-user
56
57Create a new entry called 'system/root':
58
59	$ tpm insert system/root
60
61Write your 'system/root' password to standard output:
62
63	$ tpm show system/root
64
65Copy your 'system/root' password to the clipboard using xclip(1):
66
67	$ tpm show system/root | tr -d '\n' | xclip
68
69=head1 SEE ALSO
70
71gpg2(1), pass(1), pwgen(1), xclip(1)