/* Assorted BFD support routines, only used internally.
- Copyright 1990, 1991, 1992 Free Software Foundation, Inc.
+ Copyright 1990, 1991, 1992, 1993 Free Software Foundation, Inc.
Written by Cygnus Support.
This file is part of BFD, the Binary File Descriptor library.
/*
SECTION
- libbfd
+ Internal functions
DESCRIPTION
- This file contains various routines which are used within BFD.
+ These routines are used within BFD.
They are not intended for export, but are documented here for
completeness.
*/
+/*ARGSUSED*/
boolean
DEFUN(_bfd_dummy_new_section_hook,(ignore, ignore_newsect),
bfd *ignore AND
return true;
}
+/*ARGSUSED*/
boolean
DEFUN(bfd_false ,(ignore),
bfd *ignore)
return false;
}
+/*ARGSUSED*/
boolean
DEFUN(bfd_true,(ignore),
bfd *ignore)
return true;
}
+/*ARGSUSED*/
PTR
DEFUN(bfd_nullvoidptr,(ignore),
bfd *ignore)
return (PTR)NULL;
}
+/*ARGSUSED*/
int
DEFUN(bfd_0,(ignore),
bfd *ignore)
return 0;
}
+/*ARGSUSED*/
unsigned int
DEFUN(bfd_0u,(ignore),
bfd *ignore)
return 0;
}
+/*ARGSUSED*/
void
DEFUN(bfd_void,(ignore),
bfd *ignore)
{
}
+/*ARGSUSED*/
boolean
DEFUN(_bfd_dummy_core_file_matches_executable_p,(ignore_core_bfd, ignore_exec_bfd),
bfd *ignore_core_bfd AND
/* of course you can't initialize a function to be the same as another, grr */
+/*ARGSUSED*/
char *
DEFUN(_bfd_dummy_core_file_failing_command,(ignore_abfd),
bfd *ignore_abfd)
return (char *)NULL;
}
+/*ARGSUSED*/
int
DEFUN(_bfd_dummy_core_file_failing_signal,(ignore_abfd),
bfd *ignore_abfd)
return 0;
}
+/*ARGSUSED*/
bfd_target *
DEFUN(_bfd_dummy_target,(ignore_abfd),
bfd *ignore_abfd)
bfd_xmalloc
SYNOPSIS
- PTR bfd_xmalloc( bfd_size_type size);
+ PTR bfd_xmalloc (bfd_size_type size);
DESCRIPTION
- Like malloc, but exit if no more memory.
+ Like <<malloc>>, but exit if no more memory.
*/
if (!ptr)
{
write (2, no_memory_message, sizeof(no_memory_message)-1);
- exit (-1);
+ exit (1);
}
return ptr;
}
bfd_xmalloc_by_size_t
SYNOPSIS
- PTR bfd_xmalloc_by_size_t ( size_t size);
+ PTR bfd_xmalloc_by_size_t (size_t size);
DESCRIPTION
- Like malloc, but exit if no more memory.
- Uses size_t, so it's suitable for use as obstack_chunk_alloc.
+ Like <<malloc>>, but exit if no more memory.
+ Uses <<size_t>>, so it's suitable for use as <<obstack_chunk_alloc>>.
*/
PTR
DEFUN(bfd_xmalloc_by_size_t, (size),
}
bfd_size_type
-DEFUN(bfd_write,(ptr, size, nitems, abfd),
- CONST PTR ptr AND
- bfd_size_type size AND
- bfd_size_type nitems AND
- bfd *abfd)
+bfd_write (ptr, size, nitems, abfd)
+ CONST PTR ptr;
+ bfd_size_type size;
+ bfd_size_type nitems;
+ bfd *abfd;
{
- int nwrote = fwrite (ptr, 1, (int)(size*nitems), bfd_cache_lookup(abfd));
+ int nwrote = fwrite (ptr, 1, (int) (size * nitems), bfd_cache_lookup (abfd));
#ifdef FILE_OFFSET_IS_CHAR_INDEX
if (nwrote > 0)
abfd->where += nwrote;
#endif
+ if (nwrote != size * nitems)
+ {
+#ifdef ENOSPC
+ if (nwrote >= 0)
+ errno = ENOSPC;
+#endif
+ bfd_error = system_call_error;
+ }
return nwrote;
}
void bfd_write_bigendian_4byte_int(bfd *abfd, int i);
DESCRIPTION
- Writes a 4 byte integer to the outputing bfd, in big endian
- mode regardless of what else is going on. This is useful in
+ Write a 4 byte integer @var{i} to the output BFD @var{abfd}, in big
+ endian order regardless of what else is going on. This is useful in
archives.
*/
#ifdef FILE_OFFSET_IS_CHAR_INDEX
if (abfd->format != bfd_archive && abfd->my_archive == 0)
{
-#ifndef NDEBUG
+#if 0
/* Explanation for this code: I'm only about 95+% sure that the above
conditions are sufficient and that all i/o calls are properly
adjusting the `where' field. So this is sort of an `assert'
result = fseek (f, file_position, direction);
if (result != 0)
- /* Force redetermination of `where' field. */
- bfd_tell (abfd);
+ {
+ /* Force redetermination of `where' field. */
+ bfd_tell (abfd);
+ bfd_error = system_call_error;
+ }
else
{
#ifdef FILE_OFFSET_IS_CHAR_INDEX
mangling performs any necessary endian translations and
removes alignment restrictions. Note that types accepted and
returned by these macros are identical so they can be swapped
- around in macros--for example libaout.h defines GET_WORD to
- either bfd_get_32 or bfd_get_64.
+ around in macros---for example, @file{libaout.h} defines <<GET_WORD>>
+ to either <<bfd_get_32>> or <<bfd_get_64>>.
- In the put routines, val must be a bfd_vma. If we are on a
+ In the put routines, @var{val} must be a <<bfd_vma>>. If we are on a
system without prototypes, the caller is responsible for making
sure that is true, with a cast if necessary. We don't cast
- them in the macro definitions because that would prevent lint
- or gcc -Wall from detecting sins such as passing a pointer.
- To detect calling these with less than a bfd_vma, use gcc
- -Wconversion on a host with 64 bit bfd_vma's.
+ them in the macro definitions because that would prevent <<lint>>
+ or <<gcc -Wall>> from detecting sins such as passing a pointer.
+ To detect calling these with less than a <<bfd_vma>>, use
+ <<gcc -Wconversion>> on a host with 64 bit <<bfd_vma>>'s.
.
.{* Byte swapping macros for user section data. *}
.
.#define bfd_put_8(abfd, val, ptr) \
-. (*((unsigned char *)(ptr)) = (unsigned char)val)
+. (*((unsigned char *)(ptr)) = (unsigned char)(val))
.#define bfd_put_signed_8 \
. bfd_put_8
.#define bfd_get_8(abfd, ptr) \
/*
FUNCTION
bfd_h_put_size
-FUNCTION
bfd_h_get_size
DESCRIPTION
These macros have the same function as their <<bfd_get_x>>
- bretherin, except that they are used for removing information
+ bretheren, except that they are used for removing information
for the header records of object files. Believe it or not,
some object files keep their header records in big endian
- order, and their data in little endian order.
+ order and their data in little endian order.
.
.{* Byte swapping macros for file header data. *}
.
*/
/* Sign extension to bfd_signed_vma. */
-#define COERCE16(x) ((bfd_signed_vma) (((x) ^ 0x8000) - 0x8000))
-#define COERCE32(x) ((bfd_signed_vma) (((x) ^ 0x80000000) - 0x80000000))
+#define COERCE16(x) (((bfd_signed_vma) (x) ^ 0x8000) - 0x8000)
+#define COERCE32(x) (((bfd_signed_vma) (x) ^ 0x80000000) - 0x80000000)
#define EIGHT_GAZILLION (((HOST_64_BIT)0x80000000) << 32)
-#define COERCE64(x) ((bfd_signed_vma)\
- (((x) ^ EIGHT_GAZILLION) - EIGHT_GAZILLION))
+#define COERCE64(x) \
+ (((bfd_signed_vma) (x) ^ EIGHT_GAZILLION) - EIGHT_GAZILLION)
bfd_vma
DEFUN(bfd_getb16,(addr),
bfd_getb32 (addr)
register bfd_byte *addr;
{
- return ((((addr[0] << 8) | addr[1]) << 8) | addr[2]) << 8 | addr[3];
+ return (((((bfd_vma)addr[0] << 8) | addr[1]) << 8)
+ | addr[2]) << 8 | addr[3];
}
bfd_vma
bfd_getl32 (addr)
register bfd_byte *addr;
{
- return ((((addr[3] << 8) | addr[2]) << 8) | addr[1]) << 8 | addr[0];
+ return (((((bfd_vma)addr[3] << 8) | addr[2]) << 8)
+ | addr[1]) << 8 | addr[0];
}
bfd_signed_vma
bfd_getb_signed_32 (addr)
register bfd_byte *addr;
{
- return COERCE32(((((addr[0] << 8) | addr[1]) << 8)
+ return COERCE32((((((bfd_vma)addr[0] << 8) | addr[1]) << 8)
| addr[2]) << 8 | addr[3]);
}
bfd_getl_signed_32 (addr)
register bfd_byte *addr;
{
- return COERCE32(((((addr[3] << 8) | addr[2]) << 8)
+ return COERCE32((((((bfd_vma)addr[3] << 8) | addr[2]) << 8)
| addr[1]) << 8 | addr[0]);
}
addr[2]) << 8) |
addr[3]) );
- low = ((((((((addr[4]) << 8) |
+ low = (((((((((bfd_vma)addr[4]) << 8) |
addr[5]) << 8) |
addr[6]) << 8) |
addr[7]));
addr[5]) << 8) |
addr[4]));
- low = (((((((addr[3] << 8) |
+ low = ((((((((bfd_vma)addr[3] << 8) |
addr[2]) << 8) |
addr[1]) << 8) |
addr[0]) );
addr[2]) << 8) |
addr[3]) );
- low = ((((((((addr[4]) << 8) |
+ low = (((((((((bfd_vma)addr[4]) << 8) |
addr[5]) << 8) |
addr[6]) << 8) |
addr[7]));
addr[5]) << 8) |
addr[4]));
- low = (((((((addr[3] << 8) |
+ low = ((((((((bfd_vma)addr[3] << 8) |
addr[2]) << 8) |
addr[1]) << 8) |
addr[0]) );
in read-write files, though. See other set_section_contents functions
to see why it doesn't work for new sections. */
boolean
-DEFUN(bfd_generic_set_section_contents, (abfd, section, location, offset, count),
- bfd *abfd AND
- sec_ptr section AND
- PTR location AND
- file_ptr offset AND
- bfd_size_type count)
+bfd_generic_set_section_contents (abfd, section, location, offset, count)
+ bfd *abfd;
+ sec_ptr section;
+ PTR location;
+ file_ptr offset;
+ bfd_size_type count;
{
- if (count == 0)
- return true;
- if ((bfd_size_type)(offset+count) > bfd_get_section_size_after_reloc(section)
- || bfd_seek(abfd, (file_ptr)(section->filepos + offset), SEEK_SET) == -1
- || bfd_write(location, (bfd_size_type)1, count, abfd) != count)
- return (false); /* on error */
- return (true);
+ if (count == 0)
+ return true;
+
+ if (offset + count > bfd_get_section_size_after_reloc (section))
+ {
+ bfd_error = bad_value;
+ return false;
+ }
+
+ if (bfd_seek (abfd, (file_ptr) (section->filepos + offset), SEEK_SET) == -1
+ || bfd_write (location, (bfd_size_type) 1, count, abfd) != count)
+ return false;
+
+ return true;
}
/*
INTERNAL_FUNCTION
bfd_log2
-DESCRIPTION
- Return the log base 2 of the value supplied, rounded up. eg an
- arg of 1025 would return 11.
-
SYNOPSIS
unsigned int bfd_log2(bfd_vma x);
+
+DESCRIPTION
+ Return the log base 2 of the value supplied, rounded up. E.g., an
+ @var{x} of 1025 returns 11.
*/
unsigned