File dkim-genkey.8 of Package netqmail

.\"
.\" Copyright 2011 Peter Conrad <conrad@quisquis.de>
.\"
.\" This file is licensed under the terms of the
.\" GNU General Public License Version 2. A copy of these terms should be
.\" enclosed as "gpl-2.0.txt" in the package containing this file.
.\"
.TH dkim-genkey 8
.SH NAME
dkim-genkey \- create public/private key pair for DKIM signatures
.SH SYNOPSIS
.B dkim-genkey
.I basename
.SH DESCRIPTION
.B dkim-genkey
creates
.IR basename .key
containing a private key and
.IR basename .pub
containing a public key.

The private key is in a format suitable for use by the Mail::DKIM perl
module as used by the qmail-remote wrapper script. It must be configured
in @QMAIL_CONFDIR@/dkim/signconf.xml before it is used by qmail-remote.

The public key file contains a complete TXT record. It must be published
using a DNS server so that receiving MTAs can verify the signature
generated by qmail-remote.

.B dkim-genkey
will try to chgrp
.IR basename .key
to group mail and must therefore be run as root or as a user belonging
to the mail group.

.SH "SEE ALSO"
Mail::DKIM(3),
qmail-remote(8),
RFC-4871