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 65535. | 
| 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. |