summaryrefslogtreecommitdiff
path: root/pod/nginx/switches.pod
blob: 908d7e79db78bdce2916e18661789a91c3ba1add (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
=encoding utf-8


=head1 Name


switches - Command-line parameters


=head1



nginx supports the following command-line parameters:

=over




=item *

C<-?> E<verbar> C<-h>E<mdash>print help
for command-line parameters.



=item *

C<-c I<C<file>>>E<mdash>use an alternative
configuration I<C<file>> instead of a default file.



=item *

C<-e I<C<file>>>E<mdash>use an alternative
error log I<C<file>> to store the log
instead of a default file (1.19.5).
The special value C<stderr> selects the standard error file.



=item *

C<-g I<C<directives>>>E<mdash>set
L<global configuration directives|ngx_core_module>,
for example,

    
    nginx -g "pid /var/run/nginx.pid; worker_processes `sysctl -n hw.ncpu`;"





=item *

C<-p I<C<prefix>>>E<mdash>set nginx path prefix,
i.e. a directory that will keep server files
(default value is I<C<E<sol>usrE<sol>localE<sol>nginx>>).



=item *

C<-q>E<mdash>suppress non-error messages
during configuration testing.



=item *

C<-s I<C<signal>>>E<mdash>send a I<signal>
to the master process.
The argument I<signal> can be one of:

=over



=item *

C<stop>E<mdash>shut down quickly


=item *

C<quit>E<mdash>shut down gracefully


=item *

C<reload>E<mdash>reload configuration,
start the new worker process with a new configuration,
gracefully shut down old worker processes.


=item *

C<reopen>E<mdash>reopen log files


=back





=item *

C<-t>E<mdash>test the configuration file: nginx checks the
configuration for correct syntax, and then tries to open files
referred in the configuration.



=item *

C<-T>E<mdash>same as C<-t>,
but additionally dump configuration files to standard output (1.9.2).



=item *

C<-v>E<mdash>print nginx version.



=item *

C<-V>E<mdash>print nginx version, compiler version,
and configure parameters.



=back