.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. .TH UWSGI_CURL_CRON "1" "April 2024" "uwsgi_curl_cron 2.0.24-debian" "User Commands" .SH NAME uwsgi_curl_cron \- fast (pure C), self-healing, developer-friendly WSGI server .SH SYNOPSIS .B uwsgi-core-local [\fI\,options\/\fR...] .SH DESCRIPTION .TP \fB\-s\fR|\-\-socket bind to the specified UNIX/TCP socket using default protocol .TP \fB\-s\fR|\-\-uwsgi\-socket bind to the specified UNIX/TCP socket using uwsgi protocol .TP \fB\-\-suwsgi\-socket\fR bind to the specified UNIX/TCP socket using uwsgi protocol over SSL .TP \fB\-\-ssl\-socket\fR bind to the specified UNIX/TCP socket using uwsgi protocol over SSL .TP \fB\-\-http\-socket\fR bind to the specified UNIX/TCP socket using HTTP protocol .TP \fB\-\-http\-socket\-modifier1\fR force the specified modifier1 when using HTTP protocol .TP \fB\-\-http\-socket\-modifier2\fR force the specified modifier2 when using HTTP protocol .TP \fB\-\-http11\-socket\fR bind to the specified UNIX/TCP socket using HTTP 1.1 (Keep\-Alive) protocol .TP \fB\-\-https\-socket\fR bind to the specified UNIX/TCP socket using HTTPS protocol .TP \fB\-\-https\-socket\-modifier1\fR force the specified modifier1 when using HTTPS protocol .TP \fB\-\-https\-socket\-modifier2\fR force the specified modifier2 when using HTTPS protocol .TP \fB\-\-fastcgi\-socket\fR bind to the specified UNIX/TCP socket using FastCGI protocol .TP \fB\-\-fastcgi\-nph\-socket\fR bind to the specified UNIX/TCP socket using FastCGI protocol (nph mode) .TP \fB\-\-fastcgi\-modifier1\fR force the specified modifier1 when using FastCGI protocol .TP \fB\-\-fastcgi\-modifier2\fR force the specified modifier2 when using FastCGI protocol .TP \fB\-\-scgi\-socket\fR bind to the specified UNIX/TCP socket using SCGI protocol .TP \fB\-\-scgi\-nph\-socket\fR bind to the specified UNIX/TCP socket using SCGI protocol (nph mode) .TP \fB\-\-scgi\-modifier1\fR force the specified modifier1 when using SCGI protocol .TP \fB\-\-scgi\-modifier2\fR force the specified modifier2 when using SCGI protocol .TP \fB\-\-raw\-socket\fR bind to the specified UNIX/TCP socket using RAW protocol .TP \fB\-\-raw\-modifier1\fR force the specified modifier1 when using RAW protocol .TP \fB\-\-raw\-modifier2\fR force the specified modifier2 when using RAW protocol .TP \fB\-\-puwsgi\-socket\fR bind to the specified UNIX/TCP socket using persistent uwsgi protocol (puwsgi) .TP \fB\-\-protocol\fR force the specified protocol for default sockets .TP \fB\-\-socket\-protocol\fR force the specified protocol for default sockets .TP \fB\-\-shared\-socket\fR create a shared socket for advanced jailing or ipc .TP \fB\-\-undeferred\-shared\-socket\fR create a shared socket for advanced jailing or ipc (undeferred mode) .TP \fB\-p\fR|\-\-processes spawn the specified number of workers/processes .TP \fB\-p\fR|\-\-workers spawn the specified number of workers/processes .TP \fB\-\-thunder\-lock\fR serialize accept() usage (if possible) .TP \fB\-t\fR|\-\-harakiri set harakiri timeout .TP \fB\-\-harakiri\-verbose\fR enable verbose mode for harakiri .TP \fB\-\-harakiri\-graceful\-timeout\fR interval between graceful harakiri attempt and a sigkill .TP \fB\-\-harakiri\-graceful\-signal\fR use this signal instead of sigterm for graceful harakiri attempts .TP \fB\-\-harakiri\-queue\-threshold\fR only trigger harakiri if queue is greater than this threshold .TP \fB\-\-harakiri\-no\-arh\fR do not enable harakiri during after\-request\-hook .TP \fB\-\-no\-harakiri\-arh\fR do not enable harakiri during after\-request\-hook .TP \fB\-\-no\-harakiri\-after\-req\-hook\fR do not enable harakiri during after\-request\-hook .TP \fB\-\-backtrace\-depth\fR set backtrace depth .TP \fB\-\-mule\-harakiri\fR set harakiri timeout for mule tasks .TP \fB\-x\fR|\-\-xmlconfig load config from xml file .TP \fB\-x\fR|\-\-xml load config from xml file .TP \fB\-\-config\fR load configuration using the pluggable system .TP \fB\-\-fallback\-config\fR re\-exec uwsgi with the specified config when exit code is 1 .TP \fB\-\-strict\fR enable strict mode (placeholder cannot be used) .TP \fB\-\-skip\-zero\fR skip check of file descriptor 0 .TP \fB\-\-skip\-atexit\fR skip atexit hooks (ignored by the master) .TP \fB\-\-skip\-atexit\-teardown\fR skip atexit teardown (ignored by the master) .TP \fB\-S\fR|\-\-set set a placeholder or an option .TP \fB\-\-set\-placeholder\fR set a placeholder .TP \fB\-\-set\-ph\fR set a placeholder .TP \fB\-\-get\fR print the specified option value and exit .TP \fB\-\-declare\-option\fR declare a new uWSGI custom option .TP \fB\-\-declare\-option2\fR declare a new uWSGI custom option (non\-immediate) .TP \fB\-\-resolve\fR place the result of a dns query in the specified placeholder, sytax: placeholder=name (immediate option) .TP \fB\-\-for\fR (opt logic) for cycle .TP \fB\-\-for\-glob\fR (opt logic) for cycle (expand glob) .TP \fB\-\-for\-times\fR (opt logic) for cycle (expand the specified num to a list starting from 1) .TP \fB\-\-for\-readline\fR (opt logic) for cycle (expand the specified file to a list of lines) .TP \fB\-\-endfor\fR (opt logic) end for cycle .TP \fB\-\-end\-for\fR (opt logic) end for cycle .TP \fB\-\-if\-opt\fR (opt logic) check for option .TP \fB\-\-if\-not\-opt\fR (opt logic) check for option .TP \fB\-\-if\-env\fR (opt logic) check for environment variable .TP \fB\-\-if\-not\-env\fR (opt logic) check for environment variable .TP \fB\-\-ifenv\fR (opt logic) check for environment variable .TP \fB\-\-if\-reload\fR (opt logic) check for reload .TP \fB\-\-if\-not\-reload\fR (opt logic) check for reload .TP \fB\-\-if\-hostname\fR (opt logic) check for hostname .TP \fB\-\-if\-not\-hostname\fR (opt logic) check for hostname .TP \fB\-\-if\-hostname\-match\fR (opt logic) try to match hostname against a regular expression .TP \fB\-\-if\-not\-hostname\-match\fR (opt logic) try to match hostname against a regular expression .TP \fB\-\-if\-exists\fR (opt logic) check for file/directory existence .TP \fB\-\-if\-not\-exists\fR (opt logic) check for file/directory existence .TP \fB\-\-ifexists\fR (opt logic) check for file/directory existence .TP \fB\-\-if\-plugin\fR (opt logic) check for plugin .TP \fB\-\-if\-not\-plugin\fR (opt logic) check for plugin .TP \fB\-\-ifplugin\fR (opt logic) check for plugin .TP \fB\-\-if\-file\fR (opt logic) check for file existance .TP \fB\-\-if\-not\-file\fR (opt logic) check for file existance .TP \fB\-\-if\-dir\fR (opt logic) check for directory existance .TP \fB\-\-if\-not\-dir\fR (opt logic) check for directory existance .TP \fB\-\-ifdir\fR (opt logic) check for directory existance .TP \fB\-\-if\-directory\fR (opt logic) check for directory existance .TP \fB\-\-endif\fR (opt logic) end if .TP \fB\-\-end\-if\fR (opt logic) end if .TP \fB\-\-blacklist\fR set options blacklist context .TP \fB\-\-end\-blacklist\fR clear options blacklist context .TP \fB\-\-whitelist\fR set options whitelist context .TP \fB\-\-end\-whitelist\fR clear options whitelist context .TP \fB\-\-ignore\-sigpipe\fR do not report (annoying) SIGPIPE .TP \fB\-\-ignore\-write\-errors\fR do not report (annoying) write()/writev() errors .TP \fB\-\-write\-errors\-tolerance\fR set the maximum number of allowed write errors (default: no tolerance) .TP \fB\-\-write\-errors\-exception\-only\fR only raise an exception on write errors giving control to the app itself .TP \fB\-\-disable\-write\-exception\fR disable exception generation on write()/writev() .TP \fB\-\-inherit\fR use the specified file as config template .TP \fB\-\-include\fR include the specified file as immediate configuration .TP \fB\-\-inject\-before\fR inject a text file before the config file (advanced templating) .TP \fB\-\-inject\-after\fR inject a text file after the config file (advanced templating) .TP \fB\-d\fR|\-\-daemonize daemonize uWSGI .TP \fB\-\-daemonize2\fR daemonize uWSGI after app loading .TP \fB\-\-stop\fR stop an instance .TP \fB\-\-reload\fR reload an instance .TP \fB\-\-pause\fR pause an instance .TP \fB\-\-suspend\fR suspend an instance .TP \fB\-\-resume\fR resume an instance .TP \fB\-\-connect\-and\-read\fR connect to a socket and wait for data from it .TP \fB\-\-extract\fR fetch/dump any supported address to stdout .TP \fB\-l\fR|\-\-listen set the socket listen queue size .TP \fB\-v\fR|\-\-max\-vars set the amount of internal iovec/vars structures .TP \fB\-\-max\-apps\fR set the maximum number of per\-worker applications .TP \fB\-b\fR|\-\-buffer\-size set internal buffer size .TP \fB\-m\fR|\-\-memory\-report enable memory report .TP \fB\-\-profiler\fR enable the specified profiler .TP \fB\-c\fR|\-\-cgi\-mode force CGI\-mode for plugins supporting it .TP \fB\-a\fR|\-\-abstract\-socket force UNIX socket in abstract mode (Linux only) .TP \fB\-C\fR|\-\-chmod\-socket chmod\-socket .TP \fB\-C\fR|\-\-chmod chmod\-socket .TP \fB\-\-chown\-socket\fR chown unix sockets .TP \fB\-\-umask\fR set umask .TP \fB\-\-freebind\fR put socket in freebind mode .TP \fB\-\-map\-socket\fR map sockets to specific workers .TP \fB\-T\fR|\-\-enable\-threads enable threads .TP \fB\-\-no\-threads\-wait\fR do not wait for threads cancellation on quit/reload .TP \fB\-\-auto\-procname\fR automatically set processes name to something meaningful .TP \fB\-\-procname\-prefix\fR add a prefix to the process names .TP \fB\-\-procname\-prefix\-spaced\fR add a spaced prefix to the process names .TP \fB\-\-procname\-append\fR append a string to process names .TP \fB\-\-procname\fR set process names .TP \fB\-\-procname\-master\fR set master process name .TP \fB\-i\fR|\-\-single\-interpreter do not use multiple interpreters (where available) .TP \fB\-\-need\-app\fR exit if no app can be loaded .TP \fB\-M\fR|\-\-master enable master process .TP \fB\-\-honour\-stdin\fR do not remap stdin to \fI\,/dev/null\/\fP .TP \fB\-\-emperor\fR run the Emperor .TP \fB\-\-emperor\-proxy\-socket\fR force the vassal to became an Emperor proxy .TP \fB\-\-emperor\-wrapper\fR set a binary wrapper for vassals .TP \fB\-\-emperor\-wrapper\-override\fR set a binary wrapper for vassals to try before the default one .TP \fB\-\-emperor\-wrapper\-fallback\fR set a binary wrapper for vassals to try as a last resort .TP \fB\-\-emperor\-nofollow\fR do not follow symlinks when checking for mtime .TP \fB\-\-emperor\-procname\fR set the Emperor process name .TP \fB\-\-emperor\-freq\fR set the Emperor scan frequency (default 3 seconds) .TP \fB\-\-emperor\-required\-heartbeat\fR set the Emperor tolerance about heartbeats .TP \fB\-\-emperor\-curse\-tolerance\fR set the Emperor tolerance about cursed vassals .TP \fB\-\-emperor\-pidfile\fR write the Emperor pid in the specified file .TP \fB\-\-emperor\-tyrant\fR put the Emperor in Tyrant mode .TP \fB\-\-emperor\-tyrant\-nofollow\fR do not follow symlinks when checking for uid/gid in Tyrant mode .TP \fB\-\-emperor\-stats\fR run the Emperor stats server .TP \fB\-\-emperor\-stats\-server\fR run the Emperor stats server .TP \fB\-\-early\-emperor\fR spawn the emperor as soon as possibile .TP \fB\-\-emperor\-broodlord\fR run the emperor in BroodLord mode .TP \fB\-\-emperor\-throttle\fR set throttling level (in milliseconds) for bad behaving vassals (default 1000) .TP \fB\-\-emperor\-max\-throttle\fR set max throttling level (in milliseconds) for bad behaving vassals (default 3 minutes) .TP \fB\-\-emperor\-magic\-exec\fR prefix vassals config files with exec:// if they have the executable bit .TP \fB\-\-emperor\-on\-demand\-extension\fR search for text file (vassal name + extension) containing the on demand socket name .TP \fB\-\-emperor\-on\-demand\-ext\fR search for text file (vassal name + extension) containing the on demand socket name .TP \fB\-\-emperor\-on\-demand\-directory\fR enable on demand mode binding to the unix socket in the specified directory named like the vassal + .socket .TP \fB\-\-emperor\-on\-demand\-dir\fR enable on demand mode binding to the unix socket in the specified directory named like the vassal + .socket .TP \fB\-\-emperor\-on\-demand\-exec\fR use the output of the specified command as on demand socket name (the vassal name is passed as the only argument) .TP \fB\-\-emperor\-extra\-extension\fR allows the specified extension in the Emperor (vassal will be called with \fB\-\-config\fR) .TP \fB\-\-emperor\-extra\-ext\fR allows the specified extension in the Emperor (vassal will be called with \fB\-\-config\fR) .TP \fB\-\-emperor\-no\-blacklist\fR disable Emperor blacklisting subsystem .TP \fB\-\-emperor\-use\-clone\fR use clone() instead of fork() passing the specified unshare() flags .TP \fB\-\-emperor\-graceful\-shutdown\fR use vassals graceful shutdown during ragnarok .TP \fB\-\-emperor\-cap\fR set vassals capability .TP \fB\-\-vassals\-cap\fR set vassals capability .TP \fB\-\-vassal\-cap\fR set vassals capability .TP \fB\-\-imperial\-monitor\-list\fR list enabled imperial monitors .TP \fB\-\-imperial\-monitors\-list\fR list enabled imperial monitors .TP \fB\-\-vassals\-inherit\fR add config templates to vassals config (uses \fB\-\-inherit\fR) .TP \fB\-\-vassals\-include\fR include config templates to vassals config (uses \fB\-\-include\fR instead of \fB\-\-inherit\fR) .TP \fB\-\-vassals\-inherit\-before\fR add config templates to vassals config (uses \fB\-\-inherit\fR, parses before the vassal file) .TP \fB\-\-vassals\-include\-before\fR include config templates to vassals config (uses \fB\-\-include\fR instead of \fB\-\-inherit\fR, parses before the vassal file) .TP \fB\-\-vassals\-start\-hook\fR run the specified command before each vassal starts .TP \fB\-\-vassals\-stop\-hook\fR run the specified command after vassal's death .TP \fB\-\-vassal\-sos\fR ask emperor for reinforcement when overloaded .TP \fB\-\-vassal\-sos\-backlog\fR ask emperor for sos if backlog queue has more items than the value specified .TP \fB\-\-vassals\-set\fR automatically set the specified option (via \fB\-\-set\fR) for every vassal .TP \fB\-\-vassal\-set\fR automatically set the specified option (via \fB\-\-set\fR) for every vassal .TP \fB\-\-heartbeat\fR announce healthiness to the emperor .TP \fB\-\-reload\-mercy\fR set the maximum time (in seconds) we wait for workers and other processes to die during reload/shutdown .TP \fB\-\-worker\-reload\-mercy\fR set the maximum time (in seconds) a worker can take to reload/shutdown (default is 60) .TP \fB\-\-mule\-reload\-mercy\fR set the maximum time (in seconds) a mule can take to reload/shutdown (default is 60) .TP \fB\-\-exit\-on\-reload\fR force exit even if a reload is requested .TP \fB\-\-die\-on\-term\fR exit instead of brutal reload on SIGTERM .TP \fB\-\-force\-gateway\fR force the spawn of the first registered gateway without a master .TP \fB\-h\fR|\-\-help show this help .TP \fB\-h\fR|\-\-usage show this help .TP \fB\-\-print\-sym\fR print content of the specified binary symbol .TP \fB\-\-print\-symbol\fR print content of the specified binary symbol .TP \fB\-r\fR|\-\-reaper call waitpid(\fB\-1\fR,...) after each request to get rid of zombies .TP \fB\-R\fR|\-\-max\-requests reload workers after the specified amount of managed requests .TP \fB\-\-min\-worker\-lifetime\fR number of seconds worker must run before being reloaded (default is 60) .TP \fB\-\-max\-worker\-lifetime\fR reload workers after the specified amount of seconds (default is disabled) .TP \fB\-\-max\-worker\-lifetime\-delta\fR add (worker_id * delta) seconds to the max_worker_lifetime value of each worker .TP \fB\-z\fR|\-\-socket\-timeout set internal sockets timeout .TP \fB\-\-no\-fd\-passing\fR disable file descriptor passing .TP \fB\-\-locks\fR create the specified number of shared locks .TP \fB\-\-lock\-engine\fR set the lock engine .TP \fB\-\-ftok\fR set the ipcsem key via ftok() for avoiding duplicates .TP \fB\-\-persistent\-ipcsem\fR do not remove ipcsem's on shutdown .TP \fB\-A\fR|\-\-sharedarea create a raw shared memory area of specified pages (note: it supports keyval too) .TP \fB\-\-safe\-fd\fR do not close the specified file descriptor .TP \fB\-\-fd\-safe\fR do not close the specified file descriptor .TP \fB\-\-cache\fR create a shared cache containing given elements .TP \fB\-\-cache\-blocksize\fR set cache blocksize .TP \fB\-\-cache\-store\fR enable persistent cache to disk .TP \fB\-\-cache\-store\-sync\fR set frequency of sync for persistent cache .TP \fB\-\-cache\-no\-expire\fR disable auto sweep of expired items .TP \fB\-\-cache\-expire\-freq\fR set the frequency of cache sweeper scans (default 3 seconds) .TP \fB\-\-cache\-report\-freed\-items\fR constantly report the cache item freed by the sweeper (use only for debug) .TP \fB\-\-cache\-udp\-server\fR bind the cache udp server (used only for set/update/delete) to the specified socket .TP \fB\-\-cache\-udp\-node\fR send cache update/deletion to the specified cache udp server .TP \fB\-\-cache\-sync\fR copy the whole content of another uWSGI cache server on server startup .TP \fB\-\-cache\-use\-last\-modified\fR update last_modified_at timestamp on every cache item modification (default is disabled) .TP \fB\-\-add\-cache\-item\fR add an item in the cache .TP \fB\-\-load\-file\-in\-cache\fR load a static file in the cache .TP \fB\-\-load\-file\-in\-cache\-gzip\fR load a static file in the cache with gzip compression .TP \fB\-\-cache2\fR create a new generation shared cache (keyval syntax) .TP \fB\-\-queue\fR enable shared queue .TP \fB\-\-queue\-blocksize\fR set queue blocksize .TP \fB\-\-queue\-store\fR enable persistent queue to disk .TP \fB\-\-queue\-store\-sync\fR set frequency of sync for persistent queue .TP \fB\-Q\fR|\-\-spooler run a spooler on the specified directory .TP \fB\-\-spooler\-external\fR map spoolers requests to a spooler directory managed by an external instance .TP \fB\-\-spooler\-ordered\fR try to order the execution of spooler tasks .TP \fB\-\-spooler\-chdir\fR chdir() to specified directory before each spooler task .TP \fB\-\-spooler\-processes\fR set the number of processes for spoolers .TP \fB\-\-spooler\-quiet\fR do not be verbose with spooler tasks .TP \fB\-\-spooler\-max\-tasks\fR set the maximum number of tasks to run before recycling a spooler .TP \fB\-\-spooler\-harakiri\fR set harakiri timeout for spooler tasks .TP \fB\-\-spooler\-frequency\fR set spooler frequency .TP \fB\-\-spooler\-freq\fR set spooler frequency .TP \fB\-\-mule\fR add a mule .TP \fB\-\-mules\fR add the specified number of mules .TP \fB\-\-farm\fR add a mule farm .TP \fB\-\-mule\-msg\-size\fR set mule message buffer size .TP \fB\-\-signal\fR send a uwsgi signal to a server .TP \fB\-\-signal\-bufsize\fR set buffer size for signal queue .TP \fB\-\-signals\-bufsize\fR set buffer size for signal queue .TP \fB\-\-signal\-timer\fR add a timer (syntax: ) .TP \fB\-\-timer\fR add a timer (syntax: ) .TP \fB\-\-signal\-rbtimer\fR add a redblack timer (syntax: ) .TP \fB\-\-rbtimer\fR add a redblack timer (syntax: ) .TP \fB\-\-rpc\-max\fR maximum number of rpc slots (default: 64) .TP \fB\-L\fR|\-\-disable\-logging disable request logging .TP \fB\-\-flock\fR lock the specified file before starting, exit if locked .TP \fB\-\-flock\-wait\fR lock the specified file before starting, wait if locked .TP \fB\-\-flock2\fR lock the specified file after logging/daemon setup, exit if locked .TP \fB\-\-flock\-wait2\fR lock the specified file after logging/daemon setup, wait if locked .TP \fB\-\-pidfile\fR create pidfile (before privileges drop) .TP \fB\-\-pidfile2\fR create pidfile (after privileges drop) .TP \fB\-\-safe\-pidfile\fR create safe pidfile (before privileges drop) .TP \fB\-\-safe\-pidfile2\fR create safe pidfile (after privileges drop) .TP \fB\-\-chroot\fR chroot() to the specified directory .TP \fB\-\-pivot\-root\fR pivot_root() to the specified directories (new_root and put_old must be separated with a space) .TP \fB\-\-pivot_root\fR pivot_root() to the specified directories (new_root and put_old must be separated with a space) .TP \fB\-\-uid\fR setuid to the specified user/uid .TP \fB\-\-gid\fR setgid to the specified group/gid .TP \fB\-\-add\-gid\fR add the specified group id to the process credentials .TP \fB\-\-immediate\-uid\fR setuid to the specified user/uid IMMEDIATELY .TP \fB\-\-immediate\-gid\fR setgid to the specified group/gid IMMEDIATELY .TP \fB\-\-no\-initgroups\fR disable additional groups set via initgroups() .TP \fB\-\-cap\fR set process capability .TP \fB\-\-unshare\fR unshare() part of the processes and put it in a new namespace .TP \fB\-\-unshare2\fR unshare() part of the processes and put it in a new namespace after rootfs change .TP \fB\-\-setns\-socket\fR expose a unix socket returning namespace fds from \fI\,/proc/self/ns\/\fP .TP \fB\-\-setns\-socket\-skip\fR skip the specified entry when sending setns file descriptors .TP \fB\-\-setns\-skip\fR skip the specified entry when sending setns file descriptors .TP \fB\-\-setns\fR join a namespace created by an external uWSGI instance .TP \fB\-\-setns\-preopen\fR open \fI\,/proc/self/ns\/\fP as soon as possible and cache fds .TP \fB\-\-jailed\fR mark the instance as jailed (force the execution of post_jail hooks) .TP \fB\-\-refork\fR fork() again after privileges drop. Useful for jailing systems .TP \fB\-\-re\-fork\fR fork() again after privileges drop. Useful for jailing systems .TP \fB\-\-refork\-as\-root\fR fork() again before privileges drop. Useful for jailing systems .TP \fB\-\-re\-fork\-as\-root\fR fork() again before privileges drop. Useful for jailing systems .TP \fB\-\-refork\-post\-jail\fR fork() again after jailing. Useful for jailing systems .TP \fB\-\-re\-fork\-post\-jail\fR fork() again after jailing. Useful for jailing systems .TP \fB\-\-hook\-asap\fR run the specified hook as soon as possible .TP \fB\-\-hook\-pre\-jail\fR run the specified hook before jailing .TP \fB\-\-hook\-post\-jail\fR run the specified hook after jailing .TP \fB\-\-hook\-in\-jail\fR run the specified hook in jail after initialization .TP \fB\-\-hook\-as\-root\fR run the specified hook before privileges drop .TP \fB\-\-hook\-as\-user\fR run the specified hook after privileges drop .TP \fB\-\-hook\-as\-user\-atexit\fR run the specified hook before app exit and reload .TP \fB\-\-hook\-pre\-app\fR run the specified hook before app loading .TP \fB\-\-hook\-post\-app\fR run the specified hook after app loading .TP \fB\-\-hook\-post\-fork\fR run the specified hook after each fork .TP \fB\-\-hook\-accepting\fR run the specified hook after each worker enter the accepting phase .TP \fB\-\-hook\-accepting1\fR run the specified hook after the first worker enters the accepting phase .TP \fB\-\-hook\-accepting\-once\fR run the specified hook after each worker enter the accepting phase (once per\-instance) .TP \fB\-\-hook\-accepting1\-once\fR run the specified hook after the first worker enters the accepting phase (once per instance) .TP \fB\-\-hook\-master\-start\fR run the specified hook when the Master starts .TP \fB\-\-hook\-touch\fR run the specified hook when the specified file is touched (syntax: ) .TP \fB\-\-hook\-emperor\-start\fR run the specified hook when the Emperor starts .TP \fB\-\-hook\-emperor\-stop\fR run the specified hook when the Emperor send a stop message .TP \fB\-\-hook\-emperor\-reload\fR run the specified hook when the Emperor send a reload message .TP \fB\-\-hook\-emperor\-lost\fR run the specified hook when the Emperor connection is lost .TP \fB\-\-hook\-as\-vassal\fR run the specified hook before exec()ing the vassal .TP \fB\-\-hook\-as\-emperor\fR run the specified hook in the emperor after the vassal has been started .TP \fB\-\-hook\-as\-mule\fR run the specified hook in each mule .TP \fB\-\-hook\-as\-gateway\fR run the specified hook in each gateway .TP \fB\-\-after\-request\-hook\fR run the specified function/symbol after each request .TP \fB\-\-after\-request\-call\fR run the specified function/symbol after each request .TP \fB\-\-exec\-asap\fR run the specified command as soon as possible .TP \fB\-\-exec\-pre\-jail\fR run the specified command before jailing .TP \fB\-\-exec\-post\-jail\fR run the specified command after jailing .TP \fB\-\-exec\-in\-jail\fR run the specified command in jail after initialization .TP \fB\-\-exec\-as\-root\fR run the specified command before privileges drop .TP \fB\-\-exec\-as\-user\fR run the specified command after privileges drop .TP \fB\-\-exec\-as\-user\-atexit\fR run the specified command before app exit and reload .TP \fB\-\-exec\-pre\-app\fR run the specified command before app loading .TP \fB\-\-exec\-post\-app\fR run the specified command after app loading .TP \fB\-\-exec\-as\-vassal\fR run the specified command before exec()ing the vassal .TP \fB\-\-exec\-as\-emperor\fR run the specified command in the emperor after the vassal has been started .TP \fB\-\-mount\-asap\fR mount filesystem as soon as possible .TP \fB\-\-mount\-pre\-jail\fR mount filesystem before jailing .TP \fB\-\-mount\-post\-jail\fR mount filesystem after jailing .TP \fB\-\-mount\-in\-jail\fR mount filesystem in jail after initialization .TP \fB\-\-mount\-as\-root\fR mount filesystem before privileges drop .TP \fB\-\-mount\-as\-vassal\fR mount filesystem before exec()ing the vassal .TP \fB\-\-mount\-as\-emperor\fR mount filesystem in the emperor after the vassal has been started .TP \fB\-\-umount\-asap\fR unmount filesystem as soon as possible .TP \fB\-\-umount\-pre\-jail\fR unmount filesystem before jailing .TP \fB\-\-umount\-post\-jail\fR unmount filesystem after jailing .TP \fB\-\-umount\-in\-jail\fR unmount filesystem in jail after initialization .TP \fB\-\-umount\-as\-root\fR unmount filesystem before privileges drop .TP \fB\-\-umount\-as\-vassal\fR unmount filesystem before exec()ing the vassal .TP \fB\-\-umount\-as\-emperor\fR unmount filesystem in the emperor after the vassal has been started .TP \fB\-\-wait\-for\-interface\fR wait for the specified network interface to come up before running root hooks .TP \fB\-\-wait\-for\-interface\-timeout\fR set the timeout for wait\-for\-interface .TP \fB\-\-wait\-interface\fR wait for the specified network interface to come up before running root hooks .TP \fB\-\-wait\-interface\-timeout\fR set the timeout for wait\-for\-interface .TP \fB\-\-wait\-for\-iface\fR wait for the specified network interface to come up before running root hooks .TP \fB\-\-wait\-for\-iface\-timeout\fR set the timeout for wait\-for\-interface .TP \fB\-\-wait\-iface\fR wait for the specified network interface to come up before running root hooks .TP \fB\-\-wait\-iface\-timeout\fR set the timeout for wait\-for\-interface .TP \fB\-\-wait\-for\-fs\fR wait for the specified filesystem item to appear before running root hooks .TP \fB\-\-wait\-for\-file\fR wait for the specified file to appear before running root hooks .TP \fB\-\-wait\-for\-dir\fR wait for the specified directory to appear before running root hooks .TP \fB\-\-wait\-for\-mountpoint\fR wait for the specified mountpoint to appear before running root hooks .TP \fB\-\-wait\-for\-fs\-timeout\fR set the timeout for wait\-for\-fs/file/dir .TP \fB\-\-wait\-for\-socket\fR wait for the specified socket to be ready before loading apps .TP \fB\-\-wait\-for\-socket\-timeout\fR set the timeout for wait\-for\-socket .TP \fB\-\-call\-asap\fR call the specified function as soon as possible .TP \fB\-\-call\-pre\-jail\fR call the specified function before jailing .TP \fB\-\-call\-post\-jail\fR call the specified function after jailing .TP \fB\-\-call\-in\-jail\fR call the specified function in jail after initialization .TP \fB\-\-call\-as\-root\fR call the specified function before privileges drop .TP \fB\-\-call\-as\-user\fR call the specified function after privileges drop .TP \fB\-\-call\-as\-user\-atexit\fR call the specified function before app exit and reload .TP \fB\-\-call\-pre\-app\fR call the specified function before app loading .TP \fB\-\-call\-post\-app\fR call the specified function after app loading .TP \fB\-\-call\-as\-vassal\fR call the specified function() before exec()ing the vassal .TP \fB\-\-call\-as\-vassal1\fR call the specified function(char *) before exec()ing the vassal .TP \fB\-\-call\-as\-vassal3\fR call the specified function(char *, uid_t, gid_t) before exec()ing the vassal .TP \fB\-\-call\-as\-emperor\fR call the specified function() in the emperor after the vassal has been started .TP \fB\-\-call\-as\-emperor1\fR call the specified function(char *) in the emperor after the vassal has been started .TP \fB\-\-call\-as\-emperor2\fR call the specified function(char *, pid_t) in the emperor after the vassal has been started .TP \fB\-\-call\-as\-emperor4\fR call the specified function(char *, pid_t, uid_t, gid_t) in the emperor after the vassal has been started .TP \fB\-\-ini\fR load config from ini file .TP \fB\-y\fR|\-\-yaml load config from yaml file .TP \fB\-y\fR|\-\-yml load config from yaml file .TP \fB\-j\fR|\-\-json load config from json file .TP \fB\-j\fR|\-\-js load config from json file .TP \fB\-\-weight\fR weight of the instance (used by clustering/lb/subscriptions) .TP \fB\-\-auto\-weight\fR set weight of the instance (used by clustering/lb/subscriptions) automatically .TP \fB\-\-no\-server\fR force no\-server mode .TP \fB\-\-command\-mode\fR force command mode .TP \fB\-\-no\-defer\-accept\fR disable deferred\-accept on sockets .TP \fB\-\-tcp\-nodelay\fR enable TCP NODELAY on each request .TP \fB\-\-so\-keepalive\fR enable TCP KEEPALIVEs .TP \fB\-\-so\-send\-timeout\fR set SO_SNDTIMEO .TP \fB\-\-socket\-send\-timeout\fR set SO_SNDTIMEO .TP \fB\-\-so\-write\-timeout\fR set SO_SNDTIMEO .TP \fB\-\-socket\-write\-timeout\fR set SO_SNDTIMEO .TP \fB\-\-socket\-sndbuf\fR set SO_SNDBUF .TP \fB\-\-socket\-rcvbuf\fR set SO_RCVBUF .TP \fB\-\-shutdown\-sockets\fR force calling shutdown() in addition to close() when sockets are destroyed .TP \fB\-\-limit\-as\fR limit processes address space/vsz .TP \fB\-\-limit\-nproc\fR limit the number of spawnable processes .TP \fB\-\-reload\-on\-as\fR reload if address space is higher than specified megabytes .TP \fB\-\-reload\-on\-rss\fR reload if rss memory is higher than specified megabytes .TP \fB\-\-evil\-reload\-on\-as\fR force the master to reload a worker if its address space is higher than specified megabytes .TP \fB\-\-evil\-reload\-on\-rss\fR force the master to reload a worker if its rss memory is higher than specified megabytes .TP \fB\-\-mem\-collector\-freq\fR set the memory collector frequency when evil reloads are in place .TP \fB\-\-reload\-on\-fd\fR reload if the specified file descriptor is ready .TP \fB\-\-brutal\-reload\-on\-fd\fR brutal reload if the specified file descriptor is ready .TP \fB\-\-ksm\fR enable Linux KSM .TP \fB\-\-pcre\-jit\fR enable pcre jit (if available) .TP \fB\-\-never\-swap\fR lock all memory pages avoiding swapping .TP \fB\-\-touch\-reload\fR reload uWSGI if the specified file is modified/touched .TP \fB\-\-touch\-workers\-reload\fR trigger reload of (only) workers if the specified file is modified/touched .TP \fB\-\-touch\-mules\-reload\fR reload mules if the specified file is modified/touched .TP \fB\-\-touch\-spoolers\-reload\fR reload spoolers if the specified file is modified/touched .TP \fB\-\-touch\-chain\-reload\fR trigger chain reload if the specified file is modified/touched .TP \fB\-\-touch\-logrotate\fR trigger logrotation if the specified file is modified/touched .TP \fB\-\-touch\-logreopen\fR trigger log reopen if the specified file is modified/touched .TP \fB\-\-touch\-exec\fR run command when the specified file is modified/touched (syntax: file command) .TP \fB\-\-touch\-signal\fR signal when the specified file is modified/touched (syntax: file signal) .TP \fB\-\-fs\-reload\fR graceful reload when the specified filesystem object is modified .TP \fB\-\-fs\-brutal\-reload\fR brutal reload when the specified filesystem object is modified .TP \fB\-\-fs\-signal\fR raise a uwsgi signal when the specified filesystem object is modified (syntax: file signal) .TP \fB\-\-check\-mountpoint\fR destroy the instance if a filesystem is no more reachable (useful for reliable Fuse management) .TP \fB\-\-mountpoint\-check\fR destroy the instance if a filesystem is no more reachable (useful for reliable Fuse management) .TP \fB\-\-check\-mount\fR destroy the instance if a filesystem is no more reachable (useful for reliable Fuse management) .TP \fB\-\-mount\-check\fR destroy the instance if a filesystem is no more reachable (useful for reliable Fuse management) .TP \fB\-\-propagate\-touch\fR over\-engineering option for system with flaky signal management .TP \fB\-\-limit\-post\fR limit request body .TP \fB\-\-no\-orphans\fR automatically kill workers if master dies (can be dangerous for availability) .TP \fB\-\-prio\fR set processes/threads priority .TP \fB\-\-cpu\-affinity\fR set cpu affinity .TP \fB\-\-post\-buffering\fR set size in bytes after which will buffer to disk instead of memory .TP \fB\-\-post\-buffering\-bufsize\fR set buffer size for read() in post buffering mode .TP \fB\-\-body\-read\-warning\fR set the amount of allowed memory allocation (in megabytes) for request body before starting printing a warning .TP \fB\-\-upload\-progress\fR enable creation of .json files in the specified directory during a file upload .TP \fB\-\-no\-default\-app\fR do not fallback to default app .TP \fB\-\-manage\-script\-name\fR automatically rewrite SCRIPT_NAME and PATH_INFO .TP \fB\-\-ignore\-script\-name\fR ignore SCRIPT_NAME .TP \fB\-\-catch\-exceptions\fR report exception as http output (discouraged, use only for testing) .TP \fB\-\-reload\-on\-exception\fR reload a worker when an exception is raised .TP \fB\-\-reload\-on\-exception\-type\fR reload a worker when a specific exception type is raised .TP \fB\-\-reload\-on\-exception\-value\fR reload a worker when a specific exception value is raised .TP \fB\-\-reload\-on\-exception\-repr\fR reload a worker when a specific exception type+value (language\-specific) is raised .TP \fB\-\-exception\-handler\fR add an exception handler .TP \fB\-\-enable\-metrics\fR enable metrics subsystem .TP \fB\-\-metric\fR add a custom metric .TP \fB\-\-metric\-threshold\fR add a metric threshold/alarm .TP \fB\-\-metric\-alarm\fR add a metric threshold/alarm .TP \fB\-\-alarm\-metric\fR add a metric threshold/alarm .TP \fB\-\-metrics\-dir\fR export metrics as text files to the specified directory .TP \fB\-\-metrics\-dir\-restore\fR restore last value taken from the metrics dir .TP \fB\-\-metric\-dir\fR export metrics as text files to the specified directory .TP \fB\-\-metric\-dir\-restore\fR restore last value taken from the metrics dir .TP \fB\-\-metrics\-no\-cores\fR disable generation of cores\-related metrics .TP \fB\-\-udp\fR run the udp server on the specified address .TP \fB\-\-stats\fR enable the stats server on the specified address .TP \fB\-\-stats\-server\fR enable the stats server on the specified address .TP \fB\-\-stats\-http\fR prefix stats server json output with http headers .TP \fB\-\-stats\-minified\fR minify statistics json output .TP \fB\-\-stats\-min\fR minify statistics json output .TP \fB\-\-stats\-push\fR push the stats json to the specified destination .TP \fB\-\-stats\-pusher\-default\-freq\fR set the default frequency of stats pushers .TP \fB\-\-stats\-pushers\-default\-freq\fR set the default frequency of stats pushers .TP \fB\-\-stats\-no\-cores\fR disable generation of cores\-related stats .TP \fB\-\-stats\-no\-metrics\fR do not include metrics in stats output .TP \fB\-\-multicast\fR subscribe to specified multicast group .TP \fB\-\-multicast\-ttl\fR set multicast ttl .TP \fB\-\-multicast\-loop\fR set multicast loop (default 1) .TP \fB\-\-master\-fifo\fR enable the master fifo .TP \fB\-\-notify\-socket\fR enable the notification socket .TP \fB\-\-subscription\-notify\-socket\fR set the notification socket for subscriptions .TP \fB\-\-legion\fR became a member of a legion .TP \fB\-\-legion\-mcast\fR became a member of a legion (shortcut for multicast) .TP \fB\-\-legion\-node\fR add a node to a legion .TP \fB\-\-legion\-freq\fR set the frequency of legion packets .TP \fB\-\-legion\-tolerance\fR set the tolerance of legion subsystem .TP \fB\-\-legion\-death\-on\-lord\-error\fR declare itself as a dead node for the specified amount of seconds if one of the lord hooks fails .TP \fB\-\-legion\-skew\-tolerance\fR set the clock skew tolerance of legion subsystem (default 30 seconds) .TP \fB\-\-legion\-lord\fR action to call on Lord election .TP \fB\-\-legion\-unlord\fR action to call on Lord dismiss .TP \fB\-\-legion\-setup\fR action to call on legion setup .TP \fB\-\-legion\-death\fR action to call on legion death (shutdown of the instance) .TP \fB\-\-legion\-join\fR action to call on legion join (first time quorum is reached) .TP \fB\-\-legion\-node\-joined\fR action to call on new node joining legion .TP \fB\-\-legion\-node\-left\fR action to call node leaving legion .TP \fB\-\-legion\-quorum\fR set the quorum of a legion .TP \fB\-\-legion\-scroll\fR set the scroll of a legion .TP \fB\-\-legion\-scroll\-max\-size\fR set max size of legion scroll buffer .TP \fB\-\-legion\-scroll\-list\-max\-size\fR set max size of legion scroll list buffer .TP \fB\-\-subscriptions\-sign\-check\fR set digest algorithm and certificate directory for secured subscription system .TP \fB\-\-subscriptions\-sign\-check\-tolerance\fR set the maximum tolerance (in seconds) of clock skew for secured subscription system .TP \fB\-\-subscriptions\-sign\-skip\-uid\fR skip signature check for the specified uid when using unix sockets credentials .TP \fB\-\-subscriptions\-credentials\-check\fR add a directory to search for subscriptions key credentials .TP \fB\-\-subscriptions\-use\-credentials\fR enable management of SCM_CREDENTIALS in subscriptions UNIX sockets .TP \fB\-\-subscription\-algo\fR set load balancing algorithm for the subscription system .TP \fB\-\-subscription\-dotsplit\fR try to fallback to the next part (dot based) in subscription key .TP \fB\-\-subscribe\-to\fR subscribe to the specified subscription server .TP \fB\-\-st\fR subscribe to the specified subscription server .TP \fB\-\-subscribe\fR subscribe to the specified subscription server .TP \fB\-\-subscribe2\fR subscribe to the specified subscription server using advanced keyval syntax .TP \fB\-\-subscribe\-freq\fR send subscription announce at the specified interval .TP \fB\-\-subscription\-tolerance\fR set tolerance for subscription servers .TP \fB\-\-unsubscribe\-on\-graceful\-reload\fR force unsubscribe request even during graceful reload .TP \fB\-\-start\-unsubscribed\fR configure subscriptions but do not send them (useful with master fifo) .TP \fB\-\-subscribe\-with\-modifier1\fR force the specififed modifier1 when subscribing .TP \fB\-\-snmp\fR enable the embedded snmp server .TP \fB\-\-snmp\-community\fR set the snmp community string .TP \fB\-\-ssl\-verbose\fR be verbose about SSL errors .TP \fB\-\-ssl\-verify\-depth\fR set maximum certificate verification depth .TP \fB\-\-sni\fR add an SNI\-governed SSL context .TP \fB\-\-sni\-dir\fR check for cert/key/client_ca file in the specified directory and create a sni/ssl context on demand .TP \fB\-\-sni\-dir\-ciphers\fR set ssl ciphers for sni\-dir option .TP \fB\-\-ssl\-enable3\fR enable SSLv3 (insecure) .TP \fB\-\-ssl\-enable\-sslv3\fR enable SSLv3 (insecure) .TP \fB\-\-ssl\-enable\-tlsv1\fR enable TLSv1 (insecure) .TP \fB\-\-ssl\-option\fR set a raw ssl option (numeric value) .TP \fB\-\-sni\-regexp\fR add an SNI\-governed SSL context (the key is a regexp) .TP \fB\-\-ssl\-tmp\-dir\fR store ssl\-related temp files in the specified directory .TP \fB\-\-check\-interval\fR set the interval (in seconds) of master checks .TP \fB\-\-forkbomb\-delay\fR sleep for the specified number of seconds when a forkbomb is detected .TP \fB\-\-binary\-path\fR force binary path .TP \fB\-\-privileged\-binary\-patch\fR patch the uwsgi binary with a new command (before privileges drop) .TP \fB\-\-unprivileged\-binary\-patch\fR patch the uwsgi binary with a new command (after privileges drop) .TP \fB\-\-privileged\-binary\-patch\-arg\fR patch the uwsgi binary with a new command and arguments (before privileges drop) .TP \fB\-\-unprivileged\-binary\-patch\-arg\fR patch the uwsgi binary with a new command and arguments (after privileges drop) .TP \fB\-\-async\fR enable async mode with specified cores .TP \fB\-\-max\-fd\fR set maximum number of file descriptors (requires root privileges) .TP \fB\-\-logto\fR set logfile/udp address .TP \fB\-\-logto2\fR log to specified file or udp address after privileges drop .TP \fB\-\-log\-format\fR set advanced format for request logging .TP \fB\-\-logformat\fR set advanced format for request logging .TP \fB\-\-logformat\-strftime\fR apply strftime to logformat output .TP \fB\-\-log\-format\-strftime\fR apply strftime to logformat output .TP \fB\-\-logfile\-chown\fR chown logfiles .TP \fB\-\-logfile\-chmod\fR chmod logfiles .TP \fB\-\-log\-syslog\fR log to syslog .TP \fB\-\-log\-socket\fR send logs to the specified socket .TP \fB\-\-req\-logger\fR set/append a request logger .TP \fB\-\-logger\-req\fR set/append a request logger .TP \fB\-\-logger\fR set/append a logger .TP \fB\-\-logger\-list\fR list enabled loggers .TP \fB\-\-loggers\-list\fR list enabled loggers .TP \fB\-\-threaded\-logger\fR offload log writing to a thread .TP \fB\-\-log\-encoder\fR add an item in the log encoder chain .TP \fB\-\-log\-req\-encoder\fR add an item in the log req encoder chain .TP \fB\-\-log\-drain\fR drain (do not show) log lines matching the specified regexp .TP \fB\-\-log\-filter\fR show only log lines matching the specified regexp .TP \fB\-\-log\-route\fR log to the specified named logger if regexp applied on logline matches .TP \fB\-\-log\-req\-route\fR log requests to the specified named logger if regexp applied on logline matches .TP \fB\-\-use\-abort\fR call abort() on segfault/fpe, could be useful for generating a core dump .TP \fB\-\-alarm\fR create a new alarm, syntax: .TP \fB\-\-alarm\-cheap\fR use main alarm thread rather than create dedicated threads for curl\-based alarms .TP \fB\-\-alarm\-freq\fR tune the anti\-loop alarm system (default 3 seconds) .TP \fB\-\-alarm\-fd\fR raise the specified alarm when an fd is read for read (by default it reads 1 byte, set 8 for eventfd) .TP \fB\-\-alarm\-segfault\fR raise the specified alarm when the segmentation fault handler is executed .TP \fB\-\-segfault\-alarm\fR raise the specified alarm when the segmentation fault handler is executed .TP \fB\-\-alarm\-backlog\fR raise the specified alarm when the socket backlog queue is full .TP \fB\-\-backlog\-alarm\fR raise the specified alarm when the socket backlog queue is full .TP \fB\-\-lq\-alarm\fR raise the specified alarm when the socket backlog queue is full .TP \fB\-\-alarm\-lq\fR raise the specified alarm when the socket backlog queue is full .TP \fB\-\-alarm\-listen\-queue\fR raise the specified alarm when the socket backlog queue is full .TP \fB\-\-listen\-queue\-alarm\fR raise the specified alarm when the socket backlog queue is full .TP \fB\-\-log\-alarm\fR raise the specified alarm when a log line matches the specified regexp, syntax: [,alarm...] .TP \fB\-\-alarm\-log\fR raise the specified alarm when a log line matches the specified regexp, syntax: [,alarm...] .TP \fB\-\-not\-log\-alarm\fR skip the specified alarm when a log line matches the specified regexp, syntax: [,alarm...] .TP \fB\-\-not\-alarm\-log\fR skip the specified alarm when a log line matches the specified regexp, syntax: [,alarm...] .TP \fB\-\-alarm\-list\fR list enabled alarms .TP \fB\-\-alarms\-list\fR list enabled alarms .TP \fB\-\-alarm\-msg\-size\fR set the max size of an alarm message (default 8192) .TP \fB\-\-log\-master\fR delegate logging to master process .TP \fB\-\-log\-master\-bufsize\fR set the buffer size for the master logger. bigger log messages will be truncated .TP \fB\-\-log\-master\-stream\fR create the master logpipe as SOCK_STREAM .TP \fB\-\-log\-master\-req\-stream\fR create the master requests logpipe as SOCK_STREAM .TP \fB\-\-log\-reopen\fR reopen log after reload .TP \fB\-\-log\-truncate\fR truncate log on startup .TP \fB\-\-log\-maxsize\fR set maximum logfile size .TP \fB\-\-log\-backupname\fR set logfile name after rotation .TP \fB\-\-logdate\fR prefix logs with date or a strftime string .TP \fB\-\-log\-date\fR prefix logs with date or a strftime string .TP \fB\-\-log\-prefix\fR prefix logs with a string .TP \fB\-\-log\-zero\fR log responses without body .TP \fB\-\-log\-slow\fR log requests slower than the specified number of milliseconds .TP \fB\-\-log\-4xx\fR log requests with a 4xx response .TP \fB\-\-log\-5xx\fR log requests with a 5xx response .TP \fB\-\-log\-big\fR log requestes bigger than the specified size .TP \fB\-\-log\-sendfile\fR log sendfile requests .TP \fB\-\-log\-ioerror\fR log requests with io errors .TP \fB\-\-log\-micros\fR report response time in microseconds instead of milliseconds .TP \fB\-\-log\-x\-forwarded\-for\fR use the ip from X\-Forwarded\-For header instead of REMOTE_ADDR .TP \fB\-\-master\-as\-root\fR leave master process running as root .TP \fB\-\-drop\-after\-init\fR run privileges drop after plugin initialization, superseded by drop\-after\-apps .TP \fB\-\-drop\-after\-apps\fR run privileges drop after apps loading, superseded by master\-as\-root .TP \fB\-\-force\-cwd\fR force the initial working directory to the specified value .TP \fB\-\-binsh\fR override \fI\,/bin/sh\/\fP (used by exec hooks, it always fallback to \fI\,/bin/sh\/\fP) .TP \fB\-\-chdir\fR chdir to specified directory before apps loading .TP \fB\-\-chdir2\fR chdir to specified directory after apps loading .TP \fB\-\-lazy\fR set lazy mode (load apps in workers instead of master) .TP \fB\-\-lazy\-apps\fR load apps in each worker instead of the master .TP \fB\-\-cheap\fR set cheap mode (spawn workers only after the first request) .TP \fB\-\-cheaper\fR set cheaper mode (adaptive process spawning) .TP \fB\-\-cheaper\-initial\fR set the initial number of processes to spawn in cheaper mode .TP \fB\-\-cheaper\-algo\fR choose to algorithm used for adaptive process spawning .TP \fB\-\-cheaper\-step\fR number of additional processes to spawn at each overload .TP \fB\-\-cheaper\-overload\fR increase workers after specified overload .TP \fB\-\-cheaper\-algo\-list\fR list enabled cheapers algorithms .TP \fB\-\-cheaper\-algos\-list\fR list enabled cheapers algorithms .TP \fB\-\-cheaper\-list\fR list enabled cheapers algorithms .TP \fB\-\-cheaper\-rss\-limit\-soft\fR don't spawn new workers if total resident memory usage of all workers is higher than this limit .TP \fB\-\-cheaper\-rss\-limit\-hard\fR if total workers resident memory usage is higher try to stop workers .TP \fB\-\-idle\fR set idle mode (put uWSGI in cheap mode after inactivity) .TP \fB\-\-die\-on\-idle\fR shutdown uWSGI when idle .TP \fB\-\-mount\fR load application under mountpoint .TP \fB\-\-worker\-mount\fR load application under mountpoint in the specified worker or after workers spawn .TP \fB\-\-threads\fR run each worker in prethreaded mode with the specified number of threads .TP \fB\-\-thread\-stacksize\fR set threads stacksize .TP \fB\-\-threads\-stacksize\fR set threads stacksize .TP \fB\-\-thread\-stack\-size\fR set threads stacksize .TP \fB\-\-threads\-stack\-size\fR set threads stacksize .TP \fB\-\-vhost\fR enable virtualhosting mode (based on SERVER_NAME variable) .TP \fB\-\-vhost\-host\fR enable virtualhosting mode (based on HTTP_HOST variable) .TP \fB\-\-route\fR add a route .TP \fB\-\-route\-host\fR add a route based on Host header .TP \fB\-\-route\-uri\fR add a route based on REQUEST_URI .TP \fB\-\-route\-qs\fR add a route based on QUERY_STRING .TP \fB\-\-route\-remote\-addr\fR add a route based on REMOTE_ADDR .TP \fB\-\-route\-user\-agent\fR add a route based on HTTP_USER_AGENT .TP \fB\-\-route\-remote\-user\fR add a route based on REMOTE_USER .TP \fB\-\-route\-referer\fR add a route based on HTTP_REFERER .TP \fB\-\-route\-label\fR add a routing label (for use with goto) .TP \fB\-\-route\-if\fR add a route based on condition .TP \fB\-\-route\-if\-not\fR add a route based on condition (negate version) .TP \fB\-\-route\-run\fR always run the specified route action .TP \fB\-\-final\-route\fR add a final route .TP \fB\-\-final\-route\-status\fR add a final route for the specified status .TP \fB\-\-final\-route\-host\fR add a final route based on Host header .TP \fB\-\-final\-route\-uri\fR add a final route based on REQUEST_URI .TP \fB\-\-final\-route\-qs\fR add a final route based on QUERY_STRING .TP \fB\-\-final\-route\-remote\-addr\fR add a final route based on REMOTE_ADDR .TP \fB\-\-final\-route\-user\-agent\fR add a final route based on HTTP_USER_AGENT .TP \fB\-\-final\-route\-remote\-user\fR add a final route based on REMOTE_USER .TP \fB\-\-final\-route\-referer\fR add a final route based on HTTP_REFERER .TP \fB\-\-final\-route\-label\fR add a final routing label (for use with goto) .TP \fB\-\-final\-route\-if\fR add a final route based on condition .TP \fB\-\-final\-route\-if\-not\fR add a final route based on condition (negate version) .TP \fB\-\-final\-route\-run\fR always run the specified final route action .TP \fB\-\-error\-route\fR add an error route .TP \fB\-\-error\-route\-status\fR add an error route for the specified status .TP \fB\-\-error\-route\-host\fR add an error route based on Host header .TP \fB\-\-error\-route\-uri\fR add an error route based on REQUEST_URI .TP \fB\-\-error\-route\-qs\fR add an error route based on QUERY_STRING .TP \fB\-\-error\-route\-remote\-addr\fR add an error route based on REMOTE_ADDR .TP \fB\-\-error\-route\-user\-agent\fR add an error route based on HTTP_USER_AGENT .TP \fB\-\-error\-route\-remote\-user\fR add an error route based on REMOTE_USER .TP \fB\-\-error\-route\-referer\fR add an error route based on HTTP_REFERER .TP \fB\-\-error\-route\-label\fR add an error routing label (for use with goto) .TP \fB\-\-error\-route\-if\fR add an error route based on condition .TP \fB\-\-error\-route\-if\-not\fR add an error route based on condition (negate version) .TP \fB\-\-error\-route\-run\fR always run the specified error route action .TP \fB\-\-response\-route\fR add a response route .TP \fB\-\-response\-route\-status\fR add a response route for the specified status .TP \fB\-\-response\-route\-host\fR add a response route based on Host header .TP \fB\-\-response\-route\-uri\fR add a response route based on REQUEST_URI .TP \fB\-\-response\-route\-qs\fR add a response route based on QUERY_STRING .TP \fB\-\-response\-route\-remote\-addr\fR add a response route based on REMOTE_ADDR .TP \fB\-\-response\-route\-user\-agent\fR add a response route based on HTTP_USER_AGENT .TP \fB\-\-response\-route\-remote\-user\fR add a response route based on REMOTE_USER .TP \fB\-\-response\-route\-referer\fR add a response route based on HTTP_REFERER .TP \fB\-\-response\-route\-label\fR add a response routing label (for use with goto) .TP \fB\-\-response\-route\-if\fR add a response route based on condition .TP \fB\-\-response\-route\-if\-not\fR add a response route based on condition (negate version) .TP \fB\-\-response\-route\-run\fR always run the specified response route action .TP \fB\-\-router\-list\fR list enabled routers .TP \fB\-\-routers\-list\fR list enabled routers .TP \fB\-\-error\-page\-403\fR add an error page (html) for managed 403 response .TP \fB\-\-error\-page\-404\fR add an error page (html) for managed 404 response .TP \fB\-\-error\-page\-500\fR add an error page (html) for managed 500 response .TP \fB\-\-websockets\-ping\-freq\fR set the frequency (in seconds) of websockets automatic ping packets .TP \fB\-\-websocket\-ping\-freq\fR set the frequency (in seconds) of websockets automatic ping packets .TP \fB\-\-websockets\-pong\-tolerance\fR set the tolerance (in seconds) of websockets ping/pong subsystem .TP \fB\-\-websocket\-pong\-tolerance\fR set the tolerance (in seconds) of websockets ping/pong subsystem .TP \fB\-\-websockets\-max\-size\fR set the max allowed size of websocket messages (in Kbytes, default 1024) .TP \fB\-\-websocket\-max\-size\fR set the max allowed size of websocket messages (in Kbytes, default 1024) .TP \fB\-\-chunked\-input\-limit\fR set the max size of a chunked input part (default 1MB, in bytes) .TP \fB\-\-chunked\-input\-timeout\fR set default timeout for chunked input .TP \fB\-\-clock\fR set a clock source .TP \fB\-\-clock\-list\fR list enabled clocks .TP \fB\-\-clocks\-list\fR list enabled clocks .TP \fB\-\-add\-header\fR automatically add HTTP headers to response .TP \fB\-\-rem\-header\fR automatically remove specified HTTP header from the response .TP \fB\-\-del\-header\fR automatically remove specified HTTP header from the response .TP \fB\-\-collect\-header\fR store the specified response header in a request var (syntax: header var) .TP \fB\-\-response\-header\-collect\fR store the specified response header in a request var (syntax: header var) .TP \fB\-\-pull\-header\fR store the specified response header in a request var and remove it from the response (syntax: header var) .TP \fB\-\-check\-static\fR check for static files in the specified directory .TP \fB\-\-check\-static\-docroot\fR check for static files in the requested DOCUMENT_ROOT .TP \fB\-\-static\-check\fR check for static files in the specified directory .TP \fB\-\-static\-map\fR map mountpoint to static directory (or file) .TP \fB\-\-static\-map2\fR like static\-map but completely appending the requested resource to the docroot .TP \fB\-\-static\-skip\-ext\fR skip specified extension from staticfile checks .TP \fB\-\-static\-index\fR search for specified file if a directory is requested .TP \fB\-\-static\-safe\fR skip security checks if the file is under the specified path .TP \fB\-\-static\-cache\-paths\fR put resolved paths in the uWSGI cache for the specified amount of seconds .TP \fB\-\-static\-cache\-paths\-name\fR use the specified cache for static paths .TP \fB\-\-mimefile\fR set mime types file path (default \fI\,/etc/mime.types\/\fP) .TP \fB\-\-mime\-file\fR set mime types file path (default \fI\,/etc/mime.types\/\fP) .TP \fB\-\-static\-expires\-type\fR set the Expires header based on content type .TP \fB\-\-static\-expires\-type\-mtime\fR set the Expires header based on content type and file mtime .TP \fB\-\-static\-expires\fR set the Expires header based on filename regexp .TP \fB\-\-static\-expires\-mtime\fR set the Expires header based on filename regexp and file mtime .TP \fB\-\-static\-expires\-uri\fR set the Expires header based on REQUEST_URI regexp .TP \fB\-\-static\-expires\-uri\-mtime\fR set the Expires header based on REQUEST_URI regexp and file mtime .TP \fB\-\-static\-expires\-path\-info\fR set the Expires header based on PATH_INFO regexp .TP \fB\-\-static\-expires\-path\-info\-mtime\fR set the Expires header based on PATH_INFO regexp and file mtime .TP \fB\-\-static\-gzip\fR if the supplied regexp matches the static file translation it will search for a gzip version .TP \fB\-\-static\-gzip\-all\fR check for a gzip version of all requested static files .TP \fB\-\-static\-gzip\-dir\fR check for a gzip version of all requested static files in the specified dir/prefix .TP \fB\-\-static\-gzip\-prefix\fR check for a gzip version of all requested static files in the specified dir/prefix .TP \fB\-\-static\-gzip\-ext\fR check for a gzip version of all requested static files with the specified ext/suffix .TP \fB\-\-static\-gzip\-suffix\fR check for a gzip version of all requested static files with the specified ext/suffix .TP \fB\-\-honour\-range\fR enable support for the HTTP Range header .TP \fB\-\-offload\-threads\fR set the number of offload threads to spawn (per\-worker, default 0) .TP \fB\-\-offload\-thread\fR set the number of offload threads to spawn (per\-worker, default 0) .TP \fB\-\-file\-serve\-mode\fR set static file serving mode .TP \fB\-\-fileserve\-mode\fR set static file serving mode .TP \fB\-\-disable\-sendfile\fR disable sendfile() and rely on boring read()/write() .TP \fB\-\-check\-cache\fR check for response data in the specified cache (empty for default cache) .TP \fB\-\-close\-on\-exec\fR set close\-on\-exec on connection sockets (could be required for spawning processes in requests) .TP \fB\-\-close\-on\-exec2\fR set close\-on\-exec on server sockets (could be required for spawning processes in requests) .TP \fB\-\-mode\fR set uWSGI custom mode .TP \fB\-\-env\fR set environment variable .TP \fB\-\-envdir\fR load a daemontools compatible envdir .TP \fB\-\-early\-envdir\fR load a daemontools compatible envdir ASAP .TP \fB\-\-unenv\fR unset environment variable .TP \fB\-\-vacuum\fR try to remove all of the generated file/sockets .TP \fB\-\-file\-write\fR write the specified content to the specified file (syntax: file=value) before privileges drop .TP \fB\-\-cgroup\fR put the processes in the specified cgroup .TP \fB\-\-cgroup\-opt\fR set value in specified cgroup option .TP \fB\-\-cgroup\-dir\-mode\fR set permission for cgroup directory (default is 700) .TP \fB\-\-namespace\fR run in a new namespace under the specified rootfs .TP \fB\-\-namespace\-keep\-mount\fR keep the specified mountpoint in your namespace .TP \fB\-\-ns\fR run in a new namespace under the specified rootfs .TP \fB\-\-namespace\-net\fR add network namespace .TP \fB\-\-ns\-net\fR add network namespace .TP \fB\-\-enable\-proxy\-protocol\fR enable PROXY1 protocol support (only for http parsers) .TP \fB\-\-reuse\-port\fR enable REUSE_PORT flag on socket (BSD only) .TP \fB\-\-tcp\-fast\-open\fR enable TCP_FASTOPEN flag on TCP sockets with the specified qlen value .TP \fB\-\-tcp\-fastopen\fR enable TCP_FASTOPEN flag on TCP sockets with the specified qlen value .TP \fB\-\-tcp\-fast\-open\-client\fR use sendto(..., MSG_FASTOPEN, ...) instead of connect() if supported .TP \fB\-\-tcp\-fastopen\-client\fR use sendto(..., MSG_FASTOPEN, ...) instead of connect() if supported .TP \fB\-\-zerg\fR attach to a zerg server .TP \fB\-\-zerg\-fallback\fR fallback to normal sockets if the zerg server is not available .TP \fB\-\-zerg\-server\fR enable the zerg server on the specified UNIX socket .TP \fB\-\-cron\fR add a cron task .TP \fB\-\-cron2\fR add a cron task (key=val syntax) .TP \fB\-\-unique\-cron\fR add a unique cron task .TP \fB\-\-cron\-harakiri\fR set the maximum time (in seconds) we wait for cron command to complete .TP \fB\-\-legion\-cron\fR add a cron task runnable only when the instance is a lord of the specified legion .TP \fB\-\-cron\-legion\fR add a cron task runnable only when the instance is a lord of the specified legion .TP \fB\-\-unique\-legion\-cron\fR add a unique cron task runnable only when the instance is a lord of the specified legion .TP \fB\-\-unique\-cron\-legion\fR add a unique cron task runnable only when the instance is a lord of the specified legion .TP \fB\-\-loop\fR select the uWSGI loop engine .TP \fB\-\-loop\-list\fR list enabled loop engines .TP \fB\-\-loops\-list\fR list enabled loop engines .TP \fB\-\-worker\-exec\fR run the specified command as worker .TP \fB\-\-worker\-exec2\fR run the specified command as worker (after post_fork hook) .TP \fB\-\-attach\-daemon\fR attach a command/daemon to the master process (the command has to not go in background) .TP \fB\-\-attach\-control\-daemon\fR attach a command/daemon to the master process (the command has to not go in background), when the daemon dies, the master dies too .TP \fB\-\-smart\-attach\-daemon\fR attach a command/daemon to the master process managed by a pidfile (the command has to daemonize) .TP \fB\-\-smart\-attach\-daemon2\fR attach a command/daemon to the master process managed by a pidfile (the command has to NOT daemonize) .TP \fB\-\-legion\-attach\-daemon\fR same as \fB\-\-attach\-daemon\fR but daemon runs only on legion lord node .TP \fB\-\-legion\-smart\-attach\-daemon\fR same as \fB\-\-smart\-attach\-daemon\fR but daemon runs only on legion lord node .TP \fB\-\-legion\-smart\-attach\-daemon2\fR same as \fB\-\-smart\-attach\-daemon2\fR but daemon runs only on legion lord node .TP \fB\-\-daemons\-honour\-stdin\fR do not change the stdin of external daemons to \fI\,/dev/null\/\fP .TP \fB\-\-attach\-daemon2\fR attach\-daemon keyval variant (supports smart modes too) .TP \fB\-\-plugins\fR load uWSGI plugins .TP \fB\-\-plugin\fR load uWSGI plugins .TP \fB\-\-need\-plugins\fR load uWSGI plugins (exit on error) .TP \fB\-\-need\-plugin\fR load uWSGI plugins (exit on error) .TP \fB\-\-plugins\-dir\fR add a directory to uWSGI plugin search path .TP \fB\-\-plugin\-dir\fR add a directory to uWSGI plugin search path .TP \fB\-\-plugins\-list\fR list enabled plugins .TP \fB\-\-plugin\-list\fR list enabled plugins .TP \fB\-\-autoload\fR try to automatically load plugins when unknown options are found .TP \fB\-\-dlopen\fR blindly load a shared library .TP \fB\-\-allowed\-modifiers\fR comma separated list of allowed modifiers .TP \fB\-\-remap\-modifier\fR remap request modifier from one id to another .TP \fB\-\-dump\-options\fR dump the full list of available options .TP \fB\-\-show\-config\fR show the current config reformatted as ini .TP \fB\-\-binary\-append\-data\fR return the content of a resource to stdout for appending to a uwsgi binary (for data:// usage) .TP \fB\-\-print\fR simple print .TP \fB\-\-iprint\fR simple print (immediate version) .TP \fB\-\-exit\fR force exit() of the instance .TP \fB\-\-cflags\fR report uWSGI CFLAGS (useful for building external plugins) .TP \fB\-\-dot\-h\fR dump the uwsgi.h used for building the core (useful for building external plugins) .TP \fB\-\-config\-py\fR dump the uwsgiconfig.py used for building the core (useful for building external plugins) .TP \fB\-\-build\-plugin\fR build a uWSGI plugin for the current binary .TP \fB\-\-version\fR print uWSGI version .TP \fB\-\-response\-headers\-limit\fR set response header maximum size (default: 64k)