<HTML ><HEAD ><TITLE >Caudium HOWTO</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+ "><LINK REL="NEXT" TITLE="License" HREF="copyright.html"></HEAD ><BODY CLASS="book" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF" ><DIV CLASS="BOOK" ><A NAME="index"><DIV CLASS="TITLEPAGE" ><H1 CLASS="title" ><A NAME="AEN2">Caudium HOWTO</H1 ><H3 CLASS="author" ><A NAME="AEN4">David Gourdelier</H3 ><DIV CLASS="affiliation" ><SPAN CLASS="orgname" >Caudium Group<BR></SPAN ><DIV CLASS="address" ><P CLASS="address" ><br> vida at caudium dot net<br> </P ></DIV ></DIV ><P CLASS="copyright" >Copyright © 2002 by The Caudium Group.</P ><P CLASS="pubdate" >September 2002<BR></P ><DIV CLASS="revhistory" ><TABLE WIDTH="100%" BORDER="0" ><TR ><TH ALIGN="LEFT" VALIGN="TOP" COLSPAN="3" ><B >Revision History</B ></TH ></TR ><TR ><TD ALIGN="LEFT" >Revision 2.2</TD ><TD ALIGN="LEFT" >2002-09-20</TD ><TD ALIGN="LEFT" >Revised by: dg</TD ></TR ><TR ><TD ALIGN="LEFT" COLSPAN="3" >Few more fixes, document now contains images and icons. See revision history for more information.</TD ></TR ><TR ><TD ALIGN="LEFT" >Revision 2.1</TD ><TD ALIGN="LEFT" >2002-06-14</TD ><TD ALIGN="LEFT" >Revised by: dg</TD ></TR ><TR ><TD ALIGN="LEFT" COLSPAN="3" >Document is now well-formed XML, one more example. See revision history for more information.</TD ></TR ><TR ><TD ALIGN="LEFT" >Revision 2.0</TD ><TD ALIGN="LEFT" >2002-06-14</TD ><TD ALIGN="LEFT" >Revised by: Tab</TD ></TR ><TR ><TD ALIGN="LEFT" COLSPAN="3" >Converted to DocBook XML 4.1.2. See revision history for more information.</TD ></TR ><TR ><TD ALIGN="LEFT" >Revision 1.0</TD ><TD ALIGN="LEFT" >2002-06-06</TD ><TD ALIGN="LEFT" >Revised by: dg</TD ></TR ><TR ><TD ALIGN="LEFT" COLSPAN="3" >Initial release</TD ></TR ><TR ><TD ALIGN="LEFT" >Revision 0.91</TD ><TD ALIGN="LEFT" ></TD ><TD ALIGN="LEFT" ></TD ></TR ><TR ><TD ALIGN="LEFT" COLSPAN="3" >Indentation of the SGML document and one more paragraph. See revision history for more.</TD ></TR ><TR ><TD ALIGN="LEFT" >Revision 0.9</TD ><TD ALIGN="LEFT" ></TD ><TD ALIGN="LEFT" ></TD ></TR ><TR ><TD ALIGN="LEFT" COLSPAN="3" >This Howto is going into stable state. See the revision history for more information.</TD ></TR ><TR ><TD ALIGN="LEFT" >Revision 0.05</TD ><TD ALIGN="LEFT" >2002-04-04</TD ><TD ALIGN="LEFT" ></TD ></TR ><TR ><TD ALIGN="LEFT" COLSPAN="3" >This HOWTO is in the DocBook format. See the revision history for more information.</TD ></TR ><TR ><TD ALIGN="LEFT" >Revision 0.04</TD ><TD ALIGN="LEFT" ></TD ><TD ALIGN="LEFT" ></TD ></TR ><TR ><TD ALIGN="LEFT" COLSPAN="3" >Added Introduction and license. See the revision history for more information.</TD ></TR ><TR ><TD ALIGN="LEFT" >Revision 0.03</TD ><TD ALIGN="LEFT" ></TD ><TD ALIGN="LEFT" ></TD ></TR ><TR ><TD ALIGN="LEFT" COLSPAN="3" >Added some useful corrections. See the revision history for more information.</TD ></TR ><TR ><TD ALIGN="LEFT" >Revision 0.02</TD ><TD ALIGN="LEFT" ></TD ><TD ALIGN="LEFT" ></TD ></TR ><TR ><TD ALIGN="LEFT" COLSPAN="3" >Minor correction in other answers. See the revision history for more information.</TD ></TR ><TR ><TD ALIGN="LEFT" >Revision 0.01</TD ><TD ALIGN="LEFT" >2002-03-11</TD ><TD ALIGN="LEFT" ></TD ></TR ><TR ><TD ALIGN="LEFT" COLSPAN="3" >Initial revision. See the revision history for more information.</TD ></TR ></TABLE ></DIV ><DIV ><DIV CLASS="abstract" ><A NAME="AEN65"><P ></P ><P > This is the Caudium HOWTO. This document will give an overview of the Caudium server. New users will learn how to set a basic virtual server up. More experienced users will find useful tips on development and optimization. Finally at the end I give some documentation on Caudium top priorities for people who want to contribute. </P ><P ></P ></DIV ></DIV ><HR></DIV ><DIV CLASS="TOC" ><DL ><DT ><B >Table of Contents</B ></DT ><DT >1. <A HREF="copyright.html" >License</A ></DT ><DT >2. <A HREF="overview.html" >Overview</A ></DT ><DD ><DL ><DT >2.1. <A HREF="whatiscaudium.html" >What is Caudium?</A ></DT ><DT >2.2. <A HREF="fork.html" >Caudium vs Roxen: Why a fork?</A ></DT ><DT >2.3. <A HREF="apache.html" >Comparing Caudium with Apache</A ></DT ><DT >2.4. <A HREF="advantages.html" >Advantages of Caudium</A ></DT ><DT >2.5. <A HREF="disadvantages.html" >Disadvantages of Caudium</A ></DT ></DL ></DD ><DT >3. <A HREF="gettingpackages.html" >Getting packages</A ></DT ><DD ><DL ><DT >3.1. <A HREF="debian.html" >How to get packages for Debian GNU/Linux</A ></DT ><DT >3.2. <A HREF="freebsd.html" >How to get packages for FreeBSD</A ></DT ><DT >3.3. <A HREF="solaris.html" >How to get packages for Solaris</A ></DT ><DT >3.4. <A HREF="camassrc.html" >How to get CAMAS from CVS/source</A ></DT ></DL ></DD ><DT >4. <A HREF="creating.html" >Creating your first server</A ></DT ><DD ><DL ><DT >4.1. <A HREF="installing.html" >Installing Caudium from sources</A ></DT ><DT >4.2. <A HREF="starting.html" >Starting</A ></DT ><DT >4.3. <A HREF="stopping.html" >Stopping from command line</A ></DT ><DT >4.4. <A HREF="directory.html" >Directory organization</A ></DT ><DT >4.5. <A HREF="upgrade.html" >Upgrading Caudium</A ></DT ><DT >4.6. <A HREF="cifconf.html" >Configuration InterFace (<SPAN CLASS="abbrev" >CIF.</SPAN >)</A ></DT ><DT >4.7. <A HREF="adding.html" >Adding your first server</A ></DT ></DL ></DD ><DT >5. <A HREF="customizing.html" >Customizing your server</A ></DT ><DD ><DL ><DT >5.1. <A HREF="secure.html" >How to run Caudium as a non-privileged user; How to secure Caudium</A ></DT ><DT >5.2. <A HREF="benchmark.html" >How to benchmark a web server</A ></DT ><DT >5.3. <A HREF="tune.html" >How to tune your system for best Caudium performances</A ></DT ><DT >5.4. <A HREF="useyourownfonts.html" >How to use your own fonts</A ></DT ><DT >5.5. <A HREF="ultralogworking.html" >How to get UltraLog working</A ></DT ></DL ></DD ><DT >6. <A HREF="developing.html" >Developing with Caudium</A ></DT ><DD ><DL ><DT >6.1. <A HREF="firstrxml.html" >Your first RXML file</A ></DT ><DT >6.2. <A HREF="thepiketag.html" >The Pike tag</A ></DT ><DT >6.3. <A HREF="firstpikescript.html" >Your first Pike script</A ></DT ><DT >6.4. <A HREF="firstmodule.html" >Your first module</A ></DT ><DT >6.5. <A HREF="backtrace.html" >How to use a backtrace</A ></DT ><DT >6.6. <A HREF="printsomethingtodebuglogfile.html" >How to print something to debug log file</A ></DT ></DL ></DD ><DT >7. <A HREF="helpcaudiumcommunity.html" >How to help the Caudium community</A ></DT ><DD ><DL ><DT >7.1. <A HREF="promotecaudium.html" >How to promote Caudium</A ></DT ><DT >7.2. <A HREF="writedoc.html" >How to write documentation</A ></DT ><DT >7.3. <A HREF="cvsaccount.html" >How to get a CVS account</A ></DT ><DT >7.4. <A HREF="testcaudium.html" >How to test Caudium</A ></DT ><DT >7.5. <A HREF="bugreport.html" >How to send a bug report</A ></DT ></DL ></DD ><DT >8. <A HREF="c1096.html" >Revision History/Credits/The End</A ></DT ><DD ><DL ><DT >8.1. <A HREF="x1098.html" >Revision History</A ></DT ><DT >8.2. <A HREF="x1189.html" >Credits and contributors</A ></DT ><DT >8.3. <A HREF="x1209.html" >The End</A ></DT ></DL ></DD ><DT >A. <A HREF="gfdl.html" >GNU Free Documentation License</A ></DT ><DD ><DL ><DT >A.1. <A HREF="gfdl-0.html" >PREAMBLE</A ></DT ><DT >A.2. <A HREF="gfdl-1.html" >APPLICABILITY AND DEFINITIONS</A ></DT ><DT >A.3. <A HREF="gfdl-2.html" >VERBATIM COPYING</A ></DT ><DT >A.4. <A HREF="gfdl-3.html" >COPYING IN QUANTITY</A ></DT ><DT >A.5. <A HREF="gfdl-4.html" >MODIFICATIONS</A ></DT ><DT >A.6. <A HREF="gfdl-5.html" >COMBINING DOCUMENTS</A ></DT ><DT >A.7. <A HREF="gfdl-6.html" >COLLECTIONS OF DOCUMENTS</A ></DT ><DT >A.8. <A HREF="gfdl-7.html" >AGGREGATION WITH INDEPENDENT WORKS</A ></DT ><DT >A.9. <A HREF="gfdl-8.html" >TRANSLATION</A ></DT ><DT >A.10. <A HREF="gfdl-9.html" >TERMINATION</A ></DT ><DT >A.11. <A HREF="gfdl-10.html" >FUTURE REVISIONS OF THIS LICENSE</A ></DT ><DT >A.12. <A HREF="gfdl-11.html" >How to use this License for your documents</A ></DT ></DL ></DD ></DL ></DIV ><DIV CLASS="LOT" ><DL CLASS="LOT" ><DT ><B >List of Figures</B ></DT ><DT >4-1. <A HREF="adding.html#cif_ports" >Ports in the CIF</A ></DT ><DT >4-2. <A HREF="adding.html#cif_filesystem" >Filesystem in the CIF</A ></DT ><DT >4-3. <A HREF="adding.html#cif_filesystem_example" >Example of output</A ></DT ></DL ></DIV ><DIV CLASS="LOT" ><DL CLASS="LOT" ><DT ><B >List of Examples</B ></DT ><DT >4-1. <A HREF="adding.html#AEN605" >Your user filesystem.</A ></DT ><DT >4-2. <A HREF="adding.html#AEN660" >A simple virtual hosting regular expression.</A ></DT ><DT >4-3. <A HREF="adding.html#AEN664" >A better and quicker regular expression.</A ></DT ><DT >6-1. <A HREF="firstrxml.html#AEN884" >Some simple RXML tags.</A ></DT ><DT >6-2. <A HREF="thepiketag.html#AEN896" >The PHP documentation as a Pike tag.</A ></DT ><DT >6-3. <A HREF="firstpikescript.html#AEN923" >A basic Pike script.</A ></DT ><DT >6-4. <A HREF="firstpikescript.html#AEN927" >A real world script.</A ></DT ><DT >6-5. <A HREF="firstpikescript.html#AEN931" >A script for the power user.</A ></DT ><DT >6-6. <A HREF="firstmodule.html#AEN988" >A sample module.</A ></DT ></DL ></DIV ></DIV ><DIV CLASS="NAVFOOTER" ><HR ALIGN="LEFT" WIDTH="100%"><TABLE SUMMARY="Footer navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" > </TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" > </TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><A HREF="copyright.html" ACCESSKEY="N" >Next</A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" > </TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" > </TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" >License</TD ></TR ></TABLE ></DIV ></BODY ></HTML >