CSMATCH(1)

πŸ“¦
version 2.2.8 Β· 3 versions
, in epel 10, epel 9, fedora 43, fedora 44

✨ CSMATCH ✨

okay bestie, pull up a chair, because this is the manual page for csmatch (section 1 of the manual, iykyk) πŸ’…


🌸 NAME 🌸

csmatch β€” a compiler wrapper that runs the Smatch analyzer in background. yes, in background, she's multitasking, she's the main character 🧚


πŸ¦‹ SYNOPSIS πŸ¦‹

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

πŸ’– DESCRIPTION πŸ’–

csmatch is a compiler wrapper that runs Smatch in background. so here's the vibe: you make a symbolic link to csmatch and you name that link whatever your compiler is called (gcc, g++, ...), then you drop it somewhere in your $PATH. that's it, that's the whole trick ✨

The following parameters are given to Smatch by default:

  • -D_Float128=long double

The following parameters are passed to Smatch 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 csmatch is installed on system, the following command activates the wrapper:

export PATH="$(csmatch --print-path-to-wrap):$PATH"
not me putting the wrapper's little symlink directory at the front of $PATH… lowkey that's the whole point though 🫢

πŸŽ€ OPTIONS πŸŽ€

  • --help β€” Prints basic usage information. she's telling you how to use her, respectfully πŸ’…
  • --print-path-to-wrap β€” Prints path to the directory with symlinks to the csmatch executable. iconic little directory reveal ✨

🌈 EXIT STATUS 🌈

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

fr fr β€” Smatch can be having a whole meltdown back there and the exit status will simply not care πŸ’€

⭐ ENVIRONMENT VARIABLES ⭐

  • DEBUG_CSMATCH β€” If set to a non-empty string, csmatch outputs the list of parameters given to Smatch to the standard output. she's spilling the tea about what she handed to Smatch πŸ“
  • CSMATCH_ADD_OPTS β€” csmatch expects a colon-separated list of Smatch options that should be appended to command line prior to invoking Smatch. 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. yes bestie, even if they already appear, and always at the end β€” no negotiating, no cap πŸ‘‘

πŸ’€ BUGS πŸ’€

Please report bugs and feature requests at https://github.com/csutils/cscppc. be nice, be specific, and give them the receipts πŸ™ˆ


πŸ‘‘ AUTHOR πŸ‘‘

Written by Kamil Dudka. the legend herself, we stan 🫢


🌸 COPYING 🌸

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.


and that's the whole page, bestie πŸ’œ this was the csmatch manual, dated 06/29/2026, straight from section 1 of the manual β€” slay, go wrap a compiler, periodt βœ¨πŸŽ€

πŸ“¦ where this page comes from