X-Git-Url: http://www.git.stargrave.org/?a=blobdiff_plain;f=Documentation%2Fpublic-inbox-daemon.pod;h=3bf95496e89191b3092a4d215b93177b90c08d11;hb=0b15dfc58ceaecdcb1c9285c3ad55813006c8338;hp=42beda69927d5104769145eeac01d5cb8c5a04ef;hpb=66c6699142d95cce9e5c9d49e0498161a776cc22;p=public-inbox.git diff --git a/Documentation/public-inbox-daemon.pod b/Documentation/public-inbox-daemon.pod index 42beda69..3bf95496 100644 --- a/Documentation/public-inbox-daemon.pod +++ b/Documentation/public-inbox-daemon.pod @@ -12,8 +12,7 @@ public-inbox-daemon - common usage for public-inbox network daemons This manual describes common options and behavior for public-inbox network daemons. Network daemons for public-inbox provide read-only NNTP and HTTP access to public-inboxes. Write -access to a public-inbox repository will never be required to -run these. +access to a public-inbox will never be required to run these. These daemons are implemented with a common core using non-blocking sockets and optimized for fairness; even with @@ -25,8 +24,6 @@ breaking existing connections during software upgrades. These daemons may also utilize multiple pre-forked worker processes to take advantage of multiple CPUs. -Native TLS (Transport Layer Security) support is planned. - =head1 OPTIONS =over @@ -37,11 +34,14 @@ This takes an absolute path to a Unix socket or HOST:PORT to listen on. For example, to listen to TCP connections on port 119, use: C<-l 0.0.0.0:119>. This may also point to a Unix socket (C<-l /path/to/http.sock>) for a reverse proxy -like L to use. +like L to use. May be specified multiple times to allow listening on multiple sockets. +This does not need to be specified at all if relying on +L or similar + Default: server-dependent unless socket activation is used with L or similar (see L). @@ -77,7 +77,7 @@ Default: 1 =head1 SIGNALS -Most of our signal handling behavior is copied from L +Most of our signal handling behavior is copied from L and/or L; so it is possible to reuse common scripts for managing them. @@ -133,6 +133,18 @@ See L Used by systemd (and compatible) installations for socket activation. See L and L. +=item PERL_INLINE_DIRECTORY + +Pointing this to point to a writable directory enables the use +of L and L extensions which may provide +platform-specific performance improvements. Currently, this +enables the use of L which speeds up subprocess +spawning with the Linux kernel. + +public-inbox will never enable L automatically without +this environment variable set or C<~/.cache/public-inbox/inline-c> +created by a user. See L and L for more details. + =back =head1 UPGRADING @@ -157,12 +169,12 @@ interrupted and lost. Feedback welcome via plain-text mail to L -The mail archives are hosted at L -and L +The mail archives are hosted at L and +L =head1 COPYRIGHT -Copyright 2013-2016 all contributors L +Copyright 2013-2021 all contributors L License: AGPL-3.0+ L