From: Fabian Keil Date: Mon, 26 Jun 2017 12:15:27 +0000 (+0000) Subject: Rebuild the user manual with listen-backlog documentation X-Git-Tag: v_3_0_27~109 X-Git-Url: http://www.privoxy.org/gitweb/?p=privoxy.git;a=commitdiff_plain;h=37e01aa0ee434c20c270b669587a4419279a9c7e Rebuild the user manual with listen-backlog documentation Sponsored by: Robert Klemme --- diff --git a/doc/webserver/developer-manual/coding.html b/doc/webserver/developer-manual/coding.html index 800fa834..3dd280e0 100644 --- a/doc/webserver/developer-manual/coding.html +++ b/doc/webserver/developer-manual/coding.html @@ -1129,10 +1129,10 @@ const char FILENAME_h_rcs[] = FILENAME_H_VERSION;

Note: This - declares the rcs variables that should be added to the - "show-proxy-args" page. If this is a brand new creation by you, you are - free to change the "Copyright" section to represent the rights you wish - to maintain.

+ declares the rcs variables that should be added to the "show-version" + page. If this is a brand new creation by you, you are free to change + the "Copyright" section to represent the rights you wish to + maintain.

Note: The formfeed character that is present right after the comment flower box is handy for (X|GNU)Emacs users to skip the verbiage and get to the diff --git a/doc/webserver/developer-manual/index.html b/doc/webserver/developer-manual/index.html index 36be1f97..fccfc66c 100644 --- a/doc/webserver/developer-manual/index.html +++ b/doc/webserver/developer-manual/index.html @@ -19,8 +19,8 @@ "https://www.privoxy.org/user-manual/copyright.html" target= "_top">Copyright � 2001-2016 by Privoxy Developers

-

$Id: developer-manual.sgml,v 2.82 2017/01/23 - 12:59:45 fabiankeil Exp $

+

$Id: developer-manual.sgml,v 2.83 2017/06/08 + 13:08:39 fabiankeil Exp $

diff --git a/doc/webserver/user-manual/actions-file.html b/doc/webserver/user-manual/actions-file.html index 401c1778..970b20f5 100644 --- a/doc/webserver/user-manual/actions-file.html +++ b/doc/webserver/user-manual/actions-file.html @@ -100,7 +100,7 @@

The default profiles, and their associated actions, as pre-defined in default.action are:

- +

Table 1. Default Configurations

diff --git a/doc/webserver/user-manual/appendix.html b/doc/webserver/user-manual/appendix.html index 42b24a2a..f1cb35b9 100644 --- a/doc/webserver/user-manual/appendix.html +++ b/doc/webserver/user-manual/appendix.html @@ -280,7 +280,7 @@ either.

  • -

    Privoxy main page:

    +

    Privoxy main page:

    http://config.privoxy.org/

    @@ -292,32 +292,32 @@

  • Show information about the current configuration, including - viewing and editing of actions files:

    + viewing and editing of actions files:

    http://config.privoxy.org/show-status

  • -

    Show the source code version numbers:

    +

    Show the source code version numbers:

    http://config.privoxy.org/show-version

  • -

    Show the browser's request headers:

    +

    Show the browser's request headers:

    http://config.privoxy.org/show-request

  • -

    Show which actions apply to a URL and why:

    +

    Show which actions apply to a URL and why:

    http://config.privoxy.org/show-url-info

    @@ -329,17 +329,17 @@ "off", "Privoxy" continues to run, but only as a pass-through proxy, with no actions taking place:

    + "AEN6098" id="AEN6098">

    http://config.privoxy.org/toggle

    -

    Short cuts. Turn off, then on:

    +

    Short cuts. Turn off, then on:

    http://config.privoxy.org/toggle?set=disable

    -
    +

    http://config.privoxy.org/toggle?set=enable

    diff --git a/doc/webserver/user-manual/config.html b/doc/webserver/user-manual/config.html index a5920cee..293d332b 100644 --- a/doc/webserver/user-manual/config.html +++ b/doc/webserver/user-manual/config.html @@ -2333,9 +2333,63 @@ +
    +

    7.6.10. listen-backlog

    +
    +
    +
    Specifies:
    +
    +

    Connection queue length requested from the operating + system.

    +
    +
    Type of value:
    +
    +

    Number.

    +
    +
    Default value:
    +
    +

    128

    +
    +
    Effect if unset:
    +
    +

    A connection queue length of 128 is requested from the + operating system.

    +
    +
    Notes:
    +
    +

    Under high load incoming connection may queue up before + Privoxy gets around to serve them. The queue length is limitted + by the operating system. Once the queue is full, additional + connections are dropped before Privoxy can accept and serve + them.

    +

    Increasing the queue length allows Privoxy to accept more + incomming connections that arrive roughly at the same time.

    +

    Note that Privoxy can only request a certain queue length, + whether or not the requested length is actually used depends on + the operating system which may use a different length + instead.

    +

    On many operating systems a limit of -1 can be specified to + instruct the operating system to use the maximum queue length + allowed. Check the listen man page to see if your platform + allows this.

    +

    On some platforms you can use "netstat -Lan -p tcp" to see + the effective queue length.

    +

    Effectively using a value above 128 usually requires + changing the system configuration as well. On FreeBSD-based + system the limit is controlled by the kern.ipc.soacceptqueue + sysctl.

    +
    +
    Examples:
    +
    +

    listen-backlog 4096

    +
    +
    +
    +

    7.6.10. + "HANDLE-AS-EMPTY-DOC-RETURNS-OK">7.6.11. handle-as-empty-doc-returns-ok

    @@ -2382,7 +2436,7 @@

    7.6.11. enable-compression

    + "ENABLE-COMPRESSION">7.6.12. enable-compression
    Specifies:
    @@ -2425,7 +2479,7 @@

    7.6.12. compression-level

    + "COMPRESSION-LEVEL">7.6.13. compression-level
    Specifies:
    @@ -2479,7 +2533,7 @@

    7.6.13. client-header-order

    + "CLIENT-HEADER-ORDER">7.6.14. client-header-order
    Specifies:
    @@ -2517,7 +2571,7 @@

    7.6.14. client-specific-tag

    + "CLIENT-SPECIFIC-TAG">7.6.15. client-specific-tag
    Specifies:
    @@ -2600,7 +2654,7 @@

    7.6.15. client-tag-lifetime

    + "CLIENT-TAG-LIFETIME">7.6.16. client-tag-lifetime
    Specifies:
    @@ -2658,7 +2712,7 @@

    7.6.16. trust-x-forwarded-for

    + "TRUST-X-FORWARDED-FOR">7.6.17. trust-x-forwarded-for
    Specifies:
    @@ -2727,7 +2781,7 @@

    7.6.17. receive-buffer-size

    + "RECEIVE-BUFFER-SIZE">7.6.18. receive-buffer-size
    Specifies:
    diff --git a/doc/webserver/user-manual/index.html b/doc/webserver/user-manual/index.html index c25dc20d..10a79603 100644 --- a/doc/webserver/user-manual/index.html +++ b/doc/webserver/user-manual/index.html @@ -245,20 +245,22 @@
    7.6.9. max-client-connections
    7.6.10. handle-as-empty-doc-returns-ok
    + "config.html#LISTEN-BACKLOG">listen-backlog
    7.6.11. enable-compression
    + "config.html#HANDLE-AS-EMPTY-DOC-RETURNS-OK">handle-as-empty-doc-returns-ok
    7.6.12. compression-level
    + "config.html#ENABLE-COMPRESSION">enable-compression
    7.6.13. client-header-order
    + "config.html#COMPRESSION-LEVEL">compression-level
    7.6.14. client-specific-tag
    + "config.html#CLIENT-HEADER-ORDER">client-header-order
    7.6.15. client-tag-lifetime
    + "config.html#CLIENT-SPECIFIC-TAG">client-specific-tag
    7.6.16. trust-x-forwarded-for
    + "config.html#CLIENT-TAG-LIFETIME">client-tag-lifetime
    7.6.17. trust-x-forwarded-for
    +
    7.6.18. receive-buffer-size