From 24fb88dbb023ae08adc9989bf19e0c6c569a6607 Mon Sep 17 00:00:00 2001 From: Laurent Bercot Date: Mon, 16 Oct 2023 17:45:02 +0000 Subject: Doc fixes Signed-off-by: Laurent Bercot --- doc/tipideed.html | 25 ++++++++++++++++--------- 1 file changed, 16 insertions(+), 9 deletions(-) (limited to 'doc/tipideed.html') diff --git a/doc/tipideed.html b/doc/tipideed.html index 1d764ff..254fa2f 100644 --- a/doc/tipideed.html +++ b/doc/tipideed.html @@ -120,8 +120,7 @@ underlying system.

tipideed expects the following variables in its environment, and will exit with an error message if they are undefined. When tipideed is run under -s6-tcpserver -(with s6-tcpserver-access) or +s6-tcpserver or s6-tlsserver, these variables are automatically set by the super-server. This is the way tipidee gets its network information without having to perform network @@ -136,6 +135,10 @@ operations itself.

The IP address the server is bound to. It will be passed as SERVER_ADDR to CGI scripts.
+
TCPLOCALPORT
+
The port the server is bound to. It will be passed as SERVER_PORT +to CGI scripts unless the requested URI explicitly mentions a different port.
+
TCPREMOTEIP
The IP address of the client. It will be passed as REMOTE_ADDR to CGI scripts.
@@ -149,7 +152,13 @@ to CGI scripts.

tipideed can function without these variables, but if they're present, it -uses them to get more information. +uses them to get more information. They're typically obtained by calling +s6-tcpserver-access +before tipideed in the +s6-tcpserver +command line. +(For HTTPS, s6-tlsserver +calls it implicitly.)

@@ -160,12 +169,6 @@ not mention a Host, i.e. in HTTP/1.0 requests without a full request URL. If this variable is absent, the default will be set to the local IP address itself (between square brackets if IPv6). -
TCPLOCALPORT
-
The port the server is bound to. It will be passed as SERVER_PORT -to CGI scripts unless the requested URI explicitly mentions a different port. -If this variable is absent, the default will be set to 80 in case of HTTP or -443 in the case of HTTPS.
-
TCPREMOTEHOST
The domain name associated to the IP address of the client. It will be passed as REMOTE_HOST to CGI scripts; if absent, the value of @@ -487,6 +490,10 @@ It makes no sense to try to follow the book to the letter, expending precious resources, when the client can't even be bothered to pretend it's legit. Knowing when to exit early is crucial for good resource management. +
  • tipideed does not have any configuration defaults baked in; it +reads all its configuration values, including the defaults, from the cdb +file created by tipidee-config. That +is why having such a cdb file is mandatory for tipideed to run.
  • tipideed is pronounced tipi-deed. You can say tipi-dee-dee, but only if you're the type of person who also says PC computer, NIC card or ATM machine.
    • -- cgit v1.3.1