<HTML ><HEAD ><TITLE >Run Time Facilities</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.63 "><LINK REL="HOME" TITLE="PHHTTPD HTTP Accelerator HOWTO" HREF="index.html"><LINK REL="PREVIOUS" TITLE="Logging" HREF="logging.html"></HEAD ><BODY CLASS="SECT1" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TH COLSPAN="3" ALIGN="center" >PHHTTPD HTTP Accelerator HOWTO</TH ></TR ><TR ><TD WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A HREF="logging.html" >Prev</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ></TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" > </TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><DIV CLASS="SECT1" ><H1 CLASS="SECT1" ><A NAME="RUNTIME" >5. Run Time Facilities</A ></H1 ><DIV CLASS="SECT2" ><H2 CLASS="SECT2" ><A NAME="AEN171" >5.1. Overview</A ></H2 ><P >While phhttpd is running it listens to a 'control' socket for messages from the administrator. The currently provided <B CLASS="COMMAND" >phhttpd_ctl</B > program allows the administrator to minimally interact with phhttpd. This provides both control and status reporting. </P ><P > <B CLASS="COMMAND" >phhttpd_ctl</B > always wants a <TT CLASS="PARAMETER" ><I >--control</I ></TT > argument that specifies the control socket of the running phhttpd daemon. This should match the <control> tag specified in the config file. </P ></DIV ><DIV CLASS="SECT2" ><H2 CLASS="SECT2" ><A NAME="AEN178" >5.2. Log Rotating</A ></H2 ><P > phhttpd can be told to rotate its logs so that existing logs may be processed. </P ><P > The <TT CLASS="PARAMETER" ><I >--rotate</I ></TT > argument to <B CLASS="COMMAND" >phhttpd_ctl</B > tells phhttpd to rename the existing files to a unique name, open new files with the previously used names, then close the renamed logs and start using the newly created files. <B CLASS="COMMAND" >phhttpd_ctl</B > will output the names of the newly created files which will be safe to use once the command exits. </P ><P > The <TT CLASS="PARAMETER" ><I >--reopen</I ></TT > argument to <B CLASS="COMMAND" >phhttpd_ctl</B > tells phhttpd to close the existing file logs and reopen the files with the filenames that were configured. This implies that an external entity has moved the files to new names and wants phhttpd to stop using them. </P ></DIV ><DIV CLASS="SECT2" ><H2 CLASS="SECT2" ><A NAME="AEN188" >5.3. Status Reporting</A ></H2 ><P > The <TT CLASS="PARAMETER" ><I >--status</I ></TT > argument to <B CLASS="COMMAND" >phhttpd_ctl</B > tells phhttpd to return a quick status blurb about the server. It contains miscellaneous information about the running state of the server. </P ></DIV ></DIV ><DIV CLASS="NAVFOOTER" ><HR ALIGN="LEFT" WIDTH="100%"><TABLE WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><A HREF="logging.html" >Prev</A ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="index.html" >Home</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" > </TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" >Logging</TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" > </TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" > </TD ></TR ></TABLE ></DIV ></BODY ></HTML >