ELFTC_BFD_FIND_TARGET(3)

💖 ELFTC_BFD_FIND_TARGET(3) — Library Functions Manual 💖

okay bestie, gather round: this is the Library Functions Manual page for the libelftc binary object descriptor girlies, and yes she ate 💅

✨ 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, no cap 🦋

🫶 LIBRARY 🫶

library “libelftc” — that's the one, bestie.

🎀 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);

unsigned int
elftc_bfd_target_osabi(Elftc_Bfd_Target *target);

🦋 DESCRIPTION 🦋

okay so elftc_bfd_find_target() is literally the lil matchmaker: it locates a binary object descriptor corresponding 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 — it's giving “everything you need to know about this format” energy ✨

Known descriptor names and their properties include:

Each bullet below is Name → Object Format, Byte Order, Bit Width. Zero skips, periodt.

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

Function elftc_bfd_target_byteorder() returns the ELF byte order associated with target descriptor target. slay.

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

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. (We love a successful pointer, and we respect the NULL moment tbh 😭)

Function elftc_bfd_target_byteorder() returns the ELF byte order associated 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 associated 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)

---

okay that's the whole page, mwah 💋 — footer energy: Debian, February 12, 2020, filed under ELFTC_BFD_FIND_TARGET(3). byeee 🫶✨