1cronosplit(1m) cronosplit(1m)
2
6 cronosplit - split log files into cronolog-compatible files
7
9 cronosplit --template=TEMPLATE [--print-invalid] [--help] [--version]
10 file ...
11
13 cronosplit is a simple program that reads lines from a set of input log
14 files, which must be in Common Log Format and write each lines to an
15 output files, the name of which is constructed using the template spec‐
16 ified and timestamp from the the line. The template uses the same for‐
17 mat specifiers as the Unix date(1) command (which are the same as the
18 standard C strftime library function).
19
21 accepts the following options and arguments:
22 --template=TEMPLATE
24 specifies the template for the output log files (using the for‐
25 mat specifiers described below).
26 --verbose
28 print additional status messages to the standard error stream.
29 --debug
31 print debug messages to the standard error stream.
32 --help print a help message and then exit.
34 --version
36 print version information and exit.
37
39 Each character in the template represents a character in the expanded
40 filename, except for date and time format specifiers, which are
41 replaced by their expansion. Format specifiers consist of a `%' fol‐
42 lowed by one of the following characters:
43 % a literal % character
45 n a new-line character
47 t a horizontal tab character
49 Time fields:
51 H hour (00..23)
53 I hour (01..12)
55 p the locale's AM or PM indicator
57 M minute (00..59)
59 S second (00..61, which allows for leap seconds)
61 X the locale's time representation (e.g.: "15:12:47")
63 Z time zone (e.g. GMT), or nothing if the time zone cannot be
65 determined
66 Date fields:
68 a the locale's abbreviated weekday name (e.g.: Sun..Sat)
70 A the locale's full weekday name (e.g.: Sunday .. Saturday)
72 b the locale's abbreviated month name (e.g.: Jan .. Dec)
74 B the locale's full month name, (e.g.: January .. December)
76 c the locale's date and time (e.g.: "Sun Dec 15 14:12:47 GMT
78 1996")
79 d day of month (01 .. 31)
81 j day of year (001 .. 366)
83 m month (01 .. 12)
85 U week of the year with Sunday as first day of week (00..53, where
87 week 1 is the week containing the first Sunday of the year)
88 W week of the year with Monday as first day of week (00..53, where
90 week 1 is the week containing the first Monday of the year)
91 w day of week (0 .. 6, where 0 corresponds to Sunday)
93 x locale's date representation (e.g. today in Britain: "12/04/96")
95 y year without the century (00 .. 99)
97 Y year with the century (1970 .. 2038)
99 Other specifiers may be available depending on the C library's imple‐
101 mentation of the strftime function.
102
104 apache(1m) cronolog(1m) date(1) strftime(3) environ(5)
105 More information and the latest version of cronolog and cronosplit can
107 be obtained from
108 http://www.ford-mason.co.uk/resources/cronolog/
110 If you have any suggestions, bug reports, fixes, or enhancements,
112 please mail them to the author.
113 More about Apache
115 Documentation for the Apache http server is available from
116 http://www.apache.org
118
120 Andrew Ford <A.Ford@ford-mason.co.uk>
121 cronosplit is based on a script called splitlog by Roy Fielding, which
123 is part of the wwwstat package.
124 March 1998 cronosplit(1m)