Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
NGHTTPD(1)			    nghttp2			    NGHTTPD(1)

NAME
       nghttpd - HTTP/2	server

SYNOPSIS
       nghttpd [OPTION]... <PORT> [<PRIVATE_KEY> <CERT>]

DESCRIPTION
       HTTP/2 server

       <PORT> Specify listening	port number.

       <PRIVATE_KEY>
	      Set    path   to	 server's  private   key.    Required	unless
	      --no-tls is specified.

       <CERT> Set   path   to	server's   certificate.	    Required	unless
	      --no-tls is specified.

OPTIONS
       -a, --address=<ADDR>
	      The address to bind to.  If not specified	the default IP address
	      determined by getaddrinfo	is used.

       -D, --daemon
	      Run in a background.  If -D is used, the current working	direc-
	      tory  is	changed	to '/'.	 Therefore  if this option is used, -d
	      option must be specified.

       -V, --verify-client
	      The server  sends	a client certificate  request.	If the	client
	      did   not	 return	  a certificate, the  handshake	is terminated.
	      Currently,  this	option just  requests	a  client  certificate
	      and does not verify it.

       -d, --htdocs=<PATH>
	      Specify  document	 root.	 If  this option is not	specified, the
	      document root is the current working directory.

       -v, --verbose
	      Print debug information	such  as  reception/  transmission  of
	      frames and name/value pairs.

       --no-tls
	      Disable SSL/TLS.

       -c, --header-table-size=<SIZE>
	      Specify decoder header table size.

       --encoder-header-table-size=<SIZE>
	      Specify  encoder header table size.  The decoder (client)	speci-
	      fies  the	maximum	 dynamic table	size it	  accepts.   Then  the
	      negotiated  dynamic  table  size	is  the	minimum	of this	option
	      value and	the value which	client specified.

       --color
	      Force colored log	output.

       -p, --push=<PATH>=<PUSH_PATH,...>
	      Push  resources <PUSH_PATH>s  when <PATH>	 is  requested.	  This
	      option   can  be used repeatedly	to specify multiple push  con-
	      figurations.    <PATH>  and    <PUSH_PATH>s   are	 relative   to
	      document	root.	See   --htdocs	option.	 Example: -p/=/foo.png
	      -p/doc=/bar.css

       -b, --padding=<N>
	      Add at  most <N>	bytes to a  frame payload  as padding.	 Spec-
	      ify 0 to disable padding.

       -m, --max-concurrent-streams=<N>
	      Set  the maximum number of  the concurrent streams in one	HTTP/2
	      session.

	      Default: 100

       -n, --workers=<N>
	      Set the number of	worker threads.

	      Default: 1

       -e, --error-gzip
	      Make error response gzipped.

       -w, --window-bits=<N>
	      Sets the stream level initial window size	to 2**<N>-1.

       -W, --connection-window-bits=<N>
	      Sets   the   connection	level	 initial   window   size    to
	      2**<N>-1.

       --dh-param-file=<PATH>
	      Path  to file that contains  DH parameters in PEM	format.	 With-
	      out  this	  option,  DHE	 cipher	 suites	  are  not available.

       --early-response
	      Start sending response when request HEADERS is received,	rather
	      than complete request is received.

       --trailer=<HEADER>
	      Add a trailer  header to a response.   <HEADER> must not include
	      pseudo header field  (header field name starting with ':').  The
	      trailer  is  sent	 only  if  a response has body part.  Example:
	      --trailer	'foo: bar'.

       --hexdump
	      Display  the   incoming  traffic	in    hexadecimal   (Canonical
	      hex+ASCII	 display).   If	 SSL/TLS   is used, decrypted data are
	      used.

       --echo-upload
	      Send back	uploaded content if method is POST or PUT.

       --mime-types-file=<PATH>
	      Path  to file  that contains  MIME media	types and  the	exten-
	      sions that represent them.

	      Default: /etc/mime.types

       --no-content-length
	      Don't send content-length	header field.

       --version
	      Display version information and exit.

       -h, --help
	      Display this help	and exit.

       The <SIZE> argument is an integer and an	optional unit (e.g., 10K is 10
       * 1024).	 Units are K, M	and G (powers of 1024).

SEE ALSO
       nghttp(1), nghttpx(1), h2load(1)

AUTHOR
       Tatsuhiro Tsujikawa

COPYRIGHT
       2012, 2015, 2016, Tatsuhiro Tsujikawa

1.41.0				 Jun 02, 2020			    NGHTTPD(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | SEE ALSO | AUTHOR | COPYRIGHT

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=nghttpd&sektion=1&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help