Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
ELFTC_BFD_FIND_TARGET		     LOCAL		 ELFTC_BFD_FIND_TARGET

NAME
     elftc_bfd_find_target, elftc_bfd_target_byteorder,
     elftc_bfd_target_class, elftc_bfd_target_flavor, elftc_bfd_target_machine
     --	binary object descriptor handling

LIBRARY
     library ``libelftc''

SYNOPSIS
     #include <libelftc.h>

     struct Elftc_Bfd_Target;

     Elftc_Bfd_Target *
     elftc_bfd_find_target(const char *target_name);

     unsigned int
     elftc_bfd_target_class(Elftc_Bfd_Target *target);

     unsigned int
     elftc_bfd_target_byteorder(Elftc_Bfd_Target *target);

     Elftc_Bfd_Target_Flavor
     elftc_bfd_target_flavor(Elftc_Bfd_Target *target);

     unsigned int
     elftc_bfd_target_machine(Elftc_Bfd_Target *target);

DESCRIPTION
     Function elftc_bfd_find_target() locates a	binary object descriptor cor-
     responding	to the descriptor name in argument target_name.	 Binary	object
     descriptors encapsulate properties	of an object format such as its	file
     representation, ELF class,	and byte endianness.

     Known descriptor names and	their properties include:

	 Name			 Object	Format	  Byte Order	Bit Width
	 binary			 Binary		  -		-
	 efi-app-ia32		 PE		  LSB		32
	 efi-app-x86_64		 PE		  LSB		64
	 elf32-avr		 ELF		  LSB		32
	 elf32-big		 ELF		  MSB		32
	 elf32-bigarm		 ELF		  MSB		32
	 elf32-bigmips		 ELF		  MSB		32
	 elf32-i386		 ELF		  LSB		32
	 elf32-i386-freebsd	 ELF		  LSB		32
	 elf32-ia64-big		 ELF		  MSB		32
	 elf32-little		 ELF		  LSB		32
	 elf32-littlearm	 ELF		  LSB		32
	 elf32-littlemips	 ELF		  LSB		32
	 elf32-powerpc		 ELF		  MSB		32
	 elf32-powerpc-freebsd	 ELF		  MSB		32
	 elf32-powerpcle	 ELF		  LSB		32
	 elf32-sh		 ELF		  MSB		32
	 elf32-shl		 ELF		  LSB		32
	 elf32-sh-nbsd		 ELF		  MSB		32
	 elf32-shl-nbsd		 ELF		  LSB		32
	 elf32-shbig-linux	 ELF		  MSB		32
	 elf32-shl-linux	 ELF		  LSB		32
	 elf32-sparc		 ELF		  MSB		32
	 elf32-tradbigmips	 ELF		  MSB		32
	 elf32-tradlittlemips	 ELF		  LSB		32
	 elf64-alpha		 ELF		  LSB		64
	 elf64-alpha-freebsd	 ELF		  LSB		64
	 elf64-big		 ELF		  MSB		64
	 elf64-bigmips		 ELF		  MSB		64
	 elf64-ia64-big		 ELF		  MSB		64
	 elf64-ia64-little	 ELF		  LSB		64
	 elf64-little		 ELF		  LSB		64
	 elf64-littleaarch64	 ELF		  LSB		64
	 elf64-littlemips	 ELF		  LSB		64
	 elf64-powerpc		 ELF		  MSB		64
	 elf64-powerpc-freebsd	 ELF		  MSB		64
	 elf64-powerpcle	 ELF		  LSB		64
	 elf64-sh64		 ELF		  MSB		64
	 elf64-sh64l		 ELF		  LSB		64
	 elf64-sh64-nbsd	 ELF		  MSB		64
	 elf64-sh64l-nbsd	 ELF		  LSB		64
	 elf64-sh64big-linux	 ELF		  MSB		64
	 elf64-sh64-linux	 ELF		  LSB		64
	 elf64-sparc		 ELF		  MSB		64
	 elf64-sparc-freebsd	 ELF		  MSB		64
	 elf64-tradbigmips	 ELF		  MSB		64
	 elf64-tradlittlemips	 ELF		  LSB		64
	 elf64-x86-64		 ELF		  LSB		64
	 elf64-x86-64-freebsd	 ELF		  LSB		64
	 ihex			 IHEX		  -		-
	 pei-i386		 PE		  LSB		32
	 pei-x86-64		 PE		  LSB		64
	 srec			 SREC		  -		-
	 symbolsrec		 SREC		  -		-

     Function elftc_bfd_target_byteorder() returns the ELF byte	order associ-
     ated with target descriptor target.

     Function elftc_bfd_target_class() returns the ELF class associated	with
     target descriptor target.

     Function elftc_bfd_target_flavor()	returns	the object format associated
     with target descriptor target.  The known object formats are:
	 ETF_ELF     An	ELF object.
	 ETF_BINARY  Raw binary.
	 ETF_IHEX    An	object encoded in Intel	hex format.
	 ETF_NONE    An	unknown	object format.
	 ETF_SREC    An	object encoded as S-records.

RETURN VALUES
     Function elftc_bfd_find_target() returns a	valid pointer to an opaque
     binary target descriptor if successful, or	NULL in	case of	an error.

     Function elftc_bfd_target_byteorder() returns the ELF byte	order associ-
     ated with the target descriptor; one of ELFDATA2MSB or ELFDATA2LSB.

     Function elftc_bfd_target_class() returns the ELF class associated	with
     the target	descriptor; one	of ELFCLASS32 or ELFCLASS64.

     Function elftc_bfd_target_machine() returns the ELF architecture associ-
     ated with the target descriptor.

     Function elftc_bfd_target_flavor()	returns	one of ETF_BINARY, ETF_ELF,
     ETF_IHEX or ETF_SREC if successful	or ETF_NONE in case of error.

EXAMPLES
     To	return descriptor information associated with target name
     ``elf64-big'' use:

	   struct Elftc_Bfd_Target *t;

	   if ((t = elftc_bfd_find_target("elf64-big"))	== NULL)
		   errx(EXIT_FAILURE, "Cannot find target descriptor");

	   printf("Class: %s\n", elftc_bfd_target_class(t) == ELFCLASS32 ?
	       "ELFCLASS32" : "ELFCLASS64");
	   printf("Byteorder: %s\n",
	       elftc_bfd_target_byteorder(t) ==	ELFDATA2LSB ? "LSB" : "MSB");
	   printf("Flavor: %d\n", elftc_bfd_target_flavor(t));

SEE ALSO
     elf(3)

FreeBSD	Ports 11.2	       November	30, 2011	    FreeBSD Ports 11.2

NAME | LIBRARY | SYNOPSIS | DESCRIPTION | RETURN VALUES | EXAMPLES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=elftc_bfd_find_target&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help