1 .\" Man page generated from reStructuredText.
3 .TH "NGHTTPD" "1" "Jun 02, 2020" "1.41.0" "nghttp2"
5 nghttpd \- HTTP/2 server
7 .nr rst2man-indent-level 0
11 level \\n[rst2man-indent-level]
12 level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
19 .\" .rstReportMargin pre:
21 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
22 . nr rst2man-indent-level +1
23 .\" .rstReportMargin post:
27 .\" indent \\n[an-margin]
28 .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
29 .nr rst2man-indent-level -1
30 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
31 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
35 \fBnghttpd\fP [OPTION]... <PORT> [<PRIVATE_KEY> <CERT>]
42 Specify listening port number.
47 Set path to server\(aqs private key. Required unless
48 \fI\%\-\-no\-tls\fP is specified.
53 Set path to server\(aqs certificate. Required unless
54 \fI\%\-\-no\-tls\fP is specified.
59 .B \-a, \-\-address=<ADDR>
60 The address to bind to. If not specified the default IP
61 address determined by getaddrinfo is used.
66 Run in a background. If \fI\%\-D\fP is used, the current working
67 directory is changed to \(aq\fI/\fP\(aq. Therefore if this option
68 is used, \fI\%\-d\fP option must be specified.
72 .B \-V, \-\-verify\-client
73 The server sends a client certificate request. If the
74 client did not return a certificate, the handshake is
75 terminated. Currently, this option just requests a
76 client certificate and does not verify it.
80 .B \-d, \-\-htdocs=<PATH>
81 Specify document root. If this option is not specified,
82 the document root is the current working directory.
87 Print debug information such as reception/ transmission
88 of frames and name/value pairs.
97 .B \-c, \-\-header\-table\-size=<SIZE>
98 Specify decoder header table size.
102 .B \-\-encoder\-header\-table\-size=<SIZE>
103 Specify encoder header table size. The decoder (client)
104 specifies the maximum dynamic table size it accepts.
105 Then the negotiated dynamic table size is the minimum of
106 this option value and the value which client specified.
111 Force colored log output.
115 .B \-p, \-\-push=<PATH>=<PUSH_PATH,...>
116 Push resources <PUSH_PATH>s when <PATH> is requested.
117 This option can be used repeatedly to specify multiple
118 push configurations. <PATH> and <PUSH_PATH>s are
119 relative to document root. See \fI\%\-\-htdocs\fP option.
120 Example: \fI\%\-p\fP/=/foo.png \fI\%\-p\fP/doc=/bar.css
124 .B \-b, \-\-padding=<N>
125 Add at most <N> bytes to a frame payload as padding.
126 Specify 0 to disable padding.
130 .B \-m, \-\-max\-concurrent\-streams=<N>
131 Set the maximum number of the concurrent streams in one
138 .B \-n, \-\-workers=<N>
139 Set the number of worker threads.
145 .B \-e, \-\-error\-gzip
146 Make error response gzipped.
150 .B \-w, \-\-window\-bits=<N>
151 Sets the stream level initial window size to 2**<N>\-1.
155 .B \-W, \-\-connection\-window\-bits=<N>
156 Sets the connection level initial window size to
161 .B \-\-dh\-param\-file=<PATH>
162 Path to file that contains DH parameters in PEM format.
163 Without this option, DHE cipher suites are not
168 .B \-\-early\-response
169 Start sending response when request HEADERS is received,
170 rather than complete request is received.
174 .B \-\-trailer=<HEADER>
175 Add a trailer header to a response. <HEADER> must not
176 include pseudo header field (header field name starting
177 with \(aq:\(aq). The trailer is sent only if a response has
178 body part. Example: \fI\%\-\-trailer\fP \(aqfoo: bar\(aq.
183 Display the incoming traffic in hexadecimal (Canonical
184 hex+ASCII display). If SSL/TLS is used, decrypted data
190 Send back uploaded content if method is POST or PUT.
194 .B \-\-mime\-types\-file=<PATH>
195 Path to file that contains MIME media types and the
196 extensions that represent them.
198 Default: \fB/etc/mime.types\fP
202 .B \-\-no\-content\-length
203 Don\(aqt send content\-length header field.
208 Display version information and exit.
213 Display this help and exit.
216 The <SIZE> argument is an integer and an optional unit (e.g., 10K is
217 10 * 1024). Units are K, M and G (powers of 1024).
220 \fBnghttp(1)\fP, \fBnghttpx(1)\fP, \fBh2load(1)\fP
224 2012, 2015, 2016, Tatsuhiro Tsujikawa
225 .\" Generated by docutils manpage writer.