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. This allows the server
to present a friendly message describing the problem. The HTML page may contain
images and links to the server’s home page or other pages.
Parameters
The following table describes parameters for the send-error function.
Table 5–124 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 407.
This can be any HTTP response status code or reason phrase according
to the HTTP specification.
The following is a list of common HTTP response status codes and
reason strings:
-
401 Unauthorized
-
403 Forbidden
-
404 Not Found
-
500 Server Error
|
bucket
|
(Optional) Common to all obj.conf functions.
|
Example
Error fn=send-error code=401 path=/sun/server61/docs/errors/401.html
|