X-Git-Url: http://info.iut-bm.univ-fcomte.fr/pub/gitweb/simgrid.git/blobdiff_plain/d13b1659a0c2551ee41b287a269e391bb2d7bc8a..7cbb44e02a4c28ea278e9b82c9dda3bdff2c3cb9:/include/simgrid/modelchecker.h diff --git a/include/simgrid/modelchecker.h b/include/simgrid/modelchecker.h index 15b877dcbe..2ddf8a9165 100644 --- a/include/simgrid/modelchecker.h +++ b/include/simgrid/modelchecker.h @@ -1,42 +1,54 @@ /* simgrid/modelchecker.h - Formal Verification made possible in SimGrid */ -/* Copyright (c) 2008-2014. The SimGrid Team. - * All rights reserved. */ +/* Copyright (c) 2008-2019. The SimGrid Team. All rights reserved. */ /* This program is free software; you can redistribute it and/or modify it * under the terms of the license (GNU LGPL) which comes with this package. */ -#include - -#include /* HAVE_MC ? */ -#include -#include "xbt/automaton.h" +/** \file modelchecker.h + * + * This is the API used by the user simulated program to communicate + * with the MC. + */ #ifndef SIMGRID_MODELCHECKER_H #define SIMGRID_MODELCHECKER_H +#include /* SIMGRID_HAVE_MC ? */ +#include + +#include /* size_t */ + SG_BEGIN_DECL() -XBT_PUBLIC(int) MC_random(int min, int max); +XBT_PUBLIC int MC_random(int min, int max); + +#if SIMGRID_HAVE_MC -#ifdef HAVE_MC +/* Internal variable used to check if we're running under the MC + * + * Please don't use directly: you should use MC_is_active. */ +extern XBT_PUBLIC int _sg_do_model_check; +extern XBT_PUBLIC int _sg_mc_max_visited_states; -extern int _sg_do_model_check; /* please don't use directly: we inline MC_is_active, but that's what you should use */ -extern int _sg_mc_visited; +#define MC_is_active() _sg_do_model_check +#define MC_visited_reduction() _sg_mc_max_visited_states -#define MC_is_active() _sg_do_model_check -#define MC_visited_reduction() _sg_mc_visited +/** Assertion for the model-checker + * + * This function is used to define safety properties to verify. + */ +XBT_PUBLIC void MC_assert(int); -XBT_PUBLIC(void) MC_assert(int); -XBT_PUBLIC(void) MC_automaton_new_propositional_symbol(const char* id, int(*fct)(void)); -XBT_PUBLIC(void) MC_automaton_new_propositional_symbol_pointer(const char *id, int* value); -XBT_PUBLIC(void) MC_automaton_new_propositional_symbol_callback(const char* id, - xbt_automaton_propositional_symbol_callback_type callback, - void* data, xbt_automaton_propositional_symbol_free_function_type free_function); -XBT_PUBLIC(void *) MC_snapshot(void); -XBT_PUBLIC(int) MC_compare_snapshots(void *s1, void *s2); -XBT_PUBLIC(void) MC_cut(void); -XBT_PUBLIC(void) MC_ignore(void *addr, size_t size); +XBT_PUBLIC void MC_automaton_new_propositional_symbol(const char* id, int (*fct)(void)); +XBT_PUBLIC void MC_automaton_new_propositional_symbol_pointer(const char* id, int* value); + +XBT_PUBLIC void MC_cut(void); +XBT_PUBLIC void MC_ignore(void* addr, size_t size); + +XBT_PUBLIC void MC_ignore_heap(void* address, size_t size); +XBT_PUBLIC void MC_unignore_heap(void* address, size_t size); +XBT_PUBLIC void MC_ignore_global_variable(const char* var_name); #else @@ -46,13 +58,13 @@ XBT_PUBLIC(void) MC_ignore(void *addr, size_t size); #define MC_assert(a) xbt_assert(a) #define MC_automaton_new_propositional_symbol(a, b) ((void)0) #define MC_automaton_new_propositional_symbol_pointer(a, b) ((void)0) -#define MC_automaton_new_propositional_symbol_callback(id,callback,data,free_function) \ - if(free_function) free_function(data); -#define MC_snapshot() ((void*)0) -#define MC_compare_snapshots(a, b) 0 #define MC_cut() ((void)0) #define MC_ignore(a, b) ((void)0) +#define MC_ignore_heap(a,s) ((void)0) +#define MC_remove_ignore_heap(a,s) ((void)0) +#define MC_ignore_global_variable(v) ((void)0) + #endif SG_END_DECL()