1CSCLNG(1)                                                            CSCLNG(1)
2
3
4

NAME

6       csclng - a compiler wrapper that runs the Clang analyzer in background
7

SYNOPSIS

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

DESCRIPTION

12       csclng is a compiler wrapper that runs clang in background. Create a
13       symbolic link to csclng named as your compiler (gcc, g++, ...) and put
14       it to your $PATH.
15
16       The following parameters are given to clang by default:
17
18       •   --analyze
19
20       •   -Xanalyzer -analyzer-output=text
21
22       The following parameters are passed to clang from compiler’s command
23       line:
24
25       •   -D...
26
27       •   -I...
28
29       •   -include ...
30
31       •   -iquote ...
32
33       •   -isystem ...
34
35       •   -m16
36
37       •   -m32
38
39       •   -m64
40
41       •   -fexceptions
42
43       •   -fno-exceptions
44
45       •   -O...
46
47       •   -std...
48
49       The following file extensions are recognized as C/C++ source files:
50
51       •   c
52
53       •   C
54
55       •   cc
56
57       •   cpp
58
59       •   cxx
60
61       If csclng is installed on system, the following command activates the
62       wrapper:
63
64           export PATH="`csclng --print-path-to-wrap`:$PATH"
65

OPTIONS

67       --help
68           Prints basic usage information.
69
70       --print-path-to-wrap
71           Prints path to the directory with symlinks to the csclng
72           executable.
73

EXIT STATUS

75       csclng propagates the exit status returned by the compiler (in case
76       csclng succeeds to run the compiler). The exit status returned by clang
77       does not affect the resulting exit status.
78

ENVIRONMENT VARIABLES

80       DEBUG_CSCLNG
81           If set to a non-empty string, csclng outputs the list of parameters
82           given to clang to the standard output.
83
84       CSCLNG_ADD_OPTS
85           csclng expects a colon-separated list of Clang options that should
86           be appended to command line prior to invoking Clang. The options
87           are appended even if they already appear in the command line and
88           they are always appended at the end of the command line.
89

BUGS

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

AUTHOR

95       Written by Kamil Dudka.
96

COPYING

98       Copyright (C) 2013-2014 Red Hat, Inc. Free use of this software is
99       granted under the terms of the GNU General Public License (GPL). See
100       the COPYING file for details.
101
102
103
104                                  11/11/2021                         CSCLNG(1)