summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--Documentation/manual.xml219
1 files changed, 217 insertions, 2 deletions
diff --git a/Documentation/manual.xml b/Documentation/manual.xml
index c45f204..880bf03 100644
--- a/Documentation/manual.xml
+++ b/Documentation/manual.xml
@@ -1,6 +1,6 @@
1<?xml version="1.0" encoding="UTF-8"?> 1<?xml version="1.0" encoding="UTF-8"?>
2<?xml-stylesheet href="file://localhost/home/urkle/Documents/DocBook/docbook.css" type="text/css"?> 2<?xml-stylesheet href="file://localhost/home/urkle/Documents/DocBook/docbook.css" type="text/css"?>
3<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "file:/usr/share/sgml/docbook/xml-dtd-4.1.2-1.0-8/docbookx.dtd" [ 3<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
4<!ENTITY EmailContact "<email>urkle &lt;at&gt; outoforder &lt;dot&gt; cc</email>"> 4<!ENTITY EmailContact "<email>urkle &lt;at&gt; outoforder &lt;dot&gt; cc</email>">
5]> 5]>
6<article> 6<article>
@@ -867,7 +867,222 @@ where a.id=n.id and a.id='PPIDskBRH30AAGPtAsg';</screen>
867 <simpara>Default: AbHhmRSsTUuv</simpara> 867 <simpara>Default: AbHhmRSsTUuv</simpara>
868 <simpara>Context: virtual host</simpara> 868 <simpara>Context: virtual host</simpara>
869 <para>Each character in the format-string defines an attribute of the request that you wish to log. The default logs the information required to create Combined Log Format logs, plus several extras. Here is the full list of allowable keys, which sometimes resemble their Apache counterparts, but do not always:</para> 869 <para>Each character in the format-string defines an attribute of the request that you wish to log. The default logs the information required to create Combined Log Format logs, plus several extras. Here is the full list of allowable keys, which sometimes resemble their Apache counterparts, but do not always:</para>
870 <para>TODO: Insert Log Format Types Table</para> 870 <table>
871 <title>Core LogFormat parameters</title>
872 <tgroup cols="5">
873 <colspec colname="1" colnum="1"/>
874 <colspec colname="2" colnum="2"/>
875 <colspec colname="3" colnum="3"/>
876 <colspec colname="4" colnum="4"/>
877 <colspec colname="5" colnum="5"/>
878 <thead>
879 <row>
880 <entry colname="1">Symbol</entry>
881 <entry colname="2">Meaning</entry>
882 <entry colname="3">DB Field</entry>
883 <entry colname="4">Data Type</entry>
884 <entry colname="5">Example</entry>
885 </row>
886 </thead>
887 <tbody>
888 <row>
889 <entry colname="1">A</entry>
890 <entry colname="2">User Agent</entry>
891 <entry colname="3">agent</entry>
892 <entry colname="4">varchar(255)</entry>
893 <entry colname="5">Mozilla/4.0 (compat; MSIE 6.0; Windows)</entry>
894 </row>
895 <row>
896 <entry colname="1">a</entry>
897 <entry colname="2">CGi request arguments</entry>
898 <entry colname="3">request_args</entry>
899 <entry colname="4">varchar(255)</entry>
900 <entry colname="5">user=Smith&amp;cart=1231&amp;item=532</entry>
901 </row>
902 <row>
903 <entry colname="1">b</entry>
904 <entry colname="2">Bytes transfered</entry>
905 <entry colname="3">bytes_sent</entry>
906 <entry colname="4">int unsigned</entry>
907 <entry colname="5">32561</entry>
908 </row>
909 <row>
910 <entry colname="1">c<xref linkend="Foot.LogCookie" xreflabel="[1]"/></entry>
911 <entry colname="2">Text of cookie</entry>
912 <entry colname="3">cookie</entry>
913 <entry colname="4">varchar(255)</entry>
914 <entry colname="5">Apache=sdyn.fooonline.net 1300102700823</entry>
915 </row>
916 <row>
917 <entry>f</entry>
918 <entry>Local filename requested</entry>
919 <entry>request_file</entry>
920 <entry>varchar(255)</entry>
921 <entry>/var/www/html/books-cycroad.html</entry>
922 </row>
923 <row>
924 <entry>H</entry>
925 <entry>HTTP request_protocol</entry>
926 <entry>request_protocol</entry>
927 <entry>varchar(10)</entry>
928 <entry>HTTP/1.1</entry>
929 </row>
930 <row>
931 <entry>h</entry>
932 <entry>Name of remote host</entry>
933 <entry>remote_host</entry>
934 <entry>varchar(50)</entry>
935 <entry>blah.foobar.com</entry>
936 </row>
937 <row>
938 <entry>I</entry>
939 <entry>Request ID (from modd_unique_id)</entry>
940 <entry>id</entry>
941 <entry>char(19)</entry>
942 <entry>POlFcUBRH30AAALdBG8</entry>
943 </row>
944 <row>
945 <entry>l</entry>
946 <entry>Ident user info</entry>
947 <entry>remote_logname</entry>
948 <entry>varcgar(50)</entry>
949 <entry>bobby</entry>
950 </row>
951 <row>
952 <entry>M</entry>
953 <entry>Machine ID<xref linkend="Foot.MachineID" xreflabel="[2]"/></entry>
954 <entry>machine_id</entry>
955 <entry>varchar(25)</entry>
956 <entry>web01</entry>
957 </row>
958 <row>
959 <entry>m</entry>
960 <entry>HTTP request method</entry>
961 <entry>request_method</entry>
962 <entry>varchar(10)</entry>
963 <entry>GET</entry>
964 </row>
965 <row>
966 <entry>P</entry>
967 <entry>httpd cchild PID</entry>
968 <entry>child_pid</entry>
969 <entry>smallint unsigned</entry>
970 <entry>3215</entry>
971 </row>
972 <row>
973 <entry>p</entry>
974 <entry>http port</entry>
975 <entry>server_port</entry>
976 <entry>smallint unsigned</entry>
977 <entry>80</entry>
978 </row>
979 <row>
980 <entry>R</entry>
981 <entry>Referer</entry>
982 <entry>referer</entry>
983 <entry>varchar(255)</entry>
984 <entry>http://www.biglinks4u.com/linkpage.html</entry>
985 </row>
986 <row>
987 <entry>r</entry>
988 <entry>Request in full form</entry>
989 <entry>request_line</entry>
990 <entry>varchar(255)</entry>
991 <entry>GET /books-cycroad.html HTTP/1.1</entry>
992 </row>
993 <row>
994 <entry>S</entry>
995 <entry>Time of request in UNIX time_t format</entry>
996 <entry>time_stamp</entry>
997 <entry>int unsigned</entry>
998 <entry>1005598029</entry>
999 </row>
1000 <row>
1001 <entry>T</entry>
1002 <entry>Seconds to service request</entry>
1003 <entry>request_duration</entry>
1004 <entry>smallint unsigned</entry>
1005 <entry>2</entry>
1006 </row>
1007 <row>
1008 <entry>t</entry>
1009 <entry>Time of request in human format</entry>
1010 <entry>request_time</entry>
1011 <entry>char(28)</entry>
1012 <entry> [02/Dec/2001:15:01:26 -0800]</entry>
1013 </row>
1014 <row>
1015 <entry>U</entry>
1016 <entry>Request in simple form</entry>
1017 <entry>request_uri</entry>
1018 <entry>varchar(255)</entry>
1019 <entry>/books-cycroad.html</entry>
1020 </row>
1021 <row>
1022 <entry>u</entry>
1023 <entry>User info from HTTP auth</entry>
1024 <entry>remote_user</entry>
1025 <entry>varchar(50)</entry>
1026 <entry>bobby</entry>
1027 </row>
1028 <row>
1029 <entry>v</entry>
1030 <entry>Virtual host servicing the request</entry>
1031 <entry>virtual_host</entry>
1032 <entry>varchar(255)</entry>
1033 <entry>www.foobar.com</entry>
1034 </row>
1035 </tbody>
1036 </tgroup>
1037 </table>
1038 <note id="Foot.LogCookie">
1039 <simpara>[1] You must also specify LogSQLWhichCookie for this to take effect.</simpara>
1040 </note>
1041 <note id="Foot.MachineID">
1042 <simpara>[2] You must also specify LogSQLmachineID for this to take effect.</simpara>
1043 </note>
1044 <table>
1045 <title>SSL LogFormat Parameters</title>
1046 <tgroup cols="5">
1047 <colspec colname="1" colnum="1"/>
1048 <colspec colname="2" colnum="2"/>
1049 <colspec colname="3" colnum="3"/>
1050 <colspec colname="4" colnum="4"/>
1051 <colspec colname="5" colnum="5"/>
1052 <thead>
1053 <row>
1054 <entry colname="1">Symbol</entry>
1055 <entry colname="2">Meaning</entry>
1056 <entry colname="3">DB Field</entry>
1057 <entry colname="4">Data Type</entry>
1058 <entry colname="5">Example</entry>
1059 </row>
1060 </thead>
1061 <tbody>
1062 <row>
1063 <entry colname="1">z</entry>
1064 <entry colname="2">SSL cipher used</entry>
1065 <entry colname="3">ssl_cipher</entry>
1066 <entry colname="4">varchar(25)</entry>
1067 <entry colname="5">RC4-MD5</entry>
1068 </row>
1069 <row>
1070 <entry colname="1">q</entry>
1071 <entry colname="2">Keysize of the SSL connection</entry>
1072 <entry colname="3">ssl_keysize</entry>
1073 <entry colname="4">smallint unsigned</entry>
1074 <entry colname="5">56</entry>
1075 </row>
1076 <row>
1077 <entry colname="1">Q</entry>
1078 <entry colname="2">maximum keysize supported</entry>
1079 <entry colname="3">ssl_maxkeysize</entry>
1080 <entry colname="4">smallint unsigned</entry>
1081 <entry colname="5">128</entry>
1082 </row>
1083 </tbody>
1084 </tgroup>
1085 </table>
871 </listitem> 1086 </listitem>
872 </varlistentry> 1087 </varlistentry>
873 <varlistentry> 1088 <varlistentry>