]> mj.ucw.cz Git - libucw.git/blobdiff - ucw/lib.h
Fastbuf: fbmulti: *'s and whitespace
[libucw.git] / ucw / lib.h
index ebb6d32a86868fdbc157e0e54dcac935c06c6f5e..e7518defa3d64a30cbcdfe9b39e9a3cbfc1fa21a 100644 (file)
--- a/ucw/lib.h
+++ b/ucw/lib.h
@@ -13,7 +13,7 @@
 #ifndef _UCW_LIB_H
 #define _UCW_LIB_H
 
-#include "ucw/config.h"
+#include <ucw/config.h>
 #include <stdarg.h>
 
 /*** === Macros for handling structures, offsets and alignment ***/
@@ -59,6 +59,7 @@
 #define NONRET __attribute__((noreturn))                               /** Function does not return **/
 #define UNUSED __attribute__((unused))                                 /** Variable/parameter is knowingly unused **/
 #define CONSTRUCTOR __attribute__((constructor))                       /** Call function upon start of program **/
+#define CONSTRUCTOR_WITH_PRIORITY(p) __attribute__((constructor(p)))   /** Define constructor with a given priority **/
 #define PACKED __attribute__((packed))                                 /** Structure should be packed **/
 #define CONST __attribute__((const))                                   /** Function depends only on arguments **/
 #define PURE __attribute__((pure))                                     /** Function depends only on arguments and global vars **/
@@ -118,6 +119,7 @@ enum log_levels {                   /** The available log levels to pass to msg() and friends. *
 void msg(uns flags, const char *fmt, ...) FORMAT_CHECK(printf,2,3);
 void vmsg(uns flags, const char *fmt, va_list args);           /** A vararg version of msg(). **/
 void die(const char *, ...) NONRET FORMAT_CHECK(printf,1,2);   /** Log a fatal error message and exit the program. **/
+void vdie(const char *fmt, va_list args) NONRET;               /** va_list version of die() **/
 
 extern char *log_title;                        /** An optional log message title. Set to program name by log_init(). **/
 extern int log_pid;                    /** An optional PID printed in each log message. Set to 0 if it shouldn't be logged. **/
@@ -148,6 +150,20 @@ void assert_failed_noinfo(void) NONRET;
 #define DBG(x,y...) do { } while(0)
 #endif
 
+#ifdef DEBUG_ASSERTS
+/**
+ * Sometimes, we may want to check that a pointer points to a valid memory
+ * location before we start using it for anything more complicated. This
+ * macro checks pointer validity by reading the byte it points to.
+ **/
+#define ASSERT_READABLE(ptr) ({ volatile char *__p = (ptr); *__p; })
+/** Like the previous macro, but it checks writeability, too. **/
+#define ASSERT_WRITEABLE(ptr) ({ volatile char *__p = (ptr); *__p = *__p; })
+#else
+#define ASSERT_READABLE(ptr) do { } while(0)
+#define ASSERT_WRITEABLE(ptr) do { } while(0)
+#endif
+
 /*** === Memory allocation ***/
 
 /*
@@ -177,14 +193,6 @@ void *big_alloc(u64 len) LIKE_MALLOC;              /** Allocate a large memory block in the
 void *big_alloc_zero(u64 len) LIKE_MALLOC;     /** Allocate and clear a large memory block. **/
 void big_free(void *start, u64 len);           /** Free block allocated by @big_alloc() or @big_alloc_zero(). **/
 
-/*** === Trivial timers (timer.c) ***/
-
-timestamp_t get_timestamp(void);               /** Get current time as a millisecond timestamp. **/
-
-void init_timer(timestamp_t *timer);           /** Initialize a timer. **/
-uns get_timer(timestamp_t *timer);             /** Get the number of milliseconds since last init/get of a timer. **/
-uns switch_timer(timestamp_t *oldt, timestamp_t *newt);        /** Stop ticking of one timer and resume another. **/
-
 /*** === Random numbers (random.c) ***/
 
 uns random_u32(void);                          /** Return a pseudorandom 32-bit number. **/