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       •   -fno-caret-diagnostics
23
24       The following parameters are passed to Clang from compiler’s command
25       line:
26
27       •   -D...
28
29       •   -I...
30
31       •   -O...
32
33       •   -fexceptions
34
35       •   -fno-exceptions
36
37       •   -include ...
38
39       •   -iquote ...
40
41       •   -isystem ...
42
43       •   -m16
44
45       •   -m32
46
47       •   -m64
48
49       •   -std...
50
51       The following file extensions are recognized as C/C++ source files:
52
53       •   c
54
55       •   C
56
57       •   cc
58
59       •   cpp
60
61       •   cxx
62
63       If csclng is installed on system, the following command activates the
64       wrapper:
65
66           export PATH="$(csclng --print-path-to-wrap):$PATH"
67

OPTIONS

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

EXIT STATUS

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

ENVIRONMENT VARIABLES

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

BUGS

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

AUTHOR

97       Written by Kamil Dudka.
98

COPYING

100       Copyright (C) 2013-2022 Red Hat, Inc. Free use of this software is
101       granted under the terms of the GNU General Public License (GPL). See
102       the COPYING file for details.
103
104
105
106                                  07/21/2023                         CSCLNG(1)
Impressum