2007-07-27 Michael Snyder <msnyder@access-company.com>
[binutils.git] / bfd / libbfd.c
blobbf49a2e1db14671145790ef88433016f394f28df
1 /* Assorted BFD support routines, only used internally.
2 Copyright 1990, 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
3 2000, 2001, 2002, 2003, 2004, 2005, 2007
4 Free Software Foundation, Inc.
5 Written by Cygnus Support.
7 This file is part of BFD, the Binary File Descriptor library.
9 This program is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 3 of the License, or
12 (at your option) any later version.
14 This program is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 GNU General Public License for more details.
19 You should have received a copy of the GNU General Public License
20 along with this program; if not, write to the Free Software
21 Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston,
22 MA 02110-1301, USA. */
24 #include "sysdep.h"
25 #include "bfd.h"
26 #include "libbfd.h"
28 #ifndef HAVE_GETPAGESIZE
29 #define getpagesize() 2048
30 #endif
33 SECTION
34 Implementation details
36 SUBSECTION
37 Internal functions
39 DESCRIPTION
40 These routines are used within BFD.
41 They are not intended for export, but are documented here for
42 completeness.
45 /* A routine which is used in target vectors for unsupported
46 operations. */
48 bfd_boolean
49 bfd_false (bfd *ignore ATTRIBUTE_UNUSED)
51 bfd_set_error (bfd_error_invalid_operation);
52 return FALSE;
55 /* A routine which is used in target vectors for supported operations
56 which do not actually do anything. */
58 bfd_boolean
59 bfd_true (bfd *ignore ATTRIBUTE_UNUSED)
61 return TRUE;
64 /* A routine which is used in target vectors for unsupported
65 operations which return a pointer value. */
67 void *
68 bfd_nullvoidptr (bfd *ignore ATTRIBUTE_UNUSED)
70 bfd_set_error (bfd_error_invalid_operation);
71 return NULL;
74 int
75 bfd_0 (bfd *ignore ATTRIBUTE_UNUSED)
77 return 0;
80 unsigned int
81 bfd_0u (bfd *ignore ATTRIBUTE_UNUSED)
83 return 0;
86 long
87 bfd_0l (bfd *ignore ATTRIBUTE_UNUSED)
89 return 0;
92 /* A routine which is used in target vectors for unsupported
93 operations which return -1 on error. */
95 long
96 _bfd_n1 (bfd *ignore_abfd ATTRIBUTE_UNUSED)
98 bfd_set_error (bfd_error_invalid_operation);
99 return -1;
102 void
103 bfd_void (bfd *ignore ATTRIBUTE_UNUSED)
107 long
108 _bfd_norelocs_get_reloc_upper_bound (bfd *abfd ATTRIBUTE_UNUSED,
109 asection *sec ATTRIBUTE_UNUSED)
111 return sizeof (arelent *);
114 long
115 _bfd_norelocs_canonicalize_reloc (bfd *abfd ATTRIBUTE_UNUSED,
116 asection *sec ATTRIBUTE_UNUSED,
117 arelent **relptr,
118 asymbol **symbols ATTRIBUTE_UNUSED)
120 *relptr = NULL;
121 return 0;
124 bfd_boolean
125 _bfd_nocore_core_file_matches_executable_p
126 (bfd *ignore_core_bfd ATTRIBUTE_UNUSED,
127 bfd *ignore_exec_bfd ATTRIBUTE_UNUSED)
129 bfd_set_error (bfd_error_invalid_operation);
130 return FALSE;
133 /* Routine to handle core_file_failing_command entry point for targets
134 without core file support. */
136 char *
137 _bfd_nocore_core_file_failing_command (bfd *ignore_abfd ATTRIBUTE_UNUSED)
139 bfd_set_error (bfd_error_invalid_operation);
140 return NULL;
143 /* Routine to handle core_file_failing_signal entry point for targets
144 without core file support. */
147 _bfd_nocore_core_file_failing_signal (bfd *ignore_abfd ATTRIBUTE_UNUSED)
149 bfd_set_error (bfd_error_invalid_operation);
150 return 0;
153 const bfd_target *
154 _bfd_dummy_target (bfd *ignore_abfd ATTRIBUTE_UNUSED)
156 bfd_set_error (bfd_error_wrong_format);
157 return 0;
160 /* Allocate memory using malloc. */
162 void *
163 bfd_malloc (bfd_size_type size)
165 void *ptr;
167 if (size != (size_t) size)
169 bfd_set_error (bfd_error_no_memory);
170 return NULL;
173 ptr = malloc ((size_t) size);
174 if (ptr == NULL && (size_t) size != 0)
175 bfd_set_error (bfd_error_no_memory);
177 return ptr;
180 /* Allocate memory using malloc, nmemb * size with overflow checking. */
182 void *
183 bfd_malloc2 (bfd_size_type nmemb, bfd_size_type size)
185 void *ptr;
187 if ((nmemb | size) >= HALF_BFD_SIZE_TYPE
188 && size != 0
189 && nmemb > ~(bfd_size_type) 0 / size)
191 bfd_set_error (bfd_error_no_memory);
192 return NULL;
195 size *= nmemb;
197 if (size != (size_t) size)
199 bfd_set_error (bfd_error_no_memory);
200 return NULL;
203 ptr = malloc ((size_t) size);
204 if (ptr == NULL && (size_t) size != 0)
205 bfd_set_error (bfd_error_no_memory);
207 return ptr;
210 /* Reallocate memory using realloc. */
212 void *
213 bfd_realloc (void *ptr, bfd_size_type size)
215 void *ret;
217 if (size != (size_t) size)
219 bfd_set_error (bfd_error_no_memory);
220 return NULL;
223 if (ptr == NULL)
224 ret = malloc ((size_t) size);
225 else
226 ret = realloc (ptr, (size_t) size);
228 if (ret == NULL && (size_t) size != 0)
229 bfd_set_error (bfd_error_no_memory);
231 return ret;
234 /* Reallocate memory using realloc, nmemb * size with overflow checking. */
236 void *
237 bfd_realloc2 (void *ptr, bfd_size_type nmemb, bfd_size_type size)
239 void *ret;
241 if ((nmemb | size) >= HALF_BFD_SIZE_TYPE
242 && size != 0
243 && nmemb > ~(bfd_size_type) 0 / size)
245 bfd_set_error (bfd_error_no_memory);
246 return NULL;
249 size *= nmemb;
251 if (size != (size_t) size)
253 bfd_set_error (bfd_error_no_memory);
254 return NULL;
257 if (ptr == NULL)
258 ret = malloc ((size_t) size);
259 else
260 ret = realloc (ptr, (size_t) size);
262 if (ret == NULL && (size_t) size != 0)
263 bfd_set_error (bfd_error_no_memory);
265 return ret;
268 /* Allocate memory using malloc and clear it. */
270 void *
271 bfd_zmalloc (bfd_size_type size)
273 void *ptr;
275 if (size != (size_t) size)
277 bfd_set_error (bfd_error_no_memory);
278 return NULL;
281 ptr = malloc ((size_t) size);
283 if ((size_t) size != 0)
285 if (ptr == NULL)
286 bfd_set_error (bfd_error_no_memory);
287 else
288 memset (ptr, 0, (size_t) size);
291 return ptr;
294 /* Allocate memory using malloc (nmemb * size) with overflow checking
295 and clear it. */
297 void *
298 bfd_zmalloc2 (bfd_size_type nmemb, bfd_size_type size)
300 void *ptr;
302 if ((nmemb | size) >= HALF_BFD_SIZE_TYPE
303 && size != 0
304 && nmemb > ~(bfd_size_type) 0 / size)
306 bfd_set_error (bfd_error_no_memory);
307 return NULL;
310 size *= nmemb;
312 if (size != (size_t) size)
314 bfd_set_error (bfd_error_no_memory);
315 return NULL;
318 ptr = malloc ((size_t) size);
320 if ((size_t) size != 0)
322 if (ptr == NULL)
323 bfd_set_error (bfd_error_no_memory);
324 else
325 memset (ptr, 0, (size_t) size);
328 return ptr;
332 INTERNAL_FUNCTION
333 bfd_write_bigendian_4byte_int
335 SYNOPSIS
336 bfd_boolean bfd_write_bigendian_4byte_int (bfd *, unsigned int);
338 DESCRIPTION
339 Write a 4 byte integer @var{i} to the output BFD @var{abfd}, in big
340 endian order regardless of what else is going on. This is useful in
341 archives.
344 bfd_boolean
345 bfd_write_bigendian_4byte_int (bfd *abfd, unsigned int i)
347 bfd_byte buffer[4];
348 bfd_putb32 ((bfd_vma) i, buffer);
349 return bfd_bwrite (buffer, (bfd_size_type) 4, abfd) == 4;
353 /** The do-it-yourself (byte) sex-change kit */
355 /* The middle letter e.g. get<b>short indicates Big or Little endian
356 target machine. It doesn't matter what the byte order of the host
357 machine is; these routines work for either. */
359 /* FIXME: Should these take a count argument?
360 Answer (gnu@cygnus.com): No, but perhaps they should be inline
361 functions in swap.h #ifdef __GNUC__.
362 Gprof them later and find out. */
365 FUNCTION
366 bfd_put_size
367 FUNCTION
368 bfd_get_size
370 DESCRIPTION
371 These macros as used for reading and writing raw data in
372 sections; each access (except for bytes) is vectored through
373 the target format of the BFD and mangled accordingly. The
374 mangling performs any necessary endian translations and
375 removes alignment restrictions. Note that types accepted and
376 returned by these macros are identical so they can be swapped
377 around in macros---for example, @file{libaout.h} defines <<GET_WORD>>
378 to either <<bfd_get_32>> or <<bfd_get_64>>.
380 In the put routines, @var{val} must be a <<bfd_vma>>. If we are on a
381 system without prototypes, the caller is responsible for making
382 sure that is true, with a cast if necessary. We don't cast
383 them in the macro definitions because that would prevent <<lint>>
384 or <<gcc -Wall>> from detecting sins such as passing a pointer.
385 To detect calling these with less than a <<bfd_vma>>, use
386 <<gcc -Wconversion>> on a host with 64 bit <<bfd_vma>>'s.
389 .{* Byte swapping macros for user section data. *}
391 .#define bfd_put_8(abfd, val, ptr) \
392 . ((void) (*((unsigned char *) (ptr)) = (val) & 0xff))
393 .#define bfd_put_signed_8 \
394 . bfd_put_8
395 .#define bfd_get_8(abfd, ptr) \
396 . (*(unsigned char *) (ptr) & 0xff)
397 .#define bfd_get_signed_8(abfd, ptr) \
398 . (((*(unsigned char *) (ptr) & 0xff) ^ 0x80) - 0x80)
400 .#define bfd_put_16(abfd, val, ptr) \
401 . BFD_SEND (abfd, bfd_putx16, ((val),(ptr)))
402 .#define bfd_put_signed_16 \
403 . bfd_put_16
404 .#define bfd_get_16(abfd, ptr) \
405 . BFD_SEND (abfd, bfd_getx16, (ptr))
406 .#define bfd_get_signed_16(abfd, ptr) \
407 . BFD_SEND (abfd, bfd_getx_signed_16, (ptr))
409 .#define bfd_put_32(abfd, val, ptr) \
410 . BFD_SEND (abfd, bfd_putx32, ((val),(ptr)))
411 .#define bfd_put_signed_32 \
412 . bfd_put_32
413 .#define bfd_get_32(abfd, ptr) \
414 . BFD_SEND (abfd, bfd_getx32, (ptr))
415 .#define bfd_get_signed_32(abfd, ptr) \
416 . BFD_SEND (abfd, bfd_getx_signed_32, (ptr))
418 .#define bfd_put_64(abfd, val, ptr) \
419 . BFD_SEND (abfd, bfd_putx64, ((val), (ptr)))
420 .#define bfd_put_signed_64 \
421 . bfd_put_64
422 .#define bfd_get_64(abfd, ptr) \
423 . BFD_SEND (abfd, bfd_getx64, (ptr))
424 .#define bfd_get_signed_64(abfd, ptr) \
425 . BFD_SEND (abfd, bfd_getx_signed_64, (ptr))
427 .#define bfd_get(bits, abfd, ptr) \
428 . ((bits) == 8 ? (bfd_vma) bfd_get_8 (abfd, ptr) \
429 . : (bits) == 16 ? bfd_get_16 (abfd, ptr) \
430 . : (bits) == 32 ? bfd_get_32 (abfd, ptr) \
431 . : (bits) == 64 ? bfd_get_64 (abfd, ptr) \
432 . : (abort (), (bfd_vma) - 1))
434 .#define bfd_put(bits, abfd, val, ptr) \
435 . ((bits) == 8 ? bfd_put_8 (abfd, val, ptr) \
436 . : (bits) == 16 ? bfd_put_16 (abfd, val, ptr) \
437 . : (bits) == 32 ? bfd_put_32 (abfd, val, ptr) \
438 . : (bits) == 64 ? bfd_put_64 (abfd, val, ptr) \
439 . : (abort (), (void) 0))
444 FUNCTION
445 bfd_h_put_size
446 bfd_h_get_size
448 DESCRIPTION
449 These macros have the same function as their <<bfd_get_x>>
450 brethren, except that they are used for removing information
451 for the header records of object files. Believe it or not,
452 some object files keep their header records in big endian
453 order and their data in little endian order.
455 .{* Byte swapping macros for file header data. *}
457 .#define bfd_h_put_8(abfd, val, ptr) \
458 . bfd_put_8 (abfd, val, ptr)
459 .#define bfd_h_put_signed_8(abfd, val, ptr) \
460 . bfd_put_8 (abfd, val, ptr)
461 .#define bfd_h_get_8(abfd, ptr) \
462 . bfd_get_8 (abfd, ptr)
463 .#define bfd_h_get_signed_8(abfd, ptr) \
464 . bfd_get_signed_8 (abfd, ptr)
466 .#define bfd_h_put_16(abfd, val, ptr) \
467 . BFD_SEND (abfd, bfd_h_putx16, (val, ptr))
468 .#define bfd_h_put_signed_16 \
469 . bfd_h_put_16
470 .#define bfd_h_get_16(abfd, ptr) \
471 . BFD_SEND (abfd, bfd_h_getx16, (ptr))
472 .#define bfd_h_get_signed_16(abfd, ptr) \
473 . BFD_SEND (abfd, bfd_h_getx_signed_16, (ptr))
475 .#define bfd_h_put_32(abfd, val, ptr) \
476 . BFD_SEND (abfd, bfd_h_putx32, (val, ptr))
477 .#define bfd_h_put_signed_32 \
478 . bfd_h_put_32
479 .#define bfd_h_get_32(abfd, ptr) \
480 . BFD_SEND (abfd, bfd_h_getx32, (ptr))
481 .#define bfd_h_get_signed_32(abfd, ptr) \
482 . BFD_SEND (abfd, bfd_h_getx_signed_32, (ptr))
484 .#define bfd_h_put_64(abfd, val, ptr) \
485 . BFD_SEND (abfd, bfd_h_putx64, (val, ptr))
486 .#define bfd_h_put_signed_64 \
487 . bfd_h_put_64
488 .#define bfd_h_get_64(abfd, ptr) \
489 . BFD_SEND (abfd, bfd_h_getx64, (ptr))
490 .#define bfd_h_get_signed_64(abfd, ptr) \
491 . BFD_SEND (abfd, bfd_h_getx_signed_64, (ptr))
493 .{* Aliases for the above, which should eventually go away. *}
495 .#define H_PUT_64 bfd_h_put_64
496 .#define H_PUT_32 bfd_h_put_32
497 .#define H_PUT_16 bfd_h_put_16
498 .#define H_PUT_8 bfd_h_put_8
499 .#define H_PUT_S64 bfd_h_put_signed_64
500 .#define H_PUT_S32 bfd_h_put_signed_32
501 .#define H_PUT_S16 bfd_h_put_signed_16
502 .#define H_PUT_S8 bfd_h_put_signed_8
503 .#define H_GET_64 bfd_h_get_64
504 .#define H_GET_32 bfd_h_get_32
505 .#define H_GET_16 bfd_h_get_16
506 .#define H_GET_8 bfd_h_get_8
507 .#define H_GET_S64 bfd_h_get_signed_64
508 .#define H_GET_S32 bfd_h_get_signed_32
509 .#define H_GET_S16 bfd_h_get_signed_16
510 .#define H_GET_S8 bfd_h_get_signed_8
514 /* Sign extension to bfd_signed_vma. */
515 #define COERCE16(x) (((bfd_signed_vma) (x) ^ 0x8000) - 0x8000)
516 #define COERCE32(x) (((bfd_signed_vma) (x) ^ 0x80000000) - 0x80000000)
517 #define EIGHT_GAZILLION ((bfd_int64_t) 1 << 63)
518 #define COERCE64(x) \
519 (((bfd_int64_t) (x) ^ EIGHT_GAZILLION) - EIGHT_GAZILLION)
521 bfd_vma
522 bfd_getb16 (const void *p)
524 const bfd_byte *addr = p;
525 return (addr[0] << 8) | addr[1];
528 bfd_vma
529 bfd_getl16 (const void *p)
531 const bfd_byte *addr = p;
532 return (addr[1] << 8) | addr[0];
535 bfd_signed_vma
536 bfd_getb_signed_16 (const void *p)
538 const bfd_byte *addr = p;
539 return COERCE16 ((addr[0] << 8) | addr[1]);
542 bfd_signed_vma
543 bfd_getl_signed_16 (const void *p)
545 const bfd_byte *addr = p;
546 return COERCE16 ((addr[1] << 8) | addr[0]);
549 void
550 bfd_putb16 (bfd_vma data, void *p)
552 bfd_byte *addr = p;
553 addr[0] = (data >> 8) & 0xff;
554 addr[1] = data & 0xff;
557 void
558 bfd_putl16 (bfd_vma data, void *p)
560 bfd_byte *addr = p;
561 addr[0] = data & 0xff;
562 addr[1] = (data >> 8) & 0xff;
565 bfd_vma
566 bfd_getb32 (const void *p)
568 const bfd_byte *addr = p;
569 unsigned long v;
571 v = (unsigned long) addr[0] << 24;
572 v |= (unsigned long) addr[1] << 16;
573 v |= (unsigned long) addr[2] << 8;
574 v |= (unsigned long) addr[3];
575 return v;
578 bfd_vma
579 bfd_getl32 (const void *p)
581 const bfd_byte *addr = p;
582 unsigned long v;
584 v = (unsigned long) addr[0];
585 v |= (unsigned long) addr[1] << 8;
586 v |= (unsigned long) addr[2] << 16;
587 v |= (unsigned long) addr[3] << 24;
588 return v;
591 bfd_signed_vma
592 bfd_getb_signed_32 (const void *p)
594 const bfd_byte *addr = p;
595 unsigned long v;
597 v = (unsigned long) addr[0] << 24;
598 v |= (unsigned long) addr[1] << 16;
599 v |= (unsigned long) addr[2] << 8;
600 v |= (unsigned long) addr[3];
601 return COERCE32 (v);
604 bfd_signed_vma
605 bfd_getl_signed_32 (const void *p)
607 const bfd_byte *addr = p;
608 unsigned long v;
610 v = (unsigned long) addr[0];
611 v |= (unsigned long) addr[1] << 8;
612 v |= (unsigned long) addr[2] << 16;
613 v |= (unsigned long) addr[3] << 24;
614 return COERCE32 (v);
617 bfd_uint64_t
618 bfd_getb64 (const void *p ATTRIBUTE_UNUSED)
620 #ifdef BFD_HOST_64_BIT
621 const bfd_byte *addr = p;
622 bfd_uint64_t v;
624 v = addr[0]; v <<= 8;
625 v |= addr[1]; v <<= 8;
626 v |= addr[2]; v <<= 8;
627 v |= addr[3]; v <<= 8;
628 v |= addr[4]; v <<= 8;
629 v |= addr[5]; v <<= 8;
630 v |= addr[6]; v <<= 8;
631 v |= addr[7];
633 return v;
634 #else
635 BFD_FAIL();
636 return 0;
637 #endif
640 bfd_uint64_t
641 bfd_getl64 (const void *p ATTRIBUTE_UNUSED)
643 #ifdef BFD_HOST_64_BIT
644 const bfd_byte *addr = p;
645 bfd_uint64_t v;
647 v = addr[7]; v <<= 8;
648 v |= addr[6]; v <<= 8;
649 v |= addr[5]; v <<= 8;
650 v |= addr[4]; v <<= 8;
651 v |= addr[3]; v <<= 8;
652 v |= addr[2]; v <<= 8;
653 v |= addr[1]; v <<= 8;
654 v |= addr[0];
656 return v;
657 #else
658 BFD_FAIL();
659 return 0;
660 #endif
664 bfd_int64_t
665 bfd_getb_signed_64 (const void *p ATTRIBUTE_UNUSED)
667 #ifdef BFD_HOST_64_BIT
668 const bfd_byte *addr = p;
669 bfd_uint64_t v;
671 v = addr[0]; v <<= 8;
672 v |= addr[1]; v <<= 8;
673 v |= addr[2]; v <<= 8;
674 v |= addr[3]; v <<= 8;
675 v |= addr[4]; v <<= 8;
676 v |= addr[5]; v <<= 8;
677 v |= addr[6]; v <<= 8;
678 v |= addr[7];
680 return COERCE64 (v);
681 #else
682 BFD_FAIL();
683 return 0;
684 #endif
687 bfd_int64_t
688 bfd_getl_signed_64 (const void *p ATTRIBUTE_UNUSED)
690 #ifdef BFD_HOST_64_BIT
691 const bfd_byte *addr = p;
692 bfd_uint64_t v;
694 v = addr[7]; v <<= 8;
695 v |= addr[6]; v <<= 8;
696 v |= addr[5]; v <<= 8;
697 v |= addr[4]; v <<= 8;
698 v |= addr[3]; v <<= 8;
699 v |= addr[2]; v <<= 8;
700 v |= addr[1]; v <<= 8;
701 v |= addr[0];
703 return COERCE64 (v);
704 #else
705 BFD_FAIL();
706 return 0;
707 #endif
710 void
711 bfd_putb32 (bfd_vma data, void *p)
713 bfd_byte *addr = p;
714 addr[0] = (data >> 24) & 0xff;
715 addr[1] = (data >> 16) & 0xff;
716 addr[2] = (data >> 8) & 0xff;
717 addr[3] = data & 0xff;
720 void
721 bfd_putl32 (bfd_vma data, void *p)
723 bfd_byte *addr = p;
724 addr[0] = data & 0xff;
725 addr[1] = (data >> 8) & 0xff;
726 addr[2] = (data >> 16) & 0xff;
727 addr[3] = (data >> 24) & 0xff;
730 void
731 bfd_putb64 (bfd_uint64_t data ATTRIBUTE_UNUSED, void *p ATTRIBUTE_UNUSED)
733 #ifdef BFD_HOST_64_BIT
734 bfd_byte *addr = p;
735 addr[0] = (data >> (7*8)) & 0xff;
736 addr[1] = (data >> (6*8)) & 0xff;
737 addr[2] = (data >> (5*8)) & 0xff;
738 addr[3] = (data >> (4*8)) & 0xff;
739 addr[4] = (data >> (3*8)) & 0xff;
740 addr[5] = (data >> (2*8)) & 0xff;
741 addr[6] = (data >> (1*8)) & 0xff;
742 addr[7] = (data >> (0*8)) & 0xff;
743 #else
744 BFD_FAIL();
745 #endif
748 void
749 bfd_putl64 (bfd_uint64_t data ATTRIBUTE_UNUSED, void *p ATTRIBUTE_UNUSED)
751 #ifdef BFD_HOST_64_BIT
752 bfd_byte *addr = p;
753 addr[7] = (data >> (7*8)) & 0xff;
754 addr[6] = (data >> (6*8)) & 0xff;
755 addr[5] = (data >> (5*8)) & 0xff;
756 addr[4] = (data >> (4*8)) & 0xff;
757 addr[3] = (data >> (3*8)) & 0xff;
758 addr[2] = (data >> (2*8)) & 0xff;
759 addr[1] = (data >> (1*8)) & 0xff;
760 addr[0] = (data >> (0*8)) & 0xff;
761 #else
762 BFD_FAIL();
763 #endif
766 void
767 bfd_put_bits (bfd_uint64_t data, void *p, int bits, bfd_boolean big_p)
769 bfd_byte *addr = p;
770 int i;
771 int bytes;
773 if (bits % 8 != 0)
774 abort ();
776 bytes = bits / 8;
777 for (i = 0; i < bytes; i++)
779 int index = big_p ? bytes - i - 1 : i;
781 addr[index] = data & 0xff;
782 data >>= 8;
786 bfd_uint64_t
787 bfd_get_bits (const void *p, int bits, bfd_boolean big_p)
789 const bfd_byte *addr = p;
790 bfd_uint64_t data;
791 int i;
792 int bytes;
794 if (bits % 8 != 0)
795 abort ();
797 data = 0;
798 bytes = bits / 8;
799 for (i = 0; i < bytes; i++)
801 int index = big_p ? i : bytes - i - 1;
803 data = (data << 8) | addr[index];
806 return data;
809 /* Default implementation */
811 bfd_boolean
812 _bfd_generic_get_section_contents (bfd *abfd,
813 sec_ptr section,
814 void *location,
815 file_ptr offset,
816 bfd_size_type count)
818 bfd_size_type sz;
819 if (count == 0)
820 return TRUE;
822 sz = section->rawsize ? section->rawsize : section->size;
823 if (offset + count < count
824 || offset + count > sz)
826 bfd_set_error (bfd_error_invalid_operation);
827 return FALSE;
830 if (bfd_seek (abfd, section->filepos + offset, SEEK_SET) != 0
831 || bfd_bread (location, count, abfd) != count)
832 return FALSE;
834 return TRUE;
837 bfd_boolean
838 _bfd_generic_get_section_contents_in_window
839 (bfd *abfd ATTRIBUTE_UNUSED,
840 sec_ptr section ATTRIBUTE_UNUSED,
841 bfd_window *w ATTRIBUTE_UNUSED,
842 file_ptr offset ATTRIBUTE_UNUSED,
843 bfd_size_type count ATTRIBUTE_UNUSED)
845 #ifdef USE_MMAP
846 bfd_size_type sz;
848 if (count == 0)
849 return TRUE;
850 if (abfd->xvec->_bfd_get_section_contents
851 != _bfd_generic_get_section_contents)
853 /* We don't know what changes the bfd's get_section_contents
854 method may have to make. So punt trying to map the file
855 window, and let get_section_contents do its thing. */
856 /* @@ FIXME : If the internal window has a refcount of 1 and was
857 allocated with malloc instead of mmap, just reuse it. */
858 bfd_free_window (w);
859 w->i = bfd_zmalloc (sizeof (bfd_window_internal));
860 if (w->i == NULL)
861 return FALSE;
862 w->i->data = bfd_malloc (count);
863 if (w->i->data == NULL)
865 free (w->i);
866 w->i = NULL;
867 return FALSE;
869 w->i->mapped = 0;
870 w->i->refcount = 1;
871 w->size = w->i->size = count;
872 w->data = w->i->data;
873 return bfd_get_section_contents (abfd, section, w->data, offset, count);
875 sz = section->rawsize ? section->rawsize : section->size;
876 if (offset + count > sz
877 || ! bfd_get_file_window (abfd, section->filepos + offset, count, w,
878 TRUE))
879 return FALSE;
880 return TRUE;
881 #else
882 abort ();
883 #endif
886 /* This generic function can only be used in implementations where creating
887 NEW sections is disallowed. It is useful in patching existing sections
888 in read-write files, though. See other set_section_contents functions
889 to see why it doesn't work for new sections. */
890 bfd_boolean
891 _bfd_generic_set_section_contents (bfd *abfd,
892 sec_ptr section,
893 const void *location,
894 file_ptr offset,
895 bfd_size_type count)
897 if (count == 0)
898 return TRUE;
900 if (bfd_seek (abfd, section->filepos + offset, SEEK_SET) != 0
901 || bfd_bwrite (location, count, abfd) != count)
902 return FALSE;
904 return TRUE;
908 INTERNAL_FUNCTION
909 bfd_log2
911 SYNOPSIS
912 unsigned int bfd_log2 (bfd_vma x);
914 DESCRIPTION
915 Return the log base 2 of the value supplied, rounded up. E.g., an
916 @var{x} of 1025 returns 11. A @var{x} of 0 returns 0.
919 unsigned int
920 bfd_log2 (bfd_vma x)
922 unsigned int result = 0;
924 while ((x = (x >> 1)) != 0)
925 ++result;
926 return result;
929 bfd_boolean
930 bfd_generic_is_local_label_name (bfd *abfd, const char *name)
932 char locals_prefix = (bfd_get_symbol_leading_char (abfd) == '_') ? 'L' : '.';
934 return name[0] == locals_prefix;
937 /* Can be used from / for bfd_merge_private_bfd_data to check that
938 endianness matches between input and output file. Returns
939 TRUE for a match, otherwise returns FALSE and emits an error. */
940 bfd_boolean
941 _bfd_generic_verify_endian_match (bfd *ibfd, bfd *obfd)
943 if (ibfd->xvec->byteorder != obfd->xvec->byteorder
944 && ibfd->xvec->byteorder != BFD_ENDIAN_UNKNOWN
945 && obfd->xvec->byteorder != BFD_ENDIAN_UNKNOWN)
947 const char *msg;
949 if (bfd_big_endian (ibfd))
950 msg = _("%B: compiled for a big endian system and target is little endian");
951 else
952 msg = _("%B: compiled for a little endian system and target is big endian");
954 (*_bfd_error_handler) (msg, ibfd);
956 bfd_set_error (bfd_error_wrong_format);
957 return FALSE;
960 return TRUE;
963 /* Give a warning at runtime if someone compiles code which calls
964 old routines. */
966 void
967 warn_deprecated (const char *what,
968 const char *file,
969 int line,
970 const char *func)
972 /* Poor man's tracking of functions we've already warned about. */
973 static size_t mask = 0;
975 if (~(size_t) func & ~mask)
977 /* Note: separate sentences in order to allow
978 for translation into other languages. */
979 if (func)
980 fprintf (stderr, _("Deprecated %s called at %s line %d in %s\n"),
981 what, file, line, func);
982 else
983 fprintf (stderr, _("Deprecated %s called\n"), what);
984 mask |= ~(size_t) func;
988 /* Helper function for reading uleb128 encoded data. */
990 bfd_vma
991 read_unsigned_leb128 (bfd *abfd ATTRIBUTE_UNUSED,
992 bfd_byte *buf,
993 unsigned int *bytes_read_ptr)
995 bfd_vma result;
996 unsigned int num_read;
997 unsigned int shift;
998 unsigned char byte;
1000 result = 0;
1001 shift = 0;
1002 num_read = 0;
1005 byte = bfd_get_8 (abfd, buf);
1006 buf++;
1007 num_read++;
1008 result |= (((bfd_vma) byte & 0x7f) << shift);
1009 shift += 7;
1011 while (byte & 0x80);
1012 *bytes_read_ptr = num_read;
1013 return result;
1016 /* Helper function for reading sleb128 encoded data. */
1018 bfd_signed_vma
1019 read_signed_leb128 (bfd *abfd ATTRIBUTE_UNUSED,
1020 bfd_byte *buf,
1021 unsigned int *bytes_read_ptr)
1023 bfd_vma result;
1024 unsigned int shift;
1025 unsigned int num_read;
1026 unsigned char byte;
1028 result = 0;
1029 shift = 0;
1030 num_read = 0;
1033 byte = bfd_get_8 (abfd, buf);
1034 buf ++;
1035 num_read ++;
1036 result |= (((bfd_vma) byte & 0x7f) << shift);
1037 shift += 7;
1039 while (byte & 0x80);
1040 if (shift < 8 * sizeof (result) && (byte & 0x40))
1041 result |= (((bfd_vma) -1) << shift);
1042 *bytes_read_ptr = num_read;
1043 return result;
1046 bfd_boolean
1047 _bfd_generic_find_line (bfd *abfd ATTRIBUTE_UNUSED,
1048 asymbol **symbols ATTRIBUTE_UNUSED,
1049 asymbol *symbol ATTRIBUTE_UNUSED,
1050 const char **filename_ptr ATTRIBUTE_UNUSED,
1051 unsigned int *linenumber_ptr ATTRIBUTE_UNUSED)
1053 return FALSE;
1056 bfd_boolean
1057 _bfd_generic_init_private_section_data (bfd *ibfd ATTRIBUTE_UNUSED,
1058 asection *isec ATTRIBUTE_UNUSED,
1059 bfd *obfd ATTRIBUTE_UNUSED,
1060 asection *osec ATTRIBUTE_UNUSED,
1061 struct bfd_link_info *link_info ATTRIBUTE_UNUSED)
1063 return TRUE;