patatt - Man Page

DKIM-like cryptographic patch attestation

Synopsis

patatt {sign,validate,genkey,install-hook} [options]

Description

This tools allows cryptographically signing patches sent via email by using DKIM-like message headers. This approach is both effective and doesn't interfere with other code review tools the way inline or detached PGP signatures do. For a full overview of core concepts and considerations, please see README.

If you already have a PGP key configured for signing git tags or commits, then you should be able to use patatt without any additional configuration. Try running the following in any git repository:

git format-patch -1 --stdout | patatt sign

If patatt is not finding your PGP key, try adding the following to your ~/.gitconfig:

[user]
    signingkey = [yourkeyid]

To find out your keyid, run gpg --list-secret-keys. If you want to use a specific subkey, you can specify the subkey ID with a ! at the end.

Using As a Git Hook

If you use git-send-email for sending patches, then you can get them automatically signed via the sendemail-validate hook. To install, run the following command in the repository you want enabled for signing:

$ patatt install-hook

Or you can install it manually:

$ echo 'patatt sign --hook "${1}"' >> .git/hooks/sendemail-validate
$ chmod a+x .git/hooks/sendemail-validate

Subcommands

You can run patatt [subcommand] --help to see a summary of flags for each subcommand.

Support

Please email tools@linux.kernel.org with support requests.

Author

mricon@kernel.org

License: MIT-0

Info

2021-10-04 0.4.9