736 lines
9.7 KiB
HTML
736 lines
9.7 KiB
HTML
<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
|
|
> |