---
name: "ccfilter"
section: "1"
platform: "macos"
package: "vim"
version: "167"
release: "macOS 26.5"
platforms: ["macos"]
url: "https://new.carta.tech/ccfilter"
---

# ccfilter(1)

a compiler's output filter for vim quickfix

## NAME

ccfilter - a compiler's output filter for vim quickfix

## SYNOPSIS

ccfilter \[ **\<options\>** \]

## DESCRIPTION

The ccfilter utility "filters" the output of several compilers and makers (make/gmake) from several platforms (see NOTES below) to a standardized format which easily fits in vim's quickfix feature. For further details, see in vim ":help quickfix".

ccfilter reads **'stdin'** and outputs to **'stdout'** .

The need for ccfilter is clear, as some compilers have irregular and/or multiple line error messages (with the relevant information on line 2), which makes it impossible for the errorformat to correctly display them !

When working on different platforms, and with different compilers, ccfilter eases the utilization of quickfix, due to its standardized output, allowing to have in .vimrc a plain\
     **:set errorformat=%f:%l:%c:%t:%m**

## USAGE

When using ccfilter, one would include the following lines in .vimrc:\
     **:set shellpipe=\\\\\|&ccfilter\\\\\>**\
     **:set errorformat=%f:%l:%c:%t:%m**

## OPTIONS

- \-c

  Decrement column by one. This may be needed, depending on the compiler being used.

- \-r

  Decrement row by one.  This may be needed, depending on the compiler being used.

- \-v

  Verbose (Outputs also invalid lines). This option makes ccfilter output also the lines that couldn't be correctly parsed. This is used mostly for ccfilter debugging.

- \-o \<COMPILER\>

  Treat input as \<COMPILER\>'s output. Even when configuring ccfilter to assume a default COMPILER, sometimes it's helpful to be able to specify the COMPILER used to generate ccfilter's input. For example, when cross-compiling on a network from a single machine.

- \-h

  Shows a brief help, describing the configured default COMPILER and the valid parameters for COMPILER.

## NOTES

Currently, ccfilter accepts output from several compilers, as described below:

- GCC

  GCC compiler

- AIX

  AIX's C compiler

- ATT

  AT&T/NCR's High Performance C Compiler

- IRIX

  IRIX's MIPS/MIPSpro C compiler

- SOLARIS

  SOLARIS's SparcWorks C compiler

- HPUX

  HPUX's C compiler

## AUTHOR

**ccfilter** was developed by **Pablo Ariel Kohan** **mailto:pablo@memco.co.il**