CSBUILD(1)

📦
version 3.8.7 · 5 versions
, in epel 9

💅 CSBUILD(1) — the manual page, bestie edition 🎀

okay so this is the User Commands manual page for csbuild, and yes it slaps. it's the tool that plugs your static analyzers straight into your build process so you don't have to sit there doing it by hand like a Victorian child. iconic behavior honestly ✨

🌸 NAME 🌸

csbuild — the tool for plugging static analyzers into the build process. that's it, that's the whole vibe check. 🦋

✨ SYNOPSIS ✨

like, literally just look at it:

usage: csbuild [-h] -c BUILD_CMD [-g GIT_COMMIT_RANGE] [--git-bisect]
       [--added-exit-code ADDED_EXIT_CODE] [--base-fail-exit-code
       BASE_FAIL_EXIT_CODE] [--print-current] [--no-print-current]
       [--print-added] [--no-print-added] [--print-fixed]
       [--no-print-fixed] [--clean] [--no-clean] [--cswrap-timeout
       CSWRAP_TIMEOUT] [--color] [--no-color] [--gen-travis-yml]
       [--install INSTALL] [--prep-cmd PREP_CMD] [--build-dir BUILD_DIR]
       [-w GCC_WARNING_LEVEL] [--gcc-add-flag GCC_ADD_FLAG]
       [--gcc-add-c-only-flag GCC_ADD_C_ONLY_FLAG]
       [--gcc-add-cxx-only-flag GCC_ADD_CXX_ONLY_FLAG] [--gcc-del-flag
       GCC_DEL_FLAG] [--clang-add-flag CLANG_ADD_FLAG] [-U
       EMBED_CONTEXT] [--version]

there's also a <hotpink>usage:</hotpink> line up in DESCRIPTION that gives you the whole argument dump, so basically you're never lost. 🫶

💖 DESCRIPTION 💖

the usage line, refresh, because we love a recap:

usage: csbuild [-h] -c BUILD_CMD [-g GIT_COMMIT_RANGE] [--git-bisect]
       [--added-exit-code ADDED_EXIT_CODE] [--base-fail-exit-code
       BASE_FAIL_EXIT_CODE] [--print-current] [--no-print-current]
       [--print-added] [--no-print-added] [--print-fixed]
       [--no-print-fixed] [--clean] [--no-clean] [--cswrap-timeout
       CSWRAP_TIMEOUT] [--color] [--no-color] [--gen-travis-yml]
       [--install INSTALL] [--prep-cmd PREP_CMD] [--build-dir BUILD_DIR]
       [-w GCC_WARNING_LEVEL] [--gcc-add-flag GCC_ADD_FLAG]
       [--gcc-add-c-only-flag GCC_ADD_C_ONLY_FLAG]
       [--gcc-add-cxx-only-flag GCC_ADD_CXX_ONLY_FLAG] [--gcc-del-flag
       GCC_DEL_FLAG] [--clang-add-flag CLANG_ADD_FLAG] [-U
       EMBED_CONTEXT] [--version]

🧚 optional arguments (yes, all of them, i'm not skipping a single one)

  • -h, --help — prints this help message and dips. the classic. 💅
  • -c BUILD_CMD, --build-cmd BUILD_CMD — the shell command used to build the sources. it runs in @BUILDDIR@, which lowkey defaults to $PWD if you don't pass --build-dir. also @SRCDIR@ expands to $PWD at the time csbuild was invoked. 🏗️
  • -g GIT_COMMIT_RANGE, --git-commit-range GIT_COMMIT_RANGE — range of git revisions for a differential scan, in the format OLD_REV..NEW_REV. this is your diff queen era. 🔍
  • --git-bisect — if a new defect gets added, use git-bisect to identify the cause. WARNING: the given command must (re)compile all sources for this option to work! no cap, it's serious. 💀
  • --added-exit-code ADDED_EXIT_CODE — exit code to return if there's any defect added in the new version (default: 7). 🚪
  • --base-fail-exit-code BASE_FAIL_EXIT_CODE — exit code to return if the base scan fails (default: 0). 😭
  • --print-current — print all defects in the current version (this is the default unless -g is given). WARNING: the given command must (re)compile all sources for this option to work! ⚠️
  • --no-print-current — disables --print-current. that's the whole gig. 🙈
  • --print-added — print defects added in the new version (this is the default if -g is given). 🆕
  • --no-print-added — disables --print-added. 🙂‍↔️
  • --print-fixed — print defects fixed in the new version. WARNING: the given command must (re)compile all sources for this option to work! 🛠️
  • --no-fixed... wait no, it's --no-print-fixed — disables --print-fixed. 🚫
  • --clean — clean the temporary directory with results (and @BUILDDIR@) on exit. this is the default, bestie. 🧹
  • --no-clean — disables --clean. keep that mess, i guess. 🗑️
  • --cswrap-timeout CSWRAP_TIMEOUT — maximal amount of time in seconds taken by analysis of a single module (default: 30). tick tock ⏰
  • --color — use colorized console output (this is the default if connected to a tty). 🌈
  • --no-color — disables --color. monochrome moment. 🖤
  • --gen-travis-yml — generate the .travis.yml file for Travis CI (requires --install). nostalgic fr fr. 📜
  • --install INSTALL — space-separated list of packages to install with --gen-travis-yml. 📦
  • --prep-cmd PREP_CMD — shell command to run before the build. it runs in @BUILDDIR@, which defaults to $PWD if --build-dir isn't specified. and @SRCDIR@ expands to $PWD at the time of csbuild's invocation. prep queen 🧴
  • --build-dir BUILD_DIR — directory to be created to run the prep and build commands in (optional). if you don't specify it, the commands run in $PWD. @BUILDDIR@ in the operand of --build-cmd and --prep-cmd expands to the --build-dir operand converted to an absolute path. use --no-clean to preserve @BUILDDIR@ on exit. literally the main character of directories 🏠👑
  • -w GCC_WARNING_LEVEL, --gcc-warning-level GCC_WARNING_LEVEL — adjust the GCC warning level. -w0 means no additional warnings, -w1 appends -Wall and -Wextra, and -w2 enables some other useful warnings (default: 2). volume knob for warnings 🔉🔊
  • --gcc-add-flag GCC_ADD_FLAG — append the given compiler flag when invoking gcc (can be used multiple times). ➕
  • --gcc-add-c-only-flag GCC_ADD_C_ONLY_FLAG — append the given compiler flag when invoking gcc for C (can be used multiple times). 🅲
  • --gcc-add-cxx-only-flag GCC_ADD_CXX_ONLY_FLAG — append the given compiler flag when invoking gcc for C++ (can be used multiple times). 🅲🅲
  • --gcc-del-flag GCC_DEL_FLAG — drop the given compiler flag when invoking gcc (can be used multiple times). bye bestie 👋
  • --clang-add-flag CLANG_ADD_FLAG — append the given flag when invoking the clang static analyzer (can be used multiple times). 🧠
  • -U EMBED_CONTEXT, --embed-context EMBED_CONTEXT — embed a number of lines of context from the source file for the key event (default: 3). context is everything, periodt. 📖
  • --version — print the version of csbuild and exit. the flex. 🏆
i would never gatekeep this from you, so: every warning above is load-bearing. if an option says the given command must (re)compile all sources, that is not a suggestion, that is the whole assignment. 💀✨

and that's the page, bestie 🫶 — this was csbuild from csmock-3.8.7-1.el9, dated June 2026. manual page CSBUILD(1), user commands section, signing off. slay, stay analyzed, and don't forget to --no-clean if you want the receipts 🎀💜

📦 where this page comes from