xref: /freebsd/contrib/expat/lib/internal.h (revision fe9278888fd4414abe2d922e469cf608005f4c65)
1 /* internal.h
2 
3    Internal definitions used by Expat.  This is not needed to compile
4    client code.
5 
6    The following calling convention macros are defined for frequently
7    called functions:
8 
9    FASTCALL    - Used for those internal functions that have a simple
10                  body and a low number of arguments and local variables.
11 
12    PTRCALL     - Used for functions called though function pointers.
13 
14    PTRFASTCALL - Like PTRCALL, but for low number of arguments.
15 
16    inline      - Used for selected internal functions for which inlining
17                  may improve performance on some platforms.
18 
19    Note: Use of these macros is based on judgement, not hard rules,
20          and therefore subject to change.
21                             __  __            _
22                          ___\ \/ /_ __   __ _| |_
23                         / _ \\  /| '_ \ / _` | __|
24                        |  __//  \| |_) | (_| | |_
25                         \___/_/\_\ .__/ \__,_|\__|
26                                  |_| XML parser
27 
28    Copyright (c) 2002-2003 Fred L. Drake, Jr. <fdrake@users.sourceforge.net>
29    Copyright (c) 2002-2006 Karl Waclawek <karl@waclawek.net>
30    Copyright (c) 2003      Greg Stein <gstein@users.sourceforge.net>
31    Copyright (c) 2016-2025 Sebastian Pipping <sebastian@pipping.org>
32    Copyright (c) 2018      Yury Gribov <tetra2005@gmail.com>
33    Copyright (c) 2019      David Loffredo <loffredo@steptools.com>
34    Copyright (c) 2023-2024 Sony Corporation / Snild Dolkow <snild@sony.com>
35    Copyright (c) 2024      Taichi Haradaguchi <20001722@ymail.ne.jp>
36    Licensed under the MIT license:
37 
38    Permission is  hereby granted,  free of charge,  to any  person obtaining
39    a  copy  of  this  software   and  associated  documentation  files  (the
40    "Software"),  to  deal in  the  Software  without restriction,  including
41    without  limitation the  rights  to use,  copy,  modify, merge,  publish,
42    distribute, sublicense, and/or sell copies of the Software, and to permit
43    persons  to whom  the Software  is  furnished to  do so,  subject to  the
44    following conditions:
45 
46    The above copyright  notice and this permission notice  shall be included
47    in all copies or substantial portions of the Software.
48 
49    THE  SOFTWARE  IS  PROVIDED  "AS  IS",  WITHOUT  WARRANTY  OF  ANY  KIND,
50    EXPRESS  OR IMPLIED,  INCLUDING  BUT  NOT LIMITED  TO  THE WARRANTIES  OF
51    MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN
52    NO EVENT SHALL THE AUTHORS OR  COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
53    DAMAGES OR  OTHER LIABILITY, WHETHER  IN AN  ACTION OF CONTRACT,  TORT OR
54    OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
55    USE OR OTHER DEALINGS IN THE SOFTWARE.
56 */
57 
58 #if defined(__GNUC__) && defined(__i386__) && ! defined(__MINGW32__)
59 /* We'll use this version by default only where we know it helps.
60 
61    regparm() generates warnings on Solaris boxes.   See SF bug #692878.
62 
63    Instability reported with egcs on a RedHat Linux 7.3.
64    Let's comment out:
65    #define FASTCALL __attribute__((stdcall, regparm(3)))
66    and let's try this:
67 */
68 #  define FASTCALL __attribute__((regparm(3)))
69 #  define PTRFASTCALL __attribute__((regparm(3)))
70 #endif
71 
72 /* Using __fastcall seems to have an unexpected negative effect under
73    MS VC++, especially for function pointers, so we won't use it for
74    now on that platform. It may be reconsidered for a future release
75    if it can be made more effective.
76    Likely reason: __fastcall on Windows is like stdcall, therefore
77    the compiler cannot perform stack optimizations for call clusters.
78 */
79 
80 /* Make sure all of these are defined if they aren't already. */
81 
82 #ifndef FASTCALL
83 #  define FASTCALL
84 #endif
85 
86 #ifndef PTRCALL
87 #  define PTRCALL
88 #endif
89 
90 #ifndef PTRFASTCALL
91 #  define PTRFASTCALL
92 #endif
93 
94 #ifndef XML_MIN_SIZE
95 #  if ! defined(__cplusplus) && ! defined(inline)
96 #    ifdef __GNUC__
97 #      define inline __inline
98 #    endif /* __GNUC__ */
99 #  endif
100 #endif /* XML_MIN_SIZE */
101 
102 #ifdef __cplusplus
103 #  define inline inline
104 #else
105 #  ifndef inline
106 #    define inline
107 #  endif
108 #endif
109 
110 #include <limits.h> // ULONG_MAX
111 
112 #if defined(_WIN32)                                                            \
113     && (! defined(__USE_MINGW_ANSI_STDIO)                                      \
114         || (1 - __USE_MINGW_ANSI_STDIO - 1 == 0))
115 #  define EXPAT_FMT_ULL(midpart) "%" midpart "I64u"
116 #  if defined(_WIN64) // Note: modifiers "td" and "zu" do not work for MinGW
117 #    define EXPAT_FMT_PTRDIFF_T(midpart) "%" midpart "I64d"
118 #    define EXPAT_FMT_SIZE_T(midpart) "%" midpart "I64u"
119 #  else
120 #    define EXPAT_FMT_PTRDIFF_T(midpart) "%" midpart "d"
121 #    define EXPAT_FMT_SIZE_T(midpart) "%" midpart "u"
122 #  endif
123 #else
124 #  define EXPAT_FMT_ULL(midpart) "%" midpart "llu"
125 #  if ! defined(ULONG_MAX)
126 #    error Compiler did not define ULONG_MAX for us
127 #  elif ULONG_MAX == 18446744073709551615u // 2^64-1
128 #    define EXPAT_FMT_PTRDIFF_T(midpart) "%" midpart "ld"
129 #    define EXPAT_FMT_SIZE_T(midpart) "%" midpart "lu"
130 #  elif defined(EMSCRIPTEN) // 32bit mode Emscripten
131 #    define EXPAT_FMT_PTRDIFF_T(midpart) "%" midpart "ld"
132 #    define EXPAT_FMT_SIZE_T(midpart) "%" midpart "zu"
133 #  else
134 #    define EXPAT_FMT_PTRDIFF_T(midpart) "%" midpart "d"
135 #    define EXPAT_FMT_SIZE_T(midpart) "%" midpart "u"
136 #  endif
137 #endif
138 
139 #ifndef UNUSED_P
140 #  define UNUSED_P(p) (void)p
141 #endif
142 
143 /* NOTE BEGIN If you ever patch these defaults to greater values
144               for non-attack XML payload in your environment,
145               please file a bug report with libexpat.  Thank you!
146 */
147 #define EXPAT_BILLION_LAUGHS_ATTACK_PROTECTION_MAXIMUM_AMPLIFICATION_DEFAULT   \
148   100.0f
149 #define EXPAT_BILLION_LAUGHS_ATTACK_PROTECTION_ACTIVATION_THRESHOLD_DEFAULT    \
150   8388608 // 8 MiB, 2^23
151 /* NOTE END */
152 
153 #include "expat.h" // so we can use type XML_Parser below
154 
155 #ifdef __cplusplus
156 extern "C" {
157 #endif
158 
159 void _INTERNAL_trim_to_complete_utf8_characters(const char *from,
160                                                 const char **fromLimRef);
161 
162 #if defined(XML_GE) && XML_GE == 1
163 unsigned long long testingAccountingGetCountBytesDirect(XML_Parser parser);
164 unsigned long long testingAccountingGetCountBytesIndirect(XML_Parser parser);
165 const char *unsignedCharToPrintable(unsigned char c);
166 #endif
167 
168 extern
169 #if ! defined(XML_TESTING)
170     const
171 #endif
172     XML_Bool g_reparseDeferralEnabledDefault; // written ONLY in runtests.c
173 #if defined(XML_TESTING)
174 extern unsigned int g_bytesScanned; // used for testing only
175 #endif
176 
177 #ifdef __cplusplus
178 }
179 #endif
180