3 /* gras/core.h - Unsorted part of the GRAS public interface */
5 /* Authors: Martin Quinson */
6 /* Copyright (C) 2003 the OURAGAN project. */
8 /* This program is free software; you can redistribute it and/or modify it
9 under the terms of the license (GNU LGPL) which comes with this package. */
14 #include <stddef.h> /* offsetof() */
15 #include <sys/types.h> /* size_t */
19 /*! C++ users need love */
22 # define BEGIN_DECL extern "C" {
28 /*! C++ users need love */
36 /* End of cruft for C++ */
40 /* **************************************************************************
41 * Garbage collection support
42 * **************************************************************************/
43 typedef enum { free_after_use, free_never } e_gras_free_directive_t;
45 /* **************************************************************************
46 * Initializing the processes
47 * **************************************************************************/
51 * Perform the various intialisations needed by gras. Each process must run it
53 gras_error_t gras_process_init(void);
56 * gras_process_finalize:
58 * Perform the various intialisations needed by gras. Each process must run it
60 gras_error_t gras_process_finalize(void);
62 /****************************************************************************/
63 /* Manipulating User Data */
64 /****************************************************************************/
68 * Get the data associated with the current process.
70 void *gras_userdata_get(void);
75 * Set the data associated with the current process.
77 void *gras_userdata_set(void *ud);
82 * Malloc and set the data associated with the current process.
85 #define gras_userdata_new(type) gras_userdata_set(malloc(sizeof(type)))
87 /* **************************************************************************
88 * Wrappers over OS functions
89 * **************************************************************************/
94 * Returns the fully-qualified name of the host machine, or NULL if the name
95 * cannot be determined. Always returns the same value, so multiple calls
99 gras_get_my_fqdn(void);
104 * Get the time in number of second since the Epoch.
105 * (00:00:00 UTC, January 1, 1970 in Real Life, and begining of simulation in SG)
107 double gras_time(void);
111 * @sec: number of seconds to sleep
112 * @usec: number of microseconds to sleep
114 * sleeps for the given amount of seconds plus the given amount of microseconds.
116 void gras_sleep(unsigned long sec, unsigned long usec);
120 #endif /* GRAS_CORE_H */