Table of Contents
- Introduction
- Installation
- Handling Challenger
- Virtual Servers
- Configuration Examples
- Modules
- Filesystems

  | · Introduction · Filesystem Modules · Directory Listing Modules · Content Types · File Extension Modules

- RXML Tags
- Graphics
- Proxy
- Databases
- Miscellaneous Modules
- Security Considerations
- Scripting
- Frontpage
- Upgrading
- Third Party Extensions
- Portability
- Reporting Bugs
- Appendix

Directory Listing Modules
A directory listing module handles accesses to directories, that is URLs ending with a `/`. Usually an index file, for example `index.html`, is fetched and presented. But sometimes it is preferable to show a listing of all files and directories present in the directory.

A directory listing module handles the fetching of an index file or generating the directory listing. Unlike most types of modules it is only possible to have one directory listing module per virtual server.

A directory listing module works on Challenger's virtual file system. That means that it will show the union of all filesystem modules mounted on overlapping mount points.

Directory parsing module
This is the most used directory listing module. It handles index files as well as generated directory listings. It shows the directory listings with folding/unfolding directories.

`Allow directory index file overrides`
  If set, you can force Challenger to send the directory listing even if an index file is present. This is done by adding a dot to the URL. Thus `http://www.my.site/dir/.` would show a directory listing even if `http://www.my.site/dir/` gave you an index file.

`Index files`
  This is a list of names of possible index files. If any file with such a name is present in the directory it will be shown.

Extended directory parsing module
This module takes the fold/unfold paradigm one step further, it can actually unfold the files themselves. It needs the Main RXML parser and Flik module to function.

`Include file size`
  If set, it includes the size of the file in the directory listing.

`Include readme files`
  If set, the contents of readme files, `README` and `README.html`, will be included in the directory listing.

Fast directory module
This is a simpler and faster directory listing module. It only prints a list of directories and files, without any fancy fold/unfold buttons.

Index files only
The Index files module will only fetch index files. It will never generate any directory listings.