1CSGCCA(1)                                                            CSGCCA(1)
2
3
4

NAME

6       csgcca - a compiler wrapper that runs the GCC analyzer in background
7

SYNOPSIS

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

DESCRIPTION

12       csgcca is a compiler wrapper that runs gcc -fanalyzer in background.
13       Create a symbolic link to csgcca named as your compiler and put it to
14       your $PATH.
15
16       The following parameters are given to the GCC analyzer by default:
17
18       •   -fanalyzer
19
20       •   -fdiagnostics-path-format=separate-events
21
22       •   -fno-diagnostics-show-caret
23
24       •   -fno-lto
25
26       •   -c -o /dev/null
27
28       The following parameters are passed to the GCC analyzer from compiler’s
29       command line:
30
31       •   -D...
32
33       •   -I...
34
35       •   -O...
36
37       •   -Wno-...
38
39       •   -f...
40
41       •   -include ...
42
43       •   -iquote ...
44
45       •   -isystem ...
46
47       •   -m16
48
49       •   -m32
50
51       •   -m64
52
53       •   -std...
54
55       If csgcca is installed on system, the following command activates the
56       wrapper:
57
58           export PATH="$(csgcca --print-path-to-wrap):$PATH"
59

OPTIONS

61       --help
62           Prints basic usage information.
63
64       --print-path-to-wrap
65           Prints path to the directory with symlinks to the csgcca
66           executable.
67

EXIT STATUS

69       csgcca propagates the exit status returned by the compiler (in case
70       csgcca succeeds to run the compiler). The exit status returned by the
71       GCC analyzer does not affect the resulting exit status.
72

ENVIRONMENT VARIABLES

74       DEBUG_CSGCCA
75           If set to a non-empty string, csgcca outputs the list of parameters
76           given to the GCC analyzer to the standard output.
77
78       CSGCCA_ADD_OPTS
79           csgcca expects a colon-separated list of GCC options that should be
80           appended to command line prior to invoking the GCC analyzer. The
81           options are appended even if they already appear in the command
82           line and they are always appended at the end of the command line.
83
84       CSGCCA_ANALYZER_BIN
85           If set to a non-empty string, csgcca will use the value as a path
86           (relative or absolute) to analyzer binary.
87

BUGS

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

AUTHOR

93       Written by Kamil Dudka.
94

COPYING

96       Copyright (C) 2020-2022 Red Hat, Inc. Free use of this software is
97       granted under the terms of the GNU General Public License (GPL). See
98       the COPYING file for details.
99
100
101
102                                  07/21/2023                         CSGCCA(1)