Mirrors/go-chasquid-smtp
1
0
Fork 0
mirror of https://blitiri.com.ar/repos/chasquid synced 2026-10-28 15:02:28 +00:00
Code Releases Activity

docs: Regenerate man pages with a newer version of pod2man

Browse Source 
No content changes, just regeneration with a newer version of pod2man,
so future changes to the sources are cleaner and easier to review.
This commit is contained in:
Alberto Bertogli
2026-09-27 20:45:21 +01:00
parent a09963d91f
commit f22d2289af
5 changed files with 59 additions and 44 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/man/chasquid.conf.5
+14 -11
View File
@@ -1,5 +1,5 @@
.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
@@ -52,10 +52,13 @@
. \}
.\}
.rr rF
.\"
.\" Required to disable full justification in groff 1.23.0.
.if n .ds AD l
.\" ========================================================================
.\"
.IX Title "chasquid.conf 5"
.TH chasquid.conf 5 2025-06-07 "" ""
.TH chasquid.conf 5 2025-05-02 "" ""
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -64,10 +67,10 @@
chasquid.conf(5) \-\- chasquid configuration file
.SH SYNOPSIS
.IX Header "SYNOPSIS"
\&\fBchasquid.conf\fR\|(5) is \fBchasquid\fR\|(1)'s main configuration file.
\&\fBchasquid.conf\fR\|(5) is \fBchasquid\fR\|(1)\*(Aqs main configuration file.
.SH DESCRIPTION
.IX Header "DESCRIPTION"
The file is in protocol buffers' text format.
The file is in protocol buffers\*(Aq text format.
.PP
Comments start with \f(CW\*(C`#\*(C'\fR. Empty lines are allowed. Values are of the form
\&\f(CW\*(C`key: value\*(C'\fR. Values can be strings (quoted), integers, or booleans (\f(CW\*(C`true\*(C'\fR or
@@ -80,8 +83,8 @@ Some values might be repeated, for example the listening addresses.
.IX Item "hostname (string):"
Default hostname to use when saying hello. This is used to say hello to
clients (for aesthetic purposes), and as the HELO/EHLO domain on outgoing SMTP
connections (so ideally it would resolve back to the server, but it isn't a
big deal if it doesn't). Default: the system's hostname.
connections (so ideally it would resolve back to the server, but it isn\*(Aqt a
big deal if it doesn\*(Aqt). Default: the system\*(Aqs hostname.
.IP "\fBmax_data_size_mb\fR (int):" 8
.IX Item "max_data_size_mb (int):"
Maximum email size, in megabytes. Default: 50.
@@ -97,7 +100,7 @@ which means systemd passes sockets to us. systemd sockets must be named with
\&\fBFileDescriptorName=submission\fR.
.IP "\fBsubmission_over_tls_address\fR (repeated string):" 8
.IX Item "submission_over_tls_address (repeated string):"
Addresses to listen on for submission-over-TLS (usually port 465). Default:
Addresses to listen on for submission\-over\-TLS (usually port 465). Default:
"systemd", which means systemd passes sockets to us. systemd sockets must be
named with \fBFileDescriptorName=submission_tls\fR.
.IP "\fBmonitoring_address\fR (string):" 8
@@ -150,10 +153,10 @@ syslog (at \f(CW\*(C`MAIL|INFO\*(C'\fR priority). If \f(CW\*(C`<stdout>\*(C'\fR
\&\f(CW\*(C`<stderr>\*(C'\fR, log to stderr. Default: \f(CW\*(C`<syslog>\*(C'\fR.
.IP "\fBdovecot_auth\fR (bool):" 8
.IX Item "dovecot_auth (bool):"
Enable dovecot authentication. If true, users that are not found in chasquid's
Enable dovecot authentication. If true, users that are not found in chasquid\*(Aqs
databases will be authenticated via dovecot. Default: \f(CW\*(C`false\*(C'\fR.
.Sp
The path to dovecot's auth sockets is autodetected, but can be manually
The path to dovecot\*(Aqs auth sockets is autodetected, but can be manually
overridden using the \f(CW\*(C`dovecot_userdb_path\*(C'\fR and \f(CW\*(C`dovecot_client_path\*(C'\fR if
needed.
.IP "\fBhaproxy_incoming\fR (bool):" 8
@@ -164,7 +167,7 @@ information is preserved, and SPF checks can be performed properly.
Default: \f(CW\*(C`false\*(C'\fR.
.IP "\fBmax_queue_items\fR (int):" 8
.IX Item "max_queue_items (int):"
\&\fBEXPERIMENTAL\fR, might change in backwards-incompatible ways.
\&\fBEXPERIMENTAL\fR, might change in backwards\-incompatible ways.
.Sp
Maximum number of items in the queue.
.Sp
@@ -173,7 +176,7 @@ careful when increasing this, as we keep all items in memory.
Default: \f(CW200\fR (but may change in the future).
.IP "\fBgive_up_send_after\fR (string):" 8
.IX Item "give_up_send_after (string):"
\&\fBEXPERIMENTAL\fR, might change in backwards-incompatible ways.
\&\fBEXPERIMENTAL\fR, might change in backwards\-incompatible ways.
.Sp
How long do we keep retrying sending an email before we give up. Once we give
up, a DSN will be sent back to the sender.