Wed Jun 7 20:22:22 2023 UTC ()
add a note about how to setup http -> https redirection.

bump documented version.


(mrg)
diff -r1.92 -r1.93 src/libexec/httpd/bozohttpd.8

cvs diff -r1.92 -r1.93 src/libexec/httpd/bozohttpd.8 (expand / switch to unified diff)

--- src/libexec/httpd/bozohttpd.8 2022/09/12 10:34:20 1.92
+++ src/libexec/httpd/bozohttpd.8 2023/06/07 20:22:22 1.93
@@ -1,42 +1,42 @@ @@ -1,42 +1,42 @@
1.\" $NetBSD: bozohttpd.8,v 1.92 2022/09/12 10:34:20 martin Exp $ 1.\" $NetBSD: bozohttpd.8,v 1.93 2023/06/07 20:22:22 mrg Exp $
2.\" 2.\"
3.\" $eterna: bozohttpd.8,v 1.101 2011/11/18 01:25:11 mrg Exp $ 3.\" $eterna: bozohttpd.8,v 1.101 2011/11/18 01:25:11 mrg Exp $
4.\" 4.\"
5.\" Copyright (c) 1997-2022 Matthew R. Green 5.\" Copyright (c) 1997-2023 Matthew R. Green
6.\" All rights reserved. 6.\" All rights reserved.
7.\" 7.\"
8.\" Redistribution and use in source and binary forms, with or without 8.\" Redistribution and use in source and binary forms, with or without
9.\" modification, are permitted provided that the following conditions 9.\" modification, are permitted provided that the following conditions
10.\" are met: 10.\" are met:
11.\" 1. Redistributions of source code must retain the above copyright 11.\" 1. Redistributions of source code must retain the above copyright
12.\" notice, this list of conditions and the following disclaimer. 12.\" notice, this list of conditions and the following disclaimer.
13.\" 2. Redistributions in binary form must reproduce the above copyright 13.\" 2. Redistributions in binary form must reproduce the above copyright
14.\" notice, this list of conditions and the following disclaimer in the 14.\" notice, this list of conditions and the following disclaimer in the
15.\" documentation and/or other materials provided with the distribution. 15.\" documentation and/or other materials provided with the distribution.
16.\" 16.\"
17.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 17.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
18.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 18.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 19.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 20.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, 21.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
22.\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 22.\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
23.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED 23.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
24.\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 24.\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
25.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 25.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
26.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 26.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
27.\" SUCH DAMAGE. 27.\" SUCH DAMAGE.
28.\" 28.\"
29.Dd Sep 12, 22 29.Dd Sep 12, 2023
30.Dt BOZOHTTPD 8 30.Dt BOZOHTTPD 8
31.Os 31.Os
32.Sh NAME 32.Sh NAME
33.Nm bozohttpd 33.Nm bozohttpd
34.Nd hyper text transfer protocol version 1.1 daemon 34.Nd hyper text transfer protocol version 1.1 daemon
35.Sh SYNOPSIS 35.Sh SYNOPSIS
36.Nm 36.Nm
37.Op Fl EGHVXdefhnqsu 37.Op Fl EGHVXdefhnqsu
38.Op Fl C Ar suffix cgihandler 38.Op Fl C Ar suffix cgihandler
39.Op Fl I Ar port 39.Op Fl I Ar port
40.Op Fl L Ar prefix script 40.Op Fl L Ar prefix script
41.Op Fl M Ar suffix type encoding encoding11 41.Op Fl M Ar suffix type encoding encoding11
42.Op Fl m Ar version 42.Op Fl m Ar version
@@ -514,26 +514,31 @@ is reported as two failures to @@ -514,26 +514,31 @@ is reported as two failures to
514but no failures are recorded upon successful authorization 514but no failures are recorded upon successful authorization
515due to the decrease of the failure counter. 515due to the decrease of the failure counter.
516.Ss SSL SUPPORT 516.Ss SSL SUPPORT
517.Nm 517.Nm
518has support for TLSv1.1 and TLSv1.2 protocols that are included by 518has support for TLSv1.1 and TLSv1.2 protocols that are included by
519default. 519default.
520It requires linking with the crypto and ssl library, using 520It requires linking with the crypto and ssl library, using
521.Dq -lcrypto -lssl . 521.Dq -lcrypto -lssl .
522To disable SSL SUPPORT compile 522To disable SSL SUPPORT compile
523.Nm 523.Nm
524with 524with
525.Dq -DNO_SSL_SUPPORT 525.Dq -DNO_SSL_SUPPORT
526on the compiler command line. 526on the compiler command line.
 527.Pp
 528To have an enforced redirect, such as http to https, create a shadow
 529directory root that contains a
 530.Pa .bzabsredirect
 531file that points to the real target.
527.Ss COMPRESSION 532.Ss COMPRESSION
528.Nm 533.Nm
529supports a very basic form of compression. 534supports a very basic form of compression.
530.Nm 535.Nm
531will serve the requested file postpended with 536will serve the requested file postpended with
532.Dq Pa .gz 537.Dq Pa .gz
533if it exists, it is readable, the client requested gzip compression, and 538if it exists, it is readable, the client requested gzip compression, and
534the client did not make a ranged request. 539the client did not make a ranged request.
535.Sh FILES 540.Sh FILES
536.Nm 541.Nm
537looks for a couple of special files in directories that allow certain features 542looks for a couple of special files in directories that allow certain features
538to be provided on a per-directory basis. 543to be provided on a per-directory basis.
539The 544The
@@ -631,44 +636,45 @@ It would be invoked like: @@ -631,44 +636,45 @@ It would be invoked like:
631.Bd -literal 636.Bd -literal
632httpd -C .pl /www-scripts/bin/run.perl /var/www 637httpd -C .pl /www-scripts/bin/run.perl /var/www
633.Ed 638.Ed
634and the script could look like: 639and the script could look like:
635.Bd -literal 640.Bd -literal
636#! /bin/sh 641#! /bin/sh
637 642
638if [ -r "$SCRIPT_FILENAME" -a -x "$SCRIPT_FILENAME" ]; then 643if [ -r "$SCRIPT_FILENAME" -a -x "$SCRIPT_FILENAME" ]; then
639 exec /usr/pkg/bin/perl "$SCRIPT_FILENAME" 644 exec /usr/pkg/bin/perl "$SCRIPT_FILENAME"
640fi 645fi
641 646
642exit 1 647exit 1
643.Ed 648.Ed
 649
644.Sh SEE ALSO 650.Sh SEE ALSO
645.Xr inetd.conf 5 , 651.Xr inetd.conf 5 ,
646.Xr inetd 8 652.Xr inetd 8
647.Sh HISTORY 653.Sh HISTORY
648.Nm 654.Nm
649was first written in perl, based on another perl http server 655was first written in perl, based on another perl http server
650called 656called
651.Dq tinyhttpd . 657.Dq tinyhttpd .
652It was then rewritten from scratch in perl, and then once again in C. 658It was then rewritten from scratch in perl, and then once again in C.
653From 659From
654.Dq bozohttpd 660.Dq bozohttpd
655version 20060517, it has been integrated into 661version 20060517, it has been integrated into
656.Nx . 662.Nx .
657The focus has always been simplicity and security, with minimal features 663The focus has always been simplicity and security, with minimal features
658and regular code audits. 664and regular code audits.
659This manual documents 665This manual documents
660.Nm 666.Nm
661version 20220517. 667version 20230602.
662.Sh AUTHORS 668.Sh AUTHORS
663.An -nosplit 669.An -nosplit
664.Nm 670.Nm
665was written by 671was written by
666.An Matthew R. Green 672.An Matthew R. Green
667.Aq Mt mrg@eterna.com.au . 673.Aq Mt mrg@eterna.com.au .
668.Pp 674.Pp
669The large list of contributors includes: 675The large list of contributors includes:
670.Bl -dash 676.Bl -dash
671.It 677.It
672.An Christoph Badura 678.An Christoph Badura
673.Aq Mt bad@bsd.de 679.Aq Mt bad@bsd.de
674provided Range: header support 680provided Range: header support