sarg_manpage.xml (sarg-2.3.11) | : | sarg_manpage.xml (sarg-2.4.0) | ||
---|---|---|---|---|
skipping to change at line 12 | skipping to change at line 12 | |||
<!DOCTYPE article PUBLIC '-//OASIS//DTD DocBook XML V4.5//EN' | <!DOCTYPE article PUBLIC '-//OASIS//DTD DocBook XML V4.5//EN' | |||
'http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd '> | 'http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd '> | |||
<article lang="en"> | <article lang="en"> | |||
<title>SARG</title> | <title>SARG</title> | |||
<refentry id="sarg"> | <refentry id="sarg"> | |||
<refentryinfo> | <refentryinfo> | |||
<productname>sarg</productname> | <productname>sarg</productname> | |||
<date>27 May 2012</date> | <date>12 Nov 2015</date> | |||
<author> | <author> | |||
<firstname>Frédéric</firstname> | <firstname>Frédéric</firstname> | |||
<surname>Marchal</surname> | <surname>Marchal</surname> | |||
<contrib>Docbook version of the manual page</contrib> | <contrib>Docbook version of the manual page</contrib> | |||
<email>fmarchal@users.sourceforge.net</email> | <email>fmarchal@users.sourceforge.net</email> | |||
</author> | </author> | |||
<author> | <author> | |||
<firstname>Billy</firstname> | <firstname>Billy</firstname> | |||
skipping to change at line 106 | skipping to change at line 106 | |||
Limits report to records containing the specified hostname/ip address | Limits report to records containing the specified hostname/ip address | |||
</para> | </para> | |||
</listitem> | </listitem> | |||
</varlistentry> | </varlistentry> | |||
<varlistentry><term><option>-b <replaceable>filename</replaceable></option></ter m> | <varlistentry><term><option>-b <replaceable>filename</replaceable></option></ter m> | |||
<listitem> | <listitem> | |||
<para> | <para> | |||
Enables UserAgent log and writes it to <replaceable>filename</replaceable>. | Enables UserAgent log and writes it to <replaceable>filename</replaceable>. | |||
</para> | </para> | |||
<warning><para>This option is currently unused.</para></warning> | ||||
</listitem> | </listitem> | |||
</varlistentry> | </varlistentry> | |||
<varlistentry><term><option>-c <replaceable>filename</replaceable></option></ter m> | <varlistentry><term><option>-c <replaceable>filename</replaceable></option></ter m> | |||
<listitem> | <listitem> | |||
<para> | <para> | |||
Read <replaceable>filename</replaceable> for a list of the web hosts to exclude from the report. See <xref linkend="ExcludeHostFile"/>. | Read <replaceable>filename</replaceable> for a list of the web hosts to exclude from the report. See <xref linkend="ExcludeHostFile"/>. | |||
</para> | </para> | |||
</listitem> | </listitem> | |||
</varlistentry> | </varlistentry> | |||
<varlistentry><term><option>--convert</option></term> | <varlistentry><term><option>--convert</option></term> | |||
<listitem> | <listitem> | |||
<para> | <para> | |||
Convert a <application>squid</application> log file date/time field to a human-r eadable format. | Convert a <application>squid</application> log file date/time field to a human-r eadable format. | |||
All the log files are read and output as one text on the standard output. | All the log files are read and output as one text on the standard output. | |||
</para> | </para> | |||
<para> | ||||
If the input log file name is <replaceable>-</replaceable>, the input log file | ||||
is read from standard input. | ||||
</para> | ||||
</listitem> | </listitem> | |||
</varlistentry> | </varlistentry> | |||
<varlistentry><term><option>--css</option></term> | <varlistentry><term><option>--css</option></term> | |||
<listitem> | <listitem> | |||
<para> | <para> | |||
Output, on the standard output, the internal css <command>sarg</command> inlines in the reports. You can redirect | Output, on the standard output, the internal css <command>sarg</command> inlines in the reports. You can redirect | |||
the output to a file of your choice and edit it. Then you can override the inter nal css with | the output to a file of your choice and edit it. Then you can override the inter nal css with | |||
<parameter>external_css_file</parameter> in <filename>sarg.conf</filename>. | <parameter>external_css_file</parameter> in <filename>sarg.conf</filename>. | |||
</para> | </para> | |||
skipping to change at line 246 | skipping to change at line 241 | |||
<listitem> | <listitem> | |||
<para> | <para> | |||
Reads a proxy redirector log file such as one created by <application>squidGuard </application> or <application>Rejik</application>. | Reads a proxy redirector log file such as one created by <application>squidGuard </application> or <application>Rejik</application>. | |||
If you use this option, you may want to configure <replaceable>redirector_log_fo rmat</replaceable> | If you use this option, you may want to configure <replaceable>redirector_log_fo rmat</replaceable> | |||
in <filename>sarg.conf</filename> to match the output format of your web content filtering program. | in <filename>sarg.conf</filename> to match the output format of your web content filtering program. | |||
This option can be repeated up to 64 times to read multiple files. | This option can be repeated up to 64 times to read multiple files. | |||
</para> | </para> | |||
</listitem> | </listitem> | |||
</varlistentry> | </varlistentry> | |||
<varlistentry><term><option>-m</option></term> | ||||
<listitem> | ||||
<para> | ||||
Enable advanced processing debug messages. This option produces an enourmous amo | ||||
unt of output. | ||||
</para> | ||||
</listitem> | ||||
</varlistentry> | ||||
<varlistentry><term><option>-n</option></term> | <varlistentry><term><option>-n</option></term> | |||
<listitem> | <listitem> | |||
<para> | <para> | |||
Enables ip address resolution. | Enables ip address resolution. | |||
</para> | </para> | |||
</listitem> | </listitem> | |||
</varlistentry> | </varlistentry> | |||
<varlistentry><term><option>-o <replaceable>dir</replaceable></option></term> | <varlistentry><term><option>-o <replaceable>dir</replaceable></option></term> | |||
<listitem> | <listitem> | |||
skipping to change at line 318 | skipping to change at line 305 | |||
<varlistentry><term><option>--split</option></term> | <varlistentry><term><option>--split</option></term> | |||
<listitem> | <listitem> | |||
<para> | <para> | |||
Split the squid log file and output it as text on the standard output omitting t he dates outside of the | Split the squid log file and output it as text on the standard output omitting t he dates outside of the | |||
range specified by the <option>-d</option> parameter. | range specified by the <option>-d</option> parameter. | |||
If it is combined with <option>--convert</option> | If it is combined with <option>--convert</option> | |||
the dates are also converted to a human-readable format. | the dates are also converted to a human-readable format. | |||
</para> | </para> | |||
<para> | <para> | |||
If the input log file name is <replaceable>-</replaceable>, the input log file | Combined with <option>-P</option>, the log is written in several files each cont | |||
is read from standard input. | aining one day of the | |||
</para> | original log. | |||
<para> | ||||
Combined with <option>-P</option>, the log is written in several files each | ||||
containing one day worth of the original log. | ||||
</para> | </para> | |||
</listitem> | </listitem> | |||
</varlistentry> | </varlistentry> | |||
<varlistentry><term><option>--statistics</option></term> | <varlistentry><term><option>--statistics</option></term> | |||
<listitem> | <listitem> | |||
<para> | <para> | |||
Writes some statistics about the execution time. The statistics include the | Writes some statistics about the execution time. The statistics include the | |||
total execution time; the number of records read in the input log files and the | total execution time; the number of records read in the input log files and the | |||
time it took to read them; the number of records and users processed and the | time it took to read them; the number of records and users processed and the | |||
End of changes. 5 change blocks. | ||||
21 lines changed or deleted | 4 lines changed or added |