GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
SPM(1) FreeBSD General Commands Manual SPM(1)

spm
simple password manager

spm add [group/]entry

spm del expression

spm help

spm list [-g] [group]

spm search expression

spm show expression

spm is a fully POSIX shell compliant script using gpg2(1) for encryption.

Entries are stored in a classical filesystem hierarchy where passwords are encrypted as individual files and directories may be used as groups. This way users can control access through file ownership, share entries entries with symbolic links and more just like any other files.

Group and entry names or expressions are considered relative to the storage root directoy. expression is interpreted as basic regular expression according to re_format(7). The following commands are available:

Prompt for a password if standard output is a terminal otherwise read from standard input and store it as entry. If group is specified, non-existing groups are created automatically and the password is stored under group/[../].
Ask for confirmation and delete the entry matching expression on success.
Print a short usage and refer to this manual page.
Print a recursive, indented tree-style list of all entries in group. If group is omitted, the entire storage root is listed. If the -g flag is passed only subgroups are shown.
Print the absoloute paths of all entries matching expression one per line.
Print the password to standard output if expression uniquely matches an entry and prompt for the decryption passphrase if it is not cached by gpg-agent(1) already.

The following environment variables will be used by spm if they are set and not empty:
The storage root directory. This should be an absoloute path.
Key ID used for de/encryption. Refer to gpg2(1) for accepted formats.

~/.spm/
The default storage root directory.

spm exits 1 if an error occurs otherwise 0.

Add Alice's password to the group users:
$ spm add users/alice
Password for 'users/alice':

Make sure she is an admin as well:

$ (cd ~/.spm
> mkdir admins
> ln -s ../members/alice admins/alice)

Copy her password into the X selection ready to be pasted somewhere:

$ spm show admins/alice | xclip -i

Find all admins starting with “a” or “b”:

$ spm search admins/[ab]
/home/alice/.spm/admins/alice
/home/alice/.spm/admins/bob

List all users:

$ spm list users
/home/alice/.spm/users
|-- alice
|-- bob
|-- temporary/
|   |-- tim
|   `-- tom

Find entries interactively using dmenu(1):

$ spm show "$(spm search . | dmenu -l 10)"

dmenu(1,) gpg2(1), gpg-agent(1), tpm(1), tree(1), re_format(7)

Groups have to be deleted manually using rmdir(1).

spm is written by Klemens Nanni <kl3@posteo.org>.
April 21, 2017

Search for    or go to Top of page |  Section 1 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.