The Design and Implementation of the FreeBSD Operating System, Second Edition
Now available: The Design and Implementation of the FreeBSD Operating System (Second Edition)


[ source navigation ] [ diff markup ] [ identifier search ] [ freetext search ] [ file search ] [ list types ] [ track identifier ]

FreeBSD/Linux Kernel Cross Reference
sys/contrib/libsodium/m4/ax_valgrind_check.m4

Version: -  FREEBSD  -  FREEBSD-13-STABLE  -  FREEBSD-13-0  -  FREEBSD-12-STABLE  -  FREEBSD-12-0  -  FREEBSD-11-STABLE  -  FREEBSD-11-0  -  FREEBSD-10-STABLE  -  FREEBSD-10-0  -  FREEBSD-9-STABLE  -  FREEBSD-9-0  -  FREEBSD-8-STABLE  -  FREEBSD-8-0  -  FREEBSD-7-STABLE  -  FREEBSD-7-0  -  FREEBSD-6-STABLE  -  FREEBSD-6-0  -  FREEBSD-5-STABLE  -  FREEBSD-5-0  -  FREEBSD-4-STABLE  -  FREEBSD-3-STABLE  -  FREEBSD22  -  l41  -  OPENBSD  -  linux-2.6  -  MK84  -  PLAN9  -  xnu-8792 
SearchContext: -  none  -  3  -  10 

    1 # ===========================================================================
    2 #    https://www.gnu.org/software/autoconf-archive/ax_valgrind_check.html
    3 # ===========================================================================
    4 #
    5 # SYNOPSIS
    6 #
    7 #   AX_VALGRIND_DFLT(memcheck|helgrind|drd|sgcheck, on|off)
    8 #   AX_VALGRIND_CHECK()
    9 #
   10 # DESCRIPTION
   11 #
   12 #   AX_VALGRIND_CHECK checks whether Valgrind is present and, if so, allows
   13 #   running `make check` under a variety of Valgrind tools to check for
   14 #   memory and threading errors.
   15 #
   16 #   Defines VALGRIND_CHECK_RULES which should be substituted in your
   17 #   Makefile; and $enable_valgrind which can be used in subsequent configure
   18 #   output. VALGRIND_ENABLED is defined and substituted, and corresponds to
   19 #   the value of the --enable-valgrind option, which defaults to being
   20 #   enabled if Valgrind is installed and disabled otherwise. Individual
   21 #   Valgrind tools can be disabled via --disable-valgrind-<tool>, the
   22 #   default is configurable via the AX_VALGRIND_DFLT command or is to use
   23 #   all commands not disabled via AX_VALGRIND_DFLT. All AX_VALGRIND_DFLT
   24 #   calls must be made before the call to AX_VALGRIND_CHECK.
   25 #
   26 #   If unit tests are written using a shell script and automake's
   27 #   LOG_COMPILER system, the $(VALGRIND) variable can be used within the
   28 #   shell scripts to enable Valgrind, as described here:
   29 #
   30 #     https://www.gnu.org/software/gnulib/manual/html_node/Running-self_002dtests-under-valgrind.html
   31 #
   32 #   Usage example:
   33 #
   34 #   configure.ac:
   35 #
   36 #     AX_VALGRIND_DFLT([sgcheck], [off])
   37 #     AX_VALGRIND_CHECK
   38 #
   39 #   Makefile.am:
   40 #
   41 #     @VALGRIND_CHECK_RULES@
   42 #     VALGRIND_SUPPRESSIONS_FILES = my-project.supp
   43 #     EXTRA_DIST = my-project.supp
   44 #
   45 #   This results in a "check-valgrind" rule being added to any Makefile.am
   46 #   which includes "@VALGRIND_CHECK_RULES@" (assuming the module has been
   47 #   configured with --enable-valgrind). Running `make check-valgrind` in
   48 #   that directory will run the module's test suite (`make check`) once for
   49 #   each of the available Valgrind tools (out of memcheck, helgrind and drd)
   50 #   while the sgcheck will be skipped unless enabled again on the
   51 #   commandline with --enable-valgrind-sgcheck. The results for each check
   52 #   will be output to test-suite-$toolname.log. The target will succeed if
   53 #   there are zero errors and fail otherwise.
   54 #
   55 #   Alternatively, a "check-valgrind-$TOOL" rule will be added, for $TOOL in
   56 #   memcheck, helgrind, drd and sgcheck. These are useful because often only
   57 #   some of those tools can be ran cleanly on a codebase.
   58 #
   59 #   The macro supports running with and without libtool.
   60 #
   61 # LICENSE
   62 #
   63 #   Copyright (c) 2014, 2015, 2016 Philip Withnall <philip.withnall@collabora.co.uk>
   64 #
   65 #   Copying and distribution of this file, with or without modification, are
   66 #   permitted in any medium without royalty provided the copyright notice
   67 #   and this notice are preserved.  This file is offered as-is, without any
   68 #   warranty.
   69 
   70 #serial 15
   71 
   72 dnl Configured tools
   73 m4_define([valgrind_tool_list], [[memcheck], [helgrind], [drd], [sgcheck]])
   74 m4_set_add_all([valgrind_exp_tool_set], [sgcheck])
   75 m4_foreach([vgtool], [valgrind_tool_list],
   76            [m4_define([en_dflt_valgrind_]vgtool, [on])])
   77 
   78 AC_DEFUN([AX_VALGRIND_DFLT],[
   79         m4_define([en_dflt_valgrind_$1], [$2])
   80 ])dnl
   81 
   82 AC_DEFUN([AX_VALGRIND_CHECK],[
   83         dnl Check for --enable-valgrind
   84         AC_ARG_ENABLE([valgrind],
   85                                   [AS_HELP_STRING([--enable-valgrind], [Whether to enable Valgrind on the unit tests (requires GNU make)])],
   86                                   [enable_valgrind=$enableval],[enable_valgrind=no])
   87 
   88         AS_IF([test "$enable_valgrind" != "no"],[
   89                 # Check for Valgrind.
   90                 AC_CHECK_PROG([VALGRIND],[valgrind],[valgrind])
   91                 AS_IF([test "$VALGRIND" = ""],[
   92                         AS_IF([test "$enable_valgrind" = "yes"],[
   93                                 AC_MSG_ERROR([Could not find valgrind; either install it or reconfigure with --disable-valgrind])
   94                         ],[
   95                                 enable_valgrind=no
   96                         ])
   97                 ],[
   98                         enable_valgrind=yes
   99                 ])
  100         ])
  101 
  102         AM_CONDITIONAL([VALGRIND_ENABLED],[test "$enable_valgrind" = "yes"])
  103         AC_SUBST([VALGRIND_ENABLED],[$enable_valgrind])
  104 
  105         # Check for Valgrind tools we care about.
  106         [valgrind_enabled_tools=]
  107         m4_foreach([vgtool],[valgrind_tool_list],[
  108                 AC_ARG_ENABLE([valgrind-]vgtool,
  109                     m4_if(m4_defn([en_dflt_valgrind_]vgtool),[off],dnl
  110 [AS_HELP_STRING([--enable-valgrind-]vgtool, [Whether to use ]vgtool[ during the Valgrind tests])],dnl
  111 [AS_HELP_STRING([--disable-valgrind-]vgtool, [Whether to skip ]vgtool[ during the Valgrind tests])]),
  112                               [enable_valgrind_]vgtool[=$enableval],
  113                               [enable_valgrind_]vgtool[=])
  114                 AS_IF([test "$enable_valgrind" = "no"],[
  115                         enable_valgrind_]vgtool[=no],
  116                       [test "$enable_valgrind_]vgtool[" ]dnl
  117 m4_if(m4_defn([en_dflt_valgrind_]vgtool), [off], [= "yes"], [!= "no"]),[
  118                         AC_CACHE_CHECK([for Valgrind tool ]vgtool,
  119                                        [ax_cv_valgrind_tool_]vgtool,[
  120                                 ax_cv_valgrind_tool_]vgtool[=no
  121                                 m4_set_contains([valgrind_exp_tool_set],vgtool,
  122                                     [m4_define([vgtoolx],[exp-]vgtool)],
  123                                     [m4_define([vgtoolx],vgtool)])
  124                                 AS_IF([`$VALGRIND --tool=]vgtoolx[ --help >/dev/null 2>&1`],[
  125                                         ax_cv_valgrind_tool_]vgtool[=yes
  126                                 ])
  127                         ])
  128                         AS_IF([test "$ax_cv_valgrind_tool_]vgtool[" = "no"],[
  129                                 AS_IF([test "$enable_valgrind_]vgtool[" = "yes"],[
  130                                         AC_MSG_ERROR([Valgrind does not support ]vgtool[; reconfigure with --disable-valgrind-]vgtool)
  131                                 ],[
  132                                         enable_valgrind_]vgtool[=no
  133                                 ])
  134                         ],[
  135                                 enable_valgrind_]vgtool[=yes
  136                         ])
  137                 ])
  138                 AS_IF([test "$enable_valgrind_]vgtool[" = "yes"],[
  139                         valgrind_enabled_tools="$valgrind_enabled_tools ]m4_bpatsubst(vgtool,[^exp-])["
  140                 ])
  141                 AC_SUBST([ENABLE_VALGRIND_]vgtool,[$enable_valgrind_]vgtool)
  142         ])
  143         AC_SUBST([valgrind_tools],["]m4_join([ ], valgrind_tool_list)["])
  144         AC_SUBST([valgrind_enabled_tools],[$valgrind_enabled_tools])
  145 
  146 [VALGRIND_CHECK_RULES='
  147 # Valgrind check
  148 #
  149 # Optional:
  150 #  - VALGRIND_SUPPRESSIONS_FILES: Space-separated list of Valgrind suppressions
  151 #    files to load. (Default: empty)
  152 #  - VALGRIND_FLAGS: General flags to pass to all Valgrind tools.
  153 #    (Default: --num-callers=30)
  154 #  - VALGRIND_$toolname_FLAGS: Flags to pass to Valgrind $toolname (one of:
  155 #    memcheck, helgrind, drd, sgcheck). (Default: various)
  156 
  157 # Optional variables
  158 VALGRIND_SUPPRESSIONS ?= $(addprefix --suppressions=,$(VALGRIND_SUPPRESSIONS_FILES))
  159 VALGRIND_FLAGS ?= --num-callers=30
  160 VALGRIND_memcheck_FLAGS ?= --leak-check=full --show-reachable=no
  161 VALGRIND_helgrind_FLAGS ?= --history-level=approx
  162 VALGRIND_drd_FLAGS ?=
  163 VALGRIND_sgcheck_FLAGS ?=
  164 
  165 # Internal use
  166 valgrind_log_files = $(addprefix test-suite-,$(addsuffix .log,$(valgrind_tools)))
  167 
  168 valgrind_memcheck_flags = --tool=memcheck $(VALGRIND_memcheck_FLAGS)
  169 valgrind_helgrind_flags = --tool=helgrind $(VALGRIND_helgrind_FLAGS)
  170 valgrind_drd_flags = --tool=drd $(VALGRIND_drd_FLAGS)
  171 valgrind_sgcheck_flags = --tool=exp-sgcheck $(VALGRIND_sgcheck_FLAGS)
  172 
  173 valgrind_quiet = $(valgrind_quiet_$(V))
  174 valgrind_quiet_ = $(valgrind_quiet_$(AM_DEFAULT_VERBOSITY))
  175 valgrind_quiet_0 = --quiet
  176 valgrind_v_use   = $(valgrind_v_use_$(V))
  177 valgrind_v_use_  = $(valgrind_v_use_$(AM_DEFAULT_VERBOSITY))
  178 valgrind_v_use_0 = @echo "  USE   " $(patsubst check-valgrind-%,%,$''@):;
  179 
  180 # Support running with and without libtool.
  181 ifneq ($(LIBTOOL),)
  182 valgrind_lt = $(LIBTOOL) $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) --mode=execute
  183 else
  184 valgrind_lt =
  185 endif
  186 
  187 # Use recursive makes in order to ignore errors during check
  188 check-valgrind:
  189 ifeq ($(VALGRIND_ENABLED),yes)
  190         $(A''M_V_at)$(MAKE) $(AM_MAKEFLAGS) -k \
  191                 $(foreach tool, $(valgrind_enabled_tools), check-valgrind-$(tool))
  192 else
  193         @echo "Need to use GNU make and reconfigure with --enable-valgrind"
  194 endif
  195 
  196 # Valgrind running
  197 VALGRIND_TESTS_ENVIRONMENT = \
  198         $(TESTS_ENVIRONMENT) \
  199         env VALGRIND=$(VALGRIND) \
  200         G_SLICE=always-malloc,debug-blocks \
  201         G_DEBUG=fatal-warnings,fatal-criticals,gc-friendly
  202 
  203 VALGRIND_LOG_COMPILER = \
  204         $(valgrind_lt) \
  205         $(VALGRIND) $(VALGRIND_SUPPRESSIONS) --error-exitcode=1 $(VALGRIND_FLAGS)
  206 
  207 define valgrind_tool_rule =
  208 check-valgrind-$(1):
  209 ifeq ($$(VALGRIND_ENABLED)-$$(ENABLE_VALGRIND_$(1)),yes-yes)
  210         $$(valgrind_v_use)$$(MAKE) check-TESTS \
  211                 TESTS_ENVIRONMENT="$$(VALGRIND_TESTS_ENVIRONMENT)" \
  212                 LOG_COMPILER="$$(VALGRIND_LOG_COMPILER)" \
  213                 LOG_FLAGS="$$(valgrind_$(1)_flags)" \
  214                 TEST_SUITE_LOG=test-suite-$(1).log
  215 else ifeq ($$(VALGRIND_ENABLED),yes)
  216         @echo "Need to reconfigure with --enable-valgrind-$(1)"
  217 else
  218         @echo "Need to reconfigure with --enable-valgrind"
  219 endif
  220 endef
  221 
  222 $(foreach tool,$(valgrind_tools),$(eval $(call valgrind_tool_rule,$(tool))))
  223 
  224 A''M_DISTCHECK_CONFIGURE_FLAGS ?=
  225 A''M_DISTCHECK_CONFIGURE_FLAGS += --disable-valgrind
  226 
  227 MOSTLYCLEANFILES ?=
  228 MOSTLYCLEANFILES += $(valgrind_log_files)
  229 
  230 .PHONY: check-valgrind $(add-prefix check-valgrind-,$(valgrind_tools))
  231 ']
  232 
  233         AS_IF([test "$enable_valgrind" != "yes"], [
  234                 VALGRIND_CHECK_RULES='
  235 check-valgrind:
  236         @echo "Need to use GNU make and reconfigure with --enable-valgrind"'
  237         ])
  238 
  239         AC_SUBST([VALGRIND_CHECK_RULES])
  240         m4_ifdef([_AM_SUBST_NOTMAKE], [_AM_SUBST_NOTMAKE([VALGRIND_CHECK_RULES])])
  241 ])

Cache object: a6700a7f0a1bee0e6a90ffe966001187


[ source navigation ] [ diff markup ] [ identifier search ] [ freetext search ] [ file search ] [ list types ] [ track identifier ]


This page is part of the FreeBSD/Linux Linux Kernel Cross-Reference, and was automatically generated using a modified version of the LXR engine.