Chapter 11. Customized programs

91

11.5 Web servers and applications

This section describes the locations and URLs that should be used by all web servers and web

applications in the Debian system.

1 Cgi bin executable files are installed in the directory

/usr/lib/cgi bin/

cgi bin name

and should be referred to as

http://localhost/cgi bin/

cgi bin name

2 Access to HTML documents

HTML documents for a package are stored in

/usr/share/doc/

package

and can be

referred to as

http://localhost/doc/

package

/

filename

The web server should restrict access to the document tree so that only clients on the same

host can read the documents. If the web server does not support such access controls,

then it should not provide access at all, or ask about providing access during installation.

3 Access to images

It

is

recommended

that

images

for

a

package

be

stored

in

/usr/share/images/

package

and may be referred to through an alias

/images/

as

http://localhost/images//

4 Web Document Root

Web Applications should try to avoid storing files in the Web Document Root. Instead

they should use the /usr/share/doc/package directory for documents and register the

Web Application via the

doc base

package. If access to the web document root is un 

avoidable then use

/var/www

as the Document Root. This might be just a symbolic link to the location where the system

administrator has put the real document root.

11.6 Mail transport, delivery and user agents

Debian packages which process electronic mail, whether mail user agents (MUAs) or mail

transport agents (MTAs), must ensure that they are compatible with the configuration deci 

sions below. Failure to do this may result in lost mail, broken

From:

lines, and other serious

brain damage!