send-error
Applicable in Error-class directives.
The send-error function sends an HTML file
to the client in place of a specific HTTP response status. The server
can therefore present an explanatory message describing the problem.
The HTML page may contain images and links to the server’s home
page or other pages.
Note – The send-error function can be used
to configure messages from the proxy server only and does not work
for configuring messages in place of HTTP responses from web server.
Parameters
The following table describes parameters for the send-error function.
Table 5–133
send-error Parameters
Parameter
|
Description
|
path
|
Specifies the full file system path of an HTML file to send
to the client. The file is sent as text/html regardless
of its name or actual type. If the file does not exist, the server
sends a simple default error page.
|
reason
|
(Optional) Text of one of the reason strings such as “Unauthorized”
or “Forbidden”. The string is not case sensitive.
|
code
|
(Optional) Three-digit number representing the HTTP response
status code, such as 401 or 403.
This number can be any HTTP response status code or reason phrase
according to the HTTP specification.
The common HTTP response status codes
and reason strings are:
-
401 Unauthorized
-
403 Forbidden
|
bucket
|
(Optional) Common to all obj.conf functions.
|
Example
Error fn=send-error code=401 path=/sun/server61/docs/errors/401.html
|