more doc cleanups
[external/binutils.git] / bfd / libbfd.c
1 /* Assorted BFD support routines, only used internally.
2    Copyright 1990, 1991, 1992 Free Software Foundation, Inc.
3    Written by Cygnus Support.
4
5 This file is part of BFD, the Binary File Descriptor library.
6
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2 of the License, or
10 (at your option) any later version.
11
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15 GNU General Public License for more details.
16
17 You should have received a copy of the GNU General Public License
18 along with this program; if not, write to the Free Software
19 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.  */
20
21 #include "bfd.h"
22 #include "sysdep.h"
23 #include "libbfd.h"
24
25 /*
26 SECTION
27         Internal functions
28
29 DESCRIPTION
30         These routines are used within BFD.
31         They are not intended for export, but are documented here for
32         completeness.
33 */
34
35 boolean
36 DEFUN(_bfd_dummy_new_section_hook,(ignore, ignore_newsect),
37       bfd *ignore AND
38       asection *ignore_newsect)
39 {
40   return true;
41 }
42
43 boolean
44 DEFUN(bfd_false ,(ignore),
45       bfd *ignore)
46 {
47   return false;
48 }
49
50 boolean
51 DEFUN(bfd_true,(ignore),
52       bfd *ignore)
53 {
54   return true;
55 }
56
57 PTR
58 DEFUN(bfd_nullvoidptr,(ignore),
59       bfd *ignore)
60 {
61   return (PTR)NULL;
62 }
63
64 int 
65 DEFUN(bfd_0,(ignore),
66       bfd *ignore)
67 {
68   return 0;
69 }
70
71 unsigned int 
72 DEFUN(bfd_0u,(ignore),
73       bfd *ignore)
74 {
75    return 0;
76 }
77
78 void 
79 DEFUN(bfd_void,(ignore),
80       bfd *ignore)
81 {
82 }
83
84 boolean
85 DEFUN(_bfd_dummy_core_file_matches_executable_p,(ignore_core_bfd, ignore_exec_bfd),
86       bfd *ignore_core_bfd AND
87       bfd *ignore_exec_bfd)
88 {
89   bfd_error = invalid_operation;
90   return false;
91 }
92
93 /* of course you can't initialize a function to be the same as another, grr */
94
95 char *
96 DEFUN(_bfd_dummy_core_file_failing_command,(ignore_abfd),
97       bfd *ignore_abfd)
98 {
99   return (char *)NULL;
100 }
101
102 int
103 DEFUN(_bfd_dummy_core_file_failing_signal,(ignore_abfd),
104      bfd *ignore_abfd)
105 {
106   return 0;
107 }
108
109 bfd_target *
110 DEFUN(_bfd_dummy_target,(ignore_abfd),
111      bfd *ignore_abfd)
112 {
113   return 0;
114 }
115 \f
116 /** zalloc -- allocate and clear storage */
117
118
119 #ifndef zalloc
120 char *
121 DEFUN(zalloc,(size),
122       bfd_size_type size)
123 {
124   char *ptr = (char *) malloc ((size_t)size);
125
126   if ((ptr != NULL) && (size != 0))
127    memset(ptr,0, (size_t) size);
128
129   return ptr;
130 }
131 #endif
132
133 /*
134 INTERNAL_FUNCTION
135         bfd_xmalloc
136
137 SYNOPSIS
138         PTR  bfd_xmalloc (bfd_size_type size);
139
140 DESCRIPTION
141         Like <<malloc>>, but exit if no more memory.
142
143 */
144
145 /** There is major inconsistency in how running out of memory is handled.
146   Some routines return a NULL, and set bfd_error to no_memory.
147   However, obstack routines can't do this ... */
148
149
150 DEFUN(PTR bfd_xmalloc,(size),
151       bfd_size_type size)
152 {
153   static CONST char no_memory_message[] = "Virtual memory exhausted!\n";
154   PTR ptr;
155   if (size == 0) size = 1;
156   ptr = (PTR)malloc((size_t) size);
157   if (!ptr)
158     {
159       write (2, no_memory_message, sizeof(no_memory_message)-1);
160       exit (1);
161     }
162   return ptr;
163 }
164
165 /*
166 INTERNAL_FUNCTION
167         bfd_xmalloc_by_size_t
168
169 SYNOPSIS
170         PTR bfd_xmalloc_by_size_t (size_t size);
171
172 DESCRIPTION
173         Like <<malloc>>, but exit if no more memory.
174         Uses <<size_t>>, so it's suitable for use as <<obstack_chunk_alloc>>.
175  */
176 PTR
177 DEFUN(bfd_xmalloc_by_size_t, (size),
178       size_t size)
179 {
180   return bfd_xmalloc ((bfd_size_type) size);
181 }
182 \f
183 /* Some IO code */
184
185
186 /* Note that archive entries don't have streams; they share their parent's.
187    This allows someone to play with the iostream behind BFD's back.
188
189    Also, note that the origin pointer points to the beginning of a file's
190    contents (0 for non-archive elements).  For archive entries this is the
191    first octet in the file, NOT the beginning of the archive header. */
192
193 static 
194 int DEFUN(real_read,(where, a,b, file),
195           PTR where AND
196           int a AND
197           int b AND
198           FILE *file)
199 {
200   return fread(where, a,b,file);
201 }
202 bfd_size_type
203 DEFUN(bfd_read,(ptr, size, nitems, abfd),
204       PTR ptr AND
205       bfd_size_type size AND
206       bfd_size_type nitems AND
207       bfd *abfd)
208 {
209   int nread;
210   nread = real_read (ptr, 1, (int)(size*nitems), bfd_cache_lookup(abfd));
211 #ifdef FILE_OFFSET_IS_CHAR_INDEX
212   if (nread > 0)
213     abfd->where += nread;
214 #endif
215   return nread;
216 }
217
218 bfd_size_type
219 bfd_write (ptr, size, nitems, abfd)
220      CONST PTR ptr;
221      bfd_size_type size;
222      bfd_size_type nitems;
223      bfd *abfd;
224 {
225   int nwrote = fwrite (ptr, 1, (int) (size * nitems), bfd_cache_lookup (abfd));
226 #ifdef FILE_OFFSET_IS_CHAR_INDEX
227   if (nwrote > 0)
228     abfd->where += nwrote;
229 #endif
230   if (nwrote != size * nitems)
231     {
232 #ifdef ENOSPC
233       if (nwrote >= 0)
234         errno = ENOSPC;
235 #endif
236       bfd_error = system_call_error;
237     }
238   return nwrote;
239 }
240
241 /*
242 INTERNAL_FUNCTION
243         bfd_write_bigendian_4byte_int
244
245 SYNOPSIS
246         void bfd_write_bigendian_4byte_int(bfd *abfd,  int i);
247
248 DESCRIPTION
249         Write a 4 byte integer @var{i} to the output BFD @var{abfd}, in big
250         endian order regardless of what else is going on.  This is useful in
251         archives.
252
253 */
254 void
255 DEFUN(bfd_write_bigendian_4byte_int,(abfd, i),
256       bfd *abfd AND
257       int i)
258 {
259   bfd_byte buffer[4];
260   bfd_putb32(i, buffer);
261   bfd_write((PTR)buffer, 4, 1, abfd);
262 }
263
264 long
265 DEFUN(bfd_tell,(abfd),
266       bfd *abfd)
267 {
268   file_ptr ptr;
269
270   ptr = ftell (bfd_cache_lookup(abfd));
271
272   if (abfd->my_archive)
273     ptr -= abfd->origin;
274   abfd->where = ptr;
275   return ptr;
276 }
277
278 int
279 DEFUN(bfd_flush,(abfd),
280       bfd *abfd)
281 {
282   return fflush (bfd_cache_lookup(abfd));
283 }
284
285 int
286 DEFUN(bfd_stat,(abfd, statbuf),
287       bfd *abfd AND
288       struct stat *statbuf)
289 {
290   return fstat (fileno(bfd_cache_lookup(abfd)), statbuf);
291 }
292
293 int
294 DEFUN(bfd_seek,(abfd, position, direction),
295       bfd * CONST abfd AND
296       CONST file_ptr position AND
297       CONST int direction)
298 {
299   int result;
300   FILE *f;
301   file_ptr file_position;
302   /* For the time being, a BFD may not seek to it's end.  The problem
303      is that we don't easily have a way to recognize the end of an
304      element in an archive. */
305
306   BFD_ASSERT (direction == SEEK_SET || direction == SEEK_CUR);
307
308   if (direction == SEEK_CUR && position == 0)
309     return 0;
310 #ifdef FILE_OFFSET_IS_CHAR_INDEX
311   if (abfd->format != bfd_archive && abfd->my_archive == 0)
312     {
313 #ifndef NDEBUG
314       /* Explanation for this code: I'm only about 95+% sure that the above
315          conditions are sufficient and that all i/o calls are properly
316          adjusting the `where' field.  So this is sort of an `assert'
317          that the `where' field is correct.  If we can go a while without
318          tripping the abort, we can probably safely disable this code,
319          so that the real optimizations happen.  */
320       file_ptr where_am_i_now;
321       where_am_i_now = ftell (bfd_cache_lookup (abfd));
322       if (abfd->my_archive)
323         where_am_i_now -= abfd->origin;
324       if (where_am_i_now != abfd->where)
325         abort ();
326 #endif
327       if (direction == SEEK_SET && position == abfd->where)
328         return 0;
329     }
330   else
331     {
332       /* We need something smarter to optimize access to archives.
333          Currently, anything inside an archive is read via the file
334          handle for the archive.  Which means that a bfd_seek on one
335          component affects the `current position' in the archive, as
336          well as in any other component.
337
338          It might be sufficient to put a spike through the cache
339          abstraction, and look to the archive for the file position,
340          but I think we should try for something cleaner.
341
342          In the meantime, no optimization for archives.  */
343     }
344 #endif
345
346   f = bfd_cache_lookup (abfd);
347   file_position = position;
348   if (direction == SEEK_SET && abfd->my_archive != NULL)
349     file_position += abfd->origin;
350
351   result = fseek (f, file_position, direction);
352
353   if (result != 0)
354     {
355       /* Force redetermination of `where' field.  */
356       bfd_tell (abfd);
357       bfd_error = system_call_error;
358     }
359   else
360     {
361 #ifdef FILE_OFFSET_IS_CHAR_INDEX
362       /* Adjust `where' field.  */
363       if (direction == SEEK_SET)
364         abfd->where = position;
365       else
366         abfd->where += position;
367 #endif
368     }
369   return result;
370 }
371 \f
372 /** Make a string table */
373
374 /*>bfd.h<
375  Add string to table pointed to by table, at location starting with free_ptr.
376    resizes the table if necessary (if it's NULL, creates it, ignoring
377    table_length).  Updates free_ptr, table, table_length */
378
379 boolean
380 DEFUN(bfd_add_to_string_table,(table, new_string, table_length, free_ptr),
381       char **table AND
382       char *new_string AND
383       unsigned int *table_length AND
384       char **free_ptr)
385 {
386   size_t string_length = strlen (new_string) + 1; /* include null here */
387   char *base = *table;
388   size_t space_length = *table_length;
389   unsigned int offset = (base ? *free_ptr - base : 0);
390
391   if (base == NULL) {
392     /* Avoid a useless regrow if we can (but of course we still
393        take it next time */
394     space_length = (string_length < DEFAULT_STRING_SPACE_SIZE ?
395                     DEFAULT_STRING_SPACE_SIZE : string_length+1);
396     base = zalloc ((bfd_size_type) space_length);
397
398     if (base == NULL) {
399       bfd_error = no_memory;
400       return false;
401     }
402   }
403
404   if ((size_t)(offset + string_length) >= space_length) {
405     /* Make sure we will have enough space */
406     while ((size_t)(offset + string_length) >= space_length) 
407       space_length += space_length/2; /* grow by 50% */
408
409     base = (char *) realloc (base, space_length);
410     if (base == NULL) {
411       bfd_error = no_memory;
412       return false;
413     }
414
415   }
416
417   memcpy (base + offset, new_string, string_length);
418   *table = base;
419   *table_length = space_length;
420   *free_ptr = base + offset + string_length;
421   
422   return true;
423 }
424 \f
425 /** The do-it-yourself (byte) sex-change kit */
426
427 /* The middle letter e.g. get<b>short indicates Big or Little endian
428    target machine.  It doesn't matter what the byte order of the host
429    machine is; these routines work for either.  */
430
431 /* FIXME: Should these take a count argument?
432    Answer (gnu@cygnus.com):  No, but perhaps they should be inline
433                              functions in swap.h #ifdef __GNUC__. 
434                              Gprof them later and find out.  */
435
436 /*
437 FUNCTION
438         bfd_put_size
439 FUNCTION
440         bfd_get_size
441
442 DESCRIPTION
443         These macros as used for reading and writing raw data in
444         sections; each access (except for bytes) is vectored through
445         the target format of the BFD and mangled accordingly. The
446         mangling performs any necessary endian translations and
447         removes alignment restrictions.  Note that types accepted and
448         returned by these macros are identical so they can be swapped
449         around in macros---for example, @file{libaout.h} defines <<GET_WORD>>
450         to either <<bfd_get_32>> or <<bfd_get_64>>.
451
452         In the put routines, @var{val} must be a <<bfd_vma>>.  If we are on a
453         system without prototypes, the caller is responsible for making
454         sure that is true, with a cast if necessary.  We don't cast
455         them in the macro definitions because that would prevent <<lint>>
456         or <<gcc -Wall>> from detecting sins such as passing a pointer.
457         To detect calling these with less than a <<bfd_vma>>, use
458         <<gcc -Wconversion>> on a host with 64 bit <<bfd_vma>>'s.
459
460 .
461 .{* Byte swapping macros for user section data.  *}
462 .
463 .#define bfd_put_8(abfd, val, ptr) \
464 .                (*((unsigned char *)(ptr)) = (unsigned char)val)
465 .#define bfd_put_signed_8 \
466 .               bfd_put_8
467 .#define bfd_get_8(abfd, ptr) \
468 .                (*(unsigned char *)(ptr))
469 .#define bfd_get_signed_8(abfd, ptr) \
470 .               ((*(unsigned char *)(ptr) ^ 0x80) - 0x80)
471 .
472 .#define bfd_put_16(abfd, val, ptr) \
473 .                BFD_SEND(abfd, bfd_putx16, ((val),(ptr)))
474 .#define bfd_put_signed_16 \
475 .                bfd_put_16
476 .#define bfd_get_16(abfd, ptr) \
477 .                BFD_SEND(abfd, bfd_getx16, (ptr))
478 .#define bfd_get_signed_16(abfd, ptr) \
479 .                BFD_SEND (abfd, bfd_getx_signed_16, (ptr))
480 .
481 .#define bfd_put_32(abfd, val, ptr) \
482 .                BFD_SEND(abfd, bfd_putx32, ((val),(ptr)))
483 .#define bfd_put_signed_32 \
484 .                bfd_put_32
485 .#define bfd_get_32(abfd, ptr) \
486 .                BFD_SEND(abfd, bfd_getx32, (ptr))
487 .#define bfd_get_signed_32(abfd, ptr) \
488 .                BFD_SEND(abfd, bfd_getx_signed_32, (ptr))
489 .
490 .#define bfd_put_64(abfd, val, ptr) \
491 .                BFD_SEND(abfd, bfd_putx64, ((val), (ptr)))
492 .#define bfd_put_signed_64 \
493 .                bfd_put_64
494 .#define bfd_get_64(abfd, ptr) \
495 .                BFD_SEND(abfd, bfd_getx64, (ptr))
496 .#define bfd_get_signed_64(abfd, ptr) \
497 .                BFD_SEND(abfd, bfd_getx_signed_64, (ptr))
498 .
499 */ 
500
501 /*
502 FUNCTION
503         bfd_h_put_size
504         bfd_h_get_size
505
506 DESCRIPTION
507         These macros have the same function as their <<bfd_get_x>>
508         bretheren, except that they are used for removing information
509         for the header records of object files. Believe it or not,
510         some object files keep their header records in big endian
511         order and their data in little endian order.
512 .
513 .{* Byte swapping macros for file header data.  *}
514 .
515 .#define bfd_h_put_8(abfd, val, ptr) \
516 .               bfd_put_8 (abfd, val, ptr)
517 .#define bfd_h_put_signed_8(abfd, val, ptr) \
518 .               bfd_put_8 (abfd, val, ptr)
519 .#define bfd_h_get_8(abfd, ptr) \
520 .               bfd_get_8 (abfd, ptr)
521 .#define bfd_h_get_signed_8(abfd, ptr) \
522 .               bfd_get_signed_8 (abfd, ptr)
523 .
524 .#define bfd_h_put_16(abfd, val, ptr) \
525 .                BFD_SEND(abfd, bfd_h_putx16,(val,ptr))
526 .#define bfd_h_put_signed_16 \
527 .                bfd_h_put_16
528 .#define bfd_h_get_16(abfd, ptr) \
529 .                BFD_SEND(abfd, bfd_h_getx16,(ptr))
530 .#define bfd_h_get_signed_16(abfd, ptr) \
531 .                BFD_SEND(abfd, bfd_h_getx_signed_16, (ptr))
532 .
533 .#define bfd_h_put_32(abfd, val, ptr) \
534 .                BFD_SEND(abfd, bfd_h_putx32,(val,ptr))
535 .#define bfd_h_put_signed_32 \
536 .                bfd_h_put_32
537 .#define bfd_h_get_32(abfd, ptr) \
538 .                BFD_SEND(abfd, bfd_h_getx32,(ptr))
539 .#define bfd_h_get_signed_32(abfd, ptr) \
540 .                BFD_SEND(abfd, bfd_h_getx_signed_32, (ptr))
541 .
542 .#define bfd_h_put_64(abfd, val, ptr) \
543 .                BFD_SEND(abfd, bfd_h_putx64,(val, ptr))
544 .#define bfd_h_put_signed_64 \
545 .                bfd_h_put_64
546 .#define bfd_h_get_64(abfd, ptr) \
547 .                BFD_SEND(abfd, bfd_h_getx64,(ptr))
548 .#define bfd_h_get_signed_64(abfd, ptr) \
549 .                BFD_SEND(abfd, bfd_h_getx_signed_64, (ptr))
550 .
551 */ 
552
553 /* Sign extension to bfd_signed_vma.  */
554 #define COERCE16(x) (((bfd_signed_vma) (x) ^ 0x8000) - 0x8000)
555 #define COERCE32(x) (((bfd_signed_vma) (x) ^ 0x80000000) - 0x80000000)
556 #define EIGHT_GAZILLION (((HOST_64_BIT)0x80000000) << 32)
557 #define COERCE64(x) \
558   (((bfd_signed_vma) (x) ^ EIGHT_GAZILLION) - EIGHT_GAZILLION)
559
560 bfd_vma
561 DEFUN(bfd_getb16,(addr),
562       register bfd_byte *addr)
563 {
564         return (addr[0] << 8) | addr[1];
565 }
566
567 bfd_vma
568 DEFUN(bfd_getl16,(addr),
569       register bfd_byte *addr)
570 {
571         return (addr[1] << 8) | addr[0];
572 }
573
574 bfd_signed_vma
575 DEFUN(bfd_getb_signed_16,(addr),
576       register bfd_byte *addr)
577 {
578         return COERCE16((addr[0] << 8) | addr[1]);
579 }
580
581 bfd_signed_vma
582 DEFUN(bfd_getl_signed_16,(addr),
583       register bfd_byte *addr)
584 {
585         return COERCE16((addr[1] << 8) | addr[0]);
586 }
587
588 void
589 DEFUN(bfd_putb16,(data, addr),
590       bfd_vma data AND
591       register bfd_byte *addr)
592 {
593         addr[0] = (bfd_byte)(data >> 8);
594         addr[1] = (bfd_byte )data;
595 }
596
597 void
598 DEFUN(bfd_putl16,(data, addr),
599       bfd_vma data AND              
600       register bfd_byte *addr)
601 {
602         addr[0] = (bfd_byte )data;
603         addr[1] = (bfd_byte)(data >> 8);
604 }
605
606 bfd_vma
607 bfd_getb32 (addr)
608      register bfd_byte *addr;
609 {
610         return (((((bfd_vma)addr[0] << 8) | addr[1]) << 8)
611                 | addr[2]) << 8 | addr[3];
612 }
613
614 bfd_vma
615 bfd_getl32 (addr)
616         register bfd_byte *addr;
617 {
618         return (((((bfd_vma)addr[3] << 8) | addr[2]) << 8)
619                 | addr[1]) << 8 | addr[0];
620 }
621
622 bfd_signed_vma
623 bfd_getb_signed_32 (addr)
624      register bfd_byte *addr;
625 {
626         return COERCE32((((((bfd_vma)addr[0] << 8) | addr[1]) << 8)
627                          | addr[2]) << 8 | addr[3]);
628 }
629
630 bfd_signed_vma
631 bfd_getl_signed_32 (addr)
632         register bfd_byte *addr;
633 {
634         return COERCE32((((((bfd_vma)addr[3] << 8) | addr[2]) << 8)
635                          | addr[1]) << 8 | addr[0]);
636 }
637
638 bfd_vma
639 DEFUN(bfd_getb64,(addr),
640       register bfd_byte *addr)
641 {
642 #ifdef BFD64
643   bfd_vma low, high;
644
645   high= ((((((((addr[0]) << 8) |
646               addr[1]) << 8) |
647             addr[2]) << 8) |
648           addr[3]) );
649
650   low = (((((((((bfd_vma)addr[4]) << 8) |
651               addr[5]) << 8) |
652             addr[6]) << 8) |
653           addr[7]));
654
655   return high << 32 | low;
656 #else
657   BFD_FAIL();
658   return 0;
659 #endif
660
661 }
662
663 bfd_vma
664 DEFUN(bfd_getl64,(addr),
665       register bfd_byte *addr)
666 {
667
668 #ifdef BFD64
669   bfd_vma low, high;
670   high= (((((((addr[7] << 8) |
671               addr[6]) << 8) |
672             addr[5]) << 8) |
673           addr[4]));
674
675   low = ((((((((bfd_vma)addr[3] << 8) |
676               addr[2]) << 8) |
677             addr[1]) << 8) |
678           addr[0]) );
679
680   return high << 32 | low;
681 #else
682   BFD_FAIL();
683   return 0;
684 #endif
685
686 }
687
688 bfd_signed_vma
689 DEFUN(bfd_getb_signed_64,(addr),
690       register bfd_byte *addr)
691 {
692 #ifdef BFD64
693   bfd_vma low, high;
694
695   high= ((((((((addr[0]) << 8) |
696               addr[1]) << 8) |
697             addr[2]) << 8) |
698           addr[3]) );
699
700   low = (((((((((bfd_vma)addr[4]) << 8) |
701               addr[5]) << 8) |
702             addr[6]) << 8) |
703           addr[7]));
704
705   return COERCE64(high << 32 | low);
706 #else
707   BFD_FAIL();
708   return 0;
709 #endif
710
711 }
712
713 bfd_signed_vma
714 DEFUN(bfd_getl_signed_64,(addr),
715       register bfd_byte *addr)
716 {
717
718 #ifdef BFD64
719   bfd_vma low, high;
720   high= (((((((addr[7] << 8) |
721               addr[6]) << 8) |
722             addr[5]) << 8) |
723           addr[4]));
724
725   low = ((((((((bfd_vma)addr[3] << 8) |
726               addr[2]) << 8) |
727             addr[1]) << 8) |
728           addr[0]) );
729
730   return COERCE64(high << 32 | low);
731 #else
732   BFD_FAIL();
733   return 0;
734 #endif
735
736 }
737
738 void
739 DEFUN(bfd_putb32,(data, addr),
740       bfd_vma data AND
741       register bfd_byte *addr)
742 {
743         addr[0] = (bfd_byte)(data >> 24);
744         addr[1] = (bfd_byte)(data >> 16);
745         addr[2] = (bfd_byte)(data >>  8);
746         addr[3] = (bfd_byte)data;
747 }
748
749 void
750 DEFUN(bfd_putl32,(data, addr),
751       bfd_vma data AND
752       register bfd_byte *addr)
753 {
754         addr[0] = (bfd_byte)data;
755         addr[1] = (bfd_byte)(data >>  8);
756         addr[2] = (bfd_byte)(data >> 16);
757         addr[3] = (bfd_byte)(data >> 24);
758 }
759 void
760 DEFUN(bfd_putb64,(data, addr),
761         bfd_vma data AND
762         register bfd_byte *addr)
763 {
764 #ifdef BFD64
765   addr[0] = (bfd_byte)(data >> (7*8));
766   addr[1] = (bfd_byte)(data >> (6*8));
767   addr[2] = (bfd_byte)(data >> (5*8));
768   addr[3] = (bfd_byte)(data >> (4*8));
769   addr[4] = (bfd_byte)(data >> (3*8));
770   addr[5] = (bfd_byte)(data >> (2*8));
771   addr[6] = (bfd_byte)(data >> (1*8));
772   addr[7] = (bfd_byte)(data >> (0*8));
773 #else
774   BFD_FAIL();
775 #endif
776
777 }
778
779 void
780 DEFUN(bfd_putl64,(data, addr),
781       bfd_vma data AND
782       register bfd_byte *addr)
783 {
784 #ifdef BFD64
785   addr[7] = (bfd_byte)(data >> (7*8));
786   addr[6] = (bfd_byte)(data >> (6*8));
787   addr[5] = (bfd_byte)(data >> (5*8));
788   addr[4] = (bfd_byte)(data >> (4*8));
789   addr[3] = (bfd_byte)(data >> (3*8));
790   addr[2] = (bfd_byte)(data >> (2*8));
791   addr[1] = (bfd_byte)(data >> (1*8));
792   addr[0] = (bfd_byte)(data >> (0*8));
793 #else
794   BFD_FAIL();
795 #endif
796
797 }
798
799 \f
800 /* Default implementation */
801
802 boolean
803 DEFUN(bfd_generic_get_section_contents, (abfd, section, location, offset, count),
804       bfd *abfd AND
805       sec_ptr section AND
806       PTR location AND
807       file_ptr offset AND
808       bfd_size_type count)
809 {
810     if (count == 0)
811         return true;
812     if ((bfd_size_type)(offset+count) > section->_raw_size
813         || bfd_seek(abfd, (file_ptr)(section->filepos + offset), SEEK_SET) == -1
814         || bfd_read(location, (bfd_size_type)1, count, abfd) != count)
815         return (false); /* on error */
816     return (true);
817 }
818
819 /* This generic function can only be used in implementations where creating
820    NEW sections is disallowed.  It is useful in patching existing sections
821    in read-write files, though.  See other set_section_contents functions
822    to see why it doesn't work for new sections.  */
823 boolean
824 bfd_generic_set_section_contents (abfd, section, location, offset, count)
825      bfd *abfd;
826      sec_ptr section;
827      PTR location;
828      file_ptr offset;
829      bfd_size_type count;
830 {
831   if (count == 0)
832     return true;
833
834   if (offset + count > bfd_get_section_size_after_reloc (section))
835     {
836       bfd_error = bad_value;
837       return false;
838     }
839
840   if (bfd_seek (abfd, (file_ptr) (section->filepos + offset), SEEK_SET) == -1
841       || bfd_write (location, (bfd_size_type) 1, count, abfd) != count)
842     return false;
843
844   return true;
845 }
846
847 /*
848 INTERNAL_FUNCTION
849         bfd_log2
850
851 SYNOPSIS
852         unsigned int bfd_log2(bfd_vma x);
853
854 DESCRIPTION
855         Return the log base 2 of the value supplied, rounded up.  E.g., an
856         @var{x} of 1025 returns 11.
857 */
858
859 unsigned
860 bfd_log2(x)
861      bfd_vma x;
862 {
863   unsigned result = 0;
864   while ( (bfd_vma)(1<< result) < x)
865     result++;
866   return result;
867 }