nasmlib.h
上传用户:yuppie_zhu
上传日期:2007-01-08
资源大小:535k
文件大小:8k
源码类别:

编译器/解释器

开发平台:

C/C++

  1. /* nasmlib.h header file for nasmlib.c
  2.  *
  3.  * The Netwide Assembler is copyright (C) 1996 Simon Tatham and
  4.  * Julian Hall. All rights reserved. The software is
  5.  * redistributable under the licence given in the file "Licence"
  6.  * distributed in the NASM archive.
  7.  */
  8. #ifndef NASM_NASMLIB_H
  9. #define NASM_NASMLIB_H
  10. /*
  11.  * If this is defined, the wrappers around malloc et al will
  12.  * transform into logging variants, which will cause NASM to create
  13.  * a file called `malloc.log' when run, and spew details of all its
  14.  * memory management into that. That can then be analysed to detect
  15.  * memory leaks and potentially other problems too.
  16.  */
  17. /* #define LOGALLOC */
  18. /*
  19.  * Wrappers around malloc, realloc and free. nasm_malloc will
  20.  * fatal-error and die rather than return NULL; nasm_realloc will
  21.  * do likewise, and will also guarantee to work right on being
  22.  * passed a NULL pointer; nasm_free will do nothing if it is passed
  23.  * a NULL pointer.
  24.  */
  25. #ifdef NASM_NASM_H        /* need efunc defined for this */
  26. void nasm_set_malloc_error (efunc);
  27. #ifndef LOGALLOC
  28. void *nasm_malloc (size_t);
  29. void *nasm_realloc (void *, size_t);
  30. void nasm_free (void *);
  31. char *nasm_strdup (char *);
  32. char *nasm_strndup (char *, size_t);
  33. #else
  34. void *nasm_malloc_log (char *, int, size_t);
  35. void *nasm_realloc_log (char *, int, void *, size_t);
  36. void nasm_free_log (char *, int, void *);
  37. char *nasm_strdup_log (char *, int, char *);
  38. char *nasm_strndup_log (char *, int, char *, size_t);
  39. #define nasm_malloc(x) nasm_malloc_log(__FILE__,__LINE__,x)
  40. #define nasm_realloc(x,y) nasm_realloc_log(__FILE__,__LINE__,x,y)
  41. #define nasm_free(x) nasm_free_log(__FILE__,__LINE__,x)
  42. #define nasm_strdup(x) nasm_strdup_log(__FILE__,__LINE__,x)
  43. #define nasm_strndup(x,y) nasm_strndup_log(__FILE__,__LINE__,x,y)
  44. #endif
  45. #endif
  46. /*
  47.  * ANSI doesn't guarantee the presence of `stricmp' or
  48.  * `strcasecmp'.
  49.  */
  50. int nasm_stricmp (const char *, const char *);
  51. int nasm_strnicmp (const char *, const char *, int);
  52. /*
  53.  * Convert a string into a number, using NASM number rules. Sets
  54.  * `*error' to TRUE if an error occurs, and FALSE otherwise.
  55.  */
  56. long readnum(char *str, int *error);
  57. /*
  58.  * Convert a character constant into a number. Sets
  59.  * `*warn' to TRUE if an overflow occurs, and FALSE otherwise.
  60.  * str points to and length covers the middle of the string,
  61.  * without the quotes.
  62.  */
  63. long readstrnum(char *str, int length, int *warn);
  64. /*
  65.  * seg_init: Initialise the segment-number allocator.
  66.  * seg_alloc: allocate a hitherto unused segment number.
  67.  */
  68. void seg_init(void);
  69. long seg_alloc(void);
  70. /*
  71.  * many output formats will be able to make use of this: a standard
  72.  * function to add an extension to the name of the input file
  73.  */
  74. #ifdef NASM_NASM_H
  75. void standard_extension (char *inname, char *outname, char *extension,
  76.  efunc error);
  77. #endif
  78. /*
  79.  * some handy macros that will probably be of use in more than one
  80.  * output format: convert integers into little-endian byte packed
  81.  * format in memory
  82.  */
  83. #define WRITELONG(p,v) 
  84.   do { 
  85.     *(p)++ = (v) & 0xFF; 
  86.     *(p)++ = ((v) >> 8) & 0xFF; 
  87.     *(p)++ = ((v) >> 16) & 0xFF; 
  88.     *(p)++ = ((v) >> 24) & 0xFF; 
  89.   } while (0)
  90. #define WRITESHORT(p,v) 
  91.   do { 
  92.     *(p)++ = (v) & 0xFF; 
  93.     *(p)++ = ((v) >> 8) & 0xFF; 
  94.   } while (0)
  95. /*
  96.  * and routines to do the same thing to a file
  97.  */
  98. void fwriteshort (int data, FILE *fp);
  99. void fwritelong (long data, FILE *fp);
  100. /*
  101.  * Routines to manage a dynamic random access array of longs which
  102.  * may grow in size to be more than the largest single malloc'able
  103.  * chunk.
  104.  */
  105. #define RAA_BLKSIZE 4096        /* this many longs allocated at once */
  106. #define RAA_LAYERSIZE 1024        /* this many _pointers_ allocated */
  107. typedef struct RAA RAA;
  108. typedef union RAA_UNION RAA_UNION;
  109. typedef struct RAA_LEAF RAA_LEAF;
  110. typedef struct RAA_BRANCH RAA_BRANCH;
  111. struct RAA {
  112.     /*
  113.      * Number of layers below this one to get to the real data. 0
  114.      * means this structure is a leaf, holding RAA_BLKSIZE real
  115.      * data items; 1 and above mean it's a branch, holding
  116.      * RAA_LAYERSIZE pointers to the next level branch or leaf
  117.      * structures.
  118.      */
  119.     int layers;
  120.     /*
  121.      * Number of real data items spanned by one position in the
  122.      * `data' array at this level. This number is 1, trivially, for
  123.      * a leaf (level 0): for a level 1 branch it should be
  124.      * RAA_BLKSIZE, and for a level 2 branch it's
  125.      * RAA_LAYERSIZE*RAA_BLKSIZE.
  126.      */
  127.     long stepsize;
  128.     union RAA_UNION {
  129. struct RAA_LEAF {
  130.     long data[RAA_BLKSIZE];
  131. } l;
  132. struct RAA_BRANCH {
  133.     struct RAA *data[RAA_LAYERSIZE];
  134. } b;
  135.     } u;
  136. };
  137. struct RAA *raa_init (void);
  138. void raa_free (struct RAA *);
  139. long raa_read (struct RAA *, long);
  140. struct RAA *raa_write (struct RAA *r, long posn, long value);
  141. /*
  142.  * Routines to manage a dynamic sequential-access array, under the
  143.  * same restriction on maximum mallocable block. This array may be
  144.  * written to in two ways: a contiguous chunk can be reserved of a
  145.  * given size, and a pointer returned, or single-byte data may be
  146.  * written. The array can also be read back in the same two ways:
  147.  * as a series of big byte-data blocks or as a list of structures
  148.  * of a given size.
  149.  */
  150. struct SAA {
  151.     /*
  152.      * members `end' and `elem_len' are only valid in first link in
  153.      * list; `rptr' and `rpos' are used for reading
  154.      */
  155.     struct SAA *next, *end, *rptr;
  156.     long elem_len, length, posn, start, rpos;
  157.     char *data;
  158. };
  159. struct SAA *saa_init (long elem_len);  /* 1 == byte */
  160. void saa_free (struct SAA *);
  161. void *saa_wstruct (struct SAA *);      /* return a structure of elem_len */
  162. void saa_wbytes (struct SAA *, void *, long);  /* write arbitrary bytes */
  163. void saa_rewind (struct SAA *);        /* for reading from beginning */
  164. void *saa_rstruct (struct SAA *);      /* return NULL on EOA */
  165. void *saa_rbytes (struct SAA *, long *);   /* return 0 on EOA */
  166. void saa_rnbytes (struct SAA *, void *, long); /* read a given no. of bytes */
  167. void saa_fread (struct SAA *s, long posn, void *p, long len);   /* fixup */
  168. void saa_fwrite (struct SAA *s, long posn, void *p, long len);   /* fixup */
  169. void saa_fpwrite (struct SAA *, FILE *);
  170. #ifdef NASM_NASM_H
  171. /*
  172.  * Standard scanner.
  173.  */
  174. extern char *stdscan_bufptr;
  175. void stdscan_reset(void);
  176. int stdscan (void *private_data, struct tokenval *tv);
  177. #endif
  178. #ifdef NASM_NASM_H
  179. /*
  180.  * Library routines to manipulate expression data types.
  181.  */
  182. int is_reloc(expr *);
  183. int is_simple(expr *);
  184. int is_really_simple (expr *);
  185. int is_unknown(expr *);
  186. int is_just_unknown(expr *);
  187. long reloc_value(expr *);
  188. long reloc_seg(expr *);
  189. long reloc_wrt(expr *);
  190. #endif
  191. /*
  192.  * Binary search routine. Returns index into `array' of an entry
  193.  * matching `string', or <0 if no match. `array' is taken to
  194.  * contain `size' elements.
  195.  */
  196. int bsi (char *string, char **array, int size);
  197. char *src_set_fname(char *newname);
  198. long src_set_linnum(long newline);
  199. long src_get_linnum(void);
  200. /*
  201.  * src_get may be used if you simply want to know the source file and line.
  202.  * It is also used if you maintain private status about the source location
  203.  * It return 0 if the information was the same as the last time you
  204.  * checked, -1 if the name changed and (new-old) if just the line changed.
  205.  */
  206. int src_get(long *xline, char **xname);
  207. void nasm_quote(char **str);
  208. char *nasm_strcat(char *one, char *two);
  209. void nasmlib_cleanup(void);
  210. void null_debug_routine();
  211. extern struct dfmt null_debug_form;
  212. extern struct dfmt *null_debug_arr[2];
  213. #endif