NAME | SYNOPSIS | DESCRIPTION | EXAMPLES | ATTRIBUTES | SEE ALSO
site_path/conf/map.conf
A map directive allows you to redirect requests for a URL on a host to any other URL or to a different directory. htmap administers maps to establish an alias to another resource, make a resource outside of the doc_root accessible to a client, or partition the name space into various classes of resources such as CGI, imagemap, or servlet. The URL token that is redirected does not have to correspond to any actual resource.
Servlets use maps for creating servlet chains or file aliases.
A map defintion consists of the following:
URI token
Resource target
Class type (optional)
Each line in the map.conf file has the following format:
uri_token resource_target class_type
Specifies a URI path on the given host beginning with a slash (/).
Specifies a URI path on the given host if it begin with a slash (/), or an absolute URL to any network location if it does not begin with a (/). For either local or remote redirects, class_type must be REMOTE. It can also be an absolute path on the file system if it begins with a (/) and the class_type is ADMIN, CGI, IMAP, NULL, SERVLET, or STATS.
Specifies the class type. Valid entries are as follows:
Treats the resource target as the Sun WebServer administration directory.
Treats the resource target as a CGI directory. All files located here will be treated as executable scripts.
Treats the resource target as an imagemap alias.
Treats the resource target as a regular file alias.
Treats the resource target as a remote alias.
Treats the resource target as an interface to server statistics.
Treats the resource target as a servlet or a chain of servlets. URLs which begin with the aliased token are treated as requests for servlets.
A directory alias can specify "CGI" as a class token, and all files in the directory and its subdirectories will be treated as CGI scripts. Typically, each host has a map directive to define the location of /cgi-bin. An example of creating an alias for the /cgi-bin is
map "/cgi-bin" "/var/http/www/cgi/" CGI
A directory alias can also specify "SERVLET" as a class token, and the aliased resource_target is treated as a servlet or a chain of servlets. An example of creating an alias for the resource_target is
map "/foo" "myFoo" SERVLET
where "myFoo" is a servlet defined in servlet.properties.
Another example of creating an alias for the resource_target is
map "/combo" "S1,S2" SERVLET
where "/combo" defines a chain of servlets and "S1" and "S2" are servlets defined in servlet.properties.
If map has only one parameter, it disables any redirects or aliases for that token.
map /cgi-bin /var/http/public/x/y CGI map /search /searchServlet SERVLET map /home.html /var/http/docs/index.html NULL
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
Availability | SUNWhttpc |
Interface Stability | Evolving |
NAME | SYNOPSIS | DESCRIPTION | EXAMPLES | ATTRIBUTES | SEE ALSO