.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "AIOSMTPD" "1" "2024-02-10" "1.4.4.post2" "aiosmtpd"
.SH NAME
aiosmtpd \- asyncio based SMTP server
.sp
Provides an asynchronous, RFC 5321 compliant Simple Mail Transfer Protocol (SMTP) server that supports customizable
extensions.
.INDENT 0.0
.TP
.B Author
The aiosmtpd Developers
.TP
.B Date
2024\-02\-10
.TP
.B Copyright
2015\-2022, The aiosmtpd Developers
.TP
.B Version
1.4.4.post2
.TP
.B Manual section
1
.UNINDENT
.SH SYNOPSIS
.INDENT 0.0
.INDENT 3.5
.sp
.EX
usage: aiosmtpd [\-h] [\-v] [\-n] [\-c CLASSPATH] [\-s SIZE] [\-u] [\-d]
                [\-l [[HOST][:PORT]]] [\-\-smtpscert CERTFILE]
                [\-\-smtpskey KEYFILE] [\-\-tlscert CERTFILE] [\-\-tlskey KEYFILE]
                [\-\-no\-requiretls]
                [CLASSARGS ...]
.EE
.UNINDENT
.UNINDENT
.SS Options
.INDENT 0.0
.TP
.B CLASSARGS
Additional arguments passed to the handler CLASS.
.UNINDENT
.INDENT 0.0
.TP
.B \-h, \-\-help
show this help message and exit
.UNINDENT
.INDENT 0.0
.TP
.B \-v, \-\-version
show program\(aqs version number and exit
.UNINDENT
.INDENT 0.0
.TP
.B \-n, \-\-nosetuid
This program generally tries to setuid \fBnobody\fP, unless this flag is set.  The setuid call will fail if this program is not run as root (in which case, use this flag).
.UNINDENT
.INDENT 0.0
.TP
.B \-c <CLASSPATH>, \-\-class <CLASSPATH>
Use the given class, as a Python dotted import path, as the handler class for SMTP events.  This class can process received messages and do other actions during the SMTP dialog.  Uses \fBaiosmtpd.handlers.Debugging\fP by default.
.UNINDENT
.INDENT 0.0
.TP
.B \-s <SIZE>, \-\-size <SIZE>
Restrict the total size of the incoming message to \fBSIZE\fP number of bytes via the RFC 1870 SIZE extension. Defaults to 33,554,432 bytes.
.UNINDENT
.INDENT 0.0
.TP
.B \-u, \-\-smtputf8
Enable the \fBSMTPUTF8\fP extension as defined in RFC 6531.
.UNINDENT
.INDENT 0.0
.TP
.B \-d, \-\-debug
Increase debugging output. Every \fB\-d\fP increases debugging level by one.
.UNINDENT
.INDENT 0.0
.TP
.B \-l <[HOST][:PORT]>, \-\-listen <[HOST][:PORT]>
Optional host and port to listen on.  If the \fBPORT\fP part is not given, then port \fB8025\fP is used.  If only \fB:PORT\fP is given, then \fBlocalhost\fP is used for the hostname.  If neither are given, \fBlocalhost:8025\fP is used.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-smtpscert <CERTFILE>
The certificate file for implementing \fBSMTPS\fP\&. If given, the parameter \fB\-\-smtpskey\fP must also be specified.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-smtpskey <KEYFILE>
The key file for implementing \fBSMTPS\fP\&. If given, the parameter \fB\-\-smtpscert\fP must also be specified.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-tlscert <CERTFILE>
The certificate file for implementing \fBSTARTTLS\fP\&. If given, the parameter \fB\-\-tlskey\fP must also be specified.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-tlskey <KEYFILE>
The key file for implementing \fBSTARTTLS\fP\&. If given, the parameter \fB\-\-tlscert\fP must also be specified.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-no\-requiretls
If specified, disables \fBrequire_starttls\fP of the SMTP class. (By default, \fBrequire_starttls\fP is True.) Has no effect if \fB\-\-tlscert\fP and \fB\-\-tlskey\fP are not specified.
.UNINDENT
.SH ENVIRONMENT
.INDENT 0.0
.TP
.B AIOSMTPD_CONTROLLER_TIMEOUT
.nf
How long the main thread will wait (in seconds) until the SMTP thread is ready.
Default: \fB1.0\fP
.fi
.sp
.UNINDENT
.SH AUTHOR
The aiosmtpd Developers
.SH COPYRIGHT
2015-2024, The aiosmtpd Developers
.\" Generated by docutils manpage writer.
.