blob: 8d609376b8892dabc9bdec5a31eec19d9ea7c7d3 [file] [log] [blame]
H. Peter Anvinc1494ac2007-04-13 19:58:42 +00001/* ----------------------------------------------------------------------- *
H. Peter Anvin9e6747c2009-06-28 17:13:04 -07002 *
H. Peter Anvine8677d62016-01-27 14:29:40 -08003 * Copyright 2007-2016 The NASM Authors - All Rights Reserved
H. Peter Anvin9e6747c2009-06-28 17:13:04 -07004 * See the file AUTHORS included with the NASM distribution for
5 * the specific copyright holders.
H. Peter Anvinc1494ac2007-04-13 19:58:42 +00006 *
H. Peter Anvin9e6747c2009-06-28 17:13:04 -07007 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following
9 * conditions are met:
H. Peter Anvinc1494ac2007-04-13 19:58:42 +000010 *
H. Peter Anvin9e6747c2009-06-28 17:13:04 -070011 * * Redistributions of source code must retain the above copyright
12 * notice, this list of conditions and the following disclaimer.
13 * * Redistributions in binary form must reproduce the above
14 * copyright notice, this list of conditions and the following
15 * disclaimer in the documentation and/or other materials provided
16 * with the distribution.
17 *
18 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
19 * CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
20 * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
21 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
22 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
23 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
24 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
25 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
26 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
28 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
29 * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
30 * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
H. Peter Anvinc1494ac2007-04-13 19:58:42 +000031 *
32 * ----------------------------------------------------------------------- */
33
34/*
35 * compiler.h
36 *
37 * Compiler-specific macros for NASM. Feel free to add support for
38 * other compilers in here.
H. Peter Anvinfe501952007-10-02 21:53:51 -070039 *
40 * This header file should be included before any other header.
H. Peter Anvinc1494ac2007-04-13 19:58:42 +000041 */
42
H. Peter Anvinfe501952007-10-02 21:53:51 -070043#ifndef NASM_COMPILER_H
44#define NASM_COMPILER_H 1
H. Peter Anvinc40f89e2007-04-13 20:06:41 +000045
H. Peter Anvin2fc232b2016-07-14 13:51:01 -070046/*
47 * At least DJGPP and Cygwin have broken header files if __STRICT_ANSI__
48 * is defined.
49 */
50#ifdef __GNUC__
H. Peter Anvine8677d62016-01-27 14:29:40 -080051# undef __STRICT_ANSI__
52#endif
53
H. Peter Anvinb423c022016-02-18 11:57:53 -080054/* On Microsoft platforms we support multibyte character sets in filenames */
55#define _MBCS 1
56
H. Peter Anvinc40f89e2007-04-13 20:06:41 +000057#ifdef HAVE_CONFIG_H
H. Peter Anvin397c1692016-10-04 17:01:59 -070058# include "config/config.h"
H. Peter Anvin397c1692016-10-04 17:01:59 -070059#elif defined(_MSC_VER) && (_MSC_VER >= 1310)
60# include "config/msvc.h"
H. Peter Anvinf5287232016-10-19 13:23:04 -070061#elif defined(__WATCOM__)
62# include "config/watcom.h"
H. Peter Anvin253a4e72008-06-10 13:00:27 -070063#else
H. Peter Anvin276785a2016-10-04 17:13:50 -070064# include "config/unknown.h"
H. Peter Anvin397c1692016-10-04 17:01:59 -070065#endif /* Configuration file */
H. Peter Anvinc1494ac2007-04-13 19:58:42 +000066
H. Peter Anvin687b3632007-10-11 12:50:24 -070067/* This is required to get the standard <inttypes.h> macros when compiling
68 with a C++ compiler. This must be defined *before* <inttypes.h> is
69 included, directly or indirectly. */
70#define __STDC_CONSTANT_MACROS 1
71#define __STDC_LIMIT_MACROS 1
72#define __STDC_FORMAT_MACROS 1
73
H. Peter Anvin3ef4f002016-03-08 12:14:55 -080074#ifdef HAVE_INTTYPES_H
75# include <inttypes.h>
76#else
77# include "nasmint.h"
78#endif
79
H. Peter Anvin304b6052007-09-28 10:50:20 -070080#include <stddef.h>
81#include <stdarg.h>
H. Peter Anvinfe501952007-10-02 21:53:51 -070082#include <stdio.h>
H. Peter Anvinb8af9aa2007-09-17 13:53:14 -070083
H. Peter Anvin4c9132e2016-10-19 13:13:38 -070084#ifdef HAVE_SYS_TYPES_H
85# include <sys/types.h>
86#endif
87
H. Peter Anvin3ef4f002016-03-08 12:14:55 -080088/* Some versions of MSVC have these only with underscores in front */
H. Peter Anvin304b6052007-09-28 10:50:20 -070089#ifndef HAVE_SNPRINTF
90# ifdef HAVE__SNPRINTF
91# define snprintf _snprintf
92# else
93int snprintf(char *, size_t, const char *, ...);
94# endif
H. Peter Anvinb8af9aa2007-09-17 13:53:14 -070095#endif
96
H. Peter Anvin304b6052007-09-28 10:50:20 -070097#ifndef HAVE_VSNPRINTF
Cyrill Gorcunovb2c34492014-11-26 10:44:19 +030098# ifdef HAVE__VSNPRINTF
H. Peter Anvin304b6052007-09-28 10:50:20 -070099# define vsnprintf _vsnprintf
100# else
101int vsnprintf(char *, size_t, const char *, va_list);
102# endif
H. Peter Anvinb8af9aa2007-09-17 13:53:14 -0700103#endif
104
H. Peter Anvin397c1692016-10-04 17:01:59 -0700105#if !defined(HAVE_STRLCPY) || !defined(HAVE_DECL_STRLCPY)
H. Peter Anvineaa68f12009-08-10 15:56:52 -0700106size_t strlcpy(char *, const char *, size_t);
107#endif
108
H. Peter Anvin6867acc2007-10-10 14:58:45 -0700109#ifndef __cplusplus /* C++ has false, true, bool as keywords */
H. Peter Anvind338b372016-02-18 00:54:30 -0800110# ifdef HAVE_STDBOOL_H
H. Peter Anvin6867acc2007-10-10 14:58:45 -0700111# include <stdbool.h>
H. Peter Anvind338b372016-02-18 00:54:30 -0800112# elif defined(HAVE__BOOL)
113# typedef _Bool bool
114# define false 0
115# define true 1
H. Peter Anvin6867acc2007-10-10 14:58:45 -0700116# else
H. Peter Anvin253a4e72008-06-10 13:00:27 -0700117/* This is sort of dangerous, since casts will behave different than
118 casting to the standard boolean type. Always use !!, not (bool). */
119typedef enum bool { false, true } bool;
H. Peter Anvin6867acc2007-10-10 14:58:45 -0700120# endif
121#endif
122
H. Peter Anvin9656a582008-10-30 10:52:08 -0700123/* Provide a substitute for offsetof() if we don't have one. This
124 variant works on most (but not *all*) systems... */
125#ifndef offsetof
126# define offsetof(t,m) ((size_t)&(((t *)0)->m))
127#endif
128
129/* The container_of construct: if p is a pointer to member m of
130 container class c, then return a pointer to the container of which
131 *p is a member. */
132#ifndef container_of
133# define container_of(p, c, m) ((c *)((char *)(p) - offsetof(c,m)))
134#endif
135
H. Peter Anvinc13d31a2007-10-26 18:49:29 -0700136/* Some misguided platforms hide the defs for these */
H. Peter Anvin397c1692016-10-04 17:01:59 -0700137#if defined(HAVE_STRCASECMP) && !defined(HAVE_DECL_STRCASECMP)
H. Peter Anvinc13d31a2007-10-26 18:49:29 -0700138int strcasecmp(const char *, const char *);
139#endif
140
H. Peter Anvin397c1692016-10-04 17:01:59 -0700141#if defined(HAVE_STRICMP) && !defined(HAVE_DECL_STRICMP)
H. Peter Anvinc13d31a2007-10-26 18:49:29 -0700142int stricmp(const char *, const char *);
143#endif
144
H. Peter Anvin397c1692016-10-04 17:01:59 -0700145#if defined(HAVE_STRNCASECMP) && !defined(HAVE_DECL_STRNCASECMP)
H. Peter Anvinc13d31a2007-10-26 18:49:29 -0700146int strncasecmp(const char *, const char *, size_t);
147#endif
148
H. Peter Anvin397c1692016-10-04 17:01:59 -0700149#if defined(HAVE_STRNICMP) && !defined(HAVE_DECL_STRNICMP)
H. Peter Anvinc13d31a2007-10-26 18:49:29 -0700150int strnicmp(const char *, const char *, size_t);
151#endif
152
H. Peter Anvin397c1692016-10-04 17:01:59 -0700153#if defined(HAVE_STRSEP) && !defined(HAVE_DECL_STRSEP)
H. Peter Anvinc13d31a2007-10-26 18:49:29 -0700154char *strsep(char **, const char *);
155#endif
156
H. Peter Anvind1fb15c2007-11-13 09:37:59 -0800157/*
158 * Define this to 1 for faster performance if this is a littleendian
159 * platform which can do unaligned memory references. It is safe
160 * to leave it defined to 0 even if that is true.
161 */
H. Peter Anvin714ad042008-02-16 15:28:02 -0800162#if defined(__386__) || defined(__i386__) || defined(__x86_64__)
H. Peter Anvind1fb15c2007-11-13 09:37:59 -0800163# define X86_MEMORY 1
H. Peter Anvin2f0f9ea2008-06-08 20:53:29 -0700164# ifndef WORDS_LITTLEENDIAN
165# define WORDS_LITTLEENDIAN 1
166# endif
H. Peter Anvind1fb15c2007-11-13 09:37:59 -0800167#else
168# define X86_MEMORY 0
169#endif
170
H. Peter Anvin51997d32008-06-10 09:35:26 -0700171/*
172 * Hints to the compiler that a particular branch of code is more or
173 * less likely to be taken.
174 */
175#if defined(__GNUC__) && __GNUC__ >= 3
176# define likely(x) __builtin_expect(!!(x), 1)
177# define unlikely(x) __builtin_expect(!!(x), 0)
178#else
179# define likely(x) (!!(x))
180# define unlikely(x) (!!(x))
181#endif
182
H. Peter Anvin396e6dc2009-07-01 22:01:07 -0700183/*
H. Peter Anvin4976cd22016-05-25 03:56:34 -0700184 * Hints about malloc-like functions that never return NULL
185 */
186#if defined(__GNUC__) && __GNUC__ >= 4 /* ? */
187# define never_null __attribute__((returns_nonnull))
188# define safe_alloc never_null __attribute__((malloc))
H. Peter Anvin9b733a52016-10-14 15:01:06 -0700189# ifdef __has_attribute
190# if __has_attribute(alloc_size)
191# define safe_malloc(s) safe_alloc __attribute__((alloc_size(s)))
192# define safe_malloc2(s1,s2) safe_alloc __attribute__((alloc_size(s1,s2)))
193# define safe_realloc(s) never_null __attribute__((alloc_size(s)))
194# endif
195# endif
196#endif
197
198#ifndef never_null
H. Peter Anvin4976cd22016-05-25 03:56:34 -0700199# define never_null
H. Peter Anvin9b733a52016-10-14 15:01:06 -0700200#endif
201#ifndef safe_alloc
H. Peter Anvin4976cd22016-05-25 03:56:34 -0700202# define safe_alloc
H. Peter Anvin9b733a52016-10-14 15:01:06 -0700203#endif
204#ifndef safe_malloc
205# define safe_malloc(s) safe_alloc
H. Peter Anvin44e3a112016-10-14 15:05:28 -0700206# define safe_malloc2(s1,s2) safe_alloc
H. Peter Anvin9b733a52016-10-14 15:01:06 -0700207# define safe_realloc(s) never_null
H. Peter Anvin4976cd22016-05-25 03:56:34 -0700208#endif
209
210/*
H. Peter Anvin396e6dc2009-07-01 22:01:07 -0700211 * How to tell the compiler that a function doesn't return
212 */
213#ifdef __GNUC__
H. Peter Anvin84280bb2009-07-05 19:22:28 -0700214# define no_return void __attribute__((noreturn))
H. Peter Anvin396e6dc2009-07-01 22:01:07 -0700215#else
H. Peter Anvin84280bb2009-07-05 19:22:28 -0700216# define no_return void
H. Peter Anvin396e6dc2009-07-01 22:01:07 -0700217#endif
218
H. Peter Anvinf0d92fd2016-02-02 16:01:43 -0800219/*
220 * How to tell the compiler that a function takes a printf-like string
221 */
222#ifdef __GNUC__
223# define printf_func(fmt, list) __attribute__((format(printf, fmt, list)))
224#else
225# define printf_func(fmt, list)
226#endif
227
H. Peter Anvinfe501952007-10-02 21:53:51 -0700228#endif /* NASM_COMPILER_H */