blob: c5f4ac9ed55662dacf26e931ca82de3caae1c4b8 [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 Anvin253a4e72008-06-10 13:00:27 -070059/* autoconf doesn't define these if they are redundant, but we want to
60 be able to #ifdef them... */
H. Peter Anvin397c1692016-10-04 17:01:59 -070061#elif defined(_MSC_VER) && (_MSC_VER >= 1310)
62# include "config/msvc.h"
H. Peter Anvin253a4e72008-06-10 13:00:27 -070063#else
H. Peter Anvin397c1692016-10-04 17:01:59 -070064/* Add more compiler-specific header files here */
65#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 Anvin3ef4f002016-03-08 12:14:55 -080084/* Some versions of MSVC have these only with underscores in front */
H. Peter Anvin304b6052007-09-28 10:50:20 -070085#ifndef HAVE_SNPRINTF
86# ifdef HAVE__SNPRINTF
87# define snprintf _snprintf
88# else
89int snprintf(char *, size_t, const char *, ...);
90# endif
H. Peter Anvinb8af9aa2007-09-17 13:53:14 -070091#endif
92
H. Peter Anvin304b6052007-09-28 10:50:20 -070093#ifndef HAVE_VSNPRINTF
Cyrill Gorcunovb2c34492014-11-26 10:44:19 +030094# ifdef HAVE__VSNPRINTF
H. Peter Anvin304b6052007-09-28 10:50:20 -070095# define vsnprintf _vsnprintf
96# else
97int vsnprintf(char *, size_t, const char *, va_list);
98# endif
H. Peter Anvinb8af9aa2007-09-17 13:53:14 -070099#endif
100
H. Peter Anvin397c1692016-10-04 17:01:59 -0700101#if !defined(HAVE_STRLCPY) || !defined(HAVE_DECL_STRLCPY)
H. Peter Anvineaa68f12009-08-10 15:56:52 -0700102size_t strlcpy(char *, const char *, size_t);
103#endif
104
H. Peter Anvin6867acc2007-10-10 14:58:45 -0700105#ifndef __cplusplus /* C++ has false, true, bool as keywords */
H. Peter Anvind338b372016-02-18 00:54:30 -0800106# ifdef HAVE_STDBOOL_H
H. Peter Anvin6867acc2007-10-10 14:58:45 -0700107# include <stdbool.h>
H. Peter Anvind338b372016-02-18 00:54:30 -0800108# elif defined(HAVE__BOOL)
109# typedef _Bool bool
110# define false 0
111# define true 1
H. Peter Anvin6867acc2007-10-10 14:58:45 -0700112# else
H. Peter Anvin253a4e72008-06-10 13:00:27 -0700113/* This is sort of dangerous, since casts will behave different than
114 casting to the standard boolean type. Always use !!, not (bool). */
115typedef enum bool { false, true } bool;
H. Peter Anvin6867acc2007-10-10 14:58:45 -0700116# endif
117#endif
118
H. Peter Anvin9656a582008-10-30 10:52:08 -0700119/* Provide a substitute for offsetof() if we don't have one. This
120 variant works on most (but not *all*) systems... */
121#ifndef offsetof
122# define offsetof(t,m) ((size_t)&(((t *)0)->m))
123#endif
124
125/* The container_of construct: if p is a pointer to member m of
126 container class c, then return a pointer to the container of which
127 *p is a member. */
128#ifndef container_of
129# define container_of(p, c, m) ((c *)((char *)(p) - offsetof(c,m)))
130#endif
131
H. Peter Anvinc13d31a2007-10-26 18:49:29 -0700132/* Some misguided platforms hide the defs for these */
H. Peter Anvin397c1692016-10-04 17:01:59 -0700133#if defined(HAVE_STRCASECMP) && !defined(HAVE_DECL_STRCASECMP)
H. Peter Anvinc13d31a2007-10-26 18:49:29 -0700134int strcasecmp(const char *, const char *);
135#endif
136
H. Peter Anvin397c1692016-10-04 17:01:59 -0700137#if defined(HAVE_STRICMP) && !defined(HAVE_DECL_STRICMP)
H. Peter Anvinc13d31a2007-10-26 18:49:29 -0700138int stricmp(const char *, const char *);
139#endif
140
H. Peter Anvin397c1692016-10-04 17:01:59 -0700141#if defined(HAVE_STRNCASECMP) && !defined(HAVE_DECL_STRNCASECMP)
H. Peter Anvinc13d31a2007-10-26 18:49:29 -0700142int strncasecmp(const char *, const char *, size_t);
143#endif
144
H. Peter Anvin397c1692016-10-04 17:01:59 -0700145#if defined(HAVE_STRNICMP) && !defined(HAVE_DECL_STRNICMP)
H. Peter Anvinc13d31a2007-10-26 18:49:29 -0700146int strnicmp(const char *, const char *, size_t);
147#endif
148
H. Peter Anvin397c1692016-10-04 17:01:59 -0700149#if defined(HAVE_STRSEP) && !defined(HAVE_DECL_STRSEP)
H. Peter Anvinc13d31a2007-10-26 18:49:29 -0700150char *strsep(char **, const char *);
151#endif
152
H. Peter Anvind1fb15c2007-11-13 09:37:59 -0800153/*
154 * Define this to 1 for faster performance if this is a littleendian
155 * platform which can do unaligned memory references. It is safe
156 * to leave it defined to 0 even if that is true.
157 */
H. Peter Anvin714ad042008-02-16 15:28:02 -0800158#if defined(__386__) || defined(__i386__) || defined(__x86_64__)
H. Peter Anvind1fb15c2007-11-13 09:37:59 -0800159# define X86_MEMORY 1
H. Peter Anvin2f0f9ea2008-06-08 20:53:29 -0700160# ifndef WORDS_LITTLEENDIAN
161# define WORDS_LITTLEENDIAN 1
162# endif
H. Peter Anvind1fb15c2007-11-13 09:37:59 -0800163#else
164# define X86_MEMORY 0
165#endif
166
H. Peter Anvin51997d32008-06-10 09:35:26 -0700167/*
168 * Hints to the compiler that a particular branch of code is more or
169 * less likely to be taken.
170 */
171#if defined(__GNUC__) && __GNUC__ >= 3
172# define likely(x) __builtin_expect(!!(x), 1)
173# define unlikely(x) __builtin_expect(!!(x), 0)
174#else
175# define likely(x) (!!(x))
176# define unlikely(x) (!!(x))
177#endif
178
H. Peter Anvin396e6dc2009-07-01 22:01:07 -0700179/*
H. Peter Anvin4976cd22016-05-25 03:56:34 -0700180 * Hints about malloc-like functions that never return NULL
181 */
182#if defined(__GNUC__) && __GNUC__ >= 4 /* ? */
183# define never_null __attribute__((returns_nonnull))
184# define safe_alloc never_null __attribute__((malloc))
185# define safe_malloc(s) safe_alloc __attribute__((alloc_size(s)))
186# define safe_malloc2(s1,s2) safe_alloc __attribute__((alloc_size(s1,s2)))
187# define safe_realloc(s) never_null __attribute__((alloc_size(s)))
188#else
189# define never_null
190# define safe_alloc
191# define safe_malloc(s)
192# define safe_malloc2(s1,s2)
193# define safe_realloc(s)
194#endif
195
196/*
H. Peter Anvin396e6dc2009-07-01 22:01:07 -0700197 * How to tell the compiler that a function doesn't return
198 */
199#ifdef __GNUC__
H. Peter Anvin84280bb2009-07-05 19:22:28 -0700200# define no_return void __attribute__((noreturn))
H. Peter Anvin396e6dc2009-07-01 22:01:07 -0700201#else
H. Peter Anvin84280bb2009-07-05 19:22:28 -0700202# define no_return void
H. Peter Anvin396e6dc2009-07-01 22:01:07 -0700203#endif
204
H. Peter Anvinf0d92fd2016-02-02 16:01:43 -0800205/*
206 * How to tell the compiler that a function takes a printf-like string
207 */
208#ifdef __GNUC__
209# define printf_func(fmt, list) __attribute__((format(printf, fmt, list)))
210#else
211# define printf_func(fmt, list)
212#endif
213
H. Peter Anvinfe501952007-10-02 21:53:51 -0700214#endif /* NASM_COMPILER_H */