Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
CCZE(1)				     CCZE			       CCZE(1)

       ccze - A	robust log colorizer

       ccze [options] <logfile

       This manual page	documents briefly the ccze utility, which is a drop-in
       replacement for colorize, but written in	C, to be faster	and  less  re-
       source-hungry. The goal was to be fully backwards compatible, yet supe-
       rior with respect to speed and features.

       These programs follow the usual GNU command line	syntax,	with long  op-
       tions  starting with two	dashes (`-'). A	summary	of options is included

       -a, --argument PLUGIN=ARGUMENTS
	      Use this option to pass ARGUMENTS	to the specified  PLUGIN.  The
	      argument list is whitespace separated.

       -A, --raw-ansi
	      If one wants to enable raw ANSI color sequences instead of using
	      curses, this option does just that.

       -c, --color KEY=COLOR
	      Set the color of the keyword KEY to COLOR, like one would	do  in
	      one of the configuration files.

       -C, --convert-date
	      Convert  unix  timestamp	to  readable  date format (in oops and
	      squid logs, for example).

       -F, --rcfile rcfile
	      Read rcfile as a configuration file upon startup,	instead	of the
	      default ones.

       -h, --html
	      Instead  of  colorising the input	onto the console, output it in
	      HTML format instead.

       -l, --list-plugins
	      List all available (loaded) plugins, along with their type and a
	      short description.

       -m, --mode mode
	      Change  the  output  mode.  Available modes are curses, ansi and

       -o, --options OPTIONS...
	      CCZE is able to toggle some of its features  with	 this  option.
	      You  can	toggle the scroll, wordcolor, lookups, and transparent
	      features,	or you can fiddle with cssfile.	All of these  are  en-
	      abled  by	default, except	cssfile. One can turn them off by pre-
	      fixing the option	with a "no".

	      With scroll, one can enable or disable scrolling.	If the	output
	      is not redirected, it is wise to leave it	enabled.

	      The wordcolor option makes ccze search for different keywords in
	      unparsed input, and color	those too. Since it is quite fast, and
	      makes  the  output  look better, it is recommended to leave this

	      However, lookups is an option that might be better  to  disable.
	      When  on,	ccze will try to look up usernames, service names, and
	      lots of other stuff, which will slow down	coloring a great deal.
	      If  one  is piping a long	log through ccze, this option might be
	      turned off to speed up the process.

	      With the transparent option, one can make	CCZE treat black back-
	      ground  colors  as  transparent -	that means, a black background
	      will appear transparent in a similar X terminal. If turned  off,
	      it will appear as	black.

	      If cssfile is set, then CCZE will	not inline the Cascading Style
	      Sheet information	into the outputted HTML, but include a link to
	      the external stylesheet given in this paramater.

       -p, --plugin PLUGIN
	      While the	default	action is to load all plugins (see the Plugins
	      section below), when this	option is present, only	the  specified
	      plugins  will  be	 loaded. If one	knows what kind	of log will be
	      piped through ccze, using	this option may	 result	 in  a	slight

       -r, --remove-facilty
	      Syslog-ng	puts the facility level	before log messages. With this
	      switch, these can	be cut off.

       --help Show summary of options and exit.

       -V, --version
	      Show version of program.

       Different programs have different kind of logs, and every kind  of  log
       ccze supports is	implemented via	a plug-in. They	are by default located
       under /usr/local/lib/ccze and $HOME/.ccze (so they can be overridden by
       the user	easily).

       At  the moment, the following modules are bundled with the official re-

       apm    For coloring apmd's logs.

       distcc For coloring distccd's logs. (See	distccd(1))

       exim   For coloring exim's main.log. (See exim(8))

	      For coloring fetchmail's log files. (See fetchmail(1))

	      For coloring ftpStats compatible log files, such as  Pure-FTPD's
	      Stats log	format.

       httpd  For  coloring  apache-style access.log and error.log files. (See

	      As a side-effect,	all compatible	formats,  like	pure-ftpd(8)'s
	      common-log format	is also	supported by this plugin.

	      For  coloring  icecast/icecast.log  and icecast/usage.log	files.
	      (See icecast(8))

       oops   For coloring oops/oops.log files.

       php    For coloring php.log files.

	      For coloring postfix logs. (See postfix(1))

	      For coloring procmail's log file.	(See procmail(1))

	      For coloring  proftpd's  access.log  and	auth.log  files.  (See

       squid  For  coloring squid's access.log,	store.log and cache.log	files.
	      (See squid(8))

       sulog  For coloring sulog files.	(See su(1))

       super  For coloring super.log files. (See super(1))

       syslog For coloring generic syslog messages. (See syslogd(8))

       ulogd  For coloring ulogd logs.

       vsftpd For coloring vsftpd.log files. (See vsftpd(8))

	      For coloring xferlog files. (See xferlog(5))

       /usr/local/etc/colorizerc, $HOME/.colorizerc
	      These files are the default configuration	 files	for  colorize,
	      and are parsed by	ccze for the sake of full compatibility.
       /usr/local/etc/cczerc, $HOME/.cczerc
	      This  two	 are  the  main	 configuration files, in which one can
	      change the colors	used by	the program to	his  liking.  See  the
	      comments	in  the	 beginning  of /usr/local/etc/cczerc for a de-
	      scription	on the files' structure.

	      If neither of these files	exist on your system,  consider	 using
	      the  ccze-dump  utility  in the source tree, which dumps the de-
	      fault color set to standard output.


       ccze was	written	by Gergely Nagy	<>, based
       on colorize by Istvan Karaszi <>.

CCZE 0.2.1			  2003-04-24			       CCZE(1)


Want to link to this manual page? Use this URL:

home | help