Skip to content

Commit d91b4fe

Browse files
committed
docs: add changes from PR 167
1 parent dba084a commit d91b4fe

File tree

1 file changed

+48
-6
lines changed

1 file changed

+48
-6
lines changed

source/configuration/index.rst

Lines changed: 48 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -99,6 +99,25 @@ Available listener options:
9999
defines SSL/TLS
100100
:ref:`settings <configuration-listeners-ssl>`.
101101

102+
* - **backlog**
103+
- Integer;
104+
controls the 'backlog' parameter to the *listen(2)* system-call.
105+
This essentially limits the number of pending connections waiting
106+
to be accepted.
107+
108+
The default varies by system.
109+
110+
On Linux, FreeBSD, OpenBSD and macOS the default is **-1** which
111+
means use the OS default. For example. on Linux since 5.4, this is
112+
**4096** (previously **128**) and on FreeBSD it's **128**.
113+
114+
On other systems the default is **511**.
115+
116+
NOTE: Whatever limit you set here will be limited by the OS
117+
system-wide sysctl. For example. on Linux that is
118+
**net.core.somaxconn** and on BSD it's **kern.ipc.somaxconn**
119+
120+
*(since 1.33.0)*
102121

103122
Here, a local listener accepts requests at port 8300
104123
and passes them to the **blogs** app
@@ -3293,14 +3312,15 @@ shared between all application languages:
32933312
32943313
* - **stderr**, **stdout**
32953314
- Strings;
3296-
filenames where Unit redirects
3297-
the application's output.
3315+
filenames where Unit redirects the application's output.
32983316
3299-
The default is **/dev/null**.
3317+
The default when running *with* **--no-daemon** is to send
3318+
*stdout* to the *console* and *stderr* to Unit's *log*.
33003319
3301-
When running in **--no-daemon** mode, application output
3302-
is always redirected to
3303-
:ref:`Unit's log file <troubleshooting-log>`.
3320+
The default when running *without* **--no-daemon** is to send
3321+
*stdout* to */dev/null* and *stderr* to Unit's *log*.
3322+
3323+
These options have *no* effect when running with **--no-daemon**.
33043324
33053325
* - **user**
33063326
- String;
@@ -4720,6 +4740,16 @@ you have:
47204740
47214741
The default is **application**.
47224742
4743+
* - **factory**
4744+
- Boolean:
4745+
when enabled, Unit treats **callable** as a factory.
4746+
4747+
The default is **false**.
4748+
4749+
**Note:** Unit does *not* support passing arguments to factories.
4750+
4751+
*(since 1.33.0)*
4752+
47234753
* - **home**
47244754
- String;
47254755
path to the app's
@@ -5357,6 +5387,16 @@ that stores instance-wide preferences.
53575387
* - Option
53585388
- Description
53595389
5390+
* - **listen_threads**
5391+
- Integer;
5392+
controls the number of router threads created to handle client
5393+
connections. Each thread includes all the configured listeners.
5394+
5395+
By default, we create as many threads as the number of CPUs that
5396+
are available to run on.
5397+
5398+
*(since 1.33.0)*
5399+
53605400
* - **http**
53615401
- Object;
53625402
fine-tunes handling of HTTP requests
@@ -5469,6 +5509,8 @@ In turn, the **http** option exposes the following settings:
54695509
54705510
The default is **true**.
54715511
5512+
*(since 1.30.0)*
5513+
54725514
* - **static**
54735515
- Object;
54745516
configures static asset handling.

0 commit comments

Comments
 (0)