src/sthread/sthread.h

   1 /* SimGrid's pthread interposer. Intercepts most of the pthread and semaphore calls to model-check them.
   2  *
   3  * Intercepting on pthread is somewhat complicated by the fact that pthread is used everywhere in the system headers.
   4  * To reduce definition conflicts, our redefinitions of the pthread symbols (in sthread.c) load as little headers as
   5  * possible. Thus, the actual implementations are separated in another file (sthread_impl.cpp) and are used as black
   6  * boxes by our redefinitions.
   7  *
   8  * The sthread_* symbols are those actual implementations, used in the pthread_* redefinitions. */
   9
  10 #ifndef SIMGRID_STHREAD_H
  11 #define SIMGRID_STHREAD_H
  12
  13 #include <sys/time.h>
  14
  15 #if defined(__ELF__)
  16 #define XBT_PUBLIC __attribute__((visibility("default")))
  17 #else
  18 #define XBT_PUBLIC
  19 #endif
  20
  21 #if defined(__cplusplus)
  22 extern "C" {
  23 #endif
  24
  25 // Launch the simulation. The old main function (passed as a parameter) is launched as an actor
  26 int sthread_main(int argc, char** argv, char** envp, int (*raw_main)(int, char**, char**));
  27 XBT_PUBLIC void sthread_enable(void);  // Start intercepting all pthread calls
  28 XBT_PUBLIC void sthread_disable(void); // Stop intercepting all pthread calls
  29
  30 typedef unsigned long int sthread_t;
  31 int sthread_create(sthread_t* thread, const /*pthread_attr_t*/ void* attr, void* (*start_routine)(void*), void* arg);
  32 int sthread_join(sthread_t thread, void** retval);
  33
  34 typedef struct {
  35   void* mutex;
  36 } sthread_mutex_t;
  37 int sthread_mutex_init(sthread_mutex_t* mutex, const /*pthread_mutexattr_t*/ void* attr);
  38 int sthread_mutex_lock(sthread_mutex_t* mutex);
  39 int sthread_mutex_trylock(sthread_mutex_t* mutex);
  40 int sthread_mutex_unlock(sthread_mutex_t* mutex);
  41 int sthread_mutex_destroy(sthread_mutex_t* mutex);
  42
  43 int sthread_gettimeofday(struct timeval* tv);
  44 void sthread_sleep(double seconds);
  45
  46 #if defined(__cplusplus)
  47 }
  48 #endif
  49
  50 #endif