obsolete-buildroot/sources/boa.conf

   1 # Boa v0.94 configuration file
   2 # File format has not changed from 0.93
   3 # File format has changed little from 0.92
   4 # version changes are noted in the comments
   5 #
   6 # The Boa configuration file is parsed with a lex/yacc or flex/bison
   7 # generated parser.  If it reports an error, the line number will be
   8 # provided; it should be easy to spot.  The syntax of each of these
   9 # rules is very simple, and they can occur in any order.  Where possible
  10 # these directives mimic those of NCSA httpd 1.3; I saw no reason to
  11 # introduce gratuitous differences.
  12
  13 # $Id$
  14
  15 # The "ServerRoot" is not in this configuration file.  It can be compiled
  16 # into the server (see defines.h) or specified on the command line with
  17 # the -c option, for example:
  18 #
  19 # boa -c /usr/local/boa
  20
  21
  22 # Port: The port Boa runs on.  The default port for http servers is 80.
  23 # If it is less than 1024, the server must be started as root.
  24
  25 Port 80
  26
  27 # Listen: the Internet address to bind(2) to.  If you leave it out,
  28 # it takes the behavior before 0.93.17.2, which is to bind to all
  29 # addresses (INADDR_ANY).  You only get one "Listen" directive,
  30 # if you want service on multiple IP addresses, you have three choices:
  31 #    1. Run boa without a "Listen" directive
  32 #       a. All addresses are treated the same; makes sense if the addresses
  33 #          are localhost, ppp, and eth0.
  34 #       b. Use the VirtualHost directive below to point requests to different
  35 #          files.  Should be good for a very large number of addresses (web
  36 #          hosting clients).
  37 #    2. Run one copy of boa per IP address, each has its own configuration
  38 #       with a "Listen" directive.  No big deal up to a few tens of addresses.
  39 #       Nice separation between clients.
  40 # The name you provide gets run through inet_aton(3), so you have to use dotted
  41 # quad notation.  This configuration is too important to trust some DNS.
  42
  43 #Listen 192.68.0.5
  44
  45 #  User: The name or UID the server should run as.
  46 # Group: The group name or GID the server should run as.
  47
  48 User nobody
  49 Group nobody
  50
  51 # ServerAdmin: The email address where server problems should be sent.
  52 # Note: this is not currently used, except as an environment variable
  53 # for CGIs.
  54
  55 #ServerAdmin root@localhost
  56
  57 # ErrorLog: The location of the error log file. If this does not start
  58 # with /, it is considered relative to the server root.
  59 # Set to /dev/null if you don't want errors logged.
  60 # If unset, defaults to /dev/stderr
  61
  62 ErrorLog /var/log/boa/error_log
  63 # Please NOTE: Sending the logs to a pipe ('|'), as shown below,
  64 #  is somewhat experimental and might fail under heavy load.
  65 # "Usual libc implementations of printf will stall the whole
  66 #  process if the receiving end of a pipe stops reading."
  67 #ErrorLog "|/usr/sbin/cronolog --symlink=/var/log/boa/error_log /var/log/boa/error-%Y%m%d.log"
  68
  69 # AccessLog: The location of the access log file. If this does not
  70 # start with /, it is considered relative to the server root.
  71 # Comment out or set to /dev/null (less effective) to disable
  72 # Access logging.
  73
  74 AccessLog /var/log/boa/access_log
  75 # Please NOTE: Sending the logs to a pipe ('|'), as shown below,
  76 #  is somewhat experimental and might fail under heavy load.
  77 # "Usual libc implementations of printf will stall the whole
  78 #  process if the receiving end of a pipe stops reading."
  79 #AccessLog  "|/usr/sbin/cronolog --symlink=/var/log/boa/access_log /var/log/boa/access-%Y%m%d.log"
  80
  81 # UseLocaltime: Logical switch.  Uncomment to use localtime
  82 # instead of UTC time
  83 #UseLocaltime
  84
  85 # VerboseCGILogs: this is just a logical switch.
  86 #  It simply notes the start and stop times of cgis in the error log
  87 # Comment out to disable.
  88
  89 #VerboseCGILogs
  90
  91 # ServerName: the name of this server that should be sent back to
  92 # clients if different than that returned by gethostname + gethostbyname
  93
  94 #ServerName www.your.org.here
  95
  96 # VirtualHost: a logical switch.
  97 # Comment out to disable.
  98 # Given DocumentRoot /var/www, requests on interface 'A' or IP 'IP-A'
  99 # become /var/www/IP-A.
 100 # Example: http://localhost/ becomes /var/www/127.0.0.1
 101 #
 102 # Not used until version 0.93.17.2.  This "feature" also breaks commonlog
 103 # output rules, it prepends the interface number to each access_log line.
 104 # You are expected to fix that problem with a postprocessing script.
 105
 106 #VirtualHost
 107
 108 # DocumentRoot: The root directory of the HTML documents.
 109 # Comment out to disable server non user files.
 110
 111 DocumentRoot /var/www
 112
 113 # UserDir: The name of the directory which is appended onto a user's home
 114 # directory if a ~user request is recieved.
 115
 116 UserDir public_html
 117
 118 # DirectoryIndex: Name of the file to use as a pre-written HTML
 119 # directory index.  Please MAKE AND USE THESE FILES.  On the
 120 # fly creation of directory indexes can be _slow_.
 121 # Comment out to always use DirectoryMaker
 122
 123 DirectoryIndex index.html
 124
 125 # DirectoryMaker: Name of program used to create a directory listing.
 126 # Comment out to disable directory listings.  If both this and
 127 # DirectoryIndex are commented out, accessing a directory will give
 128 # an error (though accessing files in the directory are still ok).
 129
 130 DirectoryMaker /usr/lib/boa/boa_indexer
 131
 132 # DirectoryCache: If DirectoryIndex doesn't exist, and DirectoryMaker
 133 # has been commented out, the the on-the-fly indexing of Boa can be used
 134 # to generate indexes of directories. Be warned that the output is
 135 # extremely minimal and can cause delays when slow disks are used.
 136 # Note: The DirectoryCache must be writable by the same user/group that
 137 # Boa runs as.
 138
 139 # DirectoryCache /var/spool/boa/dircache
 140
 141 # KeepAliveMax: Number of KeepAlive requests to allow per connection
 142 # Comment out, or set to 0 to disable keepalive processing
 143
 144 KeepAliveMax 1000
 145
 146 # KeepAliveTimeout: seconds to wait before keepalive connection times out
 147
 148 KeepAliveTimeout 10
 149
 150 # MimeTypes: This is the file that is used to generate mime type pairs
 151 # and Content-Type fields for boa.
 152 # Set to /dev/null if you do not want to load a mime types file.
 153 # Do *not* comment out (better use AddType!)
 154
 155 MimeTypes /etc/mime.types
 156
 157 # DefaultType: MIME type used if the file extension is unknown, or there
 158 # is no file extension.
 159
 160 DefaultType text/plain
 161
 162 # AddType: adds types without editing mime.types
 163 # Example: AddType type extension [extension ...]
 164
 165 # Uncomment the next line if you want .cgi files to execute from anywhere
 166 #AddType application/x-httpd-cgi cgi
 167
 168 # Redirect, Alias, and ScriptAlias all have the same semantics -- they
 169 # match the beginning of a request and take appropriate action.  Use
 170 # Redirect for other servers, Alias for the same server, and ScriptAlias
 171 # to enable directories for script execution.
 172
 173 # Redirect allows you to tell clients about documents which used to exist in
 174 # your server's namespace, but do not anymore. This allows you to tell the
 175 # clients where to look for the relocated document.
 176 # Example: Redirect /bar http://elsewhere/feh/bar
 177
 178 # Aliases: Aliases one path to another.
 179 # Example: Alias /path1/bar /path2/foo
 180
 181 # Alias /doc /usr/doc
 182
 183 # ScriptAlias: Maps a virtual path to a directory for serving scripts
 184 # Example: ScriptAlias /htbin/ /www/htbin/
 185
 186 ScriptAlias /cgi-bin/ /usr/lib/cgi-bin/
 187