1
0
mirror of https://blitiri.com.ar/repos/chasquid synced 2025-12-18 14:47:03 +00:00

docs: Regenerate man pages with a newer version of pod2man

The manpages are generated from pod files using pod2man, but it has been
a long time since we last re-generated them, and the new versions of
pod2man generate significantly different (and simpler) pages.

So this patch just regenerates the man pages, to make future changes
easier and more self contained to review.
This commit is contained in:
Alberto Bertogli
2025-05-02 12:09:38 +01:00
parent 2d228f726d
commit f2e1524a13
4 changed files with 67 additions and 379 deletions

View File

@@ -1,4 +1,5 @@
.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43) .\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
.\" .\"
.\" Standard preamble: .\" Standard preamble:
.\" ======================================================================== .\" ========================================================================
@@ -15,29 +16,12 @@
.ft R .ft R
.fi .fi
.. ..
.\" Set up some character translations and predefined strings. \*(-- will .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote. \*(C+ will
.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\ .ie n \{\
. ds -- \(*W-
. ds PI pi
. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
. ds L" ""
. ds R" ""
. ds C` "" . ds C` ""
. ds C' "" . ds C' ""
'br\} 'br\}
.el\{\ .el\{\
. ds -- \|\(em\|
. ds PI \(*p
. ds L" ``
. ds R" ''
. ds C` . ds C`
. ds C' . ds C'
'br\} 'br\}
@@ -68,79 +52,17 @@
. \} . \}
.\} .\}
.rr rF .rr rF
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear. Run. Save yourself. No user-serviceable parts.
. \" fudge factors for nroff and troff
.if n \{\
. ds #H 0
. ds #V .8m
. ds #F .3m
. ds #[ \f1
. ds #] \fP
.\}
.if t \{\
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
. ds #V .6m
. ds #F 0
. ds #[ \&
. ds #] \&
.\}
. \" simple accents for nroff and troff
.if n \{\
. ds ' \&
. ds ` \&
. ds ^ \&
. ds , \&
. ds ~ ~
. ds /
.\}
.if t \{\
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
. \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
. \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
. \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
. ds : e
. ds 8 ss
. ds o a
. ds d- d\h'-1'\(ga
. ds D- D\h'-1'\(hy
. ds th \o'bp'
. ds Th \o'LP'
. ds ae ae
. ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ======================================================================== .\" ========================================================================
.\" .\"
.IX Title "chasquid-util 1" .IX Title "chasquid-util 1"
.TH chasquid-util 1 "2025-03-21" "" "" .TH chasquid-util 1 2025-03-21 "" ""
.\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents. .\" way too many mistakes in technical documents.
.if n .ad l .if n .ad l
.nh .nh
.SH "NAME" .SH NAME
chasquid\-util \- chasquid management tool chasquid\-util \- chasquid management tool
.SH "SYNOPSIS" .SH SYNOPSIS
.IX Header "SYNOPSIS" .IX Header "SYNOPSIS"
\&\fBchasquid-util\fR [\fIoptions\fR] user-add \fIuser@domain\fR [\-\-password=\fIpassword\fR] [\-\-receive_only] \&\fBchasquid-util\fR [\fIoptions\fR] user-add \fIuser@domain\fR [\-\-password=\fIpassword\fR] [\-\-receive_only]
.PP .PP
@@ -155,10 +77,10 @@ chasquid\-util \- chasquid management tool
\&\fBchasquid-util\fR [\fIoptions\fR] domaininfo-remove \fIdomain\fR \&\fBchasquid-util\fR [\fIoptions\fR] domaininfo-remove \fIdomain\fR
.PP .PP
\&\fBchasquid-util\fR [\fIoptions\fR] print-config \&\fBchasquid-util\fR [\fIoptions\fR] print-config
.SH "DESCRIPTION" .SH DESCRIPTION
.IX Header "DESCRIPTION" .IX Header "DESCRIPTION"
chasquid-util is a command-line utility for \fBchasquid\fR\|(1) operations. chasquid-util is a command-line utility for \fBchasquid\fR\|(1) operations.
.SH "OPTIONS" .SH OPTIONS
.IX Header "OPTIONS" .IX Header "OPTIONS"
.IP "\fBuser-add\fR \fIuser@domain\fR [\-\-password=\fIpassword\fR] [\-\-receive_only]" 8 .IP "\fBuser-add\fR \fIuser@domain\fR [\-\-password=\fIpassword\fR] [\-\-receive_only]" 8
.IX Item "user-add user@domain [--password=password] [--receive_only]" .IX Item "user-add user@domain [--password=password] [--receive_only]"
@@ -182,13 +104,13 @@ Resolve the given address. Talks to the running chasquid instance.
.IX Item "domaininfo-remove domain" .IX Item "domaininfo-remove domain"
Remove the domain information entry. This can be used to manually allow a Remove the domain information entry. This can be used to manually allow a
security level downgrade. Talks to the running chasquid instance. security level downgrade. Talks to the running chasquid instance.
.IP "\fBprint-config\fR" 8 .IP \fBprint-config\fR 8
.IX Item "print-config" .IX Item "print-config"
Parse and print the configuration in a human-readable way. Parse and print the configuration in a human-readable way.
.IP "\fB\-C\fR or \fB\-\-config_dir=<path\fR>" 8 .IP "\fB\-C\fR or \fB\-\-config_dir=<path\fR>" 8
.IX Item "-C or --config_dir=<path>" .IX Item "-C or --config_dir=<path>"
Configuration directory. Configuration directory.
.IP "\fB\-\-configdir=<path\fR>" 8 .IP \fB\-\-configdir=<path\fR> 8
.IX Item "--configdir=<path>" .IX Item "--configdir=<path>"
Deprecated alias for \fB\-\-config_dir=<path\fR>. Deprecated alias for \fB\-\-config_dir=<path\fR>.
.SH "SEE ALSO" .SH "SEE ALSO"

View File

@@ -1,4 +1,5 @@
.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43) .\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
.\" .\"
.\" Standard preamble: .\" Standard preamble:
.\" ======================================================================== .\" ========================================================================
@@ -15,29 +16,12 @@
.ft R .ft R
.fi .fi
.. ..
.\" Set up some character translations and predefined strings. \*(-- will .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote. \*(C+ will
.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\ .ie n \{\
. ds -- \(*W-
. ds PI pi
. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
. ds L" ""
. ds R" ""
. ds C` "" . ds C` ""
. ds C' "" . ds C' ""
'br\} 'br\}
.el\{\ .el\{\
. ds -- \|\(em\|
. ds PI \(*p
. ds L" ``
. ds R" ''
. ds C` . ds C`
. ds C' . ds C'
'br\} 'br\}
@@ -68,88 +52,26 @@
. \} . \}
.\} .\}
.rr rF .rr rF
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear. Run. Save yourself. No user-serviceable parts.
. \" fudge factors for nroff and troff
.if n \{\
. ds #H 0
. ds #V .8m
. ds #F .3m
. ds #[ \f1
. ds #] \fP
.\}
.if t \{\
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
. ds #V .6m
. ds #F 0
. ds #[ \&
. ds #] \&
.\}
. \" simple accents for nroff and troff
.if n \{\
. ds ' \&
. ds ` \&
. ds ^ \&
. ds , \&
. ds ~ ~
. ds /
.\}
.if t \{\
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
. \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
. \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
. \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
. ds : e
. ds 8 ss
. ds o a
. ds d- d\h'-1'\(ga
. ds D- D\h'-1'\(hy
. ds th \o'bp'
. ds Th \o'LP'
. ds ae ae
. ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ======================================================================== .\" ========================================================================
.\" .\"
.IX Title "chasquid 1" .IX Title "chasquid 1"
.TH chasquid 1 "2023-10-03" "" "" .TH chasquid 1 2023-10-03 "" ""
.\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents. .\" way too many mistakes in technical documents.
.if n .ad l .if n .ad l
.nh .nh
.SH "NAME" .SH NAME
chasquid \- SMTP (email) server chasquid \- SMTP (email) server
.SH "SYNOPSIS" .SH SYNOPSIS
.IX Header "SYNOPSIS" .IX Header "SYNOPSIS"
\&\fBchasquid\fR [\fIoptions\fR...] \&\fBchasquid\fR [\fIoptions\fR...]
.SH "DESCRIPTION" .SH DESCRIPTION
.IX Header "DESCRIPTION" .IX Header "DESCRIPTION"
chasquid is an \s-1SMTP\s0 (email) server with a focus on simplicity, security, and chasquid is an SMTP (email) server with a focus on simplicity, security, and
ease of operation. ease of operation.
.PP .PP
It's written in Go, and distributed under the Apache license 2.0. It's written in Go, and distributed under the Apache license 2.0.
.SH "OPTIONS" .SH OPTIONS
.IX Header "OPTIONS" .IX Header "OPTIONS"
.IP "\fB\-config_dir\fR \fIdir\fR" 8 .IP "\fB\-config_dir\fR \fIdir\fR" 8
.IX Item "-config_dir dir" .IX Item "-config_dir dir"
@@ -159,13 +81,13 @@ configuration directory (default \fI/etc/chasquid\fR)
configuration values (in text protobuf format) to override the on-disk configuration values (in text protobuf format) to override the on-disk
configuration with. This should only be needed in very specific cases for configuration with. This should only be needed in very specific cases for
deployments where editing the configuration file is not feasible. deployments where editing the configuration file is not feasible.
.IP "\fB\-alsologtostderr\fR" 8 .IP \fB\-alsologtostderr\fR 8
.IX Item "-alsologtostderr" .IX Item "-alsologtostderr"
also log to stderr, in addition to the file also log to stderr, in addition to the file
.IP "\fB\-logfile\fR \fIfile\fR" 8 .IP "\fB\-logfile\fR \fIfile\fR" 8
.IX Item "-logfile file" .IX Item "-logfile file"
file to log to (enables logtime) file to log to (enables logtime)
.IP "\fB\-logtime\fR" 8 .IP \fB\-logtime\fR 8
.IX Item "-logtime" .IX Item "-logtime"
include the time when writing the log to stderr include the time when writing the log to stderr
.IP "\fB\-logtosyslog\fR \fItag\fR" 8 .IP "\fB\-logtosyslog\fR \fItag\fR" 8
@@ -174,50 +96,50 @@ log to syslog, with the given tag
.IP "\fB\-v\fR \fIlevel\fR" 8 .IP "\fB\-v\fR \fIlevel\fR" 8
.IX Item "-v level" .IX Item "-v level"
verbosity level (1 = debug) verbosity level (1 = debug)
.IP "\fB\-version\fR" 8 .IP \fB\-version\fR 8
.IX Item "-version" .IX Item "-version"
show version and exit show version and exit
.SH "FILES" .SH FILES
.IX Header "FILES" .IX Header "FILES"
The daemon's configuration is by default in \fI/etc/chasquid/\fR, and can be The daemon's configuration is by default in \fI/etc/chasquid/\fR, and can be
changed with the \fI\-config_dir\fR flag. changed with the \fI\-config_dir\fR flag.
.PP .PP
Inside that directory, the daemon expects the following structure: Inside that directory, the daemon expects the following structure:
.IP "\fIchasquid.conf\fR" 8 .IP \fIchasquid.conf\fR 8
.IX Item "chasquid.conf" .IX Item "chasquid.conf"
Main config file, see \fBchasquid.conf\fR\|(5). Main config file, see \fBchasquid.conf\fR\|(5).
.IP "\fIdomains/\fR" 8 .IP \fIdomains/\fR 8
.IX Item "domains/" .IX Item "domains/"
Per-domain configuration. Per-domain configuration.
.IP "\fIdomains/example.com/\fR" 8 .IP \fIdomains/example.com/\fR 8
.IX Item "domains/example.com/" .IX Item "domains/example.com/"
Domain-specific configuration. Can be empty. Domain-specific configuration. Can be empty.
.IP "\fIdomains/example.com/users\fR" 8 .IP \fIdomains/example.com/users\fR 8
.IX Item "domains/example.com/users" .IX Item "domains/example.com/users"
User and password database for this domain. User and password database for this domain.
.IP "\fIdomains/example.com/aliases\fR" 8 .IP \fIdomains/example.com/aliases\fR 8
.IX Item "domains/example.com/aliases" .IX Item "domains/example.com/aliases"
Aliases for the domain. Aliases for the domain.
.IP "\fIcerts/\fR" 8 .IP \fIcerts/\fR 8
.IX Item "certs/" .IX Item "certs/"
Certificates to use, one directory per pair. Certificates to use, one directory per pair.
.IP "\fIcerts/mx.example.com/\fR" 8 .IP \fIcerts/mx.example.com/\fR 8
.IX Item "certs/mx.example.com/" .IX Item "certs/mx.example.com/"
Certificates for this domain. Certificates for this domain.
.IP "\fIcerts/mx.example.com/fullchain.pem\fR" 8 .IP \fIcerts/mx.example.com/fullchain.pem\fR 8
.IX Item "certs/mx.example.com/fullchain.pem" .IX Item "certs/mx.example.com/fullchain.pem"
Certificate (full chain). Certificate (full chain).
.IP "\fIcerts/mx.example.com/privkey.pem\fR" 8 .IP \fIcerts/mx.example.com/privkey.pem\fR 8
.IX Item "certs/mx.example.com/privkey.pem" .IX Item "certs/mx.example.com/privkey.pem"
Private key. Private key.
.PP .PP
Note the \fIcerts/\fR directory layout matches the one from certbot (client for Note the \fIcerts/\fR directory layout matches the one from certbot (client for
Let's Encrypt \s-1CA\s0), so you can just symlink \fIcerts/\fR to Let's Encrypt CA), so you can just symlink \fIcerts/\fR to
\&\fI/etc/letsencrypt/live\fR. \&\fI/etc/letsencrypt/live\fR.
.PP .PP
Make sure the user you use to run chasquid under (\*(L"mail\*(R" in the example Make sure the user you use to run chasquid under ("mail" in the example
config) can access the certificates and private keys. config) can access the certificates and private keys.
.SH "CONTACT" .SH CONTACT
.IX Header "CONTACT" .IX Header "CONTACT"
Main website <https://blitiri.com.ar/p/chasquid>. Main website <https://blitiri.com.ar/p/chasquid>.
.PP .PP

View File

@@ -1,4 +1,5 @@
.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43) .\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
.\" .\"
.\" Standard preamble: .\" Standard preamble:
.\" ======================================================================== .\" ========================================================================
@@ -15,29 +16,12 @@
.ft R .ft R
.fi .fi
.. ..
.\" Set up some character translations and predefined strings. \*(-- will .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote. \*(C+ will
.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\ .ie n \{\
. ds -- \(*W-
. ds PI pi
. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
. ds L" ""
. ds R" ""
. ds C` "" . ds C` ""
. ds C' "" . ds C' ""
'br\} 'br\}
.el\{\ .el\{\
. ds -- \|\(em\|
. ds PI \(*p
. ds L" ``
. ds R" ''
. ds C` . ds C`
. ds C' . ds C'
'br\} 'br\}
@@ -68,105 +52,43 @@
. \} . \}
.\} .\}
.rr rF .rr rF
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear. Run. Save yourself. No user-serviceable parts.
. \" fudge factors for nroff and troff
.if n \{\
. ds #H 0
. ds #V .8m
. ds #F .3m
. ds #[ \f1
. ds #] \fP
.\}
.if t \{\
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
. ds #V .6m
. ds #F 0
. ds #[ \&
. ds #] \&
.\}
. \" simple accents for nroff and troff
.if n \{\
. ds ' \&
. ds ` \&
. ds ^ \&
. ds , \&
. ds ~ ~
. ds /
.\}
.if t \{\
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
. \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
. \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
. \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
. ds : e
. ds 8 ss
. ds o a
. ds d- d\h'-1'\(ga
. ds D- D\h'-1'\(hy
. ds th \o'bp'
. ds Th \o'LP'
. ds ae ae
. ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ======================================================================== .\" ========================================================================
.\" .\"
.IX Title "mda-lmtp 1" .IX Title "mda-lmtp 1"
.TH mda-lmtp 1 "2018-04-02" "" "" .TH mda-lmtp 1 2018-04-02 "" ""
.\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents. .\" way too many mistakes in technical documents.
.if n .ad l .if n .ad l
.nh .nh
.SH "NAME" .SH NAME
mda\-lmtp \- MDA that uses LMTP to do the mail delivery mda\-lmtp \- MDA that uses LMTP to do the mail delivery
.SH "SYNOPSIS" .SH SYNOPSIS
.IX Header "SYNOPSIS" .IX Header "SYNOPSIS"
mda-lmtp mda-lmtp
[\fB\-addr_network\fR \fInet\fR] [\fB\-addr_network\fR \fInet\fR]
\&\fB\-addr\fR \fIaddr\fR \&\fB\-addr\fR \fIaddr\fR
\&\fB\-d\fR \fIrecipient\fR \&\fB\-d\fR \fIrecipient\fR
\&\fB\-f\fR \fIfrom\fR \&\fB\-f\fR \fIfrom\fR
.SH "DESCRIPTION" .SH DESCRIPTION
.IX Header "DESCRIPTION" .IX Header "DESCRIPTION"
mda-lmtp is a very basic \s-1MDA\s0 that uses \s-1LMTP\s0 to do the mail delivery. mda-lmtp is a very basic MDA that uses LMTP to do the mail delivery.
.PP .PP
It takes command line arguments similar to maildrop or procmail, reads an It takes command line arguments similar to maildrop or procmail, reads an
email via standard input, and sends it over the given \s-1LMTP\s0 server. Supports email via standard input, and sends it over the given LMTP server. Supports
connecting to \s-1LMTP\s0 servers over \s-1UNIX\s0 sockets and \s-1TCP.\s0 connecting to LMTP servers over UNIX sockets and TCP.
.PP .PP
It can be used when your mail server does not support \s-1LMTP\s0 directly. It can be used when your mail server does not support LMTP directly.
.SH "EXAMPLE" .SH EXAMPLE
.IX Header "EXAMPLE" .IX Header "EXAMPLE"
\&\fBmda-lmtp\fR \fI\-\-addr=localhost:1234\fR \fI\-f juan@casa\fR \fI\-d jose\fR < email \&\fBmda-lmtp\fR \fI\-\-addr=localhost:1234\fR \fI\-f juan@casa\fR \fI\-d jose\fR < email
.SH "OPTIONS" .SH OPTIONS
.IX Header "OPTIONS" .IX Header "OPTIONS"
.IP "\fB\-addr\fR \fIaddress\fR" 8 .IP "\fB\-addr\fR \fIaddress\fR" 8
.IX Item "-addr address" .IX Item "-addr address"
\&\s-1LMTP\s0 server address to connect to. LMTP server address to connect to.
.IP "\fB\-addr_network\fR \fInetwork\fR" 8 .IP "\fB\-addr_network\fR \fInetwork\fR" 8
.IX Item "-addr_network network" .IX Item "-addr_network network"
Network of the \s-1LMTP\s0 address (e.g. \fIunix\fR or \fItcp\fR). If not present, it will Network of the LMTP address (e.g. \fIunix\fR or \fItcp\fR). If not present, it will
be autodetected from the address itself. be autodetected from the address itself.
.IP "\fB\-d\fR \fIrecipient\fR" 8 .IP "\fB\-d\fR \fIrecipient\fR" 8
.IX Item "-d recipient" .IX Item "-d recipient"
@@ -176,13 +98,13 @@ Recipient.
Whom the message is from. Whom the message is from.
.SH "RETURN VALUES" .SH "RETURN VALUES"
.IX Header "RETURN VALUES" .IX Header "RETURN VALUES"
.IP "\fB0\fR" 8 .IP \fB0\fR 8
.IX Item "0" .IX Item "0"
success success
.IP "\fB75\fR" 8 .IP \fB75\fR 8
.IX Item "75" .IX Item "75"
temporary failure temporary failure
.IP "\fIother\fR" 8 .IP \fIother\fR 8
.IX Item "other" .IX Item "other"
permanent failures (usually indicate misconfiguration) permanent failures (usually indicate misconfiguration)
.SH "SEE ALSO" .SH "SEE ALSO"

View File

@@ -1,4 +1,5 @@
.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43) .\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
.\" .\"
.\" Standard preamble: .\" Standard preamble:
.\" ======================================================================== .\" ========================================================================
@@ -15,29 +16,12 @@
.ft R .ft R
.fi .fi
.. ..
.\" Set up some character translations and predefined strings. \*(-- will .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote. \*(C+ will
.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\ .ie n \{\
. ds -- \(*W-
. ds PI pi
. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
. ds L" ""
. ds R" ""
. ds C` "" . ds C` ""
. ds C' "" . ds C' ""
'br\} 'br\}
.el\{\ .el\{\
. ds -- \|\(em\|
. ds PI \(*p
. ds L" ``
. ds R" ''
. ds C` . ds C`
. ds C' . ds C'
'br\} 'br\}
@@ -68,96 +52,34 @@
. \} . \}
.\} .\}
.rr rF .rr rF
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear. Run. Save yourself. No user-serviceable parts.
. \" fudge factors for nroff and troff
.if n \{\
. ds #H 0
. ds #V .8m
. ds #F .3m
. ds #[ \f1
. ds #] \fP
.\}
.if t \{\
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
. ds #V .6m
. ds #F 0
. ds #[ \&
. ds #] \&
.\}
. \" simple accents for nroff and troff
.if n \{\
. ds ' \&
. ds ` \&
. ds ^ \&
. ds , \&
. ds ~ ~
. ds /
.\}
.if t \{\
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
. \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
. \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
. \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
. ds : e
. ds 8 ss
. ds o a
. ds d- d\h'-1'\(ga
. ds D- D\h'-1'\(hy
. ds th \o'bp'
. ds Th \o'LP'
. ds ae ae
. ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ======================================================================== .\" ========================================================================
.\" .\"
.IX Title "smtp-check 1" .IX Title "smtp-check 1"
.TH smtp-check 1 "2023-07-14" "" "" .TH smtp-check 1 2023-07-14 "" ""
.\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents. .\" way too many mistakes in technical documents.
.if n .ad l .if n .ad l
.nh .nh
.SH "NAME" .SH NAME
smtp\-check \- SMTP setup checker smtp\-check \- SMTP setup checker
.SH "SYNOPSIS" .SH SYNOPSIS
.IX Header "SYNOPSIS" .IX Header "SYNOPSIS"
\&\fBsmtp-check\fR [\-port \fIport\fR] [\-localname \fIdomain\fR] [\-skip_tls_check] \fIdomain\fR \&\fBsmtp-check\fR [\-port \fIport\fR] [\-localname \fIdomain\fR] [\-skip_tls_check] \fIdomain\fR
.SH "DESCRIPTION" .SH DESCRIPTION
.IX Header "DESCRIPTION" .IX Header "DESCRIPTION"
smtp-check is a command-line too for checking \s-1SMTP\s0 setups (\s-1DNS\s0 records, \s-1TLS\s0 smtp-check is a command-line too for checking SMTP setups (DNS records, TLS
certificates, \s-1SPF,\s0 etc.). certificates, SPF, etc.).
.SH "OPTIONS" .SH OPTIONS
.IX Header "OPTIONS" .IX Header "OPTIONS"
.IP "\fB\-port\fR \fIport\fR:" 8 .IP "\fB\-port\fR \fIport\fR:" 8
.IX Item "-port port:" .IX Item "-port port:"
Port to use for connecting to the \s-1MX\s0 servers. Port to use for connecting to the MX servers.
.IP "\fB\-localname\fR \fIdomain\fR:" 8 .IP "\fB\-localname\fR \fIdomain\fR:" 8
.IX Item "-localname domain:" .IX Item "-localname domain:"
Local name to use for the \s-1EHLO\s0 command. Local name to use for the EHLO command.
.IP "\fB\-skip_tls_check\fR:" 8 .IP \fB\-skip_tls_check\fR: 8
.IX Item "-skip_tls_check:" .IX Item "-skip_tls_check:"
Skip \s-1TLS\s0 check (useful if connections are blocked). Skip TLS check (useful if connections are blocked).
.SH "SEE ALSO" .SH "SEE ALSO"
.IX Header "SEE ALSO" .IX Header "SEE ALSO"
\&\fBchasquid\fR\|(1) \&\fBchasquid\fR\|(1)