Specify the ErrorDocument directive to customize the error message displayed on the Web browser when an error occurs.
Text: Specifies the character string enclosed in ".
local-URL: Specifies the contents of the local site by adding a / at the beginning.
full-URL: Specifies the contents of another site by using a URL that starts with http:// or https://.
The error status numbers that can be specified in this directive and the possibility to specify text, the local URL, and the full URL is described below:
Error status number (meaning) | Text | Local URL | Full URL |
---|---|---|---|
400 (Bad Request) | Y | N | N |
401 (Authorization Required) | Y | Y | N |
403 (Forbidden) | Y | Y | Y |
404 (Not Found) | Y | Y | Y |
405 (Method Not Allowed) | Y | Y | Y |
406 (Not Acceptable) | Y | Y | Y |
408 (Request Time-out) | N | N | N |
410 (Gone) | Y | Y | Y |
411 (Length Required) | Y | N | N |
412 (Precondition Failed) | Y | Y | Y |
413 (Request Entity Too Large) | Y | Y | Y |
414 (Request-URI Too Large) | Y | N | N |
416 (Requested Range Not Satisfiable) | Y | Y | Y |
417 (Expectation Failed) | Y | N | N |
500 (Internal Server Error) | Y | Y | Y |
501 (Method Not Implemented) | Y | Y | Y |
502 (Bad Gateway) | Y | Y | N |
503 (Service Temporarily Unavailable) | Y# | Y# | Y# |
506 (Variant Also Negotiates) | Y | Y | Y |
When you specify this directive, consider the following points:
httpsd.conf, <VirtualHost>, <Directory>, .htaccess
FileInfo level
ErrorDocument 500 "Server Error."
ErrorDocument 404 /missing.html
ErrorDocument 403 http://some.other_server.com/subscription_info.html
ErrorDocument 404 http://[2001::123:4567:89ab:cdef]/missing.html
~<<logs/error_log>> (UNIX version)
~<<logs/error.log>> (Windows version)
The ErrorLog directive specifies the name of the file in which error log is output. You can select the log contents to be output by the LogLevel directive.
In the file name you can specify absolute path, or relative path from the specified value of the ServerRoot directive.
file-name: Specifies the name of the file that stores the error log. You can specify the file name using the relative path from the specified value of the ServerRoot directive.
pipe: Specifies the program that receives error log information from the standard input in the "|Program name" format. For the notes on Windows version, see CustomLog directive.
httpsd.conf, and <VirtualHost>
ErrorLog logs/error.log
The ExtendedStatus directive specifies whether to display the extended status information of each request in the format for displaying the status by the server-status handler.
On: Displays extended status information. This information is displayed even if the client IP address is an IPv6 address. A maximum of 31 bytes can be displayed.
Off: Does not display the extended status information.
httpsd.conf
The ExpiresActive directive specifies whether to add the Expires header and Cache-Control header to the response.
On: Adds the Expires header and Cache-Control header.
Off: Does not add the Expires header and Cache-Control header.
httpsd.conf, <VirtualHost>, <Directory>, .htaccess
Indexes level
~((0-2147483647))(Unit: Seconds)
The ExpiresByType directive specifies the expiry date for the specified MIME type document when you add Expires header and Cache-Control header to the response. This directive is enabled when the ExpiresActive directive is set to On. The default expiry date set in the ExpiresDefault directive is overwritten by these settings for each MIME type.
Specify the standard time by A or M, and specify the time from the standard time to the expiry date in seconds. Do not enter a space between A or M and the time.
A: The time when client accesses is interpreted as the standard time.
M: The time when the file was last modified is interpreted as the standard time.
httpsd.conf, <VirtualHost>, <Directory>, .htaccess
Indexes level
ExpiresByType text/html A604800
~((0 - 2147483647)) (Unit: Seconds)
The ExpiresDefault directive specifies the default expiry date when you add the Expires header and Cache-Control header to the response. This directive is enabled when the ExpiresActive directive is set to On. The ExpiresByType directive overwrites these settings for each MIME type.
Specify the standard time by A or M, and specify the time from the standard time to the expiry date in seconds. Do not enter a blank between A or M and the time.
A: The time when the client accesses is interpreted as the standard time.
M: The time when the file was last modified is interpreted as the standard time.
httpsd.conf, <VirtualHost>, <Directory>, .htaccess
Indexes level
ExpiresDefault A604800
The FancyIndexing directive specifies whether to perform the format display (fancy index) when you display the directory index.
On: Performs the format display.
Off: Does not perform the format display.
httpsd.conf, <VirtualHost>, <Directory>, .htaccess
Indexes level
FancyIndexing On
Use the format display functionality.
~<<All>>
The FileETag directive specifies the file attribute value used for creating Etag response header field. When this directive is not specified, the unique ID assigned to the file, last updated time, and bytes count are set in the Etag response header field.
When you do not specify + - in the option, the attribute value specified in the option is used.
When you specify + - in the option, you can change the attribute value set by the FileETag directive.
+: The attribute value specified in the option is added to the set attribute value.
-: The attribute value specified in the option is deleted from the set attribute value.
The following table lists the options that you can specify:
Option | Meaning |
---|---|
Inode | The unique ID assigned to the file is included. |
Mtime | Last updated time of the file is included. |
Size | Bytes count of the file is included. |
All | All the Inode, Mtime, and the Size options are enabled. |
None | Etag header is not added. |
httpsd.conf, <VirtualHost>, <Directory>, .htaccess
FileInfo level
FileETag Inode Mtime Size
FileETag -Inode
FileETag Inode Mtime
FileETag Size
FileETag All
FileETag -Inode -Mtime -Size
Define the ForceType directive in the <Directory> block or in the access control file. This directive specifies the MIME types to be used for all the contents under the specific directory. If you specify none, the previous ForceType directive specifications are disabled.
<Directory>, .htaccess
FileInfo level
~<<#-1>>
This directive specifies the group name used when server processes are running.
httpsd.conf
Group nogroup Define the group name nogroup
Specify the 'Header' directive for customizing the response header when the Web server responds with the status code 200. When using this directive as a reverse proxy, the response header is customized regardless of the status code value returned by the backend Web server.
set: Sets the header. If the header is found, rewrite it with the specified header value.
append: Adds the header value to the existing header. A comma delimits the existing header values. Sets the header if it does not exist.
add: Sets a header in another line even if the header exists. Use this directive when setting the same header in multiple lines.
unset: If the specified header exists, deletes it.
env=environment-variable: When the specified environment variable is set, executes the contents specified in the Header directive.
env=!environment-variable: When the specified environment variable is not set, executes the contents specified in the Header directive.
If the header value contains spaces, then you must enclose the value in "(double quotation mark). For the header value you can specify character strings containing only the characters, character string including the format identifiers, or the character string containing both the characters and the format identifiers. The format identifiers are as follows:
Format | Meaning |
---|---|
%t | Display the time when the request was received, by the time elapsed from January 01, 1970, 00:00:00 (GMT: Greenwich Mean Time. The unit is Microseconds. "t=" is added in the beginning. |
%D | Display the time taken for request processing. The unit is microseconds. "D=" is added in the beginning. |
%{env_name}e | Value of the environment variable env_name. |
The mod_headers module must be embedded to use the header customization functionality. For details on the header customization functionality, see 4.10 Header customization functionality.
httpsd.conf, <VirtualHost>, <Directory>, .htaccess
FileInfo level
Header set Cache-Control no-cache
The HeaderName directive specifies the file name (without path information) of the file that describes the comments added to the header when displaying the directory index. You can describe the file name in the HTML or the plain text format. However, MIME type must be correctly defined in the file specified with the AddType directive or the TypesConfig directive. When you create comments in the plain text, the <PRE> tag is added to the HTML of the directory index display.
httpsd.conf, <VirtualHost>, <Directory>, .htaccess
Indexes level
HeaderName HEADER.html
Contents of HEADER.html under each directory are added to the header.
The HostnameLookups directive specifies whether to reverse the lookup of the host name to convert the IP address of the REMOTE_HOST environment variable of CGI and the client IP address to be output to the log file, into the host name. If you use reverse, response is delayed.
On: Converts the IP address into the host name.
Off: Does not convert the IP address into the host name.
double: Converts the IP address into the host name. After conversion, reconvert and confirm that the IP address is correct.
This directive supports IPv6 addresses.
httpsd.conf, <VirtualHost>, <Directory>
HostnameLookups Off
Do not convert the IP address in the host name.
~((1 - 2097093))<<256>> (Unit: KB)
The HWSContentCacheMaxFileSize directive specifies the upper limit of the file size that you can cache in KB. In the HWSContentCacheMaxFileSize directive, if you specify a value greater than the value of the HWSContentCacheSize directive, the value of the HWSContentCacheSize directive is set.
The mod_hws_cache module must be embedded to use the static contents cache functionality. For details on the static contents cache functionality, see 4.12 Static contents cache functionality.
httpsd.conf
HWSContentCacheMaxFileSize 32
~((1 - 2097093))<<8192>> (unit: KB)
The HWSContentCacheSize directive specifies the upper limit of the memory size of the data to be cached in server process, in KB.
The mod_hws_cache module must be embedded to use the static contents cache functionality. For details on the static contents cache functionality, see 4.12 Static contents cache functionality.
httpsd.conf
HWSContentCacheSize 1024
This directive sets the character set for messages (hereafter called the error document) that are displayed on the Web browser when an error occurs. In the error document, the character set is set as a value of charset= by the META tags. For the error documents customized with the ErrorDocument directive, character set is not set as per the META tags in this directive.
On: Sets the character set ISO-8859-1.
Off: Does not set the character set.
character-set: Sets the specified character set.
httpsd.conf
HWSErrorDocumentMETACharset ISO-2022-JP
Specify The HWSErrorLogClientAddr directive to change the message text to be output to error log from"[client client-address]" to "[X-Forwarded-For header-value]".On the back-end server, change the the message text to be output to the error log from "[client client-address]" to "[X-Forwarded-For header-value]".
When the back-end server receives a request through a load balancer or a proxy server, "[client client-address]" to be output to the error log could becomes the IP address of the load balancer or proxy server, instead of the actual client IP address from which the request was sent. However, as because some load balancers and proxy servers can add the original client IP address to the X-Forwarded-For header, change the header settings to the client IP address by changing the output content to the value of the X-Forwarded-For header.
X-Forwarded-For: Change "[client client-address]" to be output to error log to "[X-Forwarded-For header-value]".
Some types of messages cannot be changed. For example, when an error occurs before the server receives the X-Forwarded-For header. The messages you cannot change are as follows.
No. | Message |
---|---|
1 | [client client-address] detailed-information: core_output_filter: Error reading from bucket. |
2 | [client client-address] request failed: URI too long (longer than upper-limit) |
3 | [client client-address] request failed: erroneous characters after protocol string: request-line |
4 | [client client-address] client sent invalid HTTP/0.9 request: HEAD request-URI-value |
5 | [client client-address] {child process process-ID|server thread thread-ID}:forcing termination of request "request-line" |
6 | [client client-address] detailed-information: core_output_filter: writing data to the network |
7 | [client client-address] request failed: error reading the headers# |
No. | Message |
---|---|
1 | [client client-address] [port client-port-number] allocate error |
2 | [client client-address] [port client-port-number] data set error |
3 | [client client-address] [port client-port-number] No client certificate |
4 | [client client-address] detailed-information: SSL handshake interrupted by system: client port port-number |
5 | [client client-address] detailed-information: SSL handshake interrupted by system: client port port-number (SSL-handshake-process-time)(error-number-value)( server-process-ID): SSL-handshake-processing-status |
6 | [client client-address] SSL library error error-number in handshake |
7 | [client client-address] [port client-port-number] SSL library error error-number in handshake(SSL-handshake-process-time)(error-number-value)(server-process-ID): SSL-handshake-processing-status |
8 | [client client-address] [port client-port-number] verify error:num=value:error-message |
9 | [client client-address] [port client-port-number] Verify depth exceeded |
10 | [client client-address] [port client-port-number] verify error |
httpsd.conf
The HWSGracefulStopLog directive specifies whether the request information that is forcefully terminated after the waiting time of forced termination elapses, is to be output in the error log file when you execute planned termination.
On: Outputs the forcefully terminated request information to the error log file.
Off: Does not output the forcefully terminated request information to the error log file.
httpsd.conf
HWSGracefulStopLog On
~((0 - 3600))<<300>> (Unit: Seconds)
The HWSGracefulStopTimeout directive specifies the forced termination waiting time until the request being executed is stopped at once during the planned termination. The upper limit of the forced termination waiting time is not set if 0 is specified.
httpsd.conf
HWSGracefulStopTimeout 600
(ISO-8859-1)
The HWSImapMenuCharset directive specifies the character set displayed in menus in the following cases:
The character set is set as the value of charset= in the Content-Type header of the response.
httpsd.conf, <VirtualHost>, <Directory>, .htaccess
Indexes level
HWSImapMenuCharset SHIFT_JIS
The HWSKeepStartServers directive specifies whether to maintain only the number of running server processes that are specified in the StartServers directive.
On: Only the number of running server processes that are specified in the StartServers directive are maintained. If the number of server processes is less than the value specified in the StartServers directive, new processes are generated. This functionality is valid when the value specified in each directive regarding the number of processes, is related as follows:
MinSpareServers < StartServers MaxClients
and
MinSpareServers < MaxSpareServers MaxClients
When the setting value of the StartServers directive is less than the setting value of the MinSpareServers directive, the number of server processes is maintained by the value of the MinSpareServers directive.Off: The running server processes, equivalent to the number specified in the StartServers directive are not maintained.
For details on other directives regarding the number of processes, see 4.1 Relationship between processes and directives of Cosminexus HTTP Server.
httpsd.conf
The HWSLogSSLVervose directive specifies whether to output detailed information for the info-level and error-level failures among the errors that are output to the log during the SSL handshake process between clients and servers. When SSL is enabled, we recommend that you set this directive to On.
On: Displays detailed information
Off: Does not display detailed information
httpsd.conf
The HWSLogTimeVerbose directive specifies whether to display error log# times, request log times, access times in the access log, the time taken for request processing (%), and request process start times (%t), accurate to the millisecond.
#: This directive targets the error log specified by using the ErrorLog directive. The CGI script error log specified by using the ScriptLog directive is not targeted.
On: Displays the hours and time in Milliseconds.
Off: Displays the hours and time accurate to the second
httpsd.conf
~((0 - 2147483647))<<8192>>
The HWSMaxQueueSize directive specifies the maximum number of waiting requests for requests from clients. There is no limit on the number of requests when 0 is specified. The requests from the client that exceed the request queue size specified in this directive are disconnected in the server side.
httpsd.conf
The HWSNotModifiedResponseHeaders directive specifies the response header added when the status code 304 Not Modified is sent to the client.
Note that the headers below are added to responses even if they are not specified in this directive. However, the headers are not always added, but are added only when settings for the headers have been performed, such as on external modules or servers.
httpsd.conf
HWSNotModifiedResponseHeaders Set-Cookie Set-Cookie2
When using a reverse proxy, the HWSProxyPassReverseCookie directive enables the reverse proxy to convert a Set-Cookie header received from a backend server. This process is required to send the cookie as the return for a request sent to the backend server via the reverse proxy after the Web browser receives the Set-Cookie header.
path-name: Specify the same name as for the ProxyPass directive.
The mod_proxy and mod_proxy_http modules must be embedded to use a reverse proxy. For details on reverse proxies, see the 4.7 Setting the reverse proxy.
httpsd.conf, <VirtualHost>
The HWSRequestLog directive specifies the name of the file to which a request log is output. The request log is a generic name that refers to module trace information, request trace information, and I/O filter trace information. The type of the output request log can be selected by using the HWSRequestLogType directive.
file-name: Specifies the name of the file to which the request log is output. For the file name, you can specify either an absolute path, or a relative path from the specification value of the ServerRoot directive.
pipe: Specifies the program that receives log information from standard input in the format | program-name. For notes on the Windows version, see the CustomLog directive.
httpsd.conf
(module-info request)
The HWSRequestLogType directive specifies the type of trace information to be output to the request log that is set by using the HWSRequestLog directive. The following table shows the types of trace information.
Trace type | Description |
---|---|
module-debug | Outputs trace information for internal modules and the trace information corresponding to module-info. Because specifying this trace type results in the output of a large amount of data, do not specify this trace type for a purpose other than debugging. |
module-info | Outputs the module trace information collected when external modules and CGI programs are executed. |
request | Outputs trace information when a request process starts and is completed. For a KeepAlive connection, trace information is also output when the next request line is received. This trace is called a request trace. |
filter | Outputs I/O filter trace information that indicates the execution trigger of the input and output filter function for a module. Because specifying this trace type results in the output of a large amount of data, do not specify this trace type for a purpose other than debugging. |
none | No request logs are collected. |
When none is included in the specified trace types, no request logs are collected.
httpsd.conf
The HWSSetEnvIfIPV6 directive defines environment variables based on the IPv6 address of the client or the server. Set the specified environment variable when the request value meets the conditions of the IPv6 address. By default, the value is set to 1. When an exclamation mark (!) is added before an environment variable, that environment variable setting is canceled.
The following request values can be specified.
Request value | Description |
---|---|
Remote_Addr | The IPv6 address of the client |
Server_Addr | The IPv6 address of the server that received the request |
Specify the IPv6 address without enclosing it in square brackets ([ ]). Note that the prefix length can be specified in decimal format after the IPv6 address. The prefix length is specified in the IPv6-address/prefix-length format.
httpsd.conf, <VirtualHost>, <Directory>, .htaccess
FileInfo level
HWSSetEnvIfIPv6 Remote_Addr 2001:0:0:1230::/64 IPV6_CLIENT
The IPv6 address of the client starts with 2001:0:0:1230, specify the IPV6_CLIENT environment variable.
The HWSStackTrace directive specifies whether to output the contents of the stack trace information. This directive is enabled only when using the HP-UX version.
On: Outputs the contents of the stack trace information to the error log file.
Off: Does not output the contents of the stack trace information to the error log file.
httpsd.conf
HWSStackTrace On
The HWSSuppressModuleTrace directive specifies the file name of a module for which trace information is to be suppressed and the type of functions to be suppressed.
all: Suppresses all module trace information output by the specified module.
hook: Of the trace information output by the specified module, suppresses trace information other than that for the handler function. For details on types of functions, see Table 4-4 of 4.2.6 Collecting the module trace.
handler: Of the trace information output by the specified module, suppresses only the trace information for the handler function. For details on types of functions, see Table 4-4 of 4.2.6 Collecting the module trace.
The module file name to be output to either the error log or request log is specified for module-file-name. To suppress the module trace information shown in the following example, mod_example.c is specified for module-file-name:
[Mon Dec 18 14:57:14 2006] [info] hws : module --> (mod_example.c[12])(1896)
[Mon Dec 18 14:57:14 2006] [info] hws : module <-- (mod_example.c[12])(1896)(-1)
The following table shows the names of the standard external modules provided by Cosminexus HTTP Server and the corresponding module file names:
Table 6-5 TableNames of standard external modules provided by Cosminexus HTTP Server and corresponding module file names
Module name | Module file name |
---|---|
mod_expires.so | mod_expires.c |
mod_headers.so | mod_headers.c |
mod_hws_cache.so | mod_hws_cache.c |
mod_hws_ldap.so | mod_hws_ldap.c |
mod_hws_qos.so | mod_hws_qos.c |
mod_proxy.so | mod_proxy.c |
mod_proxy_http.so | Module trace information is not output. |
When using external modules other than the standard modules provided by Cosminexus HTTP Server, module trace information might be output. In addition, if debug is set by using the LogLevel directive, or if module-debug is set by using the HWSRequestLogType directive, trace information for internal modules is output.
Note that you can specify this directive multiple times. If you specify the directives by using the same module name, only the last directive specified is valid.
Module trace information cannot be suppressed during execution of a CGI program.
httpsd.conf
HWSSuppressModuleTrace mod_proxy.c all
HWSSuppressModuleTrace mod_proxy.c hook
~<<logs/hws.trcid>>
The HWSTraceIdFile directive specifies the file name that stores the shared memory ID for trace collection. In the file name you can specify the absolute path, or the relative path from the specified value of the ServerRoot directive.
Multiple Web servers cannot share this file. In the case of starting multiple Web servers by specifying the same ServerRoot directives, you need to specify different file names in this directive.
httpsd.conf
~<<logs/hws.trclog>>
The HWSTraceLogFile directive specifies the file name that outputs the trace collected in the shared memory when the server process ends abnormally. In the file name you can specify the absolute path, or the relative path from the specified value of the ServerRoot directive.
The trace is output by wrapping around to multiple files.
For the UNIX version, up to 5 files are output. Output file names are specified-file-name.nn, where nn is a number from 01 to 05. When Cosminexus HTTP Server starts, specified-file-name.01 is the current output file name. When trace information is output to the current output file with file name specified-file-name.nn, the next current file name becomes specified-file-name.nn + 1. If the nn portion of specified-file-name.nn is 05, the next current file name becomes specified-file-name.01.
For the Windows version, up to 2 files are output. Output file names are specified-file-name.01 or specified-file-name.02. When Cosminexus HTTP Server starts, specified-file-name.01 is the current output file name. If trace information is output to the current output file with file name specified-file-name.01, the next current file name becomes specified-file-name.02. If trace information is output to the current output file whose name is specified-file-name.02, the next current file name becomes specified-file-name.01.
httpsd.conf
The IdentityCheck directive specifies whether to use the identd daemon of the client host to check the identity of the client. For details on ident, see RFC 1413.
However, when an IPv6 address is assigned to the client host, the client is not checked by using the identd daemon even if On is specified. If %1 is specified as the log format, unknown is output to REMOTE_IDENT, which is a CGI environment valuable.
On: Checks the client by using the identd daemon
Off: Does not check the client by using the identd daemon
httpsd.conf, <VirtualHost>, <Directory>
This directive specifies the default base line of the image map file.
map: Location of map file
referrer: Location of document (Location of HTML file that displays the image map)
URL: Specified URL
For the URL, you can also specify an IPv6 address or the host name corresponding to an IPv6 address.
httpsd.conf, <VirtualHost>, <Directory>, .htaccess
Indexes level
This directive specifies the default values for the default line of the image map file.
error: Displays the standard error message (The web server responds with the status code 500 Server Error).
nocontent: Ignores the request (The web server responds with the status code 204 No Content).
map: Displays the URL of map file in the menu.
referer: The web server responds with the status code 302 Found.
URL: Displays the contents of the specified URL.
For the URL, you can also specify an IPv6 address or the host name corresponding to an IPv6 address.
httpsd.conf, <VirtualHost>, <Directory>, .htaccess
Indexes level
The ImapMenu specifies the menu display when 'map' is provided in the specification value of the image map file or when the coordinates (0,0) on the image map are pointed with the mouse. The operation when an image map file is requested without any specified coordinates is also as per these settings.
none: Does not generate the menu. The operations are as per the default line specifications of the map file.
formatted: Displays the header and link list. The comments in the map file are ignored.
semiformatted: Displays the link list. Also, displays the comments in the map file.
unformatted: You can set the menu format independently by describing HTML in the map file.
httpsd.conf, <VirtualHost>, <Directory>, .htaccess
Indexes level
The 'Include' directive makes the file specified in the file name available as the configuration file.
In the file name, you can specify the absolute path, or the relative path from the specified value of the ServerRoot directive. If there are multiple specifications of this directive, the merged contents are used. When the file contains the same directives, the directive specified later would overwrite the earlier ones.
httpsd.conf
The IndexIgnore directive specifies the file name that is not displayed on the Web browser when you display the directory index. You can specify even by the regular expressions.
httpsd.conf, <VirtualHost>, <Directory>, .htaccess
Indexes level
IndexIgnore .??* *~ *# HEADER* README* RCS CVS *,v *,t
The IndexOptions directive sets the format display functionality options of the directory index. An option is enabled when + is specified before the option, or when +- is omitted. By default, all the options are disabled. The following table describes the list of options that you can specify:
Table 6-6 The Option list
Option | Meaning |
Charset=character-set (ISO-8859-1 ![]() (UTF-8 ![]() | This option specifies the character set of the pages used for index display. If the character set used in the file specified in the HeaderName directive or the ReadmeName directive differs from the default character set (for the UNIX version: ISO-8859-1, for the Windows version: UTF-8), specify the same character set as for the file specified in the HeaderName directive or the ReadmeName directive. For this option, =character-set cannot be omitted. The operation when -Charset is specified is the same as the operation when +Charset is specified. |
DescriptionWidth[={Number of characters | *}] <<23, 30, 42, or 49>> | This option specifies the width of file descriptive text area by number of characters (1 character=1 byte). If you specify *, the display is in accordance with the maximum length of the file descriptive text specified in the AddDescription directive. If you omit this option, the width of the file descriptive text area is 23 bytes (However, width is +7 when SuppressSize is specified and +19 when SuppressLastModified is specified). You can omit ={number-of-characters | *} when the -DescriptionWidth is specified. Display width in such case is 23 bytes. |
FancyIndexing | Enables the format display functionality of the directory index. |
FoldersFirst | Specify this option when performing the index display of the directory before the file. However, this is the case only when the FancyIndexing is enabled. |
IconsAreLinks | Link the icons to files when you display the directory in index format. |
IconHeight[=Number of pixels]((>0))<<22>> | This option specifies the height of icon in number of pixels when you display the directory index format. Specify this option along with the IconWidth option. This option becomes the HEIGHT attribute of the HTML IMG tag that displays the index. |
IconWidth[=Number of pixels]((>0))<<20>> | This option specifies the icon width in pixels when you display the directory index format. Specify this option along with the IconHeight option. This option becomes the Width attribute of the HTML IMG tag that displays the index. |
IgnoreCase | When you display the directory index format, this option sorts the file names and the directory names ignoring the case. |
NameWidth[={number-of-characters | *}]<<23>> | This option specifies the width of file name and the directory name area with the number of characters (1 character=1byte). If you specify *, the display is in accordance with the maximum length of file name and the directory name. If you omit ={number-of-characters | *}, always specify this option as -NameWidth. |
ScanHTMLTitles | When the AddDescription directive is not specified, search for the <TITLE> tag in the HTML file and display it as the descriptive text. |
SuppressColumnSorting | This option disables the functionality that sorts the index into the columns of the file name, directory name, last updated date and time, file size, and file descriptive text. |
SuppressDescription | This option does not display the descriptive text of the file. |
SuppressHTMLPreamble | This option outputs both the contents of the file specified in the HeaderName directive and the HTML header that is automatically created (such as <HTML> and <TITLE>) when the HeaderName directive is specified. This option suppresses the output of the HTML header that is automatically created when the file specified in the HeaderName directive is written in HTML. |
SuppressLastModified | This option does not display the last updated date and time. |
SuppressSize | This option does not display the file size. |
TrackModified | This option sets the Last-Modified value and Etag value in the HTTP response header of the response for directory display. If you specify this option, as the directory can check the file configuration changes, the client can use the cache functionality effectively. This option is valid only when the operating system and file system supports stat(). |
httpsd.conf, <VirtualHost>, <Directory>, .htaccess
Indexes level
The IndexOrderDefault directive specifies the default sorting order for the files in the directory index display.
Ascending: Ascending order
Descending: Descending order
Name: Sort by the file name.
Date: Sort by the file update date.
Size: Sort by the file size.
Description: Sort by the descriptive text specified in the AddDescription directive.
httpsd.conf, <VirtualHost>, <Directory>, .htaccess
Indexes level