man5/na_httpd.hostprefixes(5) manual page

NAME

na_httpd.hostprefixes - configuration of HTTP root directories for virtual hosts

The httpd.hostprefixes file maps virtual hosts used in HTTP to corresponding root directories. The same configuration file is used for both IP virtual hosts (discriminated by the IP address used for connecting to the server) and HTTP virtual hosts (discriminated by the Host: header used in HTTP requests).

Each virtual host has a corresponding subdirectory within the directory specified by the option httpd.rootdir. This subdirectory is called the virtual host root directory. Clients connected to a virtual host can only access files within the virtual host root directory.

In the httpd.hostprefixes file, each line consists of a virtual host root directory followed by the names and IP addresses of a virtual host. If you specify an IP address, the virtual host root directory is associated with the given virtual host for IP-level virtual hosting. If you specify a name, the virtual host root directory is associated with the virtual host with that name, using HTTP-level virtual hosting. If the filer can resolve that name to an IP address, which is used for an IP-level host alias (see the alias option in na_ifconfig(1)), the filer uses that IP address in the same way as it would if you specified the IP address in the httpd.hostprefixes file.

If the /etc/httpd.hostprefixes file is edited, it is read again by the HTTP server after the changes are saved.

EXAMPLE

This example maps requests sent to www.customer1.com to the customer1 subdirectory of httpd.rootdir and requests directed at a host with IP address 207.68.156.58 to the subdirectory customer2.

/customer1 www.customer1.com /customer2 207.68.156.58

If the command

toaster> ifconfig vh alias www.customer1.com

had been issued before the configuration file was read, requests destined for the IP address of www.customer1.com would also be mapped to the /customer1 subdirectory, regardless any the Host: header they included.

EFFECTIVE

Any changes take effect within 5 minutes

PERSISTENCE

Changes are persistent across system reboots.

NAME

SYNOPSIS

DESCRIPTION

EXAMPLE

EFFECTIVE

PERSISTENCE

SEE ALSO