public-inbox.git  about / heads / tags
an "archives first" approach to mailing lists
blob 58d59ba2cc149b2e45053b054c6e06273b5b5c44 1218 bytes (raw)
$ git show HEAD:Documentation/public-inbox.cgi.pod	# shows this blob on the CLI

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
 
=head1 NAME

public-inbox.cgi - CGI wrapper for PublicInbox::WWW

=head1 SYNOPSIS

You generally want to run public-inbox-netd or public-inbox-httpd, instead

=head1 DESCRIPTION

public-inbox.cgi provides a CGI interface wrapper on top of the
PSGI/Plack L<PublicInbox::WWW> module.  It is only provided for
compatibility reasons and NOT recommended.

CGI with Perl is slow due to code loading overhead and
web servers lack the scheduling fairness of L<public-inbox-netd(1)>
and L<public-inbox-httpd(1)> for handling git clones and
streaming large mbox downloads.

=head1 COMPATIBILITY NOTE

When using the CGI with Apache, make sure to set AllowEncodedSlashes to On, as
public-inbox makes heavy use of encoded slashes.

=head1 CONTACT

Feedback welcome via plain-text mail to L<mailto:meta@public-inbox.org>

The mail archives are hosted at L<https://public-inbox.org/meta/> and
L<http://4uok3hntl7oi7b4uf4rtfwefqeexfzil2w6kgk2jn5z2f764irre7byd.onion/meta/>

=head1 COPYRIGHT

Copyright all contributors L<mailto:meta@public-inbox.org>

License: AGPL-3.0+ L<https://www.gnu.org/licenses/agpl-3.0.txt>

=head1 SEE ALSO

L<public-inbox-netd(1)>, L<public-inbox-httpd(1)>,
L<PublicInbox::WWW>, L<public-inbox-daemon(8)>,

git clone https://public-inbox.org/public-inbox.git
git clone http://7fh6tueqddpjyxjmgtdiueylzoqt6pt7hec3pukyptlmohoowvhde4yd.onion/public-inbox.git