aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorOmar Polo <op@omarpolo.com>2024-08-03 10:49:39 +0000
committerOmar Polo <op@omarpolo.com>2024-08-03 10:49:39 +0000
commit69e34a630aa835783412477ebd41fed289361a71 (patch)
treed046a2be53eb1af51ecc139645cbb97c9445fdce
parent040f7aaca1032511212b4fbad28717dcfadc3d49 (diff)
gmid.conf.5: some love for the EXAMPLES section
Few grammar and style fixes, plus add an example about logging on a file. Prodded by https://github.com/omar-polo/gmid/issues/34
-rw-r--r--gmid.conf.525
1 files changed, 20 insertions, 5 deletions
diff --git a/gmid.conf.5 b/gmid.conf.5
index f509c5a..66e4299 100644
--- a/gmid.conf.5
+++ b/gmid.conf.5
@@ -631,7 +631,7 @@ if no mapping was found.
The following is an example of a possible configuration for a site
that enables only TLSv1.3, adds the MIME types mapping from
.Pa /usr/share/misc/mime.types
-and defines two virtual host:
+and defines two virtual hosts:
.Bd -literal -offset indent
protocols "tlsv1.3"
@@ -657,9 +657,9 @@ server "example.it" {
}
.Ed
.Pp
-Yet another example, showing how to enable a
+This example shows how to enable the
.Ic chroot
-and use
+and use a
.Ic location
rule
.Bd -literal -offset indent
@@ -686,13 +686,28 @@ server "example.com" {
}
.Ed
.Pp
-This shows how to set up a reverse proxy: all request for
+This example shows how to log requests to
+.Pa /var/gemini/logs/access.log
+when running in the
+.Pa /var/gemini
+chroot.
+The file will be created if not exists.
+.Bd -literal -offset indent
+chroot "/var/gemini"
+user "_gmid"
+
+log {
+ access "/logs/access.log" # relative to the chroot
+}
+.Ed
+.Pp
+This example shows how to set up a reverse proxy: all request for
.Sq example.com
will be forwarded to 10.0.0.6 transparently.
Proxying establish a new TLS connection, so any client-certificates used
to connect to
.Xr gmid 8
-cannot be provided to the proxied server as well.
+cannot be provided to the proxied server.
.Bd -literal -offset indent
server "example.com" {
listen on * port 1965