htmap(1M)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | EXIT STATUS | ATTRIBUTES | FILES | SEE ALSO | NOTES

NAME

htmap- Manages maps at the site level.

SYNOPSIS

htmap add [-c class] -i instance -f from -h hostname -t to [-z admin[-p]]
htmap delete -i instance -f from -h hostname [-z admin[-p]]
htmap help
htmap list -i instance [-f from] -h hostname [-z admin[-p]]
htmap version

DESCRIPTION

The htmap command adds, deletes, and lists aliases from one Uniform Resource Identifier (URI) to another resource on a web site. By default it creates a reference from a URI token to a file or directory on disk.

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.

OPTIONS

The following subcommands are supported:

add

Adds a new map.

delete

Deletes an existing map.

help

Displays help on usage.

list

Lists all maps.

version

Displays the version of htmap command.

The following options are supported:

-c class

Specifies the class file for the map. Values can be one of the following (if no -c is specified, then the class defaults to NULL):

ADMIN

Treats the alias as a URL to access the Sun WebServer Administration Console and the administration server.

CGI

Treats the aliased file or directory as a CGI resource (all files located here will be treated as executable scripts).

IMAP

Treats the alias as an imagemap resource.

NULL

Treats the aliased directory in no special way.

REMOTE

Treats the alias as a new URL, either on the local host or on another network location.

SERVLET

Treats the aliased resource_target as a servlet or a chain of servlets.

STATS

Treats the alias as an interface to server statistics.

-f from

Indicates the URI token the web server will map. Any URI that begins with this token will be redirected to the resource defined by the map class and the -t to destination.

-h hostname

Specifies the virtual host.

-i instance

Specifies the name of the httpd instance. Valid with all subcommands.

-t to

Defines the path name or URL to the actual resource. Valid with the add subcommand.

EXAMPLES

---

Example 1




To create a URL http://www.A.com/swshelp/ that references a directory outside of the www.A.com document root:

# htmap add -i sws_server -h www.A.com -f /swshelp/ \\ 
   -t /usr/http/admin_server/public/admin/help/en/

---

---

Example 2




To create a URL http://www.A.com/siteadmin/ that starts the Sun WebServer Administration Console for administration of the web site:

# htmap add -i sws_server -h www.A.com -f /siteadmin/ \\ 
  -t /sws-administration -c ADMIN

---

---

Example 3




This example shows how to create an alias that accesses a servlet without using the standard servlet token (/servlet/ by default). To redirect http://www.A.com/calendar/ to a servlet chain that invokes a servlet named login then a servlet named calendar:

# htmap -i sws_server -h www.A.com -f /calendar/ \\ 
  -t login,calendar -c SERVLET 

Note that login and calendar must be in the servlets path and have definitions in servlets.properties.

---

EXIT STATUS

The following exit values are returned:

0

Successful completion.

>0

An error occurred.

ATTRIBUTES

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWhttp
Interface Stability	Evolving

FILES

The following files are used by the command-line utilities:

site_path/conf/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..

SEE ALSO

map.conf(4)

NOTES

If the command is run by root user, then the username and password of an administrator are not required.

Users other than root must use the -z option and pass the user name and password of a valid administrator to the command.

Sun WebServer 2.0  Last Revised 17 July 1998

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | EXIT STATUS | ATTRIBUTES | FILES | SEE ALSO | NOTES