home *** CD-ROM | disk | FTP | other *** search
/ PC Shareware 1997 June / PC_Shareware-1997-06.iso / programy / genesis / debug.h < prev    next >
Encoding:
C/C++ Source or Header  |  1996-04-05  |  4.1 KB  |  154 lines
  1. /*------------------------------------------------------------------
  2.             Debug Library
  3.             -------------
  4.  
  5.     Header for C interface to debug library
  6.  
  7.     (C) Silicon Dream Ltd 1994
  8.  
  9.   ------------------------------------------------------------------
  10.  
  11. Changes:                        Date:
  12. * Created file                        27/10/94
  13. */
  14.  
  15. #ifndef DEBUG
  16. #define DEBUG
  17.  
  18. #include <stdarg.h>
  19. #include <stdlib.h>
  20. #include <atomic.h>
  21.  
  22. /* Defined operations:
  23.  
  24.     DebOut("debug.txt+")        First call to Deb should provide an output file name
  25.                       The optional '+' provides additional output to the console
  26.     DebOut("....", p1, p2...pn);    Outputs a formatted debug string with a timestamp
  27.     DebOut(FLUSH)            Forces flushing buffer contents to file
  28.     DebOut(STOP)            Flushes buffer to file and closes the file
  29.     Malloc(size)            Allocates memory
  30.     Free(ptr)            Frees memory
  31.     DebListMem()            Lists details of all memory currently allocated to the
  32.                     debug output file
  33.  
  34.     Given that the debug library can be linked to many EXEs and/or DLLs at the
  35.     same time the rules governing what appears in what file are quite straightforward.
  36.     There is one output file per instance (ie. per data segment to which the library
  37.     is linked). If say we link to a DLL with one data segment per instance, then each
  38.     task using the DLL will have a seperate output file. The first call to DebOut() for
  39.     each instance should provide the name of an output file. The allocated memory list
  40.     also works on a per-instance basis, so for instance an EXE linked to the library will
  41.     get only its allocated memory shown by DebListMem() and not that of some DLL linked
  42.     to its own copy of the library
  43. */
  44.  
  45. #define FLUSH        "\xff\0"
  46. #define STOP        "\xfe\0"
  47.  
  48. typedef void (* DebOutFunc) (char *sz, ...);
  49. typedef void (* AddOutFunc) (char *sz);
  50. typedef void *(* AppAllocFunc) (ulong ulSize);
  51. typedef void (* AppFreeFunc) (void *pv);
  52.  
  53. extern void Deb (ulong ulClock, char *sz, AddOutFunc pfnAddOut, va_list val);
  54. extern void *DebAlloc (ulong ulSizeIn, char *szFN, ushort usLine, bool bNew, AppAllocFunc DebAppAlloc);
  55. extern void DebFree (void *pvMem, bool bDeb, AppFreeFunc DebAppFree);
  56. extern void DebMem (DebOutFunc pfnDebOut);
  57.  
  58. extern void DebStart (void);
  59.  
  60. /* If we're linking the debug library with a windows DLL we will not get
  61.    access to the standard C library function clock, instead we use the
  62.    windows function GetTickCount. Also it seems the malloc function can
  63.    corrupt memory under windows so instead we call two seperate memory
  64.    allocation routines for windows and non windows programs */
  65.  
  66. //------------------ C PROGRAM -------------------------
  67. #ifndef _WINDOWS
  68.  
  69. #include <time.h>
  70.  
  71. #ifdef _DEBUG
  72. _st void AddOut (char *sz)
  73.     {
  74.     printf(sz);
  75.     }
  76.  
  77. _st void DebOut (char *sz, ...)
  78.     {
  79.     va_list        val;
  80.  
  81.     va_start(val, sz);
  82.     Deb(((ulong) clock())*1000L/CLOCKS_PER_SEC, sz, AddOut, val);
  83.     va_end(val);
  84.     }
  85. #endif
  86.  
  87. _st void *DebAppAlloc (ulong ulSize)
  88.     {
  89.     return malloc((size_t) ulSize);
  90.     }
  91.  
  92. _st void DebAppFree (void *pv)
  93.     {
  94.     free(pv);
  95.     }
  96.  
  97. #endif
  98.  
  99. //------------------ WINDOWS PROGRAM -------------------
  100. #ifdef _WINDOWS
  101.  
  102. #include <windows.h>
  103.  
  104. #ifdef _DEBUG
  105. _st void AddOut (char *sz)
  106.     {
  107.     OutputDebugString(sz);
  108.     }
  109.  
  110. _st void DebOut (char *sz, ...)
  111.     {
  112.     va_list        val;
  113.  
  114.     va_start(val, sz);
  115.     Deb(((ulong) GetTickCount()), sz, AddOut, val);
  116.     va_end(val);
  117.     }
  118. #endif
  119.  
  120. _st void *DebAppAlloc (ulong ulSize)
  121.     {
  122.     HGLOBAL        hg, *phg;
  123.  
  124.     if ((hg=GlobalAlloc(0, ulSize+sizeof(HGLOBAL)))==0)
  125.         return NULL;
  126.     phg=(HGLOBAL *) GlobalLock(hg);
  127.     *phg=hg;
  128.     return (void *) (phg+1);
  129.     }
  130.  
  131. _st void DebAppFree (void *pv)
  132.     {
  133.     HGLOBAL        *phg=((HGLOBAL *) pv)-1;
  134.  
  135.     GlobalUnlock(*phg);
  136.     GlobalFree(*phg);
  137.     }
  138.  
  139. #endif
  140.  
  141. //------------------ ANY PROGRAM -----------------------
  142. #ifdef _DEBUG
  143. #define Malloc(x)    DebAlloc(x, __FILE__, __LINE__, FALSE, DebAppAlloc)
  144. #define Free(x)        DebFree(x, TRUE, DebAppFree)
  145. #define DebListMem()    DebMem(DebOut)
  146. #endif
  147. #ifndef _DEBUG
  148. #define Malloc(x)    DebAlloc(x, NULL, 0, FALSE, DebAppAlloc)
  149. #define Free(x)        DebFree(x, FALSE, DebAppFree)
  150. #define DebListMem()    ;
  151. #endif
  152.  
  153. #endif DEBUG        // Do no include this file twice
  154.