Commit 1661dac7 authored by Richard Bowen's avatar Richard Bowen
Browse files

Adds LogFormat example to the split-logfiles documentation to clarify 

what is meant about using %v


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@684308 13f79535-47bb-0310-9956-ffa450edef68
parent 2b65a95e

docs/manual/programs/other.html.en

+15 −3
Changes for docs/manual/programs/other.html.en: 15 added lines, 3 removed lines.
Original line number Diff line number Diff line
@@ -43,15 +43,27 @@ 
<h2><a name="split-logfile" id="split-logfile">split-logfile</a></h2>

    <p>This perl script will take a combined Web server access log file and

    break its contents into separate files. It assumes that the first field of

    each line is the virtual host identity (put there by "<code>%v</code>"), and

    that the logfiles should be named that + "<code>.log</code>" in the current

    directory.</p>

    each line is the virtual host identity, put there using the "<code>%v</code>"

    variable in <code class="directive"><a href="../mod/mod_log_config.html#logformat">LogFormat</a></code>.

    </p>



    <div class="example"><p><code>

        LogFormat "%v %h %l %u %t \"%r\" %&gt;s %b \"%{Referer}i\" \"%{User-agent}i\""

             combined_plus_vhost<br />

        CustomLog logs/access_log combined_plus_vhost

    </code></p></div>

    

    <p>Log files will be created, in the directory where are running the

    script, for each virtual host name that appears in the combined log file. 

    These logfiles will named after the hostname, with a

    <code>.log</code> file extension.</p>



    <p>The combined log file is read from stdin. Records read will be appended

    to any existing log files.</p>



    <div class="example"><p><code>split-logfile &lt; access_log</code></p></div>





</div></div>

<div class="bottomlang">

<p><span>Available Languages: </span><a href="../en/programs/other.html" title="English">&nbsp;en&nbsp;</a> |

docs/manual/programs/other.xml

+15 −3
Changes for docs/manual/programs/other.xml: 15 added lines, 3 removed lines.
Original line number Diff line number Diff line
@@ -43,15 +43,27 @@ 
<section id="split-logfile"><title>split-logfile</title>

    <p>This perl script will take a combined Web server access log file and

    break its contents into separate files. It assumes that the first field of

    each line is the virtual host identity (put there by "<code>%v</code>"), and

    that the logfiles should be named that + "<code>.log</code>" in the current

    directory.</p>

    each line is the virtual host identity, put there using the "<code>%v</code>"

    variable in <directive module="mod_log_config">LogFormat</directive>.

    </p>



    <example>

        LogFormat "%v %h %l %u %t \"%r\" %&gt;s %b \"%{Referer}i\" \"%{User-agent}i\""

             combined_plus_vhost<br />

        CustomLog logs/access_log combined_plus_vhost

    </example>

    

    <p>Log files will be created, in the directory where are running the

    script, for each virtual host name that appears in the combined log file. 

    These logfiles will named after the hostname, with a

    <code>.log</code> file extension.</p>



    <p>The combined log file is read from stdin. Records read will be appended

    to any existing log files.</p>



    <example>split-logfile &lt; access_log</example>





</section>



</manualpage>