604
|
1 .\"
|
|
2 .\" Copyright (c) 2010 Sergey A. Osokin
|
660
|
3 .\" Copyright (c) 2011,2012 Nginx, Inc.
|
604
|
4 .\" All rights reserved.
|
|
5 .\"
|
|
6 .\" Redistribution and use in source and binary forms, with or without
|
|
7 .\" modification, are permitted provided that the following conditions
|
|
8 .\" are met:
|
|
9 .\" 1. Redistributions of source code must retain the above copyright
|
|
10 .\" notice, this list of conditions and the following disclaimer.
|
|
11 .\" 2. Redistributions in binary form must reproduce the above copyright
|
|
12 .\" notice, this list of conditions and the following disclaimer in the
|
|
13 .\" documentation and/or other materials provided with the distribution.
|
|
14 .\"
|
|
15 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
|
|
16 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
17 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
18 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
|
|
19 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
20 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
21 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
22 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
23 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
24 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
25 .\" SUCH DAMAGE.
|
|
26 .\"
|
|
27 .\"
|
666
|
28 .Dd March 6, 2012
|
604
|
29 .Dt NGINX 8
|
|
30 .Os
|
|
31 .Sh NAME
|
|
32 .Nm nginx
|
|
33 .Nd "HTTP and reverse proxy server, mail proxy server"
|
|
34 .Sh SYNOPSIS
|
|
35 .Nm
|
666
|
36 .Op Fl ?hqtVv
|
604
|
37 .Op Fl c Ar file
|
|
38 .Op Fl g Ar directives
|
|
39 .Op Fl p Ar prefix
|
|
40 .Op Fl s Ar signal
|
|
41 .Sh DESCRIPTION
|
|
42 .Nm
|
666
|
43 (pronounced
|
604
|
44 .Dq engine x )
|
|
45 is an HTTP and reverse proxy server, as well as a mail proxy server.
|
666
|
46 It is known for its high performance, stability, rich feature set, simple
|
604
|
47 configuration, and low resource consumption.
|
|
48 .Pp
|
|
49 The options are as follows:
|
|
50 .Bl -tag -width ".Fl d Ar directives"
|
666
|
51 .It Fl ?\& , h
|
604
|
52 Print help.
|
|
53 .It Fl c Ar file
|
|
54 Use an alternative configuration
|
|
55 .Ar file .
|
|
56 .It Fl g Ar directives
|
|
57 Set global configuration directives.
|
|
58 See
|
|
59 .Sx EXAMPLES
|
|
60 for details.
|
|
61 .It Fl p Ar prefix
|
666
|
62 Set the prefix path.
|
|
63 The default value is
|
604
|
64 .Pa %%PREFIX%% .
|
|
65 .It Fl q
|
|
66 Suppress non-error messages during configuration testing.
|
|
67 .It Fl s Ar signal
|
666
|
68 Send a signal to the master process.
|
604
|
69 The argument
|
|
70 .Ar signal
|
|
71 can be one of:
|
|
72 .Cm stop , quit , reopen , reload .
|
666
|
73 The following table shows the corresponding system signals:
|
604
|
74 .Pp
|
666
|
75 .Bl -tag -width ".Cm reopen" -compact
|
604
|
76 .It Cm stop
|
|
77 .Dv SIGTERM
|
|
78 .It Cm quit
|
|
79 .Dv SIGQUIT
|
|
80 .It Cm reopen
|
|
81 .Dv SIGUSR1
|
|
82 .It Cm reload
|
|
83 .Dv SIGHUP
|
|
84 .El
|
|
85 .It Fl t
|
666
|
86 Do not run, just test the configuration file.
|
604
|
87 .Nm
|
666
|
88 checks the configuration file syntax and then tries to open files
|
|
89 referenced in the configuration file.
|
|
90 .It Fl V
|
|
91 Print the
|
|
92 .Nm
|
|
93 version, compiler version, and
|
|
94 .Pa configure
|
|
95 script parameters.
|
604
|
96 .It Fl v
|
666
|
97 Print the
|
604
|
98 .Nm
|
|
99 version.
|
|
100 .El
|
|
101 .Sh SIGNALS
|
|
102 The master process of
|
|
103 .Nm
|
666
|
104 can handle the following signals:
|
604
|
105 .Pp
|
666
|
106 .Bl -tag -width ".Dv SIGINT , SIGTERM" -compact
|
604
|
107 .It Dv SIGINT , SIGTERM
|
|
108 Shut down quickly.
|
|
109 .It Dv SIGHUP
|
|
110 Reload configuration, start the new worker process with a new
|
666
|
111 configuration, and gracefully shut down old worker processes.
|
604
|
112 .It Dv SIGQUIT
|
|
113 Shut down gracefully.
|
|
114 .It Dv SIGUSR1
|
|
115 Reopen log files.
|
|
116 .It Dv SIGUSR2
|
666
|
117 Upgrade the
|
604
|
118 .Nm
|
|
119 executable on the fly.
|
|
120 .It Dv SIGWINCH
|
666
|
121 Shut down worker processes gracefully.
|
604
|
122 .El
|
|
123 .Pp
|
666
|
124 While there is no need to explicitly control worker processes normally,
|
|
125 they support some signals too:
|
604
|
126 .Pp
|
666
|
127 .Bl -tag -width ".Dv SIGINT , SIGTERM" -compact
|
604
|
128 .It Dv SIGTERM
|
|
129 Shut down quickly.
|
|
130 .It Dv SIGQUIT
|
|
131 Shut down gracefully.
|
|
132 .It Dv SIGUSR1
|
|
133 Reopen log files.
|
|
134 .El
|
|
135 .Sh DEBUGGING LOG
|
|
136 To enable a debugging log, reconfigure
|
|
137 .Nm
|
|
138 to build with debugging:
|
|
139 .Pp
|
|
140 .Dl "./configure --with-debug ..."
|
|
141 .Pp
|
|
142 and then set the
|
|
143 .Cm debug
|
|
144 level of the
|
|
145 .Va error_log :
|
|
146 .Pp
|
|
147 .Dl "error_log /path/to/log debug;"
|
|
148 .Pp
|
666
|
149 It is also possible to enable the debugging for a particular IP address:
|
604
|
150 .Bd -literal -offset indent
|
|
151 events {
|
|
152 debug_connection 127.0.0.1;
|
|
153 }
|
|
154 .Ed
|
666
|
155 .Sh ENVIRONMENT
|
|
156 The
|
|
157 .Ev NGINX
|
|
158 environment variable is used internally by
|
604
|
159 .Nm
|
666
|
160 and should not be set directly by the user.
|
|
161 .Sh FILES
|
|
162 .Bl -tag -width indent
|
|
163 .It Pa %%PID_PATH%%
|
|
164 Contains the process ID of
|
|
165 .Nm .
|
|
166 The contents of this file are not sensitive, so it can be world-readable.
|
604
|
167 .It Pa %%CONF_PATH%%
|
666
|
168 The main configuration file.
|
604
|
169 .It Pa %%ERROR_LOG_PATH%%
|
|
170 Error log file.
|
|
171 .El
|
|
172 .Sh EXIT STATUS
|
|
173 Exit status is 0 on success, or 1 if the command fails.
|
|
174 .Sh EXAMPLES
|
|
175 Test configuration file
|
|
176 .Pa ~/mynginx.conf
|
666
|
177 with global directives for PID and quantity of worker processes:
|
|
178 .Bd -literal -offset indent
|
|
179 nginx -t -c ~/mynginx.conf \e
|
|
180 -g "pid /var/run/mynginx.pid; worker_processes 2;"
|
|
181 .Ed
|
604
|
182 .Sh SEE ALSO
|
634
|
183 .\"Xr nginx.conf 5
|
|
184 .\"Pp
|
|
185 Documentation at
|
666
|
186 .Pa http://nginx.org/en/docs/ .
|
634
|
187 .Pp
|
|
188 For questions and technical support, please refer to
|
|
189 .Pa http://nginx.org/en/support.html .
|
604
|
190 .Sh HISTORY
|
|
191 Development of
|
|
192 .Nm
|
|
193 started in 2002, with the first public release on October 4, 2004.
|
|
194 .Sh AUTHORS
|
634
|
195 .An -nosplit
|
666
|
196 .An Igor Sysoev Aq igor@sysoev.ru .
|
604
|
197 .Pp
|
666
|
198 This manual page was originally written by
|
604
|
199 .An Sergey A. Osokin Aq osa@FreeBSD.org.ru
|
666
|
200 as a result of compiling many
|
604
|
201 .Nm
|
666
|
202 documents from all over the world.
|