csclng - Man Page

csclng [--help | --print-path-to-wrap]

csclng is a compiler wrapper that runs Clang in background. Create a symbolic link to csclng named as your compiler (gcc, g++, ...) and put it to your $PATH.

The following parameters are given to Clang by default:

• --analyze
• -Xanalyzer -analyzer-output=text
• -fno-caret-diagnostics

The following parameters are passed to Clang from compiler’s command line:

• -D...
• -I...
• -O...
• -fexceptions
• -fno-exceptions
• -include ...
• -iquote ...
• -isystem ...
• -m16
• -m32
• -m64
• -std...

The following file extensions are recognized as C/C++ source files:

• c
• C
• cc
• cpp
• cxx

If csclng is installed on system, the following command activates the wrapper:

export PATH="$(csclng --print-path-to-wrap):$PATH"

--help

Prints basic usage information.

--print-path-to-wrap

Prints path to the directory with symlinks to the csclng executable.

csclng propagates the exit status returned by the compiler (in case csclng succeeds to run the compiler). The exit status returned by Clang does not affect the resulting exit status.

DEBUG_CSCLNG

If set to a non-empty string, csclng outputs the list of parameters given to Clang to the standard output.

CSCLNG_ADD_OPTS

csclng expects a colon-separated list of Clang options that should be appended to command line prior to invoking Clang. The options are appended even if they already appear in the command line and they are always appended at the end of the command line.

Please report bugs and feature requests at https://github.com/csutils/cscppc.

Written by Kamil Dudka.

Copyright (C) 2013-2022 Red Hat, Inc. Free use of this software is granted under the terms of the GNU General Public License (GPL). See the COPYING file for details.