X-Git-Url: http://www.git.stargrave.org/?a=blobdiff_plain;f=Documentation%2Fpublic-inbox-config.pod;h=17b8bac70987dab9ede2fef3e6d29bae4f2eb79d;hb=7a3946ef122e8218c6ce3355d7f968562212d53b;hp=9647e4a46cef6924f5127a48532d5f7f6c3d1b0e;hpb=411dc580077c5240e9cfd4808c06623345435b69;p=public-inbox.git diff --git a/Documentation/public-inbox-config.pod b/Documentation/public-inbox-config.pod index 9647e4a4..17b8bac7 100644 --- a/Documentation/public-inbox-config.pod +++ b/Documentation/public-inbox-config.pod @@ -188,6 +188,14 @@ be treated as the default value. Default: 25 +=item publicinbox..hide + +A comma-delimited list of listings to hide the inbox from. + +Valid values are currently "www". + +Default: none + =item coderepo..dir The path to a git repository for "publicinbox..coderepo" @@ -215,7 +223,36 @@ A path to the C executable. The L interface can spawn cgit as a fallback if the publicinbox.cgitrc directive is configured. -Default: /usr/lib/cgit/cgit.cgi +Default: /var/www/htdocs/cgit/cgit.cgi or /usr/lib/cgit/cgit.cgi + +=item publicinbox.wwwlisting + +Enable a HTML listing style when the root path of the URL '/' is accessed. +Valid values are: + +=over 8 + +=item all + +Show all inboxes + +=item 404 + +Return a 404 page. This is useful to allow customization with +L + +=item match=domain + +Only show inboxes with URLs which belong to the domain of the HTTP +request + +=for TODO comment + +support showing cgit listing + +=back + +Default: 404 =back @@ -228,12 +265,33 @@ large inboxes, it makes sense to put large inboxes on a named limiter with a low max value; while smaller inboxes can use the default limiter. +C keys may be set to enforce resource limits for +a particular limiter. + +Default named-limiters are prefixed with "-". Currently, +the "-cgit" named limiter is reserved for instances spawning +cgit via C + =over 8 =item publicinboxlimiter..max The maximum number of parallel processes for the given limiter. +=item publicinboxlimiter..rlimitCore + +=item publicinboxlimiter..rlimitCPU + +=item publicinboxlimiter..rlimitData + +The maximum core size, CPU time, or data size processes run with the +given limiter will use. This may be comma-separated to distinguish +soft and hard limits. The word "INFINITY" is accepted as the +RLIM_INFINITY constant (if supported by your OS). + +See L for more info on the behavior of RLIMIT_CORE, +RLIMIT_CPU, and RLIMIT_DATA for you operating system. + =back =head3 EXAMPLE WITH NAMED LIMITERS