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       •   -c -o /dev/null
25
26       The following parameters are passed to the GCC analyzer from compiler’s
27       command line:
28
29       •   -D...
30
31       •   -I...
32
33       •   -include ...
34
35       •   -iquote ...
36
37       •   -isystem ...
38
39       •   -m16
40
41       •   -m32
42
43       •   -m64
44
45       •   -fexceptions
46
47       •   -fno-exceptions
48
49       •   -O...
50
51       •   -std...
52
53       If csgcca is installed on system, the following command activates the
54       wrapper:
55
56           export PATH="`csgcca --print-path-to-wrap`:$PATH"
57

OPTIONS

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

EXIT STATUS

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

ENVIRONMENT VARIABLES

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

BUGS

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

AUTHOR

91       Written by Kamil Dudka.
92

COPYING

94       Copyright (C) 2020-2021 Red Hat, Inc. Free use of this software is
95       granted under the terms of the GNU General Public License (GPL). See
96       the COPYING file for details.
97
98
99
100                                  11/11/2021                         CSGCCA(1)