gcc/doc/libgcc.texi

   1 @c Copyright (C) 2003, 2004, 2005 Free Software Foundation, Inc.
   2 @c This is part of the GCC manual.
   3 @c For copying conditions, see the file gcc.texi.
   4 @c Contributed by Aldy Hernandez <aldy@quesejoda.com>
   5
   6 @node Libgcc
   7 @chapter The GCC low-level runtime library
   8
   9 GCC provides a low-level runtime library, @file{libgcc.a} or
  10 @file{libgcc_s.so.1} on some platforms.  GCC generates calls to
  11 routines in this library automatically, whenever it needs to perform
  12 some operation that is too complicated to emit inline code for.
  13
  14 Most of the routines in @code{libgcc} handle arithmetic operations
  15 that the target processor cannot perform directly.  This includes
  16 integer multiply and divide on some machines, and all floating-point
  17 operations on other machines.  @code{libgcc} also includes routines
  18 for exception handling, and a handful of miscellaneous operations.
  19
  20 Some of these routines can be defined in mostly machine-independent C@.
  21 Others must be hand-written in assembly language for each processor
  22 that needs them.
  23
  24 GCC will also generate calls to C library routines, such as
  25 @code{memcpy} and @code{memset}, in some cases.  The set of routines
  26 that GCC may possibly use is documented in @ref{Other
  27 Builtins,,,gcc, Using the GNU Compiler Collection (GCC)}.
  28
  29 These routines take arguments and return values of a specific machine
  30 mode, not a specific C type.  @xref{Machine Modes}, for an explanation
  31 of this concept.  For illustrative purposes, in this chapter the
  32 floating point type @code{float} is assumed to correspond to @code{SFmode};
  33 @code{double} to @code{DFmode}; and @code{@w{long double}} to both
  34 @code{TFmode} and @code{XFmode}.  Similarly, the integer types @code{int}
  35 and @code{@w{unsigned int}} correspond to @code{SImode}; @code{long} and
  36 @code{@w{unsigned long}} to @code{DImode}; and @code{@w{long long}} and
  37 @code{@w{unsigned long long}} to @code{TImode}.
  38
  39 @menu
  40 * Integer library routines::
  41 * Soft float library routines::
  42 * Decimal float library routines::
  43 * Exception handling routines::
  44 * Miscellaneous routines::
  45 @end menu
  46
  47 @node Integer library routines
  48 @section Routines for integer arithmetic
  49
  50 The integer arithmetic routines are used on platforms that don't provide
  51 hardware support for arithmetic operations on some modes.
  52
  53 @subsection Arithmetic functions
  54
  55 @deftypefn {Runtime Function} int __ashlsi3 (int @var{a}, int @var{b})
  56 @deftypefnx {Runtime Function} long __ashldi3 (long @var{a}, int @var{b})
  57 @deftypefnx {Runtime Function} {long long} __ashlti3 (long long @var{a}, int @var{b})
  58 These functions return the result of shifting @var{a} left by @var{b} bits.
  59 @end deftypefn
  60
  61 @deftypefn {Runtime Function} int __ashrsi3 (int @var{a}, int @var{b})
  62 @deftypefnx {Runtime Function} long __ashrdi3 (long @var{a}, int @var{b})
  63 @deftypefnx {Runtime Function} {long long} __ashrti3 (long long @var{a}, int @var{b})
  64 These functions return the result of arithmetically shifting @var{a} right
  65 by @var{b} bits.
  66 @end deftypefn
  67
  68 @deftypefn {Runtime Function} int __divsi3 (int @var{a}, int @var{b})
  69 @deftypefnx {Runtime Function} long __divdi3 (long @var{a}, long @var{b})
  70 @deftypefnx {Runtime Function} {long long} __divti3 (long long @var{a}, long long @var{b})
  71 These functions return the quotient of the signed division of @var{a} and
  72 @var{b}.
  73 @end deftypefn
  74
  75 @deftypefn {Runtime Function} int __lshrsi3 (int @var{a}, int @var{b})
  76 @deftypefnx {Runtime Function} long __lshrdi3 (long @var{a}, int @var{b})
  77 @deftypefnx {Runtime Function} {long long} __lshrti3 (long long @var{a}, int @var{b})
  78 These functions return the result of logically shifting @var{a} right by
  79 @var{b} bits.
  80 @end deftypefn
  81
  82 @deftypefn {Runtime Function} int __modsi3 (int @var{a}, int @var{b})
  83 @deftypefnx {Runtime Function} long __moddi3 (long @var{a}, long @var{b})
  84 @deftypefnx {Runtime Function} {long long} __modti3 (long long @var{a}, long long @var{b})
  85 These functions return the remainder of the signed division of @var{a}
  86 and @var{b}.
  87 @end deftypefn
  88
  89 @deftypefn {Runtime Function} int __mulsi3 (int @var{a}, int @var{b})
  90 @deftypefnx {Runtime Function} long __muldi3 (long @var{a}, long @var{b})
  91 @deftypefnx {Runtime Function} {long long} __multi3 (long long @var{a}, long long @var{b})
  92 These functions return the product of @var{a} and @var{b}.
  93 @end deftypefn
  94
  95 @deftypefn {Runtime Function} long __negdi2 (long @var{a})
  96 @deftypefnx {Runtime Function} {long long} __negti2 (long long @var{a})
  97 These functions return the negation of @var{a}.
  98 @end deftypefn
  99
 100 @deftypefn {Runtime Function} {unsigned int} __udivsi3 (unsigned int @var{a}, unsigned int @var{b})
 101 @deftypefnx {Runtime Function} {unsigned long} __udivdi3 (unsigned long @var{a}, unsigned long @var{b})
 102 @deftypefnx {Runtime Function} {unsigned long long} __udivti3 (unsigned long long @var{a}, unsigned long long @var{b})
 103 These functions return the quotient of the unsigned division of @var{a}
 104 and @var{b}.
 105 @end deftypefn
 106
 107 @deftypefn {Runtime Function} {unsigned long} __udivmoddi3 (unsigned long @var{a}, unsigned long @var{b}, unsigned long *@var{c})
 108 @deftypefnx {Runtime Function} {unsigned long long} __udivti3 (unsigned long long @var{a}, unsigned long long @var{b}, unsigned long long *@var{c})
 109 These functions calculate both the quotient and remainder of the unsigned
 110 division of @var{a} and @var{b}.  The return value is the quotient, and
 111 the remainder is placed in variable pointed to by @var{c}.
 112 @end deftypefn
 113
 114 @deftypefn {Runtime Function} {unsigned int} __umodsi3 (unsigned int @var{a}, unsigned int @var{b})
 115 @deftypefnx {Runtime Function} {unsigned long} __umoddi3 (unsigned long @var{a}, unsigned long @var{b})
 116 @deftypefnx {Runtime Function} {unsigned long long} __umodti3 (unsigned long long @var{a}, unsigned long long @var{b})
 117 These functions return the remainder of the unsigned division of @var{a}
 118 and @var{b}.
 119 @end deftypefn
 120
 121 @subsection Comparison functions
 122
 123 The following functions implement integral comparisons.  These functions
 124 implement a low-level compare, upon which the higher level comparison
 125 operators (such as less than and greater than or equal to) can be
 126 constructed.  The returned values lie in the range zero to two, to allow
 127 the high-level operators to be implemented by testing the returned
 128 result using either signed or unsigned comparison.
 129
 130 @deftypefn {Runtime Function} int __cmpdi2 (long @var{a}, long @var{b})
 131 @deftypefnx {Runtime Function} int __cmpti2 (long long @var{a}, long long @var{b})
 132 These functions perform a signed comparison of @var{a} and @var{b}.  If
 133 @var{a} is less than @var{b}, they return 0; if @var{a} is greater than
 134 @var{b}, they return 2; and if @var{a} and @var{b} are equal they return 1.
 135 @end deftypefn
 136
 137 @deftypefn {Runtime Function} int __ucmpdi2 (unsigned long @var{a}, unsigned long @var{b})
 138 @deftypefnx {Runtime Function} int __ucmpti2 (unsigned long long @var{a}, unsigned long long @var{b})
 139 These functions perform an unsigned comparison of @var{a} and @var{b}.
 140 If @var{a} is less than @var{b}, they return 0; if @var{a} is greater than
 141 @var{b}, they return 2; and if @var{a} and @var{b} are equal they return 1.
 142 @end deftypefn
 143
 144 @subsection Trapping arithmetic functions
 145
 146 The following functions implement trapping arithmetic.  These functions
 147 call the libc function @code{abort} upon signed arithmetic overflow.
 148
 149 @deftypefn {Runtime Function} int __absvsi2 (int @var{a})
 150 @deftypefnx {Runtime Function} long __absvdi2 (long @var{a})
 151 These functions return the absolute value of @var{a}.
 152 @end deftypefn
 153
 154 @deftypefn {Runtime Function} int __addvsi3 (int @var{a}, int @var{b})
 155 @deftypefnx {Runtime Function} long __addvdi3 (long @var{a}, long @var{b})
 156 These functions return the sum of @var{a} and @var{b}; that is
 157 @code{@var{a} + @var{b}}.
 158 @end deftypefn
 159
 160 @deftypefn {Runtime Function} int __mulvsi3 (int @var{a}, int @var{b})
 161 @deftypefnx {Runtime Function} long __mulvdi3 (long @var{a}, long @var{b})
 162 The functions return the product of @var{a} and @var{b}; that is
 163 @code{@var{a} * @var{b}}.
 164 @end deftypefn
 165
 166 @deftypefn {Runtime Function} int __negvsi2 (int @var{a})
 167 @deftypefnx {Runtime Function} long __negvdi2 (long @var{a})
 168 These functions return the negation of @var{a}; that is @code{-@var{a}}.
 169 @end deftypefn
 170
 171 @deftypefn {Runtime Function} int __subvsi3 (int @var{a}, int @var{b})
 172 @deftypefnx {Runtime Function} long __subvdi3 (long @var{a}, long @var{b})
 173 These functions return the difference between @var{b} and @var{a};
 174 that is @code{@var{a} - @var{b}}.
 175 @end deftypefn
 176
 177 @subsection Bit operations
 178
 179 @deftypefn {Runtime Function} int __clzsi2 (int @var{a})
 180 @deftypefnx {Runtime Function} int __clzdi2 (long @var{a})
 181 @deftypefnx {Runtime Function} int __clzti2 (long long @var{a})
 182 These functions return the number of leading 0-bits in @var{a}, starting
 183 at the most significant bit position.  If @var{a} is zero, the result is
 184 undefined.
 185 @end deftypefn
 186
 187 @deftypefn {Runtime Function} int __ctzsi2 (int @var{a})
 188 @deftypefnx {Runtime Function} int __ctzdi2 (long @var{a})
 189 @deftypefnx {Runtime Function} int __ctzti2 (long long @var{a})
 190 These functions return the number of trailing 0-bits in @var{a}, starting
 191 at the least significant bit position.  If @var{a} is zero, the result is
 192 undefined.
 193 @end deftypefn
 194
 195 @deftypefn {Runtime Function} int __ffsdi2 (long @var{a})
 196 @deftypefnx {Runtime Function} int __ffsti2 (long long @var{a})
 197 These functions return the index of the least significant 1-bit in @var{a},
 198 or the value zero if @var{a} is zero.  The least significant bit is index
 199 one.
 200 @end deftypefn
 201
 202 @deftypefn {Runtime Function} int __paritysi2 (int @var{a})
 203 @deftypefnx {Runtime Function} int __paritydi2 (long @var{a})
 204 @deftypefnx {Runtime Function} int __parityti2 (long long @var{a})
 205 These functions return the value zero if the number of bits set in
 206 @var{a} is even, and the value one otherwise.
 207 @end deftypefn
 208
 209 @deftypefn {Runtime Function} int __popcountsi2 (int @var{a})
 210 @deftypefnx {Runtime Function} int __popcountdi2 (long @var{a})
 211 @deftypefnx {Runtime Function} int __popcountti2 (long long @var{a})
 212 These functions return the number of bits set in @var{a}.
 213 @end deftypefn
 214
 215 @deftypefn {Runtime Function} int32_t __bswapsi2 (int32_t @var{a})
 216 @deftypefnx {Runtime Function} int64_t __bswapdi2 (int64_t @var{a})
 217 These functions return the @var{a} byteswapped.
 218 @end deftypefn
 219
 220 @node Soft float library routines
 221 @section Routines for floating point emulation
 222 @cindex soft float library
 223 @cindex arithmetic library
 224 @cindex math library
 225 @opindex msoft-float
 226
 227 The software floating point library is used on machines which do not
 228 have hardware support for floating point.  It is also used whenever
 229 @option{-msoft-float} is used to disable generation of floating point
 230 instructions.  (Not all targets support this switch.)
 231
 232 For compatibility with other compilers, the floating point emulation
 233 routines can be renamed with the @code{DECLARE_LIBRARY_RENAMES} macro
 234 (@pxref{Library Calls}).  In this section, the default names are used.
 235
 236 Presently the library does not support @code{XFmode}, which is used
 237 for @code{long double} on some architectures.
 238
 239 @subsection Arithmetic functions
 240
 241 @deftypefn {Runtime Function} float __addsf3 (float @var{a}, float @var{b})
 242 @deftypefnx {Runtime Function} double __adddf3 (double @var{a}, double @var{b})
 243 @deftypefnx {Runtime Function} {long double} __addtf3 (long double @var{a}, long double @var{b})
 244 @deftypefnx {Runtime Function} {long double} __addxf3 (long double @var{a}, long double @var{b})
 245 These functions return the sum of @var{a} and @var{b}.
 246 @end deftypefn
 247
 248 @deftypefn {Runtime Function} float __subsf3 (float @var{a}, float @var{b})
 249 @deftypefnx {Runtime Function} double __subdf3 (double @var{a}, double @var{b})
 250 @deftypefnx {Runtime Function} {long double} __subtf3 (long double @var{a}, long double @var{b})
 251 @deftypefnx {Runtime Function} {long double} __subxf3 (long double @var{a}, long double @var{b})
 252 These functions return the difference between @var{b} and @var{a};
 253 that is, @w{@math{@var{a} - @var{b}}}.
 254 @end deftypefn
 255
 256 @deftypefn {Runtime Function} float __mulsf3 (float @var{a}, float @var{b})
 257 @deftypefnx {Runtime Function} double __muldf3 (double @var{a}, double @var{b})
 258 @deftypefnx {Runtime Function} {long double} __multf3 (long double @var{a}, long double @var{b})
 259 @deftypefnx {Runtime Function} {long double} __mulxf3 (long double @var{a}, long double @var{b})
 260 These functions return the product of @var{a} and @var{b}.
 261 @end deftypefn
 262
 263 @deftypefn {Runtime Function} float __divsf3 (float @var{a}, float @var{b})
 264 @deftypefnx {Runtime Function} double __divdf3 (double @var{a}, double @var{b})
 265 @deftypefnx {Runtime Function} {long double} __divtf3 (long double @var{a}, long double @var{b})
 266 @deftypefnx {Runtime Function} {long double} __divxf3 (long double @var{a}, long double @var{b})
 267 These functions return the quotient of @var{a} and @var{b}; that is,
 268 @w{@math{@var{a} / @var{b}}}.
 269 @end deftypefn
 270
 271 @deftypefn {Runtime Function} float __negsf2 (float @var{a})
 272 @deftypefnx {Runtime Function} double __negdf2 (double @var{a})
 273 @deftypefnx {Runtime Function} {long double} __negtf2 (long double @var{a})
 274 @deftypefnx {Runtime Function} {long double} __negxf2 (long double @var{a})
 275 These functions return the negation of @var{a}.  They simply flip the
 276 sign bit, so they can produce negative zero and negative NaN@.
 277 @end deftypefn
 278
 279 @subsection Conversion functions
 280
 281 @deftypefn {Runtime Function} double __extendsfdf2 (float @var{a})
 282 @deftypefnx {Runtime Function} {long double} __extendsftf2 (float @var{a})
 283 @deftypefnx {Runtime Function} {long double} __extendsfxf2 (float @var{a})
 284 @deftypefnx {Runtime Function} {long double} __extenddftf2 (double @var{a})
 285 @deftypefnx {Runtime Function} {long double} __extenddfxf2 (double @var{a})
 286 These functions extend @var{a} to the wider mode of their return
 287 type.
 288 @end deftypefn
 289
 290 @deftypefn {Runtime Function} double __truncxfdf2 (long double @var{a})
 291 @deftypefnx {Runtime Function} double __trunctfdf2 (long double @var{a})
 292 @deftypefnx {Runtime Function} float __truncxfsf2 (long double @var{a})
 293 @deftypefnx {Runtime Function} float __trunctfsf2 (long double @var{a})
 294 @deftypefnx {Runtime Function} float __truncdfsf2 (double @var{a})
 295 These functions truncate @var{a} to the narrower mode of their return
 296 type, rounding toward zero.
 297 @end deftypefn
 298
 299 @deftypefn {Runtime Function} int __fixsfsi (float @var{a})
 300 @deftypefnx {Runtime Function} int __fixdfsi (double @var{a})
 301 @deftypefnx {Runtime Function} int __fixtfsi (long double @var{a})
 302 @deftypefnx {Runtime Function} int __fixxfsi (long double @var{a})
 303 These functions convert @var{a} to a signed integer, rounding toward zero.
 304 @end deftypefn
 305
 306 @deftypefn {Runtime Function} long __fixsfdi (float @var{a})
 307 @deftypefnx {Runtime Function} long __fixdfdi (double @var{a})
 308 @deftypefnx {Runtime Function} long __fixtfdi (long double @var{a})
 309 @deftypefnx {Runtime Function} long __fixxfdi (long double @var{a})
 310 These functions convert @var{a} to a signed long, rounding toward zero.
 311 @end deftypefn
 312
 313 @deftypefn {Runtime Function} {long long} __fixsfti (float @var{a})
 314 @deftypefnx {Runtime Function} {long long} __fixdfti (double @var{a})
 315 @deftypefnx {Runtime Function} {long long} __fixtfti (long double @var{a})
 316 @deftypefnx {Runtime Function} {long long} __fixxfti (long double @var{a})
 317 These functions convert @var{a} to a signed long long, rounding toward zero.
 318 @end deftypefn
 319
 320 @deftypefn {Runtime Function} {unsigned int} __fixunssfsi (float @var{a})
 321 @deftypefnx {Runtime Function} {unsigned int} __fixunsdfsi (double @var{a})
 322 @deftypefnx {Runtime Function} {unsigned int} __fixunstfsi (long double @var{a})
 323 @deftypefnx {Runtime Function} {unsigned int} __fixunsxfsi (long double @var{a})
 324 These functions convert @var{a} to an unsigned integer, rounding
 325 toward zero.  Negative values all become zero.
 326 @end deftypefn
 327
 328 @deftypefn {Runtime Function} {unsigned long} __fixunssfdi (float @var{a})
 329 @deftypefnx {Runtime Function} {unsigned long} __fixunsdfdi (double @var{a})
 330 @deftypefnx {Runtime Function} {unsigned long} __fixunstfdi (long double @var{a})
 331 @deftypefnx {Runtime Function} {unsigned long} __fixunsxfdi (long double @var{a})
 332 These functions convert @var{a} to an unsigned long, rounding
 333 toward zero.  Negative values all become zero.
 334 @end deftypefn
 335
 336 @deftypefn {Runtime Function} {unsigned long long} __fixunssfti (float @var{a})
 337 @deftypefnx {Runtime Function} {unsigned long long} __fixunsdfti (double @var{a})
 338 @deftypefnx {Runtime Function} {unsigned long long} __fixunstfti (long double @var{a})
 339 @deftypefnx {Runtime Function} {unsigned long long} __fixunsxfti (long double @var{a})
 340 These functions convert @var{a} to an unsigned long long, rounding
 341 toward zero.  Negative values all become zero.
 342 @end deftypefn
 343
 344 @deftypefn {Runtime Function} float __floatsisf (int @var{i})
 345 @deftypefnx {Runtime Function} double __floatsidf (int @var{i})
 346 @deftypefnx {Runtime Function} {long double} __floatsitf (int @var{i})
 347 @deftypefnx {Runtime Function} {long double} __floatsixf (int @var{i})
 348 These functions convert @var{i}, a signed integer, to floating point.
 349 @end deftypefn
 350
 351 @deftypefn {Runtime Function} float __floatdisf (long @var{i})
 352 @deftypefnx {Runtime Function} double __floatdidf (long @var{i})
 353 @deftypefnx {Runtime Function} {long double} __floatditf (long @var{i})
 354 @deftypefnx {Runtime Function} {long double} __floatdixf (long @var{i})
 355 These functions convert @var{i}, a signed long, to floating point.
 356 @end deftypefn
 357
 358 @deftypefn {Runtime Function} float __floattisf (long long @var{i})
 359 @deftypefnx {Runtime Function} double __floattidf (long long @var{i})
 360 @deftypefnx {Runtime Function} {long double} __floattitf (long long @var{i})
 361 @deftypefnx {Runtime Function} {long double} __floattixf (long long @var{i})
 362 These functions convert @var{i}, a signed long long, to floating point.
 363 @end deftypefn
 364
 365 @deftypefn {Runtime Function} float __floatunsisf (unsigned int @var{i})
 366 @deftypefnx {Runtime Function} double __floatunsidf (unsigned int @var{i})
 367 @deftypefnx {Runtime Function} {long double} __floatunsitf (unsigned int @var{i})
 368 @deftypefnx {Runtime Function} {long double} __floatunsixf (unsigned int @var{i})
 369 These functions convert @var{i}, an unsigned integer, to floating point.
 370 @end deftypefn
 371
 372 @deftypefn {Runtime Function} float __floatundisf (unsigned long @var{i})
 373 @deftypefnx {Runtime Function} double __floatundidf (unsigned long @var{i})
 374 @deftypefnx {Runtime Function} {long double} __floatunditf (unsigned long @var{i})
 375 @deftypefnx {Runtime Function} {long double} __floatundixf (unsigned long @var{i})
 376 These functions convert @var{i}, an unsigned long, to floating point.
 377 @end deftypefn
 378
 379 @deftypefn {Runtime Function} float __floatuntisf (unsigned long long @var{i})
 380 @deftypefnx {Runtime Function} double __floatuntidf (unsigned long long @var{i})
 381 @deftypefnx {Runtime Function} {long double} __floatuntitf (unsigned long long @var{i})
 382 @deftypefnx {Runtime Function} {long double} __floatuntixf (unsigned long long @var{i})
 383 These functions convert @var{i}, an unsigned long long, to floating point.
 384 @end deftypefn
 385
 386 @subsection Comparison functions
 387
 388 There are two sets of basic comparison functions.
 389
 390 @deftypefn {Runtime Function} int __cmpsf2 (float @var{a}, float @var{b})
 391 @deftypefnx {Runtime Function} int __cmpdf2 (double @var{a}, double @var{b})
 392 @deftypefnx {Runtime Function} int __cmptf2 (long double @var{a}, long double @var{b})
 393 These functions calculate @math{a <=> b}.  That is, if @var{a} is less
 394 than @var{b}, they return @minus{}1; if @var{a} is greater than @var{b}, they
 395 return 1; and if @var{a} and @var{b} are equal they return 0.  If
 396 either argument is NaN they return 1, but you should not rely on this;
 397 if NaN is a possibility, use one of the higher-level comparison
 398 functions.
 399 @end deftypefn
 400
 401 @deftypefn {Runtime Function} int __unordsf2 (float @var{a}, float @var{b})
 402 @deftypefnx {Runtime Function} int __unorddf2 (double @var{a}, double @var{b})
 403 @deftypefnx {Runtime Function} int __unordtf2 (long double @var{a}, long double @var{b})
 404 These functions return a nonzero value if either argument is NaN, otherwise 0.
 405 @end deftypefn
 406
 407 There is also a complete group of higher level functions which
 408 correspond directly to comparison operators.  They implement the ISO C
 409 semantics for floating-point comparisons, taking NaN into account.
 410 Pay careful attention to the return values defined for each set.
 411 Under the hood, all of these routines are implemented as
 412
 413 @smallexample
 414   if (__unord@var{X}f2 (a, b))
 415     return @var{E};
 416   return __cmp@var{X}f2 (a, b);
 417 @end smallexample
 418
 419 @noindent
 420 where @var{E} is a constant chosen to give the proper behavior for
 421 NaN@.  Thus, the meaning of the return value is different for each set.
 422 Do not rely on this implementation; only the semantics documented
 423 below are guaranteed.
 424
 425 @deftypefn {Runtime Function} int __eqsf2 (float @var{a}, float @var{b})
 426 @deftypefnx {Runtime Function} int __eqdf2 (double @var{a}, double @var{b})
 427 @deftypefnx {Runtime Function} int __eqtf2 (long double @var{a}, long double @var{b})
 428 These functions return zero if neither argument is NaN, and @var{a} and
 429 @var{b} are equal.
 430 @end deftypefn
 431
 432 @deftypefn {Runtime Function} int __nesf2 (float @var{a}, float @var{b})
 433 @deftypefnx {Runtime Function} int __nedf2 (double @var{a}, double @var{b})
 434 @deftypefnx {Runtime Function} int __netf2 (long double @var{a}, long double @var{b})
 435 These functions return a nonzero value if either argument is NaN, or
 436 if @var{a} and @var{b} are unequal.
 437 @end deftypefn
 438
 439 @deftypefn {Runtime Function} int __gesf2 (float @var{a}, float @var{b})
 440 @deftypefnx {Runtime Function} int __gedf2 (double @var{a}, double @var{b})
 441 @deftypefnx {Runtime Function} int __getf2 (long double @var{a}, long double @var{b})
 442 These functions return a value greater than or equal to zero if
 443 neither argument is NaN, and @var{a} is greater than or equal to
 444 @var{b}.
 445 @end deftypefn
 446
 447 @deftypefn {Runtime Function} int __ltsf2 (float @var{a}, float @var{b})
 448 @deftypefnx {Runtime Function} int __ltdf2 (double @var{a}, double @var{b})
 449 @deftypefnx {Runtime Function} int __lttf2 (long double @var{a}, long double @var{b})
 450 These functions return a value less than zero if neither argument is
 451 NaN, and @var{a} is strictly less than @var{b}.
 452 @end deftypefn
 453
 454 @deftypefn {Runtime Function} int __lesf2 (float @var{a}, float @var{b})
 455 @deftypefnx {Runtime Function} int __ledf2 (double @var{a}, double @var{b})
 456 @deftypefnx {Runtime Function} int __letf2 (long double @var{a}, long double @var{b})
 457 These functions return a value less than or equal to zero if neither
 458 argument is NaN, and @var{a} is less than or equal to @var{b}.
 459 @end deftypefn
 460
 461 @deftypefn {Runtime Function} int __gtsf2 (float @var{a}, float @var{b})
 462 @deftypefnx {Runtime Function} int __gtdf2 (double @var{a}, double @var{b})
 463 @deftypefnx {Runtime Function} int __gttf2 (long double @var{a}, long double @var{b})
 464 These functions return a value greater than zero if neither argument
 465 is NaN, and @var{a} is strictly greater than @var{b}.
 466 @end deftypefn
 467
 468 @subsection Other floating-point functions
 469
 470 @deftypefn {Runtime Function} float __powisf2 (float @var{a}, int @var{b})
 471 @deftypefnx {Runtime Function} double __powidf2 (double @var{a}, int @var{b})
 472 @deftypefnx {Runtime Function} {long double} __powitf2 (long double @var{a}, int @var{b})
 473 @deftypefnx {Runtime Function} {long double} __powixf2 (long double @var{a}, int @var{b})
 474 These functions convert raise @var{a} to the power @var{b}.
 475 @end deftypefn
 476
 477 @deftypefn {Runtime Function} {complex float} __mulsc3 (float @var{a}, float @var{b}, float @var{c}, float @var{d})
 478 @deftypefnx {Runtime Function} {complex double} __muldc3 (double @var{a}, double @var{b}, double @var{c}, double @var{d})
 479 @deftypefnx {Runtime Function} {complex long double} __multc3 (long double @var{a}, long double @var{b}, long double @var{c}, long double @var{d})
 480 @deftypefnx {Runtime Function} {complex long double} __mulxc3 (long double @var{a}, long double @var{b}, long double @var{c}, long double @var{d})
 481 These functions return the product of @math{@var{a} + i@var{b}} and
 482 @math{@var{c} + i@var{d}}, following the rules of C99 Annex G@.
 483 @end deftypefn
 484
 485 @deftypefn {Runtime Function} {complex float} __divsc3 (float @var{a}, float @var{b}, float @var{c}, float @var{d})
 486 @deftypefnx {Runtime Function} {complex double} __divdc3 (double @var{a}, double @var{b}, double @var{c}, double @var{d})
 487 @deftypefnx {Runtime Function} {complex long double} __divtc3 (long double @var{a}, long double @var{b}, long double @var{c}, long double @var{d})
 488 @deftypefnx {Runtime Function} {complex long double} __divxc3 (long double @var{a}, long double @var{b}, long double @var{c}, long double @var{d})
 489 These functions return the quotient of @math{@var{a} + i@var{b}} and
 490 @math{@var{c} + i@var{d}} (i.e., @math{(@var{a} + i@var{b}) / (@var{c}
 491 + i@var{d})}), following the rules of C99 Annex G@.
 492 @end deftypefn
 493
 494 @node Decimal float library routines
 495 @section Routines for decimal floating point emulation
 496 @cindex decimal float library
 497 @cindex IEEE-754R
 498
 499 The software decimal floating point library implements IEEE 754R
 500 decimal floating point arithmetic and is only activated on selected
 501 targets.
 502
 503 The software decimal floating point library supports either DPD
 504 (Densely Packed Decimal) or BID (Binary Integer Decimal) encoding
 505 as selected at configure time.
 506
 507
 508 @subsection Arithmetic functions
 509
 510 @deftypefn {Runtime Function} _Decimal32 __dpd_addsd3 (_Decimal32 @var{a}, _Decimal32 @var{b})
 511 @deftypefnx {Runtime Function} _Decimal32 __bid_addsd3 (_Decimal32 @var{a}, _Decimal32 @var{b})
 512 @deftypefnx {Runtime Function} _Decimal64 __dpd_adddd3 (_Decimal64 @var{a}, _Decimal64 @var{b})
 513 @deftypefnx {Runtime Function} _Decimal64 __bid_adddd3 (_Decimal64 @var{a}, _Decimal64 @var{b})
 514 @deftypefnx {Runtime Function} _Decimal128 __dpd_addtd3 (_Decimal128 @var{a}, _Decimal128 @var{b})
 515 @deftypefnx {Runtime Function} _Decimal128 __bid_addtd3 (_Decimal128 @var{a}, _Decimal128 @var{b})
 516 These functions return the sum of @var{a} and @var{b}.
 517 @end deftypefn
 518
 519 @deftypefn {Runtime Function} _Decimal32 __dpd_subsd3 (_Decimal32 @var{a}, _Decimal32 @var{b})
 520 @deftypefnx {Runtime Function} _Decimal32 __bid_subsd3 (_Decimal32 @var{a}, _Decimal32 @var{b})
 521 @deftypefnx {Runtime Function} _Decimal64 __dpd_subdd3 (_Decimal64 @var{a}, _Decimal64 @var{b})
 522 @deftypefnx {Runtime Function} _Decimal64 __bid_subdd3 (_Decimal64 @var{a}, _Decimal64 @var{b})
 523 @deftypefnx {Runtime Function} _Decimal128 __dpd_subtd3 (_Decimal128 @var{a}, _Decimal128 @var{b})
 524 @deftypefnx {Runtime Function} _Decimal128 __bid_subtd3 (_Decimal128 @var{a}, _Decimal128 @var{b})
 525 These functions return the difference between @var{b} and @var{a};
 526 that is, @w{@math{@var{a} - @var{b}}}.
 527 @end deftypefn
 528
 529 @deftypefn {Runtime Function} _Decimal32 __dpd_mulsd3 (_Decimal32 @var{a}, _Decimal32 @var{b})
 530 @deftypefnx {Runtime Function} _Decimal32 __bid_mulsd3 (_Decimal32 @var{a}, _Decimal32 @var{b})
 531 @deftypefnx {Runtime Function} _Decimal64 __dpd_muldd3 (_Decimal64 @var{a}, _Decimal64 @var{b})
 532 @deftypefnx {Runtime Function} _Decimal64 __bid_muldd3 (_Decimal64 @var{a}, _Decimal64 @var{b})
 533 @deftypefnx {Runtime Function} _Decimal128 __dpd_multd3 (_Decimal128 @var{a}, _Decimal128 @var{b})
 534 @deftypefnx {Runtime Function} _Decimal128 __bid_multd3 (_Decimal128 @var{a}, _Decimal128 @var{b})
 535 These functions return the product of @var{a} and @var{b}.
 536 @end deftypefn
 537
 538 @deftypefn {Runtime Function} _Decimal32 __dpd_divsd3 (_Decimal32 @var{a}, _Decimal32 @var{b})
 539 @deftypefnx {Runtime Function} _Decimal32 __bid_divsd3 (_Decimal32 @var{a}, _Decimal32 @var{b})
 540 @deftypefnx {Runtime Function} _Decimal64 __dpd_divdd3 (_Decimal64 @var{a}, _Decimal64 @var{b})
 541 @deftypefnx {Runtime Function} _Decimal64 __bid_divdd3 (_Decimal64 @var{a}, _Decimal64 @var{b})
 542 @deftypefnx {Runtime Function} _Decimal128 __dpd_divtd3 (_Decimal128 @var{a}, _Decimal128 @var{b})
 543 @deftypefnx {Runtime Function} _Decimal128 __bid_divtd3 (_Decimal128 @var{a}, _Decimal128 @var{b})
 544 These functions return the quotient of @var{a} and @var{b}; that is,
 545 @w{@math{@var{a} / @var{b}}}.
 546 @end deftypefn
 547
 548 @deftypefn {Runtime Function} _Decimal32 __dpd_negsd2 (_Decimal32 @var{a})
 549 @deftypefnx {Runtime Function} _Decimal32 __bid_negsd2 (_Decimal32 @var{a})
 550 @deftypefnx {Runtime Function} _Decimal64 __dpd_negdd2 (_Decimal64 @var{a})
 551 @deftypefnx {Runtime Function} _Decimal64 __bid_negdd2 (_Decimal64 @var{a})
 552 @deftypefnx {Runtime Function} _Decimal128 __dpd_negtd2 (_Decimal128 @var{a})
 553 @deftypefnx {Runtime Function} _Decimal128 __bid_negtd2 (_Decimal128 @var{a})
 554 These functions return the negation of @var{a}.  They simply flip the
 555 sign bit, so they can produce negative zero and negative NaN@.
 556 @end deftypefn
 557
 558 @subsection Conversion functions
 559
 560 @c DFP/DFP conversions
 561 @deftypefn {Runtime Function} _Decimal64 __dpd_extendsddd2 (_Decimal32 @var{a})
 562 @deftypefnx {Runtime Function} _Decimal64 __bid_extendsddd2 (_Decimal32 @var{a})
 563 @deftypefnx {Runtime Function} _Decimal128 __dpd_extendsdtd2 (_Decimal32 @var{a})
 564 @deftypefnx {Runtime Function} _Decimal128 __bid_extendsdtd2 (_Decimal32 @var{a})
 565 @deftypefnx {Runtime Function} _Decimal128 __dpd_extendddtd2 (_Decimal64 @var{a})
 566 @deftypefnx {Runtime Function} _Decimal128 __bid_extendddtd2 (_Decimal64 @var{a})
 567 @c DFP/binary FP conversions
 568 @deftypefnx {Runtime Function} _Decimal32 __dpd_extendsfsd (float @var{a})
 569 @deftypefnx {Runtime Function} _Decimal32 __bid_extendsfsd (float @var{a})
 570 @deftypefnx {Runtime Function} double __dpd_extendsddf (_Decimal32 @var{a})
 571 @deftypefnx {Runtime Function} double __bid_extendsddf (_Decimal32 @var{a})
 572 @deftypefnx {Runtime Function} {long double} __dpd_extendsdxf (_Decimal32 @var{a})
 573 @deftypefnx {Runtime Function} {long double} __bid_extendsdxf (_Decimal32 @var{a})
 574 @deftypefnx {Runtime Function} _Decimal64 __dpd_extendsfdd (float @var{a})
 575 @deftypefnx {Runtime Function} _Decimal64 __bid_extendsfdd (float @var{a})
 576 @deftypefnx {Runtime Function} _Decimal64 __dpd_extenddfdd (double @var{a})
 577 @deftypefnx {Runtime Function} _Decimal64 __bid_extenddfdd (double @var{a})
 578 @deftypefnx {Runtime Function} {long double} __dpd_extendddxf (_Decimal64 @var{a})
 579 @deftypefnx {Runtime Function} {long double} __bid_extendddxf (_Decimal64 @var{a})
 580 @deftypefnx {Runtime Function} _Decimal128 __dpd_extendsftd (float @var{a})
 581 @deftypefnx {Runtime Function} _Decimal128 __bid_extendsftd (float @var{a})
 582 @deftypefnx {Runtime Function} _Decimal128 __dpd_extenddftd (double @var{a})
 583 @deftypefnx {Runtime Function} _Decimal128 __bid_extenddftd (double @var{a})
 584 @deftypefnx {Runtime Function} _Decimal128 __dpd_extendxftd ({long double} @var{a})
 585 @deftypefnx {Runtime Function} _Decimal128 __bid_extendxftd ({long double} @var{a})
 586 These functions extend @var{a} to the wider mode of their return type.
 587 @end deftypefn
 588
 589 @c DFP/DFP conversions
 590 @deftypefn {Runtime Function} _Decimal32 __dpd_truncddsd2 (_Decimal64 @var{a})
 591 @deftypefnx {Runtime Function} _Decimal32 __bid_truncddsd2 (_Decimal64 @var{a})
 592 @deftypefnx {Runtime Function} _Decimal32 __dpd_trunctdsd2 (_Decimal128 @var{a})
 593 @deftypefnx {Runtime Function} _Decimal32 __bid_trunctdsd2 (_Decimal128 @var{a})
 594 @deftypefnx {Runtime Function} _Decimal64 __dpd_trunctddd2 (_Decimal128 @var{a})
 595 @deftypefnx {Runtime Function} _Decimal64 __bid_trunctddd2 (_Decimal128 @var{a})
 596 @c DFP/binary FP conversions
 597 @deftypefnx {Runtime Function} float __dpd_truncsdsf (_Decimal32 @var{a})
 598 @deftypefnx {Runtime Function} float __bid_truncsdsf (_Decimal32 @var{a})
 599 @deftypefnx {Runtime Function} _Decimal32 __dpd_truncdfsd (double @var{a})
 600 @deftypefnx {Runtime Function} _Decimal32 __bid_truncdfsd (double @var{a})
 601 @deftypefnx {Runtime Function} _Decimal32 __dpd_truncxfsd ({long double} @var{a})
 602 @deftypefnx {Runtime Function} _Decimal32 __bid_truncxfsd ({long double} @var{a})
 603 @deftypefnx {Runtime Function} float __dpd_truncddsf (_Decimal64 @var{a})
 604 @deftypefnx {Runtime Function} float __bid_truncddsf (_Decimal64 @var{a})
 605 @deftypefnx {Runtime Function} double __dpd_truncdddf (_Decimal64 @var{a})
 606 @deftypefnx {Runtime Function} double __bid_truncdddf (_Decimal64 @var{a})
 607 @deftypefnx {Runtime Function} _Decimal64 __dpd_truncxfdd ({long double} @var{a})
 608 @deftypefnx {Runtime Function} _Decimal64 __bid_truncxfdd ({long double} @var{a})
 609 @deftypefnx {Runtime Function} float __dpd_trunctdsf (_Decimal128 @var{a})
 610 @deftypefnx {Runtime Function} float __bid_trunctdsf (_Decimal128 @var{a})
 611 @deftypefnx {Runtime Function} double __dpd_trunctddf (_Decimal128 @var{a})
 612 @deftypefnx {Runtime Function} double __bid_trunctddf (_Decimal128 @var{a})
 613 @deftypefnx {Runtime Function} {long double} __dpd_trunctdxf (_Decimal128 @var{a})
 614 @deftypefnx {Runtime Function} {long double} __bid_trunctdxf (_Decimal128 @var{a})
 615 These functions truncate @var{a} to the narrower mode of their return
 616 type.
 617 @end deftypefn
 618
 619 @deftypefn {Runtime Function} int __dpd_fixsdsi (_Decimal32 @var{a})
 620 @deftypefnx {Runtime Function} int __bid_fixsdsi (_Decimal32 @var{a})
 621 @deftypefnx {Runtime Function} int __dpd_fixddsi (_Decimal64 @var{a})
 622 @deftypefnx {Runtime Function} int __bid_fixddsi (_Decimal64 @var{a})
 623 @deftypefnx {Runtime Function} int __dpd_fixtdsi (_Decimal128 @var{a})
 624 @deftypefnx {Runtime Function} int __bid_fixtdsi (_Decimal128 @var{a})
 625 These functions convert @var{a} to a signed integer.
 626 @end deftypefn
 627
 628 @deftypefn {Runtime Function} long __dpd_fixsddi (_Decimal32 @var{a})
 629 @deftypefnx {Runtime Function} long __bid_fixsddi (_Decimal32 @var{a})
 630 @deftypefnx {Runtime Function} long __dpd_fixdddi (_Decimal64 @var{a})
 631 @deftypefnx {Runtime Function} long __bid_fixdddi (_Decimal64 @var{a})
 632 @deftypefnx {Runtime Function} long __dpd_fixtddi (_Decimal128 @var{a})
 633 @deftypefnx {Runtime Function} long __bid_fixtddi (_Decimal128 @var{a})
 634 These functions convert @var{a} to a signed long.
 635 @end deftypefn
 636
 637 @deftypefn {Runtime Function} {unsigned int} __dpd_fixunssdsi (_Decimal32 @var{a})
 638 @deftypefnx {Runtime Function} {unsigned int} __bid_fixunssdsi (_Decimal32 @var{a})
 639 @deftypefnx {Runtime Function} {unsigned int} __dpd_fixunsddsi (_Decimal64 @var{a})
 640 @deftypefnx {Runtime Function} {unsigned int} __bid_fixunsddsi (_Decimal64 @var{a})
 641 @deftypefnx {Runtime Function} {unsigned int} __dpd_fixunstdsi (_Decimal128 @var{a})
 642 @deftypefnx {Runtime Function} {unsigned int} __bid_fixunstdsi (_Decimal128 @var{a})
 643 These functions convert @var{a} to an unsigned integer.  Negative values all become zero.
 644 @end deftypefn
 645
 646 @deftypefn {Runtime Function} {unsigned long} __dpd_fixunssddi (_Decimal32 @var{a})
 647 @deftypefnx {Runtime Function} {unsigned long} __bid_fixunssddi (_Decimal32 @var{a})
 648 @deftypefnx {Runtime Function} {unsigned long} __dpd_fixunsdddi (_Decimal64 @var{a})
 649 @deftypefnx {Runtime Function} {unsigned long} __bid_fixunsdddi (_Decimal64 @var{a})
 650 @deftypefnx {Runtime Function} {unsigned long} __dpd_fixunstddi (_Decimal128 @var{a})
 651 @deftypefnx {Runtime Function} {unsigned long} __bid_fixunstddi (_Decimal128 @var{a})
 652 These functions convert @var{a} to an unsigned long.  Negative values
 653 all become zero.
 654 @end deftypefn
 655
 656 @deftypefn {Runtime Function} _Decimal32 __dpd_floatsisd (int @var{i})
 657 @deftypefnx {Runtime Function} _Decimal32 __bid_floatsisd (int @var{i})
 658 @deftypefnx {Runtime Function} _Decimal64 __dpd_floatsidd (int @var{i})
 659 @deftypefnx {Runtime Function} _Decimal64 __bid_floatsidd (int @var{i})
 660 @deftypefnx {Runtime Function} _Decimal128 __dpd_floatsitd (int @var{i})
 661 @deftypefnx {Runtime Function} _Decimal128 __bid_floatsitd (int @var{i})
 662 These functions convert @var{i}, a signed integer, to decimal floating point.
 663 @end deftypefn
 664
 665 @deftypefn {Runtime Function} _Decimal32 __dpd_floatdisd (long @var{i})
 666 @deftypefnx {Runtime Function} _Decimal32 __bid_floatdisd (long @var{i})
 667 @deftypefnx {Runtime Function} _Decimal64 __dpd_floatdidd (long @var{i})
 668 @deftypefnx {Runtime Function} _Decimal64 __bid_floatdidd (long @var{i})
 669 @deftypefnx {Runtime Function} _Decimal128 __dpd_floatditd (long @var{i})
 670 @deftypefnx {Runtime Function} _Decimal128 __bid_floatditd (long @var{i})
 671 These functions convert @var{i}, a signed long, to decimal floating point.
 672 @end deftypefn
 673
 674 @deftypefn {Runtime Function} _Decimal32 __dpd_floatunssisd (unsigned int @var{i})
 675 @deftypefnx {Runtime Function} _Decimal32 __bid_floatunssisd (unsigned int @var{i})
 676 @deftypefnx {Runtime Function} _Decimal64 __dpd_floatunssidd (unsigned int @var{i})
 677 @deftypefnx {Runtime Function} _Decimal64 __bid_floatunssidd (unsigned int @var{i})
 678 @deftypefnx {Runtime Function} _Decimal128 __dpd_floatunssitd (unsigned int @var{i})
 679 @deftypefnx {Runtime Function} _Decimal128 __bid_floatunssitd (unsigned int @var{i})
 680 These functions convert @var{i}, an unsigned integer, to decimal floating point.
 681 @end deftypefn
 682
 683 @deftypefn {Runtime Function} _Decimal32 __dpd_floatunsdisd (unsigned long @var{i})
 684 @deftypefnx {Runtime Function} _Decimal32 __bid_floatunsdisd (unsigned long @var{i})
 685 @deftypefnx {Runtime Function} _Decimal64 __dpd_floatunsdidd (unsigned long @var{i})
 686 @deftypefnx {Runtime Function} _Decimal64 __bid_floatunsdidd (unsigned long @var{i})
 687 @deftypefnx {Runtime Function} _Decimal128 __dpd_floatunsditd (unsigned long @var{i})
 688 @deftypefnx {Runtime Function} _Decimal128 __bid_floatunsditd (unsigned long @var{i})
 689 These functions convert @var{i}, an unsigned long, to decimal floating point.
 690 @end deftypefn
 691
 692 @subsection Comparison functions
 693
 694 @deftypefn {Runtime Function} int __dpd_unordsd2 (_Decimal32 @var{a}, _Decimal32 @var{b})
 695 @deftypefnx {Runtime Function} int __bid_unordsd2 (_Decimal32 @var{a}, _Decimal32 @var{b})
 696 @deftypefnx {Runtime Function} int __dpd_unorddd2 (_Decimal64 @var{a}, _Decimal64 @var{b})
 697 @deftypefnx {Runtime Function} int __bid_unorddd2 (_Decimal64 @var{a}, _Decimal64 @var{b})
 698 @deftypefnx {Runtime Function} int __dpd_unordtd2 (_Decimal128 @var{a}, _Decimal128 @var{b})
 699 @deftypefnx {Runtime Function} int __bid_unordtd2 (_Decimal128 @var{a}, _Decimal128 @var{b})
 700 These functions return a nonzero value if either argument is NaN, otherwise 0.
 701 @end deftypefn
 702
 703 There is also a complete group of higher level functions which
 704 correspond directly to comparison operators.  They implement the ISO C
 705 semantics for floating-point comparisons, taking NaN into account.
 706 Pay careful attention to the return values defined for each set.
 707 Under the hood, all of these routines are implemented as
 708
 709 @smallexample
 710   if (__bid_unord@var{X}d2 (a, b))
 711     return @var{E};
 712   return __bid_cmp@var{X}d2 (a, b);
 713 @end smallexample
 714
 715 @noindent
 716 where @var{E} is a constant chosen to give the proper behavior for
 717 NaN@.  Thus, the meaning of the return value is different for each set.
 718 Do not rely on this implementation; only the semantics documented
 719 below are guaranteed.
 720
 721 @deftypefn {Runtime Function} int __dpd_eqsd2 (_Decimal32 @var{a}, _Decimal32 @var{b})
 722 @deftypefnx {Runtime Function} int __bid_eqsd2 (_Decimal32 @var{a}, _Decimal32 @var{b})
 723 @deftypefnx {Runtime Function} int __dpd_eqdd2 (_Decimal64 @var{a}, _Decimal64 @var{b})
 724 @deftypefnx {Runtime Function} int __bid_eqdd2 (_Decimal64 @var{a}, _Decimal64 @var{b})
 725 @deftypefnx {Runtime Function} int __dpd_eqtd2 (_Decimal128 @var{a}, _Decimal128 @var{b})
 726 @deftypefnx {Runtime Function} int __bid_eqtd2 (_Decimal128 @var{a}, _Decimal128 @var{b})
 727 These functions return zero if neither argument is NaN, and @var{a} and
 728 @var{b} are equal.
 729 @end deftypefn
 730
 731 @deftypefn {Runtime Function} int __dpd_nesd2 (_Decimal32 @var{a}, _Decimal32 @var{b})
 732 @deftypefnx {Runtime Function} int __bid_nesd2 (_Decimal32 @var{a}, _Decimal32 @var{b})
 733 @deftypefnx {Runtime Function} int __dpd_nedd2 (_Decimal64 @var{a}, _Decimal64 @var{b})
 734 @deftypefnx {Runtime Function} int __bid_nedd2 (_Decimal64 @var{a}, _Decimal64 @var{b})
 735 @deftypefnx {Runtime Function} int __dpd_netd2 (_Decimal128 @var{a}, _Decimal128 @var{b})
 736 @deftypefnx {Runtime Function} int __bid_netd2 (_Decimal128 @var{a}, _Decimal128 @var{b})
 737 These functions return a nonzero value if either argument is NaN, or
 738 if @var{a} and @var{b} are unequal.
 739 @end deftypefn
 740
 741 @deftypefn {Runtime Function} int __dpd_gesd2 (_Decimal32 @var{a}, _Decimal32 @var{b})
 742 @deftypefnx {Runtime Function} int __bid_gesd2 (_Decimal32 @var{a}, _Decimal32 @var{b})
 743 @deftypefnx {Runtime Function} int __dpd_gedd2 (_Decimal64 @var{a}, _Decimal64 @var{b})
 744 @deftypefnx {Runtime Function} int __bid_gedd2 (_Decimal64 @var{a}, _Decimal64 @var{b})
 745 @deftypefnx {Runtime Function} int __dpd_getd2 (_Decimal128 @var{a}, _Decimal128 @var{b})
 746 @deftypefnx {Runtime Function} int __bid_getd2 (_Decimal128 @var{a}, _Decimal128 @var{b})
 747 These functions return a value greater than or equal to zero if
 748 neither argument is NaN, and @var{a} is greater than or equal to
 749 @var{b}.
 750 @end deftypefn
 751
 752 @deftypefn {Runtime Function} int __dpd_ltsd2 (_Decimal32 @var{a}, _Decimal32 @var{b})
 753 @deftypefnx {Runtime Function} int __bid_ltsd2 (_Decimal32 @var{a}, _Decimal32 @var{b})
 754 @deftypefnx {Runtime Function} int __dpd_ltdd2 (_Decimal64 @var{a}, _Decimal64 @var{b})
 755 @deftypefnx {Runtime Function} int __bid_ltdd2 (_Decimal64 @var{a}, _Decimal64 @var{b})
 756 @deftypefnx {Runtime Function} int __dpd_lttd2 (_Decimal128 @var{a}, _Decimal128 @var{b})
 757 @deftypefnx {Runtime Function} int __bid_lttd2 (_Decimal128 @var{a}, _Decimal128 @var{b})
 758 These functions return a value less than zero if neither argument is
 759 NaN, and @var{a} is strictly less than @var{b}.
 760 @end deftypefn
 761
 762 @deftypefn {Runtime Function} int __dpd_lesd2 (_Decimal32 @var{a}, _Decimal32 @var{b})
 763 @deftypefnx {Runtime Function} int __bid_lesd2 (_Decimal32 @var{a}, _Decimal32 @var{b})
 764 @deftypefnx {Runtime Function} int __dpd_ledd2 (_Decimal64 @var{a}, _Decimal64 @var{b})
 765 @deftypefnx {Runtime Function} int __bid_ledd2 (_Decimal64 @var{a}, _Decimal64 @var{b})
 766 @deftypefnx {Runtime Function} int __dpd_letd2 (_Decimal128 @var{a}, _Decimal128 @var{b})
 767 @deftypefnx {Runtime Function} int __bid_letd2 (_Decimal128 @var{a}, _Decimal128 @var{b})
 768 These functions return a value less than or equal to zero if neither
 769 argument is NaN, and @var{a} is less than or equal to @var{b}.
 770 @end deftypefn
 771
 772 @deftypefn {Runtime Function} int __dpd_gtsd2 (_Decimal32 @var{a}, _Decimal32 @var{b})
 773 @deftypefnx {Runtime Function} int __bid_gtsd2 (_Decimal32 @var{a}, _Decimal32 @var{b})
 774 @deftypefnx {Runtime Function} int __dpd_gtdd2 (_Decimal64 @var{a}, _Decimal64 @var{b})
 775 @deftypefnx {Runtime Function} int __bid_gtdd2 (_Decimal64 @var{a}, _Decimal64 @var{b})
 776 @deftypefnx {Runtime Function} int __dpd_gttd2 (_Decimal128 @var{a}, _Decimal128 @var{b})
 777 @deftypefnx {Runtime Function} int __bid_gttd2 (_Decimal128 @var{a}, _Decimal128 @var{b})
 778 These functions return a value greater than zero if neither argument
 779 is NaN, and @var{a} is strictly greater than @var{b}.
 780 @end deftypefn
 781
 782 @node Exception handling routines
 783 @section Language-independent routines for exception handling
 784
 785 document me!
 786
 787 @smallexample
 788   _Unwind_DeleteException
 789   _Unwind_Find_FDE
 790   _Unwind_ForcedUnwind
 791   _Unwind_GetGR
 792   _Unwind_GetIP
 793   _Unwind_GetLanguageSpecificData
 794   _Unwind_GetRegionStart
 795   _Unwind_GetTextRelBase
 796   _Unwind_GetDataRelBase
 797   _Unwind_RaiseException
 798   _Unwind_Resume
 799   _Unwind_SetGR
 800   _Unwind_SetIP
 801   _Unwind_FindEnclosingFunction
 802   _Unwind_SjLj_Register
 803   _Unwind_SjLj_Unregister
 804   _Unwind_SjLj_RaiseException
 805   _Unwind_SjLj_ForcedUnwind
 806   _Unwind_SjLj_Resume
 807   __deregister_frame
 808   __deregister_frame_info
 809   __deregister_frame_info_bases
 810   __register_frame
 811   __register_frame_info
 812   __register_frame_info_bases
 813   __register_frame_info_table
 814   __register_frame_info_table_bases
 815   __register_frame_table
 816 @end smallexample
 817
 818 @node Miscellaneous routines
 819 @section Miscellaneous runtime library routines
 820
 821 @subsection Cache control functions
 822 @deftypefn {Runtime Function} void __clear_cache (char *@var{beg}, char *@var{end})
 823 This function clears the instruction cache between @var{beg} and @var{end}.
 824 @end deftypefn