goto_check_c.h

Go to the documentation of this file.

/*******************************************************************\
 
Module: Checks for Errors in C/C++ Programs
 
Author: Daniel Kroening, kroening@kroening.com
 
\*******************************************************************/

 
#ifndef CPROVER_ANSI_C_GOTO_CHECK_C_H
#define CPROVER_ANSI_C_GOTO_CHECK_C_H
 
#include <goto-programs/goto_functions.h>
 
class goto_modelt;
class namespacet;
class optionst;
class message_handlert;
 
void goto_check_c(
  const namespacet &ns,
  const optionst &options,
  goto_functionst &goto_functions,
  message_handlert &message_handler);
 
void goto_check_c(
  const irep_idt &function_identifier,
  goto_functionst::goto_functiont &goto_function,
  const namespacet &ns,
  const optionst &options,
  message_handlert &message_handler);
 
void goto_check_c(
  const optionst &options,
  goto_modelt &goto_model,
  message_handlert &message_handler);
 
#define OPT_GOTO_CHECK                                                         \
  "(bounds-check)(pointer-check)(memory-leak-check)(memory-cleanup-check)"     \
  "(div-by-zero-check)(float-div-by-zero-check)"                               \
  "(enum-range-check)"                                                         \
  "(signed-overflow-check)(unsigned-overflow-check)"                           \
  "(pointer-overflow-check)(conversion-check)(undefined-shift-check)"          \
  "(float-overflow-check)(nan-check)(no-built-in-assertions)"                  \
  "(pointer-primitive-check)"                                                  \
  "(retain-trivial-checks)"                                                    \
  "(error-label):"                                                             \
  "(no-assertions)(no-assumptions)"                                            \
  "(assert-to-assume)"                                                         \
  "(no-bounds-check)(no-pointer-check)(no-signed-overflow-check)"              \
  "(no-pointer-primitive-check)(no-undefined-shift-check)"                     \
  "(no-div-by-zero-check)"
 
// clang-format off
#define HELP_GOTO_CHECK \
  " {y--no-standard-checks} \t disable default checks (more information in manpage)\n" /* NOLINT(whitespace/line_length) */ \
  " {y--bounds-check} \t enable array bounds checks (default on)\n"            \
  " {y--no-bounds-check} \t disable array bounds checks\n"                     \
  " {y--pointer-check} \t enable pointer checks (default on)\n"                \
  " {y--no-pointer-check} \t disable pointer checks\n"                         \
  " {y--memory-leak-check} \t enable memory leak checks\n"                     \
  " {y--memory-cleanup-check} \t enable memory cleanup checks\n"               \
  " {y--div-by-zero-check} \t "                                                \
  "enable division by zero checks on integers (default on)\n"                  \
  " {y--float-div-by-zero-check} \t "                                          \
  "enable division by zero checks on floating-point numbers (default off)\n"   \
  " {y--no-div-by-zero-check} \t disable division by zero checks\n"            \
  " {y--signed-overflow-check} \t "                                            \
  "enable signed arithmetic over- and underflow checks (default on)\n"         \
  " {y--no-signed-overflow-check} \t "                                         \
  "disable signed arithmetic over- and underflow checks\n"                     \
  " {y--unsigned-overflow-check} \t "                                          \
  "enable arithmetic over- and underflow checks\n"                             \
  " {y--pointer-overflow-check} \t "                                           \
  "enable pointer arithmetic over- and underflow checks\n"                     \
  " {y--conversion-check} \t "                                                 \
  "check whether values can be represented after type cast\n"                  \
  " {y--undefined-shift-check} \t check shift greater than bit-width "         \
  "(default on)\n"                                                             \
  " {y--no-undefined-shift-check} \t disable check for shift greater than "    \
  "bit-width\n"                                                                \
  " {y--float-overflow-check} \t check floating-point for +/-Inf\n"            \
  " {y--nan-check} \t check floating-point for NaN\n"                          \
  " {y--enum-range-check} \t "                                                 \
  "checks that all enum type expressions have values in the enum range\n"      \
  " {y--pointer-primitive-check} \t "                                          \
  "checks that all pointers in pointer primitives are valid or null (default " \
  "on)\n"                                                                      \
  " {y--no-pointer-primitive-check} \t "                                       \
  "disable checks that all pointers in pointer primitives are valid or null\n" \
  " {y--retain-trivial-checks} \t include checks that are trivially true\n"    \
  " {y--error-label} {ulabel} \t check that label {ulabel} is unreachable\n"   \
  " {y--no-built-in-assertions} \t ignore assertions in built-in library\n"    \
  " {y--no-assertions} \t ignore user assertions\n"                            \
  " {y--no-assumptions} \t ignore user assumptions\n"                          \
  " {y--assert-to-assume} \t convert user assertions to assumptions\n"
// clang-format on
 
#define PARSE_OPTION_OVERRIDE(cmdline, options, option)                        \
  if(cmdline.isset(option))                                                    \
    options.set_option(option, true);                                          \
  if(cmdline.isset("no-" option))                                              \
    options.set_option(option, false);                                         \
  (void)0
 
// clang-format off
#define PARSE_OPTIONS_GOTO_CHECK(cmdline, options) \
  options.set_option("memory-leak-check", cmdline.isset("memory-leak-check")); \
  options.set_option("memory-cleanup-check", cmdline.isset("memory-cleanup-check")); /* NOLINT(whitespace/line_length) */ \
  options.set_option("enum-range-check", cmdline.isset("enum-range-check")); \
  options.set_option("unsigned-overflow-check", cmdline.isset("unsigned-overflow-check")); /* NOLINT(whitespace/line_length) */  \
  options.set_option("pointer-overflow-check", cmdline.isset("pointer-overflow-check")); /* NOLINT(whitespace/line_length) */  \
  options.set_option("conversion-check", cmdline.isset("conversion-check")); \
  options.set_option("float-overflow-check", cmdline.isset("float-overflow-check")); /* NOLINT(whitespace/line_length) */  \
  options.set_option("nan-check", cmdline.isset("nan-check")); \
  options.set_option("built-in-assertions", !cmdline.isset("no-built-in-assertions")); /* NOLINT(whitespace/line_length) */ \
  options.set_option("retain-trivial-checks", \
                     cmdline.isset("retain-trivial-checks")); \
  options.set_option("assertions", !cmdline.isset("no-assertions")); /* NOLINT(whitespace/line_length) */ \
  options.set_option("assumptions", !cmdline.isset("no-assumptions")); /* NOLINT(whitespace/line_length) */ \
  options.set_option("assert-to-assume", cmdline.isset("assert-to-assume")); /* NOLINT(whitespace/line_length) */ \
  options.set_option("retain-trivial", cmdline.isset("retain-trivial")); /* NOLINT(whitespace/line_length) */ \
  if(cmdline.isset("error-label")) \
    options.set_option("error-label", cmdline.get_values("error-label"));      \
  PARSE_OPTION_OVERRIDE(cmdline, options, "bounds-check"); \
  PARSE_OPTION_OVERRIDE(cmdline, options, "pointer-check"); \
  PARSE_OPTION_OVERRIDE(cmdline, options, "div-by-zero-check"); \
  PARSE_OPTION_OVERRIDE(cmdline, options, "float-div-by-zero-check"); \
  PARSE_OPTION_OVERRIDE(cmdline, options, "signed-overflow-check"); \
  PARSE_OPTION_OVERRIDE(cmdline, options, "undefined-shift-check"); \
  PARSE_OPTION_OVERRIDE(cmdline, options, "pointer-primitive-check"); \
  (void)0
// clang-format on
 
#endif // CPROVER_ANALYSES_GOTO_CHECK_C_H