| @@ -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 |
514 | but no failures are recorded upon successful authorization | | 514 | but no failures are recorded upon successful authorization |
515 | due to the decrease of the failure counter. | | 515 | due to the decrease of the failure counter. |
516 | .Ss SSL SUPPORT | | 516 | .Ss SSL SUPPORT |
517 | .Nm | | 517 | .Nm |
518 | has support for TLSv1.1 and TLSv1.2 protocols that are included by | | 518 | has support for TLSv1.1 and TLSv1.2 protocols that are included by |
519 | default. | | 519 | default. |
520 | It requires linking with the crypto and ssl library, using | | 520 | It requires linking with the crypto and ssl library, using |
521 | .Dq -lcrypto -lssl . | | 521 | .Dq -lcrypto -lssl . |
522 | To disable SSL SUPPORT compile | | 522 | To disable SSL SUPPORT compile |
523 | .Nm | | 523 | .Nm |
524 | with | | 524 | with |
525 | .Dq -DNO_SSL_SUPPORT | | 525 | .Dq -DNO_SSL_SUPPORT |
526 | on the compiler command line. | | 526 | on the compiler command line. |
| | | 527 | .Pp |
| | | 528 | To have an enforced redirect, such as http to https, create a shadow |
| | | 529 | directory root that contains a |
| | | 530 | .Pa .bzabsredirect |
| | | 531 | file that points to the real target. |
527 | .Ss COMPRESSION | | 532 | .Ss COMPRESSION |
528 | .Nm | | 533 | .Nm |
529 | supports a very basic form of compression. | | 534 | supports a very basic form of compression. |
530 | .Nm | | 535 | .Nm |
531 | will serve the requested file postpended with | | 536 | will serve the requested file postpended with |
532 | .Dq Pa .gz | | 537 | .Dq Pa .gz |
533 | if it exists, it is readable, the client requested gzip compression, and | | 538 | if it exists, it is readable, the client requested gzip compression, and |
534 | the client did not make a ranged request. | | 539 | the client did not make a ranged request. |
535 | .Sh FILES | | 540 | .Sh FILES |
536 | .Nm | | 541 | .Nm |
537 | looks for a couple of special files in directories that allow certain features | | 542 | looks for a couple of special files in directories that allow certain features |
538 | to be provided on a per-directory basis. | | 543 | to be provided on a per-directory basis. |
539 | The | | 544 | The |
| @@ -631,44 +636,45 @@ It would be invoked like: | | | @@ -631,44 +636,45 @@ It would be invoked like: |
631 | .Bd -literal | | 636 | .Bd -literal |
632 | httpd -C .pl /www-scripts/bin/run.perl /var/www | | 637 | httpd -C .pl /www-scripts/bin/run.perl /var/www |
633 | .Ed | | 638 | .Ed |
634 | and the script could look like: | | 639 | and the script could look like: |
635 | .Bd -literal | | 640 | .Bd -literal |
636 | #! /bin/sh | | 641 | #! /bin/sh |
637 | | | 642 | |
638 | if [ -r "$SCRIPT_FILENAME" -a -x "$SCRIPT_FILENAME" ]; then | | 643 | if [ -r "$SCRIPT_FILENAME" -a -x "$SCRIPT_FILENAME" ]; then |
639 | exec /usr/pkg/bin/perl "$SCRIPT_FILENAME" | | 644 | exec /usr/pkg/bin/perl "$SCRIPT_FILENAME" |
640 | fi | | 645 | fi |
641 | | | 646 | |
642 | exit 1 | | 647 | exit 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 |
649 | was first written in perl, based on another perl http server | | 655 | was first written in perl, based on another perl http server |
650 | called | | 656 | called |
651 | .Dq tinyhttpd . | | 657 | .Dq tinyhttpd . |
652 | It was then rewritten from scratch in perl, and then once again in C. | | 658 | It was then rewritten from scratch in perl, and then once again in C. |
653 | From | | 659 | From |
654 | .Dq bozohttpd | | 660 | .Dq bozohttpd |
655 | version 20060517, it has been integrated into | | 661 | version 20060517, it has been integrated into |
656 | .Nx . | | 662 | .Nx . |
657 | The focus has always been simplicity and security, with minimal features | | 663 | The focus has always been simplicity and security, with minimal features |
658 | and regular code audits. | | 664 | and regular code audits. |
659 | This manual documents | | 665 | This manual documents |
660 | .Nm | | 666 | .Nm |
661 | version 20220517. | | 667 | version 20230602. |
662 | .Sh AUTHORS | | 668 | .Sh AUTHORS |
663 | .An -nosplit | | 669 | .An -nosplit |
664 | .Nm | | 670 | .Nm |
665 | was written by | | 671 | was 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 |
669 | The large list of contributors includes: | | 675 | The 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 |
674 | provided Range: header support | | 680 | provided Range: header support |