adding notes and reference for gpg usage

README.md

@@ -2,3 +2,9 @@
 
 # gpgport
 GnuPG enables encryption   and signing of data and communication, and features a versatile key   management system as well as access modules for public key   directories.
+
+## Quick start usage notes
+
+Documentation on gpg usage is available [here](usage_quickstart.md)
+
+

usage_quickstart.md

@@ -0,0 +1,120 @@
+# notes on gpg usage
+
+These are notes on how to encrypt key files
+
+# Create a key
+`gpg --gen-key`
+
+# Create a public key for someone to use
+`gpg --armor --output mypubkey.gpg --export [email protected]`
+
+# Encrypt a file named testy.txt
+`gpg --output testy.txt.gpg --encrypt --recipient [email protected] testy.txt`
+
+# Decrypt a file named testy.txt.gpg
+`gpg --output test.txt --decrypt test.txt.gpg`
+
+# How to export your key
+* list keys to get ID
+`gpg --list-secret-keys [email protected]`
+*  export the key
+`gpg --export-secret-keys YOUR_ID_HERE > private.key`
+* import the key on a second computer
+`gpg --import private.key`
+
+
+# keyserver
+
+https://keys.openpgp.org/about/usage
+
+## Retrieving keys
+
+To locate the key of a user, by email address:
+
+```
+
+FORM:
+gpg --auto-key-locate keyserver --locate-keys [email protected]
+
+$ gpg --auto-key-locate hkps://keys.openpgp.org --locate-keys [email protected]
+
+```
+
+To refresh all your keys (e.g. new revocation certificates and subkeys):
+
+```
+gpg --refresh-keys
+gpg --refresh-keys --keyserver pgp.mit.edu
+
+```
+
+### Uploading your key
+
+Keys can be uploaded with GnuPG's --send-keys command, but identity information can't be verified that way to make the key searchable by email address (what does this mean?).
+
+You can try this shortcut for uploading your key, which outputs a direct link to the verification page:
+
+```
+gpg --export [email protected] | curl -T - https://keys.openpgp.org
+```
+
+Alternatively, you can export them to a file and select that file in the upload page:
+
+```
+gpg --export [email protected] > my_key.pub
+```
+
+### Trusting keys
+
+https://stackoverflow.com/questions/33361068/gnupg-there-is-no-assurance-this-key-belongs-to-the-named-user
+
+#### Obtain the key-id
+
+I'm not certain why this output is identical, but perhaps its because its mine.
+
+```
+$ gpg --list-secret-keys [email protected]
+sec   rsa3072 2022-01-01 [SC] [expires: 2024-01-01]
+      XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+uid           [ultimate] John F. Davis <[email protected]>
+ssb   rsa3072 2022-01-01 [E] [expires: 2024-01-01]
+```
+
+```
+$ gpg --list-public-keys [email protected]
+pub   rsa3072 2022-01-01 [SC] [expires: 2024-01-01]
+      XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+uid           [ultimate] John F. Davis <[email protected]>
+sub   rsa3072 2022-01-01 [E] [expires: 2024-01-01]
+
+```
+
+The value for `XXXXX` above is what is used in `<KEY-ID> below.`
+
+```
+gpg --edit-key <KEY_ID>
+gpg> trust
+select value
+gpg> quit
+```
+
+## send key to specific server
+
+```
+gpg --send-keys --keyserver pgp.mit.edu
+```
+
+## search a specific server 
+
+```
+gpg --keyserver pgp.mit.edu --search [email protected]
+```
+
+## encrypt multiple recipients
+
+```
+gpg --output testy.txt.gpg --encrypt --recipient [email protected] --recipient [email protected] testy.txt
+```
+
+
+