===========
GnuPG Usage
===========

User
====

Create Key
----------

**Important:** GnuPG needs to be properly :doc:`configured <configuration>` to use strong hashes **before** creating new keys.

Create backup copy of public and private keys
---------------------------------------------

.. code-block:: bash

   gpg --output pubkey.asc --armor --export KEY_ID

.. code-block:: bash

   gpg --output seckey.asc --armor --export-secret-keys KEY_ID

Create Revocation Certificate
-----------------------------

.. code-block:: bash

   gpg --output revoke.asc --gen-revoke KEY_ID

Change or set passphrase on Key
-------------------------------

.. code-block:: bash

   gpg --edit-key KEY_ID

   gpg> passwd

   gpg> save


Change or set expiration on Key
-------------------------------

.. code-block:: bash

   gpg --edit-key KEY_ID

   gpg> key 1
   gpg> expire

   gpg> save


.. code-block:: bash
   
   gpg --send-key KEY_ID


Show Fingerprint
----------------

.. code-block:: bash

   gpg --fingerprint KEY_ID

Sign someone elses key
----------------------

.. code-block:: bash

   gpg --edit-key KEY_ID

   gpg> sign

   gpg> save


.. code-block:: bash

   gpg --send-key KEY_ID


Clearsign
---------

FIXME

Binary signature
----------------

FIXME

Detached signature
------------------

FIXME

Encryption
----------

FIXME

Decryption
----------

FIXME