# HG changeset patch # User Ruslan Ermilov # Date 1341494025 0 # Node ID 71d775bef043050841e93dfc38f3da8e524adf93 # Parent 9a5b1a63f654e4261ead1034836bb3a571a95959 Documented accept_mutex, accept_mutex_delay, multi_accept, and lock_file. diff --git a/xml/en/docs/ngx_core_module.xml b/xml/en/docs/ngx_core_module.xml --- a/xml/en/docs/ngx_core_module.xml +++ b/xml/en/docs/ngx_core_module.xml @@ -29,6 +29,42 @@ events {
+ +on | off +on +events + + +If enabled, +accepts of new connections by multiple worker processes will be serialized. +Otherwise, all worker processes will be notified about new connections, +and if volume of new connections is low, some of the worker processes +may just waste system resources. + +The use of +connection processing method +requires accept_mutex to be enabled. + + + + + + + +time +500ms +events + + +If is enabled, specifies the maximum time +during which a worker process will try to restart accepting new +connections if another worker process is already doing this +currently. + + + + + on | off on @@ -224,6 +260,23 @@ include vhosts/*.conf; + +file +logs/nginx.lock +main + + +nginx uses the locking mechanism to implement +and serialize accesses to shared memory. +On most systems the locks are implemented using atomic operations, +and this directive is ignored. +On other systems the “lock file” mechanism is used. +This directive specifies a prefix for the names of lock files. + + + + + on | off on @@ -237,6 +290,31 @@ This directive is intended for nginx dev + +on | off +off +events + + +If disabled, a worker process +will accept one new connection at a time. +Otherwise, a worker process +will accept all new connections at a time. + +The directive is ignored if +connection processing method is used because it can report +the number of new connections waiting to be accepted. + + +The use of +connection processing method +automatically enables multi_accept. + + + + + + on | off off diff --git a/xml/ru/docs/ngx_core_module.xml b/xml/ru/docs/ngx_core_module.xml --- a/xml/ru/docs/ngx_core_module.xml +++ b/xml/ru/docs/ngx_core_module.xml @@ -29,6 +29,42 @@ events {
+ +on | off +on +events + + +Если accept_mutex включён, +рабочие процессы будут принимать новые соединения по очереди. +В противном случае о новых соединениях будет сообщаться сразу всем рабочим +процессам, и при низкой интенсивности поступления новых соединений +часть рабочих процессов может работать вхолостую. + +Использование метода обработки соединений + +требует обязательного включения accept_mutex. + + + + + + + +время +500ms +events + + +При включённом задаёт максимальное время, +в течение которого рабочий процесс вновь попытается начать принимать +новые соединения, если в настоящий момент этим уже занимается другой +рабочий процесс. + + + + + on | off on @@ -220,6 +256,23 @@ include vhosts/*.conf; + +файл +logs/nginx.lock +main + + +Для реализации и сериализации доступа к +разделяемой памяти nginx использует механизм блокировок. +На большинстве систем блокировки реализованы с помощью атомарных +операций, и эта директива игнорируется. +Для остальных систем применяется механизм файлов блокировок. +Эта директива задаёт префикс имён файлов блокировок. + + + + + on | off on @@ -233,6 +286,31 @@ include vhosts/*.conf; + +on | off +off +events + + +Если multi_accept выключен, рабочий процесс +за один раз будет принимать только одно новое соединение. +В противном случае рабочий процесс +за один раз будет принимать сразу все новые соединения. + +Директива игнорируется в случае использования метода обработки соединений +, т.к. данный метод сам сообщает +число новых соединений, ожидающих приёма. + + +Использование метода обработки соединений + +автоматически включает multi_accept. + + + + + + on | off off