summaryrefslogtreecommitdiff
path: root/share/man/keyringer.1.mdwn
diff options
context:
space:
mode:
authorSilvio Rhatto <rhatto@riseup.net>2013-09-05 23:24:05 -0300
committerSilvio Rhatto <rhatto@riseup.net>2013-09-05 23:24:05 -0300
commit5811e07b6caca8023d823b8e7cf3eedc1dc1f8d9 (patch)
tree761fe9a3e67eb9f36d518e06a962f92cfcd8ded6 /share/man/keyringer.1.mdwn
parent3e01335b6df32dbbc251aface2cb3e3bad61c05b (diff)
parentf91709c2abaa2b3011ef0b9799ce2fa010f9d534 (diff)
downloadkeyringer-5811e07b6caca8023d823b8e7cf3eedc1dc1f8d9.tar.gz
keyringer-5811e07b6caca8023d823b8e7cf3eedc1dc1f8d9.tar.bz2
Merge branch 'master' into debian
Diffstat (limited to 'share/man/keyringer.1.mdwn')
-rw-r--r--share/man/keyringer.1.mdwn99
1 files changed, 99 insertions, 0 deletions
diff --git a/share/man/keyringer.1.mdwn b/share/man/keyringer.1.mdwn
new file mode 100644
index 0000000..14ae687
--- /dev/null
+++ b/share/man/keyringer.1.mdwn
@@ -0,0 +1,99 @@
+% KEYRINGER(1) Keyringer User Manual
+% Silvio Rhatto
+% August 17, 2013
+
+# NAME
+
+keyringer - encrypted and distributed secret sharing software
+
+# SYNOPSIS
+
+keyringer <*keyring*> <*action*> [*options*]...
+
+# DESCRIPTION
+
+Keyringer lets you manage and share secrets using GPG and git with custom
+commands to encrypt, decrypt, recrypt, create key pairs, etc.
+
+# ACTIONS
+
+Keyringer has three types of actions:
+
+1. Configuration actions.
+2. Secret manipulation actions.
+3. Repository lookup and manipulation actions.
+
+## CONFIGURATION ACTIONS
+
+commands
+: List available actions, useful for shell completion and syntax check.
+
+options <*ls*|*edit*|*add*>
+: List, edit or add miscelaneous *repository options*.
+
+preferences <*ls*|*edit*|*add*>
+: List, edit or add *user options* for a given repository.
+
+recipients <*ls*|*edit*> <*recipient-file*>
+: List or edit recipient configuration.
+
+usage
+: Show usage information.
+
+## SECRET MANIPULATION ACTIONS
+
+All secret manipulation actions operates upon a *SECRET*, which is the pathname
+of an encrypted file relative to keyring with optional `.asc` extension.
+
+Secret manipulation actions do not commit changes into the secret repository.
+After any manipulation, the user has to manually commit the changes.
+
+append <*SECRET*>
+: Append contents into a secret.
+
+append-batch <*SECRET*>
+: Append contents into a secret, batch mode.
+
+decrypt <*SECRET*>
+: Decrypts a secret into standard output.
+
+del <*SECRET*>
+: Removes a secret using git. After deleting a secret a git commit and push is still
+ needed to update remote repositories. To completely remove a file from a keyring,
+ you should also rewrite the git history by yourself.
+
+edit <*SECRET*>
+: Edits a secret by temporarily decrypting it, opening the decrypted copy into *$EDITOR*
+ and then recrypting it again.
+
+encrypt [*file*] <*SECRET*>
+: Encrypts content from standard input or *file* into *SECRET*.
+
+encrypt-batch <*SECRET*>
+: Encrypt content, batch mode.
+
+genpair <*ssh*|*gpg*|*ssl*|*ssl-self*> [*options*]
+: Wrapper to generete encryption keypairs, useful for automated key deployment.
+
+open <*SECRET*>
+: Open a secret using xdg-open.
+
+recrypt <*SECRET*>
+: Recrypts a secret by decrypting it and recrypting again. Useful when users are added
+ into recipient configuration. If no *SECRET* is given, all secrets in the repository
+ are re-encrypted.
+
+# REPOSITORY LOOKUP AND MANIPULATION ACTIONS
+
+git <*action*> <*options*>
+: Git wrapper that operates from the toplevel keyring repository.
+
+ls <*PATH*>
+: List contents from the toplevel repository *keys* folder or from relative *PATH*.
+
+# SEE ALSO
+
+The *README* file distributed with Keyringer contains full documentation.
+
+The Keyringer source code and all documentation may be downloaded from
+<https://keyringer.pw>.