---
name: "cronosplit"
section: "8"
platform: "linux"
package: "cronolog"
version: "1.6.1-0.1"
release: "Debian 3.0 (Woody)"
platforms: ["linux"]
url: "https://new.carta.tech/cronosplit/8"
---

# cronosplit(8)

split log files into cronolog-compatible files

## NAME

cronosplit - split log files into cronolog-compatible files

## SYNOPSIS

**cronosplit** --template=TEMPLATE \[--print-invalid\] \[--help\] \[--version\] file ...

## DESCRIPTION

**cronosplit** is a simple program that reads lines from a set of input log files, which must be in *Common Log Format* and write each lines to an output files, the name of which is constructed using the **template** specified and timestamp from the the line.  The template uses the same format specifiers as the Unix [**date**(1)](/date/1.md) command (which are the same as the standard C strftime library function).

## Options

accepts the following options and arguments:

- \--template=*TEMPLATE*

  specifies the template for the output log files (using the format specifiers described below).

- \--verbose

  print additional status messages to the standard error stream.

- \--debug

  print debug messages to the standard error stream.

- \--help

  print a help message and then exit.

- \--version

  print version information and exit.

## Template format

Each character in the template represents a character in the expanded filename, except for date and time format specifiers, which are replaced by their expansion.  Format specifiers consist of a \`%' followed by one of the following characters:

- %

  a literal % character

- n

  a new-line character

- t

  a horizontal tab character

Time fields:

- H

  hour (00..23)

- I

  hour (01..12)

- p

  the locale's AM or PM indicator

- M

  minute (00..59)

- S

  second (00..61, which allows for leap seconds)

- X

  the locale's time representation (e.g.: "15:12:47")

- Z

  time zone (e.g. GMT), or nothing if the time zone cannot be determined

Date fields:

- a

  the locale's abbreviated weekday name (e.g.: Sun..Sat)

- A

  the locale's full weekday name (e.g.: Sunday .. Saturday)

- b

  the locale's abbreviated month name (e.g.: Jan .. Dec)

- B

  the locale's full month name, (e.g.: January .. December)

- c

  the locale's date and time (e.g.: "Sun Dec 15 14:12:47 GMT 1996")

- d

  day of month (01 .. 31)

- j

  day of year (001 .. 366)

- m

  month (01 .. 12)

- U

  week of the year with Sunday as first day of week (00..53, where week 1 is the week containing the first Sunday of the year)

- W

  week of the year with Monday as first day of week (00..53, where week 1 is the week containing the first Monday of the year)

- w

  day of week (0 .. 6, where 0 corresponds to Sunday)

- x

  locale's date representation (e.g. today in Britain: "12/04/96")

- y

  year without the century (00 .. 99)

- Y

  year with the century (1970 .. 2038)

Other specifiers may be available depending on the C library's implementation of the **strftime** function.

## SEE ALSO

**apache**(1m) [**cronolog**(1m)](/cronolog/1m.md) [**date**(1)](/date/1.md) [**strftime**(3)](/strftime/3.md) [**environ**(5)](/environ/5.md)

More information and the latest version of  **cronolog** and **cronosplit** can be obtained from

        http://www.ford-mason.co.uk/resources/cronolog/

If you have any suggestions, bug reports, fixes, or enhancements, please mail them to the author.

### More about Apache

Documentation for the Apache http server is available from

        http://www.apache.org

## AUTHOR

Andrew Ford \<A.Ford@ford-mason.co.uk\>

**cronosplit** is based on a script called **splitlog** by Roy Fielding, which is part of the  **wwwstat** package.