Changeset 2825 for trunk/kLdr/kLdrHlp.h

Timestamp:

Oct 22, 2006, 5:57:19 PM (19 years ago)

Author:

bird

Message:

heap and file provider.

File:

• trunk/kLdr/kLdrHlp.h (modified) (2 diffs)

trunk/kLdr/kLdrHlp.h

@@ -29 +29 @@
 #define __kLdrHlp_h__
 
+/** @defgroup grp_kLdrHlp  kLdrHlp - Helper Functions
+ * @internal
+ * @{ */
 /** Get the minimum of two values. */
 #define KLDR_MIN(a, b) ((a) <= (b) ? (a) : (b))
 
-#ifdef __OS2__
+/** Align a size_t value. */
+#define KLDR_ALIGN_Z(val, align)    ( ((val) + ((align) - 1)) & ~(size_t)((align) - 1) )
+/** Align a void * value. */
+#define KLDR_ALIGN_P(pv, align)     ( (void *)( ((uintptr_t)(pv) + ((align) - 1)) & ~(uintptr_t)((align) - 1) ) )
+
+/*
+ * Compiler specific helpers.
+ * (I.e. operations that tend to have compiler intrinsic implementations).
+ */
+#ifdef __GNUC__
+/** memcmp */
+# define kLdrMemComp(a,b,c) __builtin_memcmp(a,b,c)
+/** memcpy */
+# define kLdrMemCopy(a,b,c) __builtin_memcpy(a,b,c)
+/** memset */
+# define kLdrMemSet(a,b,c)  __builtin_memset(a,b,c)
+/** strlen */
+# define kLdrStrLen(a)      __builtin_strlen(a)
+/** alloca */
+# define kLdrAllocA(a)      __builtin_alloca(a)
+/** int3 */
+# define kldrHlpBreakpoint() do { __asm__ __volatile__ ("int3\n\tnop"); } while (0)
+/** NULL */
+# ifndef NULL
+#  define NULL 0
+# endif
+#endif
+
+#ifdef _MSC_VER
+# include <string.h>
+# include <malloc.h>
+# pragma intrinsic(memcmp, memcpy, memset, strlen, __debugbreak)
+/** memcmp */
+# define kLdrMemComp(a,b,c) memcmp(a,b,c)
+/** memcpy */
+# define kLdrMemCopy(a,b,c) memcpy(a,b,c)
+/** memset */
+# define kLdrMemSet(a,b,c)  memset(a,b,c)
+/** strlen */
+# define kLdrStrLen(a)      strlen(a)
+/** alloca */
+# define kLdrAllocA(a)      alloca(a)
+/** int3 */
+# define kldrHlpBreakpoint() __debugbreak()
+/** NULL */
+# ifndef NULL
+#  define NULL 0
+# endif
+#endif
+
+#if !defined(kLdrMemComp) \
+ || !defined(kLdrMemCopy) \
+ || !defined(kLdrMemSet) \
+ || !defined(kLdrStrLen) \
+ || !defined(kLdrAllocA) \
+ || !defined(kldrHlpBreakpoint)
+# error "Needs porting to your compiler."
+#endif
+
 
 int kldrSemInit(void);
@@ -41 +102 @@
 int kldrSemGlobalRelease(void);
 
-/** Loader file handle. */
-typedef unsigned long KLDRFILE;
-/** Pointer to a loader file handle. */
-typedef KLDRFILE *PKLDRFILE;
-
-int kldrFileOpen(const char *pszFilename, PKLDRFILE pFile);
-int kldrFileClose(KLDRFILE File);
-int kldrFileRead(KLDRFILE File, off_t off, void *pv, size_t cb);
-
-int kldrGetEnv(const char *pszVar, char *pszVar, size_t *pcchVar)
-
-void *kldrAlloc(size_t cb);
-void kldrFree(void *pv);
-
 int kldrPrivateAlloc(void *pv, size_t cb, unsigned fFlags, void **ppv);
 int kldrPrivateFree(void *pv, size_t cb);
-int kldrSharedAlloc(void *pv, size_t cb, unsigned fFlags, const char *pszFilename, KLDRFILE File, void **ppv);
+int kldrSharedAlloc(void *pv, size_t cb, unsigned fFlags, const char *pszFilename, void *File, void **ppv);
 int kldrSharedFree(void *pv, size_t cb);
 
-void kldrExit(int rc);
+int     kldrHlpHeapInit(void);
+void    kldrHlpHeapTerm(void);
+void    kldrHlpHeapDonate(void *pv, size_t cb);
+void *  kldrHlpAlloc(size_t cb);
+void    kldrHlpFree(void *pv);
 
-/* #elif __WIN__ */
+int     kldrHlpGetEnv(const char *pszVar, char *pszVal, size_t *pcchVal);
+void    kldrHlpExit(int rc);
+void    kldrHlpAssertMsg(const char *pszExpr, const char *pszFile, unsigned iLine, const char *pszFunction);
 
-#else
+/** Assertion macro.
+ * Users should wrap it since this is ALWAYS compiled in. */
+#define kldrHlpAssert(expr) \
+    do { \
+        if (!(expr)) \
+        { \
+            kldrHlpAssertMsg(#expr, __FILE__, __LINE__, __FUNCTION__); \
+            kldrHlpBreakpoint(); \
+        } \
+    } while (0)
 
 
+/** @} */
 
-#endif
-
-/*
- * Compiler specific helpers.
- * (I.e. operations that tend to have compiler intrinsic implementations).
- */
-#ifdef __GNUC__
-/** memcpy */
-# define kLdrMemCopy(a,b,c) __builtin_memcpy(a,b,c)
-/** memset */
-# define kLdrMemSet(a,b,c) __builtin_memset(a,b,c)
-#endif
-
-#ifndef kLdrMemCopy
-# error "Needs porting to your compiler."
-#endif
 
 #endif /* __kLdrHlp_h__ */
+