1 /* Floating point routines for GDB, the GNU debugger.
2 Copyright 1986, 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996,
3 1997, 1998, 1999, 2000, 2001
4 Free Software Foundation, Inc.
6 This file is part of GDB.
8 This program is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 2 of the License, or
11 (at your option) any later version.
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with this program; if not, write to the Free Software
20 Foundation, Inc., 59 Temple Place - Suite 330,
21 Boston, MA 02111-1307, USA. */
23 /* Support for converting target fp numbers into host DOUBLEST format. */
25 /* XXX - This code should really be in libiberty/floatformat.c,
26 however configuration issues with libiberty made this very
27 difficult to do in the available time. */
31 #include "floatformat.h"
32 #include "gdb_assert.h"
33 #include "gdb_string.h"
35 #include <math.h> /* ldexp */
37 /* The odds that CHAR_BIT will be anything but 8 are low enough that I'm not
38 going to bother with trying to muck around with whether it is defined in
39 a system header, what we do if not, etc. */
40 #define FLOATFORMAT_CHAR_BIT 8
42 static unsigned long get_field (unsigned char *,
43 enum floatformat_byteorders,
44 unsigned int, unsigned int, unsigned int);
46 /* Extract a field which starts at START and is LEN bytes long. DATA and
47 TOTAL_LEN are the thing we are extracting it from, in byteorder ORDER. */
49 get_field (unsigned char *data, enum floatformat_byteorders order,
50 unsigned int total_len, unsigned int start, unsigned int len)
53 unsigned int cur_byte;
56 /* Start at the least significant part of the field. */
57 if (order == floatformat_little || order == floatformat_littlebyte_bigword)
59 /* We start counting from the other end (i.e, from the high bytes
60 rather than the low bytes). As such, we need to be concerned
61 with what happens if bit 0 doesn't start on a byte boundary.
62 I.e, we need to properly handle the case where total_len is
63 not evenly divisible by 8. So we compute ``excess'' which
64 represents the number of bits from the end of our starting
65 byte needed to get to bit 0. */
66 int excess = FLOATFORMAT_CHAR_BIT - (total_len % FLOATFORMAT_CHAR_BIT);
67 cur_byte = (total_len / FLOATFORMAT_CHAR_BIT)
68 - ((start + len + excess) / FLOATFORMAT_CHAR_BIT);
69 cur_bitshift = ((start + len + excess) % FLOATFORMAT_CHAR_BIT)
70 - FLOATFORMAT_CHAR_BIT;
74 cur_byte = (start + len) / FLOATFORMAT_CHAR_BIT;
76 ((start + len) % FLOATFORMAT_CHAR_BIT) - FLOATFORMAT_CHAR_BIT;
78 if (cur_bitshift > -FLOATFORMAT_CHAR_BIT)
79 result = *(data + cur_byte) >> (-cur_bitshift);
82 cur_bitshift += FLOATFORMAT_CHAR_BIT;
83 if (order == floatformat_little || order == floatformat_littlebyte_bigword)
88 /* Move towards the most significant part of the field. */
89 while (cur_bitshift < len)
91 result |= (unsigned long)*(data + cur_byte) << cur_bitshift;
92 cur_bitshift += FLOATFORMAT_CHAR_BIT;
93 if (order == floatformat_little || order == floatformat_littlebyte_bigword)
98 if (len < sizeof(result) * FLOATFORMAT_CHAR_BIT)
99 /* Mask out bits which are not part of the field */
100 result &= ((1UL << len) - 1);
104 /* Convert from FMT to a DOUBLEST.
105 FROM is the address of the extended float.
106 Store the DOUBLEST in *TO. */
109 convert_floatformat_to_doublest (const struct floatformat *fmt,
113 unsigned char *ufrom = (unsigned char *) from;
117 unsigned int mant_bits, mant_off;
119 int special_exponent; /* It's a NaN, denorm or zero */
121 /* If the mantissa bits are not contiguous from one end of the
122 mantissa to the other, we need to make a private copy of the
123 source bytes that is in the right order since the unpacking
124 algorithm assumes that the bits are contiguous.
126 Swap the bytes individually rather than accessing them through
127 "long *" since we have no guarantee that they start on a long
128 alignment, and also sizeof(long) for the host could be different
129 than sizeof(long) for the target. FIXME: Assumes sizeof(long)
130 for the target is 4. */
132 if (fmt->byteorder == floatformat_littlebyte_bigword)
134 static unsigned char *newfrom;
135 unsigned char *swapin, *swapout;
138 longswaps = fmt->totalsize / FLOATFORMAT_CHAR_BIT;
143 newfrom = (unsigned char *) xmalloc (fmt->totalsize);
148 while (longswaps-- > 0)
150 /* This is ugly, but efficient */
151 *swapout++ = swapin[4];
152 *swapout++ = swapin[5];
153 *swapout++ = swapin[6];
154 *swapout++ = swapin[7];
155 *swapout++ = swapin[0];
156 *swapout++ = swapin[1];
157 *swapout++ = swapin[2];
158 *swapout++ = swapin[3];
163 exponent = get_field (ufrom, fmt->byteorder, fmt->totalsize,
164 fmt->exp_start, fmt->exp_len);
165 /* Note that if exponent indicates a NaN, we can't really do anything useful
166 (not knowing if the host has NaN's, or how to build one). So it will
167 end up as an infinity or something close; that is OK. */
169 mant_bits_left = fmt->man_len;
170 mant_off = fmt->man_start;
173 special_exponent = exponent == 0 || exponent == fmt->exp_nan;
175 /* Don't bias NaNs. Use minimum exponent for denorms. For simplicity,
176 we don't check for zero as the exponent doesn't matter. */
177 if (!special_exponent)
178 exponent -= fmt->exp_bias;
179 else if (exponent == 0)
180 exponent = 1 - fmt->exp_bias;
182 /* Build the result algebraically. Might go infinite, underflow, etc;
185 /* If this format uses a hidden bit, explicitly add it in now. Otherwise,
186 increment the exponent by one to account for the integer bit. */
188 if (!special_exponent)
190 if (fmt->intbit == floatformat_intbit_no)
191 dto = ldexp (1.0, exponent);
196 while (mant_bits_left > 0)
198 mant_bits = min (mant_bits_left, 32);
200 mant = get_field (ufrom, fmt->byteorder, fmt->totalsize,
201 mant_off, mant_bits);
203 dto += ldexp ((double) mant, exponent - mant_bits);
204 exponent -= mant_bits;
205 mant_off += mant_bits;
206 mant_bits_left -= mant_bits;
209 /* Negate it if negative. */
210 if (get_field (ufrom, fmt->byteorder, fmt->totalsize, fmt->sign_start, 1))
215 static void put_field (unsigned char *, enum floatformat_byteorders,
217 unsigned int, unsigned int, unsigned long);
219 /* Set a field which starts at START and is LEN bytes long. DATA and
220 TOTAL_LEN are the thing we are extracting it from, in byteorder ORDER. */
222 put_field (unsigned char *data, enum floatformat_byteorders order,
223 unsigned int total_len, unsigned int start, unsigned int len,
224 unsigned long stuff_to_put)
226 unsigned int cur_byte;
229 /* Start at the least significant part of the field. */
230 if (order == floatformat_little || order == floatformat_littlebyte_bigword)
232 int excess = FLOATFORMAT_CHAR_BIT - (total_len % FLOATFORMAT_CHAR_BIT);
233 cur_byte = (total_len / FLOATFORMAT_CHAR_BIT)
234 - ((start + len + excess) / FLOATFORMAT_CHAR_BIT);
235 cur_bitshift = ((start + len + excess) % FLOATFORMAT_CHAR_BIT)
236 - FLOATFORMAT_CHAR_BIT;
240 cur_byte = (start + len) / FLOATFORMAT_CHAR_BIT;
242 ((start + len) % FLOATFORMAT_CHAR_BIT) - FLOATFORMAT_CHAR_BIT;
244 if (cur_bitshift > -FLOATFORMAT_CHAR_BIT)
246 *(data + cur_byte) &=
247 ~(((1 << ((start + len) % FLOATFORMAT_CHAR_BIT)) - 1)
249 *(data + cur_byte) |=
250 (stuff_to_put & ((1 << FLOATFORMAT_CHAR_BIT) - 1)) << (-cur_bitshift);
252 cur_bitshift += FLOATFORMAT_CHAR_BIT;
253 if (order == floatformat_little || order == floatformat_littlebyte_bigword)
258 /* Move towards the most significant part of the field. */
259 while (cur_bitshift < len)
261 if (len - cur_bitshift < FLOATFORMAT_CHAR_BIT)
263 /* This is the last byte. */
264 *(data + cur_byte) &=
265 ~((1 << (len - cur_bitshift)) - 1);
266 *(data + cur_byte) |= (stuff_to_put >> cur_bitshift);
269 *(data + cur_byte) = ((stuff_to_put >> cur_bitshift)
270 & ((1 << FLOATFORMAT_CHAR_BIT) - 1));
271 cur_bitshift += FLOATFORMAT_CHAR_BIT;
272 if (order == floatformat_little || order == floatformat_littlebyte_bigword)
279 #ifdef HAVE_LONG_DOUBLE
280 /* Return the fractional part of VALUE, and put the exponent of VALUE in *EPTR.
281 The range of the returned value is >= 0.5 and < 1.0. This is equivalent to
282 frexp, but operates on the long double data type. */
284 static long double ldfrexp (long double value, int *eptr);
287 ldfrexp (long double value, int *eptr)
292 /* Unfortunately, there are no portable functions for extracting the exponent
293 of a long double, so we have to do it iteratively by multiplying or dividing
294 by two until the fraction is between 0.5 and 1.0. */
302 if (value >= tmp) /* Value >= 1.0 */
308 else if (value != 0.0l) /* Value < 1.0 and > 0.0 */
322 #endif /* HAVE_LONG_DOUBLE */
325 /* The converse: convert the DOUBLEST *FROM to an extended float
326 and store where TO points. Neither FROM nor TO have any alignment
330 convert_doublest_to_floatformat (CONST struct floatformat *fmt,
331 const DOUBLEST *from,
337 unsigned int mant_bits, mant_off;
339 unsigned char *uto = (unsigned char *) to;
341 memcpy (&dfrom, from, sizeof (dfrom));
342 memset (uto, 0, (fmt->totalsize + FLOATFORMAT_CHAR_BIT - 1)
343 / FLOATFORMAT_CHAR_BIT);
345 return; /* Result is zero */
346 if (dfrom != dfrom) /* Result is NaN */
349 put_field (uto, fmt->byteorder, fmt->totalsize, fmt->exp_start,
350 fmt->exp_len, fmt->exp_nan);
351 /* Be sure it's not infinity, but NaN value is irrel */
352 put_field (uto, fmt->byteorder, fmt->totalsize, fmt->man_start,
357 /* If negative, set the sign bit. */
360 put_field (uto, fmt->byteorder, fmt->totalsize, fmt->sign_start, 1, 1);
364 if (dfrom + dfrom == dfrom && dfrom != 0.0) /* Result is Infinity */
366 /* Infinity exponent is same as NaN's. */
367 put_field (uto, fmt->byteorder, fmt->totalsize, fmt->exp_start,
368 fmt->exp_len, fmt->exp_nan);
369 /* Infinity mantissa is all zeroes. */
370 put_field (uto, fmt->byteorder, fmt->totalsize, fmt->man_start,
375 #ifdef HAVE_LONG_DOUBLE
376 mant = ldfrexp (dfrom, &exponent);
378 mant = frexp (dfrom, &exponent);
381 put_field (uto, fmt->byteorder, fmt->totalsize, fmt->exp_start, fmt->exp_len,
382 exponent + fmt->exp_bias - 1);
384 mant_bits_left = fmt->man_len;
385 mant_off = fmt->man_start;
386 while (mant_bits_left > 0)
388 unsigned long mant_long;
389 mant_bits = mant_bits_left < 32 ? mant_bits_left : 32;
391 mant *= 4294967296.0;
392 mant_long = ((unsigned long) mant) & 0xffffffffL;
395 /* If the integer bit is implicit, then we need to discard it.
396 If we are discarding a zero, we should be (but are not) creating
397 a denormalized number which means adjusting the exponent
399 if (mant_bits_left == fmt->man_len
400 && fmt->intbit == floatformat_intbit_no)
403 mant_long &= 0xffffffffL;
409 /* The bits we want are in the most significant MANT_BITS bits of
410 mant_long. Move them to the least significant. */
411 mant_long >>= 32 - mant_bits;
414 put_field (uto, fmt->byteorder, fmt->totalsize,
415 mant_off, mant_bits, mant_long);
416 mant_off += mant_bits;
417 mant_bits_left -= mant_bits;
419 if (fmt->byteorder == floatformat_littlebyte_bigword)
422 unsigned char *swaplow = uto;
423 unsigned char *swaphigh = uto + 4;
426 for (count = 0; count < 4; count++)
429 *swaplow++ = *swaphigh;
435 /* Check if VAL (which is assumed to be a floating point number whose
436 format is described by FMT) is negative. */
439 floatformat_is_negative (const struct floatformat *fmt, char *val)
441 unsigned char *uval = (unsigned char *) val;
443 return get_field (uval, fmt->byteorder, fmt->totalsize, fmt->sign_start, 1);
446 /* Check if VAL is "not a number" (NaN) for FMT. */
449 floatformat_is_nan (const struct floatformat *fmt, char *val)
451 unsigned char *uval = (unsigned char *) val;
454 unsigned int mant_bits, mant_off;
460 exponent = get_field (uval, fmt->byteorder, fmt->totalsize,
461 fmt->exp_start, fmt->exp_len);
463 if (exponent != fmt->exp_nan)
466 mant_bits_left = fmt->man_len;
467 mant_off = fmt->man_start;
469 while (mant_bits_left > 0)
471 mant_bits = min (mant_bits_left, 32);
473 mant = get_field (uval, fmt->byteorder, fmt->totalsize,
474 mant_off, mant_bits);
476 /* If there is an explicit integer bit, mask it off. */
477 if (mant_off == fmt->man_start
478 && fmt->intbit == floatformat_intbit_yes)
479 mant &= ~(1 << (mant_bits - 1));
484 mant_off += mant_bits;
485 mant_bits_left -= mant_bits;
491 /* Convert the mantissa of VAL (which is assumed to be a floating
492 point number whose format is described by FMT) into a hexadecimal
493 and store it in a static string. Return a pointer to that string. */
496 floatformat_mantissa (const struct floatformat *fmt, char *val)
498 unsigned char *uval = (unsigned char *) val;
500 unsigned int mant_bits, mant_off;
505 /* Make sure we have enough room to store the mantissa. */
506 gdb_assert (sizeof res > ((fmt->man_len + 7) / 8) * 2);
508 mant_off = fmt->man_start;
509 mant_bits_left = fmt->man_len;
510 mant_bits = (mant_bits_left % 32) > 0 ? mant_bits_left % 32 : 32;
512 mant = get_field (uval, fmt->byteorder, fmt->totalsize,
513 mant_off, mant_bits);
515 sprintf (res, "%lx", mant);
517 mant_off += mant_bits;
518 mant_bits_left -= mant_bits;
520 while (mant_bits_left > 0)
522 mant = get_field (uval, fmt->byteorder, fmt->totalsize,
525 sprintf (buf, "%08lx", mant);
529 mant_bits_left -= 32;
536 /* Convert TO/FROM target to the hosts DOUBLEST floating-point format.
538 If the host and target formats agree, we just copy the raw data
539 into the appropriate type of variable and return, letting the host
540 increase precision as necessary. Otherwise, we call the conversion
541 routine and let it do the dirty work. */
543 #ifndef HOST_FLOAT_FORMAT
544 #define HOST_FLOAT_FORMAT 0
546 #ifndef HOST_DOUBLE_FORMAT
547 #define HOST_DOUBLE_FORMAT 0
549 #ifndef HOST_LONG_DOUBLE_FORMAT
550 #define HOST_LONG_DOUBLE_FORMAT 0
553 static const struct floatformat *host_float_format = HOST_FLOAT_FORMAT;
554 static const struct floatformat *host_double_format = HOST_DOUBLE_FORMAT;
555 static const struct floatformat *host_long_double_format = HOST_LONG_DOUBLE_FORMAT;
558 floatformat_to_doublest (const struct floatformat *fmt,
559 const void *in, DOUBLEST *out)
561 gdb_assert (fmt != NULL);
562 if (fmt == host_float_format)
565 memcpy (&val, in, sizeof (val));
568 else if (fmt == host_double_format)
571 memcpy (&val, in, sizeof (val));
574 else if (fmt == host_long_double_format)
577 memcpy (&val, in, sizeof (val));
581 convert_floatformat_to_doublest (fmt, in, out);
585 floatformat_from_doublest (const struct floatformat *fmt,
586 const DOUBLEST *in, void *out)
588 gdb_assert (fmt != NULL);
589 if (fmt == host_float_format)
592 memcpy (out, &val, sizeof (val));
594 else if (fmt == host_double_format)
597 memcpy (out, &val, sizeof (val));
599 else if (fmt == host_long_double_format)
601 long double val = *in;
602 memcpy (out, &val, sizeof (val));
605 convert_doublest_to_floatformat (fmt, in, out);
609 /* Return a floating-point format for a floating-point variable of
610 length LEN. Return NULL, if no suitable floating-point format
613 We need this functionality since information about the
614 floating-point format of a type is not always available to GDB; the
615 debug information typically only tells us the size of a
618 FIXME: kettenis/2001-10-28: In many places, particularly in
619 target-dependent code, the format of floating-point types is known,
620 but not passed on by GDB. This should be fixed. */
622 const struct floatformat *
623 floatformat_from_length (int len)
625 if (len * TARGET_CHAR_BIT == TARGET_FLOAT_BIT)
626 return TARGET_FLOAT_FORMAT;
627 else if (len * TARGET_CHAR_BIT == TARGET_DOUBLE_BIT)
628 return TARGET_DOUBLE_FORMAT;
629 else if (len * TARGET_CHAR_BIT == TARGET_LONG_DOUBLE_BIT)
630 return TARGET_LONG_DOUBLE_FORMAT;
635 const struct floatformat *
636 floatformat_from_type (const struct type *type)
638 gdb_assert (TYPE_CODE (type) == TYPE_CODE_FLT);
639 if (TYPE_FLOATFORMAT (type) != NULL)
640 return TYPE_FLOATFORMAT (type);
642 return floatformat_from_length (TYPE_LENGTH (type));
645 /* If the host doesn't define NAN, use zero instead. */
650 /* Extract a floating-point number of length LEN from a target-order
651 byte-stream at ADDR. Returns the value as type DOUBLEST. */
654 extract_floating (const void *addr, int len)
656 const struct floatformat *fmt = floatformat_from_length (len);
661 warning ("Can't store a floating-point number of %d bytes.", len);
665 floatformat_to_doublest (fmt, addr, &val);
669 /* Store VAL as a floating-point number of length LEN to a
670 target-order byte-stream at ADDR. */
673 store_floating (void *addr, int len, DOUBLEST val)
675 const struct floatformat *fmt = floatformat_from_length (len);
679 warning ("Can't store a floating-point number of %d bytes.", len);
680 memset (addr, 0, len);
683 floatformat_from_doublest (fmt, &val, addr);
686 /* Extract a floating-point number of type TYPE from a target-order
687 byte-stream at ADDR. Returns the value as type DOUBLEST. */
690 extract_typed_floating (const void *addr, const struct type *type)
694 gdb_assert (TYPE_CODE (type) == TYPE_CODE_FLT);
696 if (TYPE_FLOATFORMAT (type) == NULL)
697 return extract_floating (addr, TYPE_LENGTH (type));
699 floatformat_to_doublest (TYPE_FLOATFORMAT (type), addr, &retval);
703 /* Store VAL as a floating-point number of type TYPE to a target-order
704 byte-stream at ADDR. */
707 store_typed_floating (void *addr, const struct type *type, DOUBLEST val)
709 gdb_assert (TYPE_CODE (type) == TYPE_CODE_FLT);
711 /* FIXME: kettenis/2001-10-28: It is debatable whether we should
712 zero out any remaining bytes in the target buffer when TYPE is
713 longer than the actual underlying floating-point format. Perhaps
714 we should store a fixed bitpattern in those remaining bytes,
715 instead of zero, or perhaps we shouldn't touch those remaining
718 NOTE: cagney/2001-10-28: With the way things currently work, it
719 isn't a good idea to leave the end bits undefined. This is
720 because GDB writes out the entire sizeof(<floating>) bits of the
721 floating-point type even though the value might only be stored
722 in, and the target processor may only refer to, the first N <
723 TYPE_LENGTH (type) bits. If the end of the buffer wasn't
724 initialized, GDB would write undefined data to the target. An
725 errant program, refering to that undefined data, would then
726 become non-deterministic.
728 See also the function convert_typed_floating below. */
729 memset (addr, 0, TYPE_LENGTH (type));
731 if (TYPE_FLOATFORMAT (type) == NULL)
732 return store_floating (addr, TYPE_LENGTH (type), val);
734 floatformat_from_doublest (TYPE_FLOATFORMAT (type), &val, addr);
737 /* Convert a floating-point number of type FROM_TYPE from a
738 target-order byte-stream at FROM to a floating-point number of type
739 TO_TYPE, and store it to a target-order byte-stream at TO. */
742 convert_typed_floating (const void *from, const struct type *from_type,
743 void *to, const struct type *to_type)
745 const struct floatformat *from_fmt = floatformat_from_type (from_type);
746 const struct floatformat *to_fmt = floatformat_from_type (to_type);
748 gdb_assert (TYPE_CODE (from_type) == TYPE_CODE_FLT);
749 gdb_assert (TYPE_CODE (to_type) == TYPE_CODE_FLT);
751 if (from_fmt == NULL || to_fmt == NULL)
753 /* If we don't know the floating-point format of FROM_TYPE or
754 TO_TYPE, there's not much we can do. We might make the
755 assumption that if the length of FROM_TYPE and TO_TYPE match,
756 their floating-point format would match too, but that
757 assumption might be wrong on targets that support
758 floating-point types that only differ in endianness for
759 example. So we warn instead, and zero out the target buffer. */
760 warning ("Can't convert floating-point number to desired type.");
761 memset (to, 0, TYPE_LENGTH (to_type));
763 else if (from_fmt == to_fmt)
765 /* We're in business. The floating-point format of FROM_TYPE
766 and TO_TYPE match. However, even though the floating-point
767 format matches, the length of the type might still be
768 different. Make sure we don't overrun any buffers. See
769 comment in store_typed_floating for a discussion about
770 zeroing out remaining bytes in the target buffer. */
771 memset (to, 0, TYPE_LENGTH (to_type));
772 memcpy (to, from, min (TYPE_LENGTH (from_type), TYPE_LENGTH (to_type)));
776 /* The floating-point types don't match. The best we can do
777 (aport from simulating the target FPU) is converting to the
778 widest floating-point type supported by the host, and then
779 again to the desired type. */
782 floatformat_to_doublest (from_fmt, from, &d);
783 floatformat_from_doublest (to_fmt, &d, to);