So what is this? 
Mod_random has three basic functions. 
* It can supply a random URL which can be usd to redirect to
random sites. 
* Supply text via environmental variable (funny quotes, banner ads). 
  It can do multiple ENV's by using its section feature.
* Display entire pages via its built in handlers. 
 
Read the faq for more examples and information.

An example config for your httpd.conf
file to use the random URL would look like this:
<Location /geekythings>
	SetHandler random
	RandomURL http://www.slashdot.org/
	RandomURL http://www.tangent.org/
	RandomURL http://www.freshmeat.net/
	RandomURL http://www.linux.org/
	RandomURL /usr/local/apache2/conf/random.conf
</Location>

For using the random quote feature you would
do the following:
<VirtualHost www.sample.com>
	RandomEngine On
	RandomQuote /usr/local/apache2/conf/randomquotes.txt
	RandomQuote "<P>Three blind mice give this site a raiting of two.</P>"
</virtualhost>

For loading entire files in for ads: 
<VirtualHost www.sample.com>
	RandomEngine On
	RandomAd /usr/local/apache2/conf/goo_banner_add.txt
	RandomAd /usr/local/apache2/banner_ads/
	RandomAd "<P>Buy goo, it will make you smell clean!</P>"
</virtualhost>

For loading entire files in for ads: 
<VirtualHost www.sample.com>
	RandomEngine On
	RandomAd /usr/local/apache2/conf/goo_banner_add.txt
	RandomAd /usr/local/apache2/banner_ads/
	RandomQuote "<P>Buy goo, it will make you smell clean!</P>"
</virtualhost>

Generate random ad pages:
<Location /geekythings>
	SetHandler random-ad-page
	RandomAd /usr/local/apache2/banner_ads/
</Location>

Generate random quote pages:
<Location /geekythings>
	SetHandler random-quote-page
	RandomQuote /usr/local/apache2/conf/randomquotes.txt
</Location>

	-Brian Aker
	Seattle, Washington
	<brian@tangent.org>