X-Git-Url: http://info.iut-bm.univ-fcomte.fr/pub/gitweb/simgrid.git/blobdiff_plain/1a6e40bce6e758aa2e7afffbfd3c6b63063f1472..a22eac4ecebbfe32bc971d40680651b7ab1af4d4:/include/simgrid/modelchecker.h diff --git a/include/simgrid/modelchecker.h b/include/simgrid/modelchecker.h index 6ce5570b04..7c7d09a9f8 100644 --- a/include/simgrid/modelchecker.h +++ b/include/simgrid/modelchecker.h @@ -1,51 +1,59 @@ /* simgrid/modelchecker.h - Formal Verification made possible in SimGrid */ -/* Copyright (c) 2008-2014. The SimGrid Team. +/* Copyright (c) 2008-2015. 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 +#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 + +SG_BEGIN_DECL() XBT_PUBLIC(int) MC_random(int min, int max); -#ifdef HAVE_MC +#if SIMGRID_HAVE_MC -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; +/* 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_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_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_ignore_heap(void* address, size_t size); +XBT_PUBLIC(void) MC_remove_ignore_heap(void* address, size_t size); +XBT_PUBLIC(void) MC_ignore_local_variable(const char* var_name, const char* frame); +XBT_PUBLIC(void) MC_ignore_global_variable(const char* var_name); + #else #define MC_is_active() 0 @@ -54,11 +62,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_automaton_new_propositional_symbol_pointer(a, b) ((void)0) -#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_local_variable(n,f) ((void)0) +#define MC_ignore_global_variable(v) ((void)0) + #endif SG_END_DECL()