Mastering Nginx

Directive Reference

[ 262 ]

Directive Explanation Context/Default

worker_cpu_affinity Binds worker processes to CPU

sets, as specified by a bitmask.

Only available on FreeBSD and

Linux.

Valid context: main

Default value: -

worker_priority Sets the scheduling priority for

worker processes. Works like the

nice command, with a negative

number being a higher priority.

Valid context: main

Default value: 0

worker_processes This is the number of worker

processes that will be started.

These will handle all connections

made by clients. Choosing the

right number is a complex process,

a good rule of thumb is to set this

equal to the number of CPU cores.

Valid context: main

Default value: 1

worker_rlimit_core Changes the limit on core file size

of a running process.

Valid context: main

Default value: -

worker_rlimit_

nofile

Changes the limit on the number

of open files of a running process.

Valid context: main

Default value: -

worker_rlimit_

sigpending

Changes the limit on the number

of pending signals of a running

process when using the rtsig

connection processing method.

Valid context: main

Default value: -

working_directory The current working directory

for worker processes. It should be

writable by the worker to produce

core files.

Valid context: main

Default value: -

xclient The SMTP protocol allows

checking based on IP/HELO/

LOGIN parameters, which

are passed via the XCLIENT

command. This directive enables

NGINX to communicate this

information.

Valid contexts: mail,

server

Default value: on

xml_entities The path to the DTD that declares

the character entities referenced in

the XML to be processed.

Valid contexts: http,

server, location

default value: -