Sun Java System Web Server 7.0 Update 7 Administrator's Configuration File Reference

http-listener

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.

Subelements

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

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

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

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

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. 

See Also