Prev: Next: Up: ListenHTTP[Contents][Index]


9.9.3 Error definitions

When pound returns an error status, it uses built-in error-specific description code and status page template. These values can be customized using the ErrorFile statement.

ListenHTTP directive: ErrorFile code "filename"

Read HTML page for HTTP status code code from file filename.

The code argument is a three-digit HTTP response status, and filename is the name of a file which supplies text of the error page to be returned. The file is read once, at program startup.

For compatibility with pound versions up to 4.11, the following statement is also recognized:

Errnnn "filename"

where nnn is a three-digit HTTP status code. This statement is entirely equivalent to

ErrorFile nnn "filename"

Pound produces only a subset of all possible status codes, so not all nnn codes are allowed. The discussion below lists available HTTP codes, along with the error description and default error page text.

HTTP status: 400

Bad Request

Your browser (or proxy) sent a request that this server could not understand.

HTTP status: 401

Unauthorized

This server could not verify that you are authorized to access the document requested. Either you supplied the wrong credentials (e.g., bad password), or your browser doesn’t understand how to supply the credentials required.

HTTP status: 403

Forbidden

You don’t have permission to access this resource. It is either read-protected or not readable by the server.

HTTP status: 404

Not Found

The requested URL was not found on this server.

HTTP status: 405

Method Not Allowed

The request method is not supported for the requested resource.

HTTP status: 413

Payload Too Large

The request content is larger than the proxy server is able to process.

HTTP status: 414

URI Too Long

The length of the requested URL exceeds the capacity limit for this server.

HTTP status: 500

Internal Server Error

The server encountered an internal error and was unable to complete your request.

HTTP status: 501

Not Implemented

The server does not support the action requested.

HTTP status: 503

Service Unavailable

The server is temporarily unable to service your request due to maintenance downtime or capacity problems. Please try again later.


Prev: Next: Up: ListenHTTP[Contents][Index]