]> git.xonotic.org Git - xonotic/gmqcc.git/blob - gmqcc.h
ee9853e6305e9fec4a6a040b663df2c7aca6ae48
[xonotic/gmqcc.git] / gmqcc.h
1 /*
2  * Copyright (C) 2012
3  *     Dale Weiler
4  *     Wolfgang Bumiller
5  *
6  * Permission is hereby granted, free of charge, to any person obtaining a copy of
7  * this software and associated documentation files (the "Software"), to deal in
8  * the Software without restriction, including without limitation the rights to
9  * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
10  * of the Software, and to permit persons to whom the Software is furnished to do
11  * so, subject to the following conditions:
12  *
13  * The above copyright notice and this permission notice shall be included in all
14  * copies or substantial portions of the Software.
15  *
16  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22  * SOFTWARE.
23  */
24 #ifndef GMQCC_HDR
25 #define GMQCC_HDR
26 #include <limits.h>
27 #include <stdlib.h>
28 #include <string.h>
29 #include <stdio.h>
30 #include <stdarg.h>
31 #include <ctype.h>
32
33 /*
34  * Disable some over protective warnings in visual studio because fixing them is a waste
35  * of my time.
36  */
37 #ifdef _MSC_VER
38 #       pragma warning(disable : 4244 ) /* conversion from 'int' to 'float', possible loss of data */
39 #       pragma warning(disable : 4018 ) /* signed/unsigned mismatch                                */
40 #       pragma warning(disable : 4996 ) /* This function or variable may be unsafe                 */
41 #       pragma warning(disable : 4700 ) /* uninitialized local variable used                       */
42 #endif
43
44 #define GMQCC_VERSION_MAJOR 0
45 #define GMQCC_VERSION_MINOR 2
46 #define GMQCC_VERSION_PATCH 0
47 #define GMQCC_VERSION_BUILD(J,N,P) (((J)<<16)|((N)<<8)|(P))
48 #define GMQCC_VERSION \
49     GMQCC_VERSION_BUILD(GMQCC_VERSION_MAJOR, GMQCC_VERSION_MINOR, GMQCC_VERSION_PATCH)
50
51 /*
52  * We cannoy rely on C99 at all, since compilers like MSVC
53  * simply don't support it.  We define our own boolean type
54  * as a result (since we cannot include <stdbool.h>). For
55  * compilers that are in 1999 mode (C99 compliant) we can use
56  * the language keyword _Bool which can allow for better code
57  * on GCC and GCC-like compilers, opposed to `int`.
58  */
59 #ifndef __cplusplus
60 #   ifdef  false
61 #       undef  false
62 #   endif /* !false */
63 #   ifdef  true
64 #       undef true
65 #   endif /* !true  */
66 #   define false (0)
67 #   define true  (1)
68 #   ifdef __STDC_VERSION__
69 #       if __STDC_VERSION__ < 199901L && __GNUC__ < 3
70             typedef int  bool;
71 #       else
72             typedef _Bool bool;
73 #       endif
74 #   else
75         typedef int bool;
76 #   endif /* !__STDC_VERSION__ */
77 #endif    /* !__cplusplus      */
78
79 /*
80  * Of some functions which are generated we want to make sure
81  * that the result isn't ignored. To find such function calls,
82  * we use this macro.
83  */
84 #if defined(__GNUC__) || defined(__CLANG__)
85 #   define GMQCC_WARN __attribute__((warn_unused_result))
86 #else
87 #   define GMQCC_WARN
88 #endif
89 /*
90  * This is a hack to silent clang regarding empty
91  * body if statements.
92  */
93 #define GMQCC_SUPPRESS_EMPTY_BODY do { } while (0)
94
95 /*
96  * Inline is not supported in < C90, however some compilers
97  * like gcc and clang might have an inline attribute we can
98  * use if present.
99  */
100 #ifdef __STDC_VERSION__
101 #    if __STDC_VERSION__ < 199901L
102 #       if defined(__GNUC__) || defined (__CLANG__)
103 #           if __GNUC__ < 2
104 #               define GMQCC_INLINE
105 #           else
106 #               define GMQCC_INLINE __attribute__ ((always_inline))
107 #           endif
108 #       else
109 #           define GMQCC_INLINE
110 #       endif
111 #    else
112 #       define GMQCC_INLINE inline
113 #    endif
114 /*
115  * Visual studio has __forcinline we can use.  So lets use that
116  * I suspect it also has just __inline of some sort, but our use
117  * of inline is correct (not guessed), WE WANT IT TO BE INLINE
118  */
119 #elif defined(_MSC_VER)
120 #    define GMQCC_INLINE __forceinline
121 #else
122 #    define GMQCC_INLINE
123 #endif /* !__STDC_VERSION__ */
124
125 /*
126  * noreturn is present in GCC and clang
127  * it's required for _ast_node_destory otherwise -Wmissing-noreturn
128  * in clang complains about there being no return since abort() is
129  * called.
130  */
131 #if (defined(__GNUC__) && __GNUC__ >= 2) || defined(__CLANG__)
132 #    define GMQCC_NORETURN __attribute__ ((noreturn))
133 #else
134 #    define GMQCC_NORETURN
135 #endif
136
137 /*
138  * stdint.h and inttypes.h -less subset
139  * for systems that don't have it, which we must
140  * assume is all systems. (int8_t not required)
141  */
142 #if __STDC_VERSION__ < 199901L
143 #   if   CHAR_MIN  == -128
144         typedef unsigned char  uint8_t; /* same as below */
145 #   elif SCHAR_MIN == -128
146         typedef unsigned char  uint8_t; /* same as above */
147 #   endif
148 #   if   SHRT_MAX  == 0x7FFF
149         typedef short          int16_t;
150         typedef unsigned short uint16_t;
151 #   elif INT_MAX   == 0x7FFF
152         typedef int            int16_t;
153         typedef unsigned int   uint16_t;
154 #   endif
155 #   if   INT_MAX   == 0x7FFFFFFF
156         typedef int            int32_t;
157         typedef unsigned int   uint32_t;
158 #   elif LONG_MAX  == 0x7FFFFFFF
159         typedef long           int32_t;
160         typedef unsigned long  uint32_t;
161 #   endif
162
163 #   if defined(__GNUC__) || defined (__CLANG__)
164         typedef int              int64_t  __attribute__((__mode__(__DI__)));
165         typedef unsigned int     uint64_t __attribute__((__mode__(__DI__)));
166 #   elif defined(_MSC_VER)
167         typedef __int64          int64_t;
168         typedef unsigned __int64 uint64_t;
169 #   else
170         /*
171         * Incorrectly size the types so static assertions below will
172         * fail.  There is no valid way to get a 64bit type at this point
173         * without making assumptions of too many things.
174         */
175         typedef struct { char _fail : 0; } int64_t;
176         typedef struct { char _fail : 0; } uint64_t;
177 #   endif
178     /* Ensure type sizes are correct: */
179     typedef char uint8_size_is_correct  [sizeof(uint8_t)  == 1?1:-1];
180     typedef char uint16_size_is_correct [sizeof(uint16_t) == 2?1:-1];
181     typedef char uint32_size_is_correct [sizeof(uint32_t) == 4?1:-1];
182     typedef char uint64_size_is_correct [sizeof(uint64_t) == 8?1:-1];
183     typedef char int16_size_if_correct  [sizeof(int16_t)  == 2?1:-1];
184     typedef char int32_size_is_correct  [sizeof(int32_t)  == 4?1:-1];
185     typedef char int64_size_is_correct  [sizeof(int64_t)  >= 8?1:-1];
186 #else
187 #   include <stdint.h>
188 #endif
189
190 /*===================================================================*/
191 /*=========================== util.c ================================*/
192 /*===================================================================*/
193 FILE *util_fopen(const char *filename, const char *mode);
194
195 void *util_memory_a      (size_t,       unsigned int, const char *);
196 void  util_memory_d      (void       *, unsigned int, const char *);
197 void *util_memory_r      (void       *, size_t,       unsigned int, const char *);
198 void  util_meminfo       ();
199
200 bool  util_filexists     (const char *);
201 bool  util_strupper      (const char *);
202 bool  util_strdigit      (const char *);
203 bool  util_strncmpexact  (const char *, const char *, size_t);
204 char *util_strdup        (const char *);
205 char *util_strrq         (const char *);
206 char *util_strrnl        (const char *);
207 char *util_strsws        (const char *);
208 char *util_strchp        (const char *, const char *);
209 void  util_debug         (const char *, const char *, ...);
210 int   util_getline       (char **, size_t *, FILE *);
211 void  util_endianswap    (void *,  int, int);
212
213 size_t util_strtocmd    (const char *, char *, size_t);
214 size_t util_strtononcmd (const char *, char *, size_t);
215
216 uint16_t util_crc16(uint16_t crc, const char *data, size_t len);
217 uint32_t util_crc32(uint32_t crc, const char *data, size_t len);
218
219 #ifdef NOTRACK
220 #    define mem_a(x)    malloc (x)
221 #    define mem_d(x)    free   (x)
222 #    define mem_r(x, n) realloc(x, n)
223 #else
224 #    define mem_a(x)    util_memory_a((x), __LINE__, __FILE__)
225 #    define mem_d(x)    util_memory_d((x), __LINE__, __FILE__)
226 #    define mem_r(x, n) util_memory_r((x), (n), __LINE__, __FILE__)
227 #endif
228
229 /*
230  * TODO: make these safer to use.  Currently this only works on
231  * x86 and x86_64, some systems will likely not like this. Such
232  * as BE systems.
233  */
234 #define FLT2INT(Y) *((int32_t*)&(Y))
235 #define INT2FLT(Y) *((float  *)&(Y))
236
237 /* New flexible vector implementation from Dale */
238 #define _vec_raw(A) (((size_t*)(void*)(A)) - 2)
239 #define _vec_beg(A) (_vec_raw(A)[0])
240 #define _vec_end(A) (_vec_raw(A)[1])
241 #define _vec_needsgrow(A,N) ((!(A)) || (_vec_end(A) + (N) >= _vec_beg(A)))
242 #define _vec_mightgrow(A,N) (_vec_needsgrow((A), (N)) ? (void)_vec_forcegrow((A),(N)) : (void)0)
243 #define _vec_forcegrow(A,N) _util_vec_grow(((void**)&(A)), (N), sizeof(*(A)))
244 #define _vec_remove(A,S,I,N) (memmove((char*)(A)+(I)*(S),(char*)(A)+((I)+(N))*(S),(S)*(_vec_end(A)-(I)-(N))), _vec_end(A)-=(N))
245 void _util_vec_grow(void **a, size_t i, size_t s);
246 /* exposed interface */
247 #define vec_free(A)          ((A) ? (mem_d((void*)_vec_raw(A)), (A) = NULL) : 0)
248 #define vec_push(A,V)        (_vec_mightgrow((A),1), (A)[_vec_end(A)++] = (V))
249 #define vec_size(A)          ((A) ? _vec_end(A) : 0)
250 #define vec_add(A,N)         (_vec_mightgrow((A),(N)), _vec_end(A)+=(N), &(A)[_vec_end(A)-(N)])
251 #define vec_last(A)          ((A)[_vec_end(A)-1])
252 #define vec_append(A,N,S)    memcpy(vec_add((A), (N)), (S), N * sizeof(*(S)))
253 #define vec_remove(A,I,N)    _vec_remove((A), sizeof(*(A)), (I), (N))
254 #define vec_pop(A)           (_vec_end(A)-=1)
255 /* these are supposed to NOT reallocate */
256 #define vec_shrinkto(A,N)    (_vec_end(A) = (N))
257 #define vec_shrinkby(A,N)    (_vec_end(A) -= (N))
258
259 #define vec_upload(X,Y,S)      \
260     do {                       \
261         size_t E = 0;          \
262         while (E < S) {        \
263             vec_push(X, Y[E]); \
264             E ++;              \
265         }                      \
266     } while(0)
267
268 typedef struct hash_table_t {
269     size_t                size;
270     struct hash_node_t **table;
271 } hash_table_t, *ht;
272
273 /*
274  * hashtable implementation:
275  *
276  * Note:
277  *      This was designed for pointers:  you manage the life of the object yourself
278  *      if you do use this for non-pointers please be warned that the object may not
279  *      be valid if the duration of it exceeds (i.e on stack).  So you need to allocate
280  *      yourself, or put those in global scope to ensure duration is for the whole
281  *      runtime.
282  *
283  * util_htnew(size)                             -- to make a new hashtable
284  * util_htset(table, key, value, sizeof(value)) -- to set something in the table
285  * util_htget(table, key)                       -- to get something from the table
286  * util_htdel(table)                            -- to delete the table
287  *
288  * example of use:
289  *
290  * ht    foo  = util_htnew(1024);
291  * int   data = 100;
292  * char *test = "hello world\n";
293  * util_htset(foo, "foo", (void*)&data);
294  * util_gtset(foo, "bar", (void*)test);
295  *
296  * printf("foo: %d, bar %s",
297  *     *((int *)util_htget(foo, "foo")),
298  *      ((char*)util_htget(foo, "bar"))
299  * );
300  *
301  * util_htdel(foo);
302  */
303 hash_table_t *util_htnew (size_t size);
304 void          util_htset (hash_table_t *ht, const char *key, void *value);
305 void         *util_htget (hash_table_t *ht, const char *key);
306 void          util_htdel (hash_table_t *ht);
307 size_t        util_hthash(hash_table_t *ht, const char *key);
308 void         *util_htgeth(hash_table_t *ht, const char *key, size_t hash);
309 void          util_htseth(hash_table_t *ht, const char *key, size_t hash, void *value);
310 /*===================================================================*/
311 /*=========================== code.c ================================*/
312 /*===================================================================*/
313
314 /* Note: if you change the order, fix type_sizeof in ir.c */
315 enum {
316     TYPE_VOID     ,
317     TYPE_STRING   ,
318     TYPE_FLOAT    ,
319     TYPE_VECTOR   ,
320     TYPE_ENTITY   ,
321     TYPE_FIELD    ,
322     TYPE_FUNCTION ,
323     TYPE_POINTER  ,
324     TYPE_INTEGER  ,
325     TYPE_VARIANT  ,
326     TYPE_STRUCT   ,
327     TYPE_UNION    ,
328     TYPE_ARRAY    ,
329
330     TYPE_COUNT
331 };
332
333 /* const/var qualifiers */
334 #define CV_NONE  0
335 #define CV_CONST 1
336 #define CV_VAR  -1
337 /* magic number to help parsing */
338 #define CV_WRONG  0x8000
339
340 extern const char *type_name        [TYPE_COUNT];
341 extern size_t      type_sizeof      [TYPE_COUNT];
342 extern uint16_t    type_store_instr [TYPE_COUNT];
343 extern uint16_t    field_store_instr[TYPE_COUNT];
344
345 /*
346  * could use type_store_instr + INSTR_STOREP_F - INSTR_STORE_F
347  * but this breaks when TYPE_INTEGER is added, since with the enhanced
348  * instruction set, the old ones are left untouched, thus the _I instructions
349  * are at a seperate place.
350  */
351 extern uint16_t type_storep_instr[TYPE_COUNT];
352 extern uint16_t type_eq_instr    [TYPE_COUNT];
353 extern uint16_t type_ne_instr    [TYPE_COUNT];
354 extern uint16_t type_not_instr   [TYPE_COUNT];
355
356 typedef struct {
357     uint32_t offset;      /* Offset in file of where data begins  */
358     uint32_t length;      /* Length of section (how many of)      */
359 } prog_section;
360
361 typedef struct {
362     uint32_t     version;      /* Program version (6)     */
363     uint16_t     crc16;
364     uint16_t     skip;
365
366     prog_section statements;   /* prog_section_statement  */
367     prog_section defs;         /* prog_section_def        */
368     prog_section fields;       /* prog_section_field      */
369     prog_section functions;    /* prog_section_function   */
370     prog_section strings;
371     prog_section globals;
372     uint32_t     entfield;     /* Number of entity fields */
373 } prog_header;
374
375 /*
376  * Each paramater incerements by 3 since vector types hold
377  * 3 components (x,y,z).
378  */
379 #define OFS_NULL      0
380 #define OFS_RETURN    1
381 #define OFS_PARM0     (OFS_RETURN+3)
382 #define OFS_PARM1     (OFS_PARM0 +3)
383 #define OFS_PARM2     (OFS_PARM1 +3)
384 #define OFS_PARM3     (OFS_PARM2 +3)
385 #define OFS_PARM4     (OFS_PARM3 +3)
386 #define OFS_PARM5     (OFS_PARM4 +3)
387 #define OFS_PARM6     (OFS_PARM5 +3)
388 #define OFS_PARM7     (OFS_PARM6 +3)
389
390 typedef struct {
391     uint16_t opcode;
392
393     /* operand 1 */
394     union {
395         int16_t  s1; /* signed   */
396         uint16_t u1; /* unsigned */
397     } o1;
398     /* operand 2 */
399     union {
400         int16_t  s1; /* signed   */
401         uint16_t u1; /* unsigned */
402     } o2;
403     /* operand 3 */
404     union {
405         int16_t  s1; /* signed   */
406         uint16_t u1; /* unsigned */
407     } o3;
408
409     /*
410      * This is the same as the structure in darkplaces
411      * {
412      *     unsigned short op;
413      *     short          a,b,c;
414      * }
415      * But this one is more sane to work with, and the
416      * type sizes are guranteed.
417      */
418 } prog_section_statement;
419
420 typedef struct {
421     /*
422      * The types:
423      * 0 = ev_void
424      * 1 = ev_string
425      * 2 = ev_float
426      * 3 = ev_vector
427      * 4 = ev_entity
428      * 5 = ev_field
429      * 6 = ev_function
430      * 7 = ev_pointer -- engine only
431      * 8 = ev_bad     -- engine only
432      */
433     uint16_t type;
434     uint16_t offset;
435     uint32_t name;
436 } prog_section_both;
437
438 typedef prog_section_both prog_section_def;
439 typedef prog_section_both prog_section_field;
440
441 /* this is ORed to the type */
442 #define DEF_SAVEGLOBAL (1<<15)
443 #define DEF_TYPEMASK   ((1<<15)-1)
444
445 typedef struct {
446     int32_t   entry;      /* in statement table for instructions  */
447     uint32_t  firstlocal; /* First local in local table           */
448     uint32_t  locals;     /* Total ints of params + locals        */
449     uint32_t  profile;    /* Always zero (engine uses this)       */
450     uint32_t  name;       /* name of function in string table     */
451     uint32_t  file;       /* file of the source file              */
452     int32_t   nargs;      /* number of arguments                  */
453     uint8_t   argsize[8]; /* size of arguments (keep 8 always?)   */
454 } prog_section_function;
455
456 /*
457  * Instructions
458  * These are the external instructions supported by the interperter
459  * this is what things compile to (from the C code).
460  */
461 enum {
462     INSTR_DONE,
463     INSTR_MUL_F,
464     INSTR_MUL_V,
465     INSTR_MUL_FV, /* NOTE: the float operands must NOT be at the same locations: A != C */
466     INSTR_MUL_VF, /* and here: B != C */
467     INSTR_DIV_F,
468     INSTR_ADD_F,
469     INSTR_ADD_V,
470     INSTR_SUB_F,
471     INSTR_SUB_V,
472     INSTR_EQ_F,
473     INSTR_EQ_V,
474     INSTR_EQ_S,
475     INSTR_EQ_E,
476     INSTR_EQ_FNC,
477     INSTR_NE_F,
478     INSTR_NE_V,
479     INSTR_NE_S,
480     INSTR_NE_E,
481     INSTR_NE_FNC,
482     INSTR_LE,
483     INSTR_GE,
484     INSTR_LT,
485     INSTR_GT,
486     INSTR_LOAD_F,
487     INSTR_LOAD_V,
488     INSTR_LOAD_S,
489     INSTR_LOAD_ENT,
490     INSTR_LOAD_FLD,
491     INSTR_LOAD_FNC,
492     INSTR_ADDRESS,
493     INSTR_STORE_F,
494     INSTR_STORE_V,
495     INSTR_STORE_S,
496     INSTR_STORE_ENT,
497     INSTR_STORE_FLD,
498     INSTR_STORE_FNC,
499     INSTR_STOREP_F,
500     INSTR_STOREP_V,
501     INSTR_STOREP_S,
502     INSTR_STOREP_ENT,
503     INSTR_STOREP_FLD,
504     INSTR_STOREP_FNC,
505     INSTR_RETURN,
506     INSTR_NOT_F,
507     INSTR_NOT_V,
508     INSTR_NOT_S,
509     INSTR_NOT_ENT,
510     INSTR_NOT_FNC,
511     INSTR_IF,
512     INSTR_IFNOT,
513     INSTR_CALL0,
514     INSTR_CALL1,
515     INSTR_CALL2,
516     INSTR_CALL3,
517     INSTR_CALL4,
518     INSTR_CALL5,
519     INSTR_CALL6,
520     INSTR_CALL7,
521     INSTR_CALL8,
522     INSTR_STATE,
523     INSTR_GOTO,
524     INSTR_AND,
525     INSTR_OR,
526     INSTR_BITAND,
527     INSTR_BITOR,
528
529     /*
530      * Virtual instructions used by the assembler
531      * keep at the end but before virtual instructions
532      * for the IR below.
533      */
534     AINSTR_END,
535
536     /*
537      * Virtual instructions used by the IR
538      * Keep at the end!
539      */
540     VINSTR_PHI,
541     VINSTR_JUMP,
542     VINSTR_COND,
543     /* A never returning CALL.
544      * Creating this causes IR blocks to be marked as 'final'.
545      * No-Return-Call
546      */
547     VINSTR_NRCALL
548 };
549
550 extern prog_section_statement *code_statements;
551 extern int                    *code_linenums;
552 extern prog_section_def       *code_defs;
553 extern prog_section_field     *code_fields;
554 extern prog_section_function  *code_functions;
555 extern int                    *code_globals;
556 extern char                   *code_chars;
557 extern uint16_t code_crc;
558
559 typedef float   qcfloat;
560 typedef int32_t qcint;
561
562 /*
563  * code_write -- writes out the compiled file
564  * code_init  -- prepares the code file
565  */
566 bool     code_write       (const char *filename, const char *lno);
567 void     code_init        ();
568 uint32_t code_genstring   (const char *string);
569 uint32_t code_cachedstring(const char *string);
570 qcint    code_alloc_field (size_t qcsize);
571
572 /* this function is used to keep statements and linenumbers together */
573 void     code_push_statement(prog_section_statement *stmt, int linenum);
574 void     code_pop_statement();
575
576 /*
577  * A shallow copy of a lex_file to remember where which ast node
578  * came from.
579  */
580 typedef struct {
581     const char *file;
582     size_t      line;
583 } lex_ctx;
584
585 /*===================================================================*/
586 /*============================ con.c ================================*/
587 /*===================================================================*/
588 enum {
589     CON_BLACK   = 30,
590     CON_RED,
591     CON_GREEN,
592     CON_BROWN,
593     CON_BLUE,
594     CON_MAGENTA,
595     CON_CYAN ,
596     CON_WHITE
597 };
598
599 /* message level */
600 enum {
601     LVL_MSG,
602     LVL_WARNING,
603     LVL_ERROR
604 };
605
606 void con_vprintmsg (int level, const char *name, size_t line, const char *msgtype, const char *msg, va_list ap);
607 void con_printmsg  (int level, const char *name, size_t line, const char *msgtype, const char *msg, ...);
608 void con_cvprintmsg(void *ctx, int lvl, const char *msgtype, const char *msg, va_list ap);
609 void con_cprintmsg (void *ctx, int lvl, const char *msgtype, const char *msg, ...);
610
611 void con_close ();
612 void con_init  ();
613 void con_reset ();
614 void con_color (int);
615 int  con_change(const char *, const char *);
616 int  con_verr  (const char *, va_list);
617 int  con_vout  (const char *, va_list);
618 int  con_err   (const char *, ...);
619 int  con_out   (const char *, ...);
620
621 /* error/warning interface */
622 extern size_t compile_errors;
623 extern size_t compile_warnings;
624
625 void /********/ compile_error   (lex_ctx ctx, /*LVL_ERROR*/ const char *msg, ...);
626 void /********/ vcompile_error  (lex_ctx ctx, /*LVL_ERROR*/ const char *msg, va_list ap);
627 bool GMQCC_WARN compile_warning (lex_ctx ctx, int warntype, const char *fmt, ...);
628 bool GMQCC_WARN vcompile_warning(lex_ctx ctx, int warntype, const char *fmt, va_list ap);
629
630 /*===================================================================*/
631 /*========================= assembler.c =============================*/
632 /*===================================================================*/
633 static const struct {
634     const char  *m; /* menomic     */
635     const size_t o; /* operands    */
636     const size_t l; /* menomic len */
637 } asm_instr[] = {
638     { "DONE"      , 1, 4 },
639     { "MUL_F"     , 3, 5 },
640     { "MUL_V"     , 3, 5 },
641     { "MUL_FV"    , 3, 6 },
642     { "MUL_VF"    , 3, 6 },
643     { "DIV"       , 0, 3 },
644     { "ADD_F"     , 3, 5 },
645     { "ADD_V"     , 3, 5 },
646     { "SUB_F"     , 3, 5 },
647     { "SUB_V"     , 3, 5 },
648     { "EQ_F"      , 0, 4 },
649     { "EQ_V"      , 0, 4 },
650     { "EQ_S"      , 0, 4 },
651     { "EQ_E"      , 0, 4 },
652     { "EQ_FNC"    , 0, 6 },
653     { "NE_F"      , 0, 4 },
654     { "NE_V"      , 0, 4 },
655     { "NE_S"      , 0, 4 },
656     { "NE_E"      , 0, 4 },
657     { "NE_FNC"    , 0, 6 },
658     { "LE"        , 0, 2 },
659     { "GE"        , 0, 2 },
660     { "LT"        , 0, 2 },
661     { "GT"        , 0, 2 },
662     { "FIELD_F"   , 0, 7 },
663     { "FIELD_V"   , 0, 7 },
664     { "FIELD_S"   , 0, 7 },
665     { "FIELD_ENT" , 0, 9 },
666     { "FIELD_FLD" , 0, 9 },
667     { "FIELD_FNC" , 0, 9 },
668     { "ADDRESS"   , 0, 7 },
669     { "STORE_F"   , 0, 7 },
670     { "STORE_V"   , 0, 7 },
671     { "STORE_S"   , 0, 7 },
672     { "STORE_ENT" , 0, 9 },
673     { "STORE_FLD" , 0, 9 },
674     { "STORE_FNC" , 0, 9 },
675     { "STOREP_F"  , 0, 8 },
676     { "STOREP_V"  , 0, 8 },
677     { "STOREP_S"  , 0, 8 },
678     { "STOREP_ENT", 0, 10},
679     { "STOREP_FLD", 0, 10},
680     { "STOREP_FNC", 0, 10},
681     { "RETURN"    , 0, 6 },
682     { "NOT_F"     , 0, 5 },
683     { "NOT_V"     , 0, 5 },
684     { "NOT_S"     , 0, 5 },
685     { "NOT_ENT"   , 0, 7 },
686     { "NOT_FNC"   , 0, 7 },
687     { "IF"        , 0, 2 },
688     { "IFNOT"     , 0, 5 },
689     { "CALL0"     , 1, 5 },
690     { "CALL1"     , 2, 5 },
691     { "CALL2"     , 3, 5 },
692     { "CALL3"     , 4, 5 },
693     { "CALL4"     , 5, 5 },
694     { "CALL5"     , 6, 5 },
695     { "CALL6"     , 7, 5 },
696     { "CALL7"     , 8, 5 },
697     { "CALL8"     , 9, 5 },
698     { "STATE"     , 0, 5 },
699     { "GOTO"      , 0, 4 },
700     { "AND"       , 0, 3 },
701     { "OR"        , 0, 2 },
702     { "BITAND"    , 0, 6 },
703     { "BITOR"     , 0, 5 },
704
705     { "END"       , 0, 3 } /* virtual assembler instruction */
706 };
707 /*===================================================================*/
708 /*============================= ir.c ================================*/
709 /*===================================================================*/
710
711 enum store_types {
712     store_global,
713     store_local,  /* local, assignable for now, should get promoted later */
714     store_param,  /* parameters, they are locals with a fixed position */
715     store_value,  /* unassignable */
716     store_return  /* unassignable, at OFS_RETURN */
717 };
718
719 typedef struct {
720     qcfloat x, y, z;
721 } vector;
722
723 vector  vec3_add  (vector, vector);
724 vector  vec3_sub  (vector, vector);
725 qcfloat vec3_mulvv(vector, vector);
726 vector  vec3_mulvf(vector, float);
727
728 /*===================================================================*/
729 /*============================= exec.c ==============================*/
730 /*===================================================================*/
731
732 /*
733  * Darkplaces has (or will have) a 64 bit prog loader
734  * where the 32 bit qc program is autoconverted on load.
735  * Since we may want to support that as well, let's redefine
736  * float and int here.
737  */
738 typedef union {
739     qcint   _int;
740     qcint    string;
741     qcint    function;
742     qcint    edict;
743     qcfloat _float;
744     qcfloat vector[3];
745     qcint   ivector[3];
746 } qcany;
747
748 typedef char qcfloat_size_is_correct [sizeof(qcfloat) == 4 ?1:-1];
749 typedef char qcint_size_is_correct   [sizeof(qcint)   == 4 ?1:-1];
750
751 enum {
752     VMERR_OK,
753     VMERR_TEMPSTRING_ALLOC,
754
755     VMERR_END
756 };
757
758 #define VM_JUMPS_DEFAULT 1000000
759
760 /* execute-flags */
761 #define VMXF_DEFAULT 0x0000     /* default flags - nothing */
762 #define VMXF_TRACE   0x0001     /* trace: print statements before executing */
763 #define VMXF_PROFILE 0x0002     /* profile: increment the profile counters */
764
765 struct qc_program_s;
766
767 typedef int (*prog_builtin)(struct qc_program_s *prog);
768
769 typedef struct {
770     qcint                  stmt;
771     size_t                 localsp;
772     prog_section_function *function;
773 } qc_exec_stack;
774
775 typedef struct qc_program_s {
776     char           *filename;
777
778     prog_section_statement *code;
779     prog_section_def       *defs;
780     prog_section_def       *fields;
781     prog_section_function  *functions;
782     char                   *strings;
783     qcint                  *globals;
784     qcint                  *entitydata;
785     bool                   *entitypool;
786
787     const char*            *function_stack;
788
789     uint16_t crc16;
790
791     size_t tempstring_start;
792     size_t tempstring_at;
793
794     qcint  vmerror;
795
796     size_t *profile;
797
798     prog_builtin *builtins;
799     size_t        builtins_count;
800
801     /* size_t ip; */
802     qcint  entities;
803     size_t entityfields;
804     bool   allowworldwrites;
805
806     qcint         *localstack;
807     qc_exec_stack *stack;
808     size_t statement;
809
810     size_t xflags;
811
812     int    argc; /* current arg count for debugging */
813 } qc_program;
814
815 qc_program* prog_load(const char *filename);
816 void        prog_delete(qc_program *prog);
817
818 bool prog_exec(qc_program *prog, prog_section_function *func, size_t flags, long maxjumps);
819
820 char*             prog_getstring (qc_program *prog, qcint str);
821 prog_section_def* prog_entfield  (qc_program *prog, qcint off);
822 prog_section_def* prog_getdef    (qc_program *prog, qcint off);
823 qcany*            prog_getedict  (qc_program *prog, qcint e);
824 qcint             prog_tempstring(qc_program *prog, const char *_str);
825
826
827 /*===================================================================*/
828 /*===================== parser.c commandline ========================*/
829 /*===================================================================*/
830
831 bool parser_init          ();
832 bool parser_compile_file  (const char *filename);
833 bool parser_compile_string(const char *name, const char *str);
834 bool parser_finish        (const char *output);
835 void parser_cleanup       ();
836 /* There's really no need to strlen() preprocessed files */
837 bool parser_compile_string_len(const char *name, const char *str, size_t len);
838
839 /*===================================================================*/
840 /*====================== ftepp.c commandline ========================*/
841 /*===================================================================*/
842 bool ftepp_init             ();
843 bool ftepp_preprocess_file  (const char *filename);
844 bool ftepp_preprocess_string(const char *name, const char *str);
845 void ftepp_finish           ();
846 const char *ftepp_get       ();
847 void ftepp_flush            ();
848 void ftepp_add_define       (const char *source, const char *name);
849 void ftepp_add_macro        (const char *name,   const char *value);
850
851 /*===================================================================*/
852 /*======================= main.c commandline ========================*/
853 /*===================================================================*/
854
855 #if 0
856 /* Helpers to allow for a whole lot of flags. Otherwise we'd limit
857  * to 32 or 64 -f options...
858  */
859 typedef struct {
860     size_t  idx; /* index into an array of 32 bit words */
861     uint8_t bit; /* index _into_ the 32 bit word, thus just uint8 */
862 } longbit;
863 #define LONGBIT(bit) { ((bit)/32), ((bit)%32) }
864 #else
865 typedef uint32_t longbit;
866 #define LONGBIT(bit) (bit)
867 #endif
868
869 /*===================================================================*/
870 /*============================= opts.c ==============================*/
871 /*===================================================================*/
872 typedef struct {
873     const char *name;
874     longbit     bit;
875 } opts_flag_def;
876
877 bool opts_setflag (const char *, bool);
878 bool opts_setwarn (const char *, bool);
879 bool opts_setoptim(const char *, bool);
880
881 void opts_init         (const char *, int, size_t);
882 void opts_set          (uint32_t   *, size_t, bool);
883 void opts_setoptimlevel(unsigned int);
884 void opts_ini_init     (const char *);
885
886 enum {
887 # define GMQCC_TYPE_FLAGS
888 # define GMQCC_DEFINE_FLAG(X) X,
889 #  include "opts.def"
890     COUNT_FLAGS
891 };
892 static const opts_flag_def opts_flag_list[] = {
893 # define GMQCC_TYPE_FLAGS
894 # define GMQCC_DEFINE_FLAG(X) { #X, LONGBIT(X) },
895 #  include "opts.def"
896     { NULL, LONGBIT(0) }
897 };
898
899 enum {
900 # define GMQCC_TYPE_WARNS
901 # define GMQCC_DEFINE_FLAG(X) WARN_##X,
902 #  include "opts.def"
903     COUNT_WARNINGS
904 };
905 static const opts_flag_def opts_warn_list[] = {
906 # define GMQCC_TYPE_WARNS
907 # define GMQCC_DEFINE_FLAG(X) { #X, LONGBIT(WARN_##X) },
908 #  include "opts.def"
909     { NULL, LONGBIT(0) }
910 };
911
912 enum {
913 # define GMQCC_TYPE_OPTIMIZATIONS
914 # define GMQCC_DEFINE_FLAG(NAME, MIN_O) OPTIM_##NAME,
915 #  include "opts.def"
916     COUNT_OPTIMIZATIONS
917 };
918 static const opts_flag_def opts_opt_list[] = {
919 # define GMQCC_TYPE_OPTIMIZATIONS
920 # define GMQCC_DEFINE_FLAG(NAME, MIN_O) { #NAME, LONGBIT(OPTIM_##NAME) },
921 #  include "opts.def"
922     { NULL, LONGBIT(0) }
923 };
924 static const unsigned int opts_opt_oflag[] = {
925 # define GMQCC_TYPE_OPTIMIZATIONS
926 # define GMQCC_DEFINE_FLAG(NAME, MIN_O) MIN_O,
927 #  include "opts.def"
928     0
929 };
930 extern unsigned int opts_optimizationcount[COUNT_OPTIMIZATIONS];
931
932 /* other options: */
933 typedef enum {
934     COMPILER_QCC,     /* circa  QuakeC */
935     COMPILER_FTEQCC,  /* fteqcc QuakeC */
936     COMPILER_QCCX,    /* qccx   QuakeC */
937     COMPILER_GMQCC    /* this   QuakeC */
938 } opts_std_t;
939
940 typedef struct {
941     uint32_t    O;              /* -Ox           */
942     const char *output;         /* -o file       */
943     bool        g;              /* -g            */
944     opts_std_t  standard;       /* -std=         */
945     bool        debug;          /* -debug        */
946     bool        memchk;         /* -memchk       */
947     bool        dumpfin;        /* -dumpfin      */
948     bool        dump;           /* -dump         */
949     bool        werror;         /* -Werror       */
950     bool        forcecrc;       /* --force-crc=  */
951     uint16_t    forced_crc;     /* --force-crc=  */
952     bool        pp_only;        /* -E            */
953     size_t      max_array_size; /* --max-array=  */
954
955     uint32_t flags       [1 + (COUNT_FLAGS         / 32)];
956     uint32_t warn        [1 + (COUNT_WARNINGS      / 32)];
957     uint32_t optimization[1 + (COUNT_OPTIMIZATIONS / 32)];
958 } opts_cmd_t;
959
960 extern opts_cmd_t opts;
961
962 /*===================================================================*/
963 #define OPTS_FLAG(i)         (!! (opts.flags       [(i)/32] & (1<< ((i)%32))))
964 #define OPTS_WARN(i)         (!! (opts.warn        [(i)/32] & (1<< ((i)%32))))
965 #define OPTS_OPTIMIZATION(i) (!! (opts.optimization[(i)/32] & (1<< ((i)%32))))
966
967 #endif