map.conf(4) (Sun WebServer 2.1 Command Reference)

Sun WebServer 2.1 Command Reference

map.conf(4)

NAME

map.conf- Creates an alias to a path on the file system or a redirection to a remote URL from a URI on the host.

SYNOPSIS

site_path/conf/map.conf

DESCRIPTION

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 definition consists of the following:

URI token
Resource target
Class type (optional)

Syntax

Each line in the map.conf file has the following format:

uri_token			resource_target			class_type

URI_token

Specifies a URI path on the given host beginning with a slash (/).

resource_target

Specifies a URI path on the given host if it begins 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.

class_type

Specifies the class type. Valid entries are as follows:

Note -

class_type is not case sensitive.

ADMIN: Treats the resource target as the Sun WebServer administration directory.
CGI: Treats the resource target as a CGI directory. All files located here will be treated as executable scripts.
DOOR: Treats the aliased file or directory as a resource door. Resource doors are multithreaded server daemons which run independently of the web server. With resource doors, Sun WebServer is able to pass incoming requests on to user-developed programs through the Solaris ^TMdoors mechanism. For more information on Sun WebServer resource doors, refer to the "Site URL Aliases Screen" section in the online help.
IMAP: Treats the resource target as an imagemap alias.
NULL: Treats the resource target as a regular file alias.
REMOTE: Treats the resource target as a remote alias.
STATS: Treats the resource target as an interface to server statistics.
SERVLET: 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.

EXAMPLES

Example 1

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

Example 2

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 "/servlets" "servlet1" SERVLET

where "servlet1" 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.

Example 3

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

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWhttpc
Interface Stability	Evolving