aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--Makefile2
-rw-r--r--man/forge-mail.531
-rw-r--r--man/forge.514
3 files changed, 46 insertions, 1 deletions
diff --git a/Makefile b/Makefile
index a5c9477..7d91c60 100644
--- a/Makefile
+++ b/Makefile
@@ -4,7 +4,7 @@
.PHONY: clean version.go man source.tar.gz
CFLAGS = -Wall -Wextra -Werror -pedantic -std=c99 -D_GNU_SOURCE
-MAN_PAGES = forge.5 hookc.1 forge.1
+MAN_PAGES = forge.5 hookc.1 forge.1 forge-mail.5
forge: source.tar.gz version.go hookc/*.c hookc/hookc man # TODO
go build .
diff --git a/man/forge-mail.5 b/man/forge-mail.5
new file mode 100644
index 0000000..58e3580
--- /dev/null
+++ b/man/forge-mail.5
@@ -0,0 +1,31 @@
+.\" SPDX-License-Identifier: AGPL-3.0-only
+.\" SPDX-FileCopyrightText: Copyright (c) 2025 Runxi Yu <https://runxiyu.org>
+.Dd March 30, 2025
+.Dt FORGE-MAIL 5
+.Os Lindenii Forge
+.Sh NAME
+.Nm forge-mail
+.Nd configuring Lindenii Forge email integration
+.Sh DESCRIPTION
+.Nm
+is a guide to configuring Lindenii Forge for email integration.
+.Pp
+This is currently a stub. Here is a working configuration that works
+for the Lindenii Project itself, though.
+.Sh /etc/smtpd/smtpd.conf
+.Bd -literal
+table forge file:/etc/smtpd/forge
+action "FORGE" lmtp "/srv/forge/lmtp.sock" rcpt-to virtual <forge>
+match from any for domain "forge.lindenii.runxiyu.org" action "FORGE"
+.Ed
+.Sh /etc/smtpd/forge
+.Bd -literal
+@ forge
+.Ed
+.Sh SEE ALSO
+.Xr forge 1 ,
+.Xr forge 5 ,
+.Xr smtpd.conf 5
+.Sh AUTHORS
+.An Runxi Yu Aq Mt https://runxiyu.org
+.An Test_User Aq Mt hax@runxiyu.org
diff --git a/man/forge.5 b/man/forge.5
index c8eed43..177c7f4 100644
--- a/man/forge.5
+++ b/man/forge.5
@@ -104,6 +104,20 @@ Maximum send queue size.
.It Ic nick , user , gecos
Identity fields for the IRC connection.
.El
+.It Ic lmtp
+Configuration for the LMTP/MX component. You may wish to refer to
+.Xr forge-mail 5
+for information on configuring your SMTP server.
+.Bl -tag -width Ds
+.It Ic socket
+The path to the UNIX domain socket to listen on.
+.It Ic max_size
+The maximum acceptable ingress message size.
+.It Ic domain
+The domain-part of our LMTP server.
+.It Ic read_timeout , write_timeout
+General timeouts for LMTP connections.
+.El
.El
.Sh FILES
.Bl -tag -width Ds