The http-listener element configures an HTTP listener. This element may appear zero or more times within the server element. For more information, see server.
The http-listener element can contain the following subelements:
Table 3–23 List of http-listener Subelements
Element |
Occurrences |
Description |
---|---|---|
enabled |
0 or 1 |
Determines whether the HTTP listener is enabled at runtime. The default value is true. |
name |
1 |
The name that uniquely identifies the HTTP listener. |
ip |
0 or 1 |
The IP address on which to listen. The value of this element is a specific IP address, or * to listen on all IP addresses. |
port |
1 |
The port on which to listen. The value of this element is the port number. |
acceptor-threads |
0 or 1 |
The number of threads dedicated to accept connections received by this listener. The value can be from 1 to 128. |
server-name |
1 |
The default server name. The value can include a scheme prefix (for example, http://) and port suffix (for example, :80). |
blocking-io |
0 or 1 |
Determines whether the server uses blocking IO. The default value is false. |
family |
0 or 1 |
The name of the protocol family. |
handle-protocol-mismatch |
0 or 1 |
Controls the server's response to SSL or non-SSL protocol mismatches in client requests. A mismatch occurs when a client uses SSL to send a request to a non-SSL listener, or when a client sends a request to an SSL listener without using SSL. The default is true, which means that the server attempts to detect SSL or non-SSL protocol mismatches and sends an HTTP redirect or SSL alert when a mismatch is detected. |
listen-queue-size |
0 or 1 |
The maximum size (in bytes) of the operating system listen queue backlog. The value of this element can be from 1 to 1048576. |
receive-buffer-size |
0 or 1 |
The size (in bytes) of the operating system socket receive buffer. The value of this element can be from 1 to 1048576. |
send-buffer-size |
0 or 1 |
The size (in bytes) of the operating system socket send buffer. The value of this element can be from 1 to 1048576. |
default-virtual-server-name |
1 |
The name of the virtual server that processes requests that do not match a host. The value of this element is the name value from a virtual-server element. For more details, see virtual-server. |
ssl |
0 or 1 |
Configures SSL/TLS. For more details, see ssl. |
description |
0 or 1 |
The description of the HTTP listener. The value of this element should be in a text format. |