vhost={HostList} -- virtual host matching and rewriting.
true if the value of the "Host:" field in the request message is included
in the HostList for request rewriting, and true unconditionally
for response rewriting.
It supports virtual hosting by a special rewriting for response,
that is, any full-URL of a real host in a response message will be
rewritten to that of a virtual host.
avhost={HostList} -- address based virtual hosting
equivalent to the "vhost" option.
nvhost={HostList} -- name based virtual hosting
similarly to "vhost" option, "nvhost" is used to configure virtual hosting
except that this option is restricted to create name based virtual hosts
which are distinguished each other only by their host names.
Each virtual host is identified textually by its name (thus no "-" prefix
for each host is necessary to force textual-only matching which is necessary
with the "vhost" option).
For example, the following two MOUNT parameters are equivalent to each other.
MOUNT="/* http://server/* vhost=-www.domain" MOUNT="/* http://server/* nvhost=www.domain"
A special option "nvhost=-thru" can be used
to ease forwarding a virtual domain name indicated by a client to a server.
The option means matching with virtual domain name to be sent to the target
server.
By default, the domain name can be specified explicitly with the
nvserv or the target server name in the rURL
of this MOUNT rule by default.
For example, the following three MOUNT parameters are equivalent mutually.
MOUNT="/* http://domain/* nvhost=-thru,rserv=server" MOUNT="/* http://server/* nvhost=-thru,nvserv=domain" MOUNT="/* http://server/* nvhost=domain,nvserv=-thru"
qmatch=pattern -- pattern matching in the request header
true if the pattern matches with string in the request header.
(ex. qmatch=*User-Agent:*compatible;%20MS*)
dstproto={ProtoList} -- to the server of specified protocol
true if the protocol of the destination server is in the ProtoList.
method={methodList} -- request method
true if the access method of the current request is included in the
methodList.
asproxy
true if the DeleGate is called as a proxy server that is
the requested URL is in full URL format.
!asproxy
true if the DeleGate is not accessed as a proxy server in the request.
the AUTHORIZER which is to be applied to this MOUNT point.
If AUTHORIZER is specified in both MountOption and command line option,
the one in MountOption is used.
moved[={300|301|302|303}]
don't relay to rURL but return response for redirection
as "302 Moved" with "Location:rURL".
Redirection within the same server can be eased using the
abbreviation of host-name in the rURL
like MOUNT="/path1 ///path2 moved".
referer
Apply the rewriting only to the Referer: field to be forwarded.
This is an synonym of "where=ref".
useproxy[=proxyURI]
generate "305 Use Proxy" response message.
If proxyURI is omitted or given as "direct", the response
message is sent with Set-Proxy field as "Set-Proxy: DIRECT".
Otherwise the URI is set in the field as
"Set-Proxy: SET; proxyURI=proxyURI".
realm=realmString
specify the realm of authentication.
forbidden
reject the request as forbidden (synonym of "rcode=403")
unknown
reject the request as unknown (synonym of "rcode=404")
rcode={300|301|302|303|304|305|306|403|404}
return the response with the specified status code,
which can be useful for customizing error messages.
this MOUNT entry is used to substitute a response message when an
error occurred.
It is applied If the response status code for the request shows an error (4xx
or 5xx), and the status code is in the listOfCodes if it is specified.
For example with MOUNT="/path/* file:/tmp/autherr.cgi onerror={401,407}",
the output from /tmp/autherr.cgi is sent when authentication error occurred
in access to URLs under "/path/".
robots={no|ok}
allow or disallow retrievals from robots.
The default value for NNTP and FTP is "no", while it is
"ok" for other protocols.
avserv | avserv=host
-- forwarding to an IP-address based virtual server
notate that the target server is not a name based virtual hosting server.
With this option, all of servers of alias names or IP-addresses of the target
server are MOUNTed by this MOUNT rule.
It has been the default behavior of MOUNT but it can be changed with the
option HTTPCONF="nvserv:auto" to automatically detect
virtual servers in a set of MOUNT parameters.
This "avserv" option could become necessary to notate a non-virtual
server which is automatically guessed as a virtual server.
rserv=host[:port] -- real target server
specify the real host name or IP-address and port number of the target
server toward which the HTTP connection is established.
This option is used to do MOUNT a virtual hosting server of which virtual
host name is specified in the rURL rather than in the
"nvserv=host" option.
For example, the following two MOUNT rules are equivalent to each other.
MOUNT="/v/* http://www.domain/* rserv=192.168.1.123" MOUNT="/v/* http://192.168.1.123/* nvserv=www.domain"
Specifying the "rserv" option implies that the target server is a virtual
server as if notated with the "nvserv" option.
genvhost=host
(obsoleted by nvserv and rserv options)
Specify the hostname which will be received by the target server
as its virtual hostname.
It is set in the "Host: host" field in the request message to be
forwarded to the server.
When the request is to be forwarded via a HTTP proxy, it is set
in the request URL as http://host/...
The default Host field sent to the server is derived from the
rURL
part of the MOUNT parameter which specifies the target server.
For example for MOUNT="/* http://hosti:8080/*", "Host: hosti:8080"
will be forwarded to the server (which is running at the port hosti:8080).
To through pass the Host field in the request from a client to the server,
specify as "genvhost=-thru".
ftosv=-cc-charCode
convert charset in HTTP header forwarded to server into
charCode (jis|sjis|euc|utf8)
when DeleGate as an origin HTTP server searches a file for requested URL,
the path name extended with the specified string is retrieved first.
For example with "pathext=-ja", "index-ja.html" is retrieved prior to
"index.html". It can be useful in combination with other MOUNT conditions,
like MOUNT="/* file:data/www/* nvhost=www.delegate.jp,pathext=-ja"
The target server or local directory is switched by with which name
the DeleGate is referred (in the "Host:vhost" header field).
In this example, requests for "http://dom1.com" and "http://dom2.org"
are forwarded to each corresponding server, while requests for
"http://dom3.net" or any other name are retrieved in each corresponding
local directory.
"useproxy", "method", "dst" and "withquery" options are introduced
originally to refuse potentially troublesome accesses which may invoke
CGI programs in target servers. For example, to refuse any request
with POST method, or with URL including "?":