FreeBSD Manual Pages
NAME spm -- simple password manager SYNOPSIS spm add [group/]entry spm del expression spm help spm list [-g] [group] spm search expression spm show expression DESCRIPTION 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 ac- cording to re_format(7). The following commands are available: add Prompt for a password if standard output is a terminal otherwise read from standard input and store it as entry. If group is speci- fied, non-existing groups are created automatically and the pass- word is stored under group/[../]. del Ask for confirmation and delete the entry matching expression on success. help Print a short usage and refer to this manual page. list 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. search Print the absoloute paths of all entries matching expression one per line. show 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. ENVIRONMENT The following environment variables will be used by spm if they are set and not empty: PASSWORD_STORE_DIR The storage root directory. This should be an absoloute path. PASSWORD_STORE_KEY Key ID used for de/encryption. Refer to gpg2(1) for accepted for- mats. FILES ~/.spm/ The default storage root directory. EXIT STATUS spm exits 1 if an error occurs otherwise 0. EXAMPlES 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)" SEE ALSO dmenu(1,) gpg2(1), gpg-agent(1), tpm(1), tree(1), re_format(7) CAVEATS Groups have to be deleted manually using rmdir(1). AUTHORS spm is written by Klemens Nanni <kl3@posteo.org>. April 21, 2017 SPM(1)
NAME | SYNOPSIS | DESCRIPTION | ENVIRONMENT | FILES | EXIT STATUS | EXAMPlES | SEE ALSO | CAVEATS | AUTHORS
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=spm&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>