* mod_log_config: Allow using ErrorLog providers for CustomLog.

Quote log-sink arguments for {Custom,Error,Transfer}Log directive. Except syslog and journal, which are keywords. There's no harm in quoting those, but no real point to it, either.

* Remove trailing whitespace from a bunch of *.xml files * Quoted arguments to Rewrite{Base,Cond,Map,Rule}.

Resolves bz56695 - %O can in fact be zero sometimes.

record for posterity why some 2/3-char formats begin with a funny caret.

*) SECURITY: CVE-2013-5704 (cve.mitre.org) core: HTTP trailers could be used to replace HTTP headers late during request processing, potentially undoing or otherwise confusing modules that examined or modified request headers earlier. Adds "MergeTrailers" directive to restore legacy behavior. Submitted By: Edward Lu, Yann Ylavic, Joe Orton, Eric Covener Committed By: covener

Remove compatibility references to httpd < 2.4.

Use %S instead of %C which already in use

* remove "... and port" references added in http://svn.apache.org/viewvc?rev=1208753&view=rev while trying to account for mod_remoteip. * mention mod_remote_ip for %a too.

mod_logio: new format-specifier %C (combined) which is the sum of received and sent byte counts. PR54015

Drop pre-2.3 compatibility notes from trunk docs.

Mention string-valued expression in the BNF. Clarify when header names are added to the Vary header.

Syntax updates for mod_l*.xml

fix typo.

PR37194: give a hint about capturing something more like "initial" header values when a %{foo}i might have been set or changed by a module.

Clarify the peer IP of the connection and the client IP of the request within the docs.

Update the documentation for the %a and %{c}a logging format strings, and update the mod-remoteip documentation in line with the new API.

Unify syntax of config directives taking an expression as optional contition argument

refs https://issues.apache.org/bugzilla/show_bug.cgi?id=51967 Mention that %h will sometimes log the IP address, and sometimes the hostname, depending on HostNameLookup setting and the use of hostname-based authorization directives.

Refs https://issues.apache.org/bugzilla/show_bug.cgi?id=51967 Clarify that %h logs the IP address when HostnameLookup is set Off.

Cleanup effort in prep for GA push: Trim trailing whitespace... no func change

Pulls the examples out of the paragraph text and into a table so that they are more visually distinct.

Removes the CookieLog directive, which has been documented as deprecated for more than a decade.

Additional grammatical nits.

Nitpick - Be consistent with ending each format description with a fullstop.

Add example for using %{msec_frac}t.

Mark some modules/directives non-experimental: - BufferedLogs and mod_substitute have been around a long time - mod_reqtimeout has stabilized as well

Add rpluem's suggested warning against of loss of logging data on a crash.

It's been 8 years, I think this directive can be considered not-experimental.

Add ErrorLogFormat directive for configuring the error log format, including additional information that is logged once per connection or request. Add error log IDs for connections and request to allow correlating error log lines and the corresponding access log entry.

Add information about "||" and "|$" piped log syntax to the docs.

Adding sub second timestamps and request end time to mod_log_config. Add special format tokens to %{...}t. The extended syntax allows the form: "WHICH:WHAT". WHICH is either: - "begin": use the time when the request started - "end": take "now" as the time You can omit WHICH, default is "begin". If you omit WHICH, the separating column is not allowed. WHAT is either: - "sec": timestamp in Unix seconds - "msec": timestamp in Unix milliseconds - "msec_frac": millisecond fraction of the Unix timestamp, 3 digits, 0-padded - "usec": timestamp in Unix microseconds - "usec_frac": microsecond fraction of the Unix timestamp 6 digits, 0-padded - anything different from those tokens: use strftime() You can omit WHAT, default is the formatted timestamp as used by the Common Log Format. The implementation uses a new request_config for mod_log_config to pass the request end time around between different calls to log formatters, but the end time is only generated if needed.

Replace "back-slash" with "backslash" in docs. I kept "back slash" when explicitely used in comparison with "forward slash".

Remove another confusing explanation of how things used to be long, long ago.

mod_log_config: Add the R option to log the handler used within the request. Submitted by: Christian Folini <christian.folini netnea com>

mod_log_config: Make ${cookie}C correctly match whole cookie names instead of substrings. PR: 28037 Submitted by: Dan Franklin <dan dan-franklin.com>, Stefan Fritsch

I have finally been asked one too many times whether the 'foobar' in these documents represents the literal string 'foobar'. I think that this might prove a little clearer, and require just that one little bit less explanation.

Note modules such as mod_headers affect %{Foobar}i

Cleanup the explanation.

Add in useful feature. %k which logs the keepalives value. PR: 45762 Dan Poirier <poirier@pobox.com>

mod_log_config: Add format options for %p so that the actual local or remote port can be logged. PR: 43415 Submitted by: Adam Hasselbalch Hansen <ahh@one.com> Extensively commented on and/or modified by Ruediger Pluem and Jeff Trawick

update license header text

Update the copyright year in all .c, .h and .xml files

mod_log_config: %{hextid}P will log the thread id in hex with APR versions 1.2.0 or higher.

Clean up the notes to the logformat section of the mod_log config docs. These have been growing using the "here's something else we should say" technique, without any serious thought for readability. In particular: - Remove the "..." in all the format strings, since almost nobody uses this and it can be confusing. It is still documented, just not included in the definitions. - Create three sections: modifiers, examples, and a "notes" section for stuff that doesn't go any place else. - Remove the discussion of %v being the canonical name. I think that it is quite clear since the addition of %V what the difference is.

%t has logged request time for a very long time. From mod_log_config.c: /* ### I think getting the time again at the end of the request * just for logging is dumb. i know it's "required" for CLF. * folks writing log parsing tools don't realise that out of order * times have always been possible (consider what happens if one * process calculates the time to log, but then there's a context * switch before it writes and before that process is run again the * log rotation occurs) and they should just fix their tools rather * than force the server to pay extra cpu cycles. if you've got * a problem with this, you can set the define. -djg */

* docs/manual/mod/mod_log_config.xml Fix XML validation error

Document BufferedLogs PR: 32492

Update copyright year to 2005 and standardize on current copyright owner line.

Clarify meaning of %[bB] and note difference from 1.3. Reviewed by: nd, slive

fix copyright notice

This has been coming up rather frequently on IRC, and it's a good example. It's alluded to in the SetEnvIf docs, but it's not a complete example there.

use <program> for programs

$Revision$ is slightly misdocumented (only available since svn 1.1) use LastChangedRevision instead

adjust properties and revision expansion of the English docs

add $Revision$ keyword

Fix typo.

Document the ability to look at original of final subrequest. I'd appreciate a review from someone more familiar with mod_log_config! PR: 27319

fix name of The Apache Software Foundation

apply Apache License, Version 2.0

- Add some <columspec> table-size hints - Remove some <br>s where they really shouldn't be - Reorder the sitemap slightly (indexes at the end)

just a typo (but automatically spread over the docs :-)

as Andre' pointed out, we don't need %{pid/tid}P since the user can do %P/%{tid}P or %{pid}P/%{tid}P

change the way that thread id is specified in the log format since the previous implementation used a format string already taken by mod_logio now, an optional %P format is used instead thanks to Andre' Malo for pointing out that I chose a format string already used by mod_logio!

mod_log_config: Add the ability to log the id of the thread processing the request (%I).

add the metafile attribute to all xml files.

Clarify some wording. Note this change (as previously written, it implied that 1.3.5 had this vulnerability, which is not true). I'm not sure if "httpd 2.0" is the preferred name. - <p>Note that in versions previous to 2.0.46 no escaping has been performed + <p>Note that in httpd 2.0 versions prior to 2.0.46, no escaping was performed on the strings from <code>%...r</code>, <code>%...i</code> and <code>%...o</code>. This was mainly to comply with the requirements of the Common Log Format. This implied that clients could insert control characters into the log, so you had to be quite careful when dealing with raw log files.</p> - <p>For security reasons starting with 2.0.46 non-printable and + <p>For security reasons, starting with 2.0.46, non-printable and other special characters are escaped mostly by using <code>\x<var>hh</var></code> sequences, where <var>hh</var> stands for the hexadecimal representation of the raw byte. Exceptions from this rule are <code>"</code> and <code>\</code> which are escaped by prepending - a backslash, and all whitespace characters that are written in their - C-notation (<code>\n</code>, <code>\t</code> etc).</p> + a backslash, and all whitespace characters which are written in their + C-style notation (<code>\n</code>, <code>\t</code> etc).</p>

document log escaping Reviewed by: Astrid Ke�ler, Erik Abele

Added a note that indicates that forward slashes should always be used on non-unix systems even if the OS allows backslashes

add mod_ident documentation Reviewed by: Joshua Slive, Astrid Ke�ler

add %% escaping

- reformatting & markup - zebra-styled log format table - changed the directive compat notes - mentioned, that nicknames should not contain % Reviewed by: Joshua Slive

fix a lot of weird links and markup

- add mod_logio entry to sitemap - add mod_logio transformation - add lacking section id to mod_log_config.xml (and update transformation)

New Module -- mod_logio. This adds the ability to log the bytes sent and received for each request Submitted by: Bojan Smojver <bojan@rexursive.com> Reviewed by: Justin & Ian

Typo. Submitted by: Ilia Soldis <s010148@tversu.ru>

Wrong directive name. Submitted by: Andre Malo <ndparker@gmx.net>

Note that nicknames can't be recursively defined.

Judging from the example below, this sentence has one too many negative in it. Also fix what I believe is a typo.

Update the stylesheet reference to the new language-specific version.

A few additional examples added to the docs.

Make the xml match the DTD.

Add section id, make a note into a <note>

Conversion to XML