ServerRootdirective. If server root is specified, but no
AddIcondirective has been used in configuration file to set up icons, the default icon directory is under server root
icons. The default icons that should be present are:
blank.xbmblank icon for aligning the header with listing
back.xbmfor parent directory
unknown.xbmfor unknown types
binary.xbmfor binary files
text.xbmfor text files
image.xbmfor image files
sound.xbmfor audio files
tar.xbmfor tar files
compressed.xbmfor compressed files
AddIcondirective, the defaults would be specified as follows:
Pass /httpd-internal-icons/* /server_root/icons/* AddBlankIcon /httpd-internal-icons/blank.xbm AddDirIcon /httpd-internal-icons/directory.xbm DIR AddParentIcon /httpd-internal-icons/back.xbm UP AddUnknownIcon /httpd-internal-icons/unknown.xbm AddIcon /httpd-internal-icons/binary.xbm BIN binary AddIcon /httpd-internal-icons/text.xbm TXT text/* AddIcon /httpd-internal-icons/image.xbm IMG image/* AddIcon /httpd-internal-icons/movie.xbm MOV video/* AddIcon /httpd-internal-icons/sound.xbm AU audio/* AddIcon /httpd-internal-icons/tar.xbm TAR multipart/*tar AddIcon /httpd-internal-icons/compressed.xbm CMP x-compress x-gzip
AddIcon*directives have to read:
AddIcon http://your.server/httpd-internal-icons/...and you have to pass also the full icon URL:
Pass http://your.server/httpd-internal-icons/* /server_root/icons/*Since future smart browsers might notice that the icon server is the same one as the proxy server it may be best in this case to also
Passthe partial URL as above:
Pass /httpd-internal-icons/* /server_root/icons/*
httpdis generating references to itself (redirection responses to clients). If necessary, provide full server hostname with
HostName full.server.host.nameYou may want to use this also when the real host name is different from what you want the clients to see (you have a DNS alias for the host).
Portconfiguration directive instead of the
-pport command line option. Normally:
-pport command line line option still overrides this default.
directive should never be used when the server is
being spawned by inetd, it is
only for the standalone use.
httpdcan run as a standalone server which is forking a new child to serve each request, or as a server that is spawned by
inetd. The server type is specified by the
ServerType InetdIf this directive is missing, but the
-pcommand line option is used, the default is
StandAlone. Otherwise default is
httpdre-reads its configuration file when it receives a
HUPsignal SIGHUP, the signal number 1. To make it easy to find out the parent
httpdprocess id, it writes it to a file. The signal can be sent using
kill -HUP <process-id>By default, if
ServerRootis specified, this is the file
httpd-pidunder server root; if not, it defaults to
PidFile directive can be used to set the process
id file name; it can be either an absolute path, or a relative one.
Relative path is relative to
ServerRoot, or if not
defined, relative to
ServerRoot /Web/serverroot PidFile logs/httpd-pidwould cause the process id to be written to
SIGHUP signal will also be sent to the server if the
parent of the process group in which the server belongs
terminates. All members of the orphaned process group will as required
by POSIX.1 receive a SIGHUP and a SIGCONT signal. The default behavior
on a SIGHUP is to terminate the process, but in the case of daemons it
is often meant to reload the config file (they don't have a
UserIddirective sets the default user to run as instead of
nobody. This directive is only meaningful when running server as
GroupIddirective sets the default group to run under instead of
nogroup. This directive is only meaningful when running server as
httpddown considerably. If multiple user ids are not required with the
httpdsetup then the parent process should set its user id immediately after binding to port (which may be privileged and was the original reason for running as
httpdto set its user id immediately after binding to port.
ParentGroupIddirective sets the process parent group id immediately after binding to port.
Enable METHOD Disable METHODBy default
POSTare enabled, and the rest are disabled.
Enable POST Disable DELETE
httpdperforms a reverse DNS lookup to find out the remote DNS hostname for the client host. This information is used in access control and logging. If DNS lookups become a bottleneck this feature can be disabled by specifying:
DNSLookup OffUnderstand, that if this feature if off you will not be able to use domain name templates in access control, only IP number templates.
There are logfile analyzers, such as Kevin Hughes'
getstats that will perform reverse DNS lookups to find
out hostnames for IP numbers. This is more efficient because
getstats looks up each hostname only once, whereas
httpd would look it up during each request. So, if you
are using a logfile analyzer and you don't necessarily need DNS names
in access control, there is no need to keep this feature on.
IdentityCheckconfiguration directive is turned
httpdwill connect to the ident daemon (RFC931) of the remote host and find out the remote login name of the owner of the client socket. This information is written to access log file, and put into the
REMOTE_IDENTCGI environment variable.
Default setting is
IdentityCheck Offand if you don't need this information you will save the resources by keeping it off. Furthermore, this information does not provide any more security and should not be trusted to be used in access control, but rather just for informational purposes, such as logging.
[Thanks to Per-Steinar Iversen from Norway for pointing this out!]
If the operating system on your server host has this bug, do not use IdentityCheck!
Welcomedirective specifies the default file name to use when only a directory name is specified in the URL. There may be many
Welcomedirectives giving alternative welcome page names. The one that was defined earlier will have precedence.
Default values are
index.html is there only for compatibility with NCSA
server; the word "Welcome" is more descriptive, and has precedence.
All default values will be overridden if
directive is used.
Default values could be defined as:
Welcome Welcome.html Welcome welcome.html Welcome index.html
If it is desirable to have plain directory names to produce a
directory listing, and only the ones with a trailing slash cause the
welcome page to be returned, set the
directive to off:
AlwaysWelcome OffDefault value is
UserDir dir-nameThe dir-name argument is the directory in each user's home directory to be exported, for example
httpdto add meta-information to the default HTTP response header. This information can either be additional HTTP headers such as
Expires: Friday, 30-Sep-94 12:00:00 GMTor it can be "private" MIME-headers or any other information such as
FooRatio=Bar ThisIsJustSomeInformationThe meta-information is stored in a file as it should appear in the HTTP response except for the terminating
<CR><LF>Meta-information is stored in a directory specified by the
MetaDirdirective, under the same directory as the file being retrieved:
MetaDir dir-nameDefault value is
MetaSuffix .suffixDefault value is
MetaSuffix .metameaning that meta-information files are located in the
.websubdirectory, and they end in
.metasuffix, i.e. the metafile for file:
httpdnormally gives a content-lenght header line for every document it returns. When it's running as a proxy it buffers the document received from the remote server before sending it to the client. This directive can be used to set the size of this buffer - if it is exceeded the document will be returned without a content-lenght header field.
Default setting is 50 kilobytes:
MaxContentLengthBuffer 50 KIf the value is too high users might get frustrated and interrupt the connection when nothing seems to be coming, although it is just the proxy server buffering the document.