X-Git-Url: http://info.iut-bm.univ-fcomte.fr/pub/gitweb/simgrid.git/blobdiff_plain/fb38ec7f242abb0362371bbdd3cb848d3e1d1303..5a2092b20ade8cd9ba54125b5528260f123de8ce:/include/simgrid/modelchecker.h diff --git a/include/simgrid/modelchecker.h b/include/simgrid/modelchecker.h index cc1888eca0..547f9fd237 100644 --- a/include/simgrid/modelchecker.h +++ b/include/simgrid/modelchecker.h @@ -1,49 +1,55 @@ /* simgrid/modelchecker.h - Formal Verification made possible in SimGrid */ -/* Copyright (c) 2008-2014. The SimGrid Team. - * All rights reserved. */ +/* Copyright (c) 2008-2018. 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 -SG_BEGIN_DECL() +#include /* size_t */ -/** Replay path (if any) in string representation - * - * This is a path as generated by `MC_record_stack_to_string()`. - */ -XBT_PUBLIC_DATA(char*) MC_record_path; +#include /* SIMGRID_HAVE_MC ? */ -/** Whether the replay mode is enabled */ -static inline bool MC_record_replay_is_active(void) { - return MC_record_path; -} +#include -XBT_PUBLIC(int) MC_random(int min, int max); +SG_BEGIN_DECL() -#ifdef HAVE_MC +XBT_PUBLIC int MC_random(int min, int max); -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; +#if SIMGRID_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; #define MC_is_active() _sg_do_model_check -#define MC_visited_reduction() _sg_mc_visited +#define MC_visited_reduction() _sg_mc_max_visited_states + +/** 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_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 @@ -52,11 +58,14 @@ 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_snapshot() ((void*)0) -#define MC_compare_snapshots(a, b) 0 +#define MC_automaton_new_propositional_symbol_pointer(a, b) ((void)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()