diff share/man/man1/roundup-server.1 @ 6514:a036712c96f4

Enable HTTP/1.1 support for roundup-server This enables keepalives and seems to prevent a lot of hangs/slowness in my configuration. configuration.py: add new HttpVersionOption. This is used by the command line/config in roundup-server. Validates http version string. roundup-server.py: enable HTTP 1.1 by default. use -V to set HTTP/1.0 on command line or set http_version in config file. Fix typo in config description for option include_headers. Add more vertical spacing for error report and usage display. roundup-server.1: add doc on -V also doc -I which was missing. Remove uneeded "to" from a sentence on ssl.
author John Rouillard <rouilj@ieee.org>
date Mon, 18 Oct 2021 20:12:09 -0400
parents 247f176f9020
children 36cf8a12a26b
line wrap: on
line diff
--- a/share/man/man1/roundup-server.1	Sat Oct 16 21:34:14 2021 -0400
+++ b/share/man/man1/roundup-server.1	Mon Oct 18 20:12:09 2021 -0400
@@ -35,8 +35,15 @@
 The variable "trackers" is available to the template and is a dict of all
 configured trackers.
 .TP
+\fB-I\fP \fIheader1[,header2,...]\fP
+Pass the header(s) and their values to the backend. This allow-list
+of header variables can be used by custom code in the tracker or with
+a tracker's \fBhttp_auth_header\fP configuration option to allows a
+front end server to authenticate a user and pass the user identity to
+roundup.
+.TP
 \fB-s\fP
-Enables to use of SSL.
+Enables use of SSL.
 .TP
 \fB-e\fP \fIfile\fP
 Sets a filename containing the PEM file to use for SSL. If left blank, a
@@ -45,6 +52,10 @@
 \fB-N\fP
 Log client machine names instead of IP addresses (much slower).
 .TP
+\fB-V\fP \fIHTTPVER\fP
+By default roundup-server uses HTTP/1.1 to enable keepalives for faster
+response. HTTPVER can be set to \fBHTTP/1.0\fP to disable keepalives.
+.TP
 \fB-u\fP \fIUID\fP
 Runs the Roundup web server as this UID.
 .TP

Roundup Issue Tracker: http://roundup-tracker.org/