6.2.8 Directives starting with T and U

Organization of this subsection
(1) Timeout time
(2) ThreadsPerChild number-of-threads
(3) TraceEnable {On | Off | extended}
(4) TransferLog {file-name | pipe}
(5) TypesConfig file-name
(6) UnsetEnv environment-variable [environment-variable ...]
(7) UseCanonicalName {On | Off | dns}
(8) User user-name
(9) UserDir {directory-name | disabled [user-name [user-name ...]]}

(1) Timeout time

~((0 - 65535))<<300>> (Unit: Seconds)

(a) Contents

The Timeout directive specifies the following waiting times in seconds. If 0 is specified, the waiting time is 0 seconds.

(b) Location where you can code

httpsd.conf

(c) Specification example

Timeout 300

(2) ThreadsPerChild number-of-threads[Figure]

~((1 - 1024))<<40>>

(a) Contents

This directive specifies the number of threads to be started as a server. The number of specified threads denotes the maximum number of concurrent server connections.

(b) Location where you can code

httpsd.conf

(3) TraceEnable {On | Off | extended}

(a) Contents

This directive specifies whether to deny the requests from the TRACE method.

On: Grants permission to the request from the TRACE method. However, when the request body is added, the Web server responds with the status code 413 Request Entity Too Large.

Off: Denies the request from the TRACE method. When request is from the TRACE method, the Web server responds with the status code 403 Forbidden.

Extended: Grants permission to requests from the TRACE method. Grants permission even if the request body has been added. However, the upper limit of the size of request bodies other than request bodies from a reverse proxy is 64 KB.

(b) Location where you can code

httpsd.conf, <VirtualHost>

(c) Specification example

TraceEnable Off

(4) TransferLog {file-name | pipe}

(a) Contents

This directive specifies a file in which the log is stored or a program that outputs log. You can specify the log format with the LogFormat directive that does not specify a label name.

If you specify the log format in the LogFormat directive, an IPv6 address and the host name corresponding to the IPv6 address can be output. For details on the formats that you can specify, see the CustomLog directive.

If the log format is not specified in the LogFormat directive, the log is output in a standard log format.

file-name: Specifies a file name that stores the log. In file name, you can specify the absolute path or the relative path from the specified value of the ServerRoot directive.

pipe: Specifies a program that receives the log information from the standard input in "| Program name" format. For more details regarding the notes on Windows version, see CustomLog directive.

(b) Location where you can code

httpsd.conf, <VirtualHost>

(c) Specification example

TransferLog "|[Figure]"[Figure]"<Cosminexus-installation-directory>/httpsd/sbin/rotatelogs.exe[Figure]" [Figure] "<Cosminexus-installation-directory>/httpsd/logs/access[Figure]" 86400[Figure]""

Use the rotatelogs program to divide and collect the log every 24 hours.

(5) TypesConfig file-name

~<<conf/mime.types>>

(a) Contents

This directive specifies the settings file that defines the relationship between the file extension and contents type (MIME type). In file name, you can specify the absolute path or the relative path from the specified value of the ServerRoot directive.

(b) Location where you can code

httpsd.conf

(c) Specification example

TypesConfig conf/mime.types

The settings file for MIME types is mime.types

(6) UnsetEnv environment-variable [environment-variable ...]

(a) Contents

The UnsetEnv directive specifies the environment variables to delete from the environment variables to be passed to CGI scripts that are specified in the SetEnv or PassEnv directive.

(b) Location where you can code

httpsd.conf, <VirtualHost>, <Directory>, .htaccess

(c) Overwrite permission

FileInfo level

(d) Specification example

UnsetEnv MY_ENV

(7) UseCanonicalName {On | Off | dns}

(a) Contents

This directive specifies the generation method of the standard name of the server. The standard name of the server is set in the URL and the SERVER_NAME and SERVER_PORT of the environment variable that refer to local server.

On: The standard name of server is created from the ServerName directive value and is set in the URL and environment variable that refer to the local server. When you use the IP address to specify the VirtualHost, specify the ServerName in the VirtualHost block. When the ServerName is not specified in the block, acquire the host name from the IP address.

Off: The standard name of the server is created from the host name and the port number that is provided from the client by the Host header, and is set in the URL and environment variable that refers to the local server. However, when Host header is not provided, the standard name is created using the ServerName directive and the port name that is used in the actual connection.

dns: This option is for the old client that does not have the Host header. When specifying this option, the standard name of the sever is created using the host name extracted from the server ip address received from the client and the port number used in the actual connection, and set in the URL and environment variable that refers to the local server.

Note that IPv6 addresses are supported when the On, Off, or dns option is selected.

(b) Location where you can code

httpsd.conf, <VirtualHost>, <Directory>

(8) User user-name[Figure]

~<<#-1>>

(a) Contents

This directive specifies the user name when server process is running.

(b) Location where you can code

httpsd.conf

(c) Specification example

User nobody

(9) UserDir {directory-name | disabled [user-name [user-name ...]]}

~<<public_html>>(UNIX Version)

~<<disabled>>(Windows Version)

(a) Contents

This directive specifies a location on the server that is released for the request to /~user name/ from the Web browser as the directory name. When you set this directive as disabled, you can specify the user to whom the Web contents are not disclosed.

Specify the directory name using the relative path or the absolute path.

In Windows version, only the absolute path is valid.

directory-name:
disabled:
This option specifies a user that does not release Web contents for the request to the /~user name/ from Web browser. The directory name to be accessed is not changed for the request of the specified user name. When the user name is not specified, disabled is set for all users.
(b) Note
(c) Location where you can code

httpsd.conf, <VirtualHost>

(d) Specification example
(Example 1)

UserDir public_html

If home directory of user user1 is /home/user1, access /home/user1/public_html/index.html in the request http://host name [:port number]/~user1/index.html.
(Example 2)

UserDir /home
UserDir disabled user3
UserDir disabled user4 user5

Access /home/user1/index. html in the request http://host name [:port number]/~user1/index.html. However, you cannot access /home/user3/index.html in the requests http://host name [:port number]/~user3/index.html, since user3 is disabled. The access regarding user4 and user5 are similar to user3.
(Example 3)

UserDir disabled

Specify disabled for all users.