LinuxReviws.org --get your your Linux knowledge
> Linux Reviews > Manual Pages (man) >

nginx


  1. nginx.8.man


1. nginx.8.man

Manpage of NGINX

NGINX

Section: Maintenance Commands (8)
Index Return to Main Contents

BSD mandoc
 

NAME

nginx - HTTP and reverse proxy server, mail proxy server  

SYNOPSIS

[-hqtvV? ] [-c file ] [-g directives ] [-p prefix ] [-s signal ]  

DESCRIPTION

The (spelled ``engine x'' is an HTTP and reverse proxy server, as well as a mail proxy server. The is known for its high performance, stability, rich feature set, simple configuration, and low resource consumption.

The options are as follows:

-? | h
Print help.
-c file
Use an alternative configuration file
-g directives
Set global configuration directives. See Sx EXAMPLES for details.
-p prefix
Set prefix path. Default value is %%PREFIX%%
-q
Suppress non-error messages during configuration testing.
-s signal
Send signal to the master process. The argument signal can be one of: stop , quit , reopen , reload The following table shows the corresponding system signals.

stop
SIGTERM
quit
SIGQUIT
reopen
SIGUSR1
reload
SIGHUP

-t
Don't run, just test the configuration file. The checks configuration for correct syntax and then tries to open files referred in configuration.
-v
Print version.
-V
Print version, compiler version and configure script parameters.

 

SIGNALS

The master process of can handle the following signals.

SIGINT , SIGTERM
Shut down quickly.
SIGHUP
Reload configuration, start the new worker process with a new configuration, gracefully shut down old worker processes.
SIGQUIT
Shut down gracefully.
SIGUSR1
Reopen log files.
SIGUSR2
Upgrade executable on the fly.
SIGWINCH
Shut down gracefully worker processes.

While there's no need to explicitly control worker processes normally, they support some signals, too:

SIGTERM
Shut down quickly.
SIGQUIT
Shut down gracefully.
SIGUSR1
Reopen log files.

 

DEBUGGING LOG

To enable a debugging log, reconfigure to build with debugging:

"./configure --with-debug ..."

and then set the debug level of the error_log

"error_log /path/to/log debug;"

It is also possible to enable the debugging for some IP address:

events {
        debug_connection 127.0.0.1;
}
 

FILES

%%PID_PATH%%
Contains the process ID of the listening for connections. The content of this file is not sensitive; it can be world-readable.
%%CONF_PATH%%
Main configuration file.
%%ERROR_LOG_PATH%%
Error log file.

 

EXIT STATUS

Exit status is 0 on success, or 1 if the command fails.  

EXAMPLES

nginx -t -c ~/mynginx.conf -g "pid /var/run/mynginx.pid; worker_processes 2;"
Test configuration file ~/mynginx.conf with global directives for PID and quantity of worker processes.  

SEE ALSO

nginx.conf5  

HISTORY

Development of started in 2002, with the first public release on October 4, 2004.  

AUTHORS

An Igor Sysoev Aq igor@sysoev.ru

Documentation available on http://nginx.org/ and http://sysoev.ru/nginx/

This manual page was written by An Sergey A. Osokin Aq osa@FreeBSD.org.ru as a result of compilation of many documents all over the world.  

BUGS

Report to mailing list Aq Li nginx@nginx.org if you found one.


 

Index

NAME
SYNOPSIS
DESCRIPTION
SIGNALS
DEBUGGING LOG
FILES
EXIT STATUS
EXAMPLES
SEE ALSO
HISTORY
AUTHORS
BUGS

This document was created by man2html using the manual pages.
Time: 17:31:52 GMT, October 23, 2013

Meet new people