# CCZE - A robust log colorizer - man(1) - [phpMan] - ccze usage with named pipe for coloring tail of multiple logfiles at once:: `mkfifo pipe` *Source: cheat.sh* --- [_CCZE_(1)](https://www.chedong.com/phpMan.php/man/CCZE/1/markdown) CCZE [_CCZE_(1)](https://www.chedong.com/phpMan.php/man/CCZE/1/markdown) ## NAME ccze - A robust log colorizer ## SYNOPSIS **ccze **[_options_] <_logfile_ ## DESCRIPTION This manual page documents briefly the **ccze **utility, which is a drop-in replacement for **col‐** **orize**, but written in C, to be faster and less resource-hungry. The goal was to be fully backwards compatible, yet superior with respect to speed and features. ## OPTIONS These programs follow the usual GNU command line syntax, with long options starting with two dashes (`-'). A summary of options is included below. ### -a, --argument _ Use this option to pass _ARGUMENTS_ to the specified _PLUGIN_. The argument list is white‐ space separated. ### -A, --raw-ansi If one wants to enable raw ANSI color sequences instead of using curses, this option does just that. ### -c, --color _ Set the color of the keyword _KEY_ to _COLOR_, like one would do in one of the configura‐ tion files. ### -C, --convert-date Convert unix timestamp to readable date format (in oops and squid logs, for example). ### -F, --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 _ Change the output mode. Available modes are _curses_, _ansi_ and _html_. ### -o, --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 enabled by default, except _cssfile_. One can turn them off by prefix‐ ing 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 rec‐ ommended to leave this enabled. 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 background colors as trans‐ parent - that means, a black background will appear transparent in a similar X termi‐ nal. 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 parameter. ### -p, --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 speedup. ### -r, --remove-facility 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. ## PLUGINS Different programs have different kind of logs, and every kind of log **ccze **supports is imple‐ mented via a plug-in. They are by default located under _/usr/lib/x86_64-linux-gnu/ccze_ and _$HOME/.ccze_ (so they can be overridden by the user easily). At the moment, the following modules are bundled with the official release: _apm_ For coloring apmd's logs. _distcc_ For coloring distccd's logs. (See [_distccd_(1)](https://www.chedong.com/phpMan.php/man/distccd/1/markdown)) _exim_ For coloring exim's _main.log_. (See [_exim_(8)](https://www.chedong.com/phpMan.php/man/exim/8/markdown)) _fetchmail_ For coloring fetchmail's log files. (See [_fetchmail_(1)](https://www.chedong.com/phpMan.php/man/fetchmail/1/markdown)) _ftpstats_ 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 [_apache_(8)](https://www.chedong.com/phpMan.php/man/apache/8/markdown)) As a side-effect, all compatible formats, like [_pure-ftpd_(8)](https://www.chedong.com/phpMan.php/man/pure-ftpd/8/markdown)'s common-log format is also supported by this plugin. _icecast_ For coloring _icecast/icecast.log_ and _icecast/usage.log_ files. (See [_icecast_(8)](https://www.chedong.com/phpMan.php/man/icecast/8/markdown)) _oops_ For coloring _oops/oops.log_ files. _php_ For coloring _php.log_ files. _postfix_ For coloring postfix logs. (See [_postfix_(1)](https://www.chedong.com/phpMan.php/man/postfix/1/markdown)) _procmail_ For coloring procmail's log file. (See [_procmail_(1)](https://www.chedong.com/phpMan.php/man/procmail/1/markdown)) _proftpd_ For coloring proftpd's _access.log_ and _auth.log_ files. (See [_proftpd_(8)](https://www.chedong.com/phpMan.php/man/proftpd/8/markdown)) _squid_ For coloring squid's _access.log_, _store.log_ and _cache.log_ files. (See [_squid_(8)](https://www.chedong.com/phpMan.php/man/squid/8/markdown)) _sulog_ For coloring _sulog_ files. (See [_su_(1)](https://www.chedong.com/phpMan.php/man/su/1/markdown)) _super_ For coloring _super.log_ files. (See [_super_(1)](https://www.chedong.com/phpMan.php/man/super/1/markdown)) _syslog_ For coloring generic syslog messages. (See [_syslogd_(8)](https://www.chedong.com/phpMan.php/man/syslogd/8/markdown)) _ulogd_ For coloring ulogd logs. _vsftpd_ For coloring _vsftpd.log_ files. (See [_vsftpd_(8)](https://www.chedong.com/phpMan.php/man/vsftpd/8/markdown)) _xferlog_ For coloring _xferlog_ files. (See [_xferlog_(5)](https://www.chedong.com/phpMan.php/man/xferlog/5/markdown)) ## FILES _/etc/colorizerc_, _$HOME/.colorizerc_ These files are the default configuration files for **colorize**, and are parsed by **ccze** for the sake of full compatibility. _/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 _/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 default color set to standard output. ## SEE ALSO [**colorize**(1)](https://www.chedong.com/phpMan.php/man/colorize/1/markdown) ## AUTHOR ccze was written by Gergely Nagy <>, based on colorize by Istvan Karaszi <>. CCZE 0.2.1 2003-04-24 [_CCZE_(1)](https://www.chedong.com/phpMan.php/man/CCZE/1/markdown)