commit e58a447a28a416ee719a9e457bfc8160a9b0e771
from: Anna “CyberTailor” <cyber@sysrq.in>
via: Omar Polo <op@omarpolo.com>
date: Thu Jul 29 07:31:09 2021 UTC

gmid.1: document logging

commit - 2887c631eed2e8f3fc64e454a8a036bc34e24742
commit + e58a447a28a416ee719a9e457bfc8160a9b0e771
blob - 0b06cd73790c2dfde20c0b563adf765afa66367e
blob + 6a3ac3838201f906398badc0ad56a1d7e904255c
--- README.md
+++ README.md
@@ -159,7 +159,7 @@ gmid is composed by four processes: the parent process
 the listener and the executor.  The parent process is the only one
 that doesn't drop privileges, but all it does is to wait for a SIGHUP
 to reload the configuration and spawn a new generation of children
-process.  The logger processes gather the logs and prints 'em to
+process.  The logger process gathers the logs and prints 'em to
 stderr or syslog (for the time being.)  The listener process is the
 only one that needs internet access and is sandboxed by default.  The
 executor process exists only to fork and execute CGI scripts, and
blob - 71bf2922f6e6d2a5fa3f34aa9ffa0414fddde3e7
blob + 726b0cb77e829effb300234bca94a0b4e6b157bd
--- gmid.1
+++ gmid.1
@@ -11,7 +11,7 @@
 .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
-.Dd $Mdocdate: January 30 2021$
+.Dd $Mdocdate: July 29 2021$
 .Dt GMID 1
 .Os
 .Sh NAME
@@ -598,6 +598,33 @@ text/plain
 .It xml
 text/xml
 .El
+.Sh LOGGING
+Messages and requests are logged by
+.Xr syslog 3
+using the
+.Dv DAEMON
+facility or printed on
+.Em stderr .
+.Pp
+Requests are logged with the
+.Dv NOTICE
+severity.
+Each request log entry has the following fields, separated by
+whitespace:
+.Pp
+.Bl -bullet -compact
+.It
+Client IP address and the source port number, separated by a colon
+.It
+.Sy GET
+keyword
+.It
+Request URL
+.It
+Response status
+.It
+Response meta
+.El
 .Sh EXAMPLES
 Serve the current directory
 .Bd -literal -offset indent