NAME

       elf32_xlatetom, elf64_xlatetom - translate 32-bit or 64-bit ELF data from file
       representation to memory representation

       elf32_xlatetof, elf64_xlatetof - translate 32-bit or 64-bit ELF data from memory
       representation to file representation

SYNOPSIS

       #include <libelf.h>

       int elf32_xlatetom(Elf_Data *dst, const Elf_Data *src, unsigned int encoding);
       int elf64_xlatetom(Elf_Data *dst, const Elf_Data *src, unsigned int encoding);

       int elf32_xlatetof(Elf_Data *dst, const Elf_Data *src, unsigned int encoding);
       int elf64_xlatetof(Elf_Data *dst, const Elf_Data *src, unsigned int encoding);

DESCRIPTION

       Translate  ELF  data  from  file  representation to memory representation or vice versa.  File and memory
       representations of ELF data can differ in terms of endianness.   Data  in  file  representation  normally
       comes  from  elf_rawdata while data in memory representation normally comes from elf_getdata.  When there
       is no difference between file and memory representations, these functions simply copy the ELF  data  from
       src  to  dst.   Otherwise the encoding will swap between ELFDATA2LSB (two's complement little-endian) and
       ELFDATA2MSB (two's complement big-endian). The encoding of an ELF file is specified in the Elf32_Ehdr  or
       Elf64_Ehdr  e_ident[EI_DATA]  member.   To  know  the  memory  encoding  for  a  program you can #include
       <endian.h> and check  BYTE_ORDER  ==  LITTLE_ENDIAN  (corresponding  to  ELFDATA2LSB)  or  BYTE_ORDER  ==
       BIG_ENDIAN (corresponding to ELFDATA2MSB).

PARAMETERS

       dst    Destination where the translated data will be stored.  The d_size of dst should be at least as big
              as the d_size of src.

       src    Source  data.  For  the xlatetom functions, the source data should be in file representation.  For
              the xlatetof functions, the source data should be in memory representation.

       encoding
              Specifies an encoding.  Can be either ELFDATA2LSB (two's complement little-endian) or  ELFDATA2MSB
              (two's  complement  big-endian).   For the xlatetom functions, this specifies the encoding of src.
              For the xlatetof functions, this specifies the encoding of dst.

RETURN VALUE

       On success, return dst, which will contain the translated data.  If there is no  difference  between  the
       file  and  memory  representations, dst will contain a copy of the source data.  The d_type and d_size of
       dst will be set to those of src.

        If an error occurs, return NULL and set a libelf error code.

SEE ALSO

       elf_errno(3), elf_getdata(3), elf_rawdata(3), libelf(3), elf(5)

ATTRIBUTES

       For an explanation of the terms used in this section, see attributes(7).
       ┌─────────────────────────────────────────────────────────────────────────────┬───────────────┬─────────┐
       │ Interface                                                                   │ Attribute     │ Value   │
       ├─────────────────────────────────────────────────────────────────────────────┼───────────────┼─────────┤
       │ elf32_xlatetom(), elf64_xlatetom(), elf32_xlatetof(), elf64_xlatetof()      │ Thread safety │ MT-Safe │
       └─────────────────────────────────────────────────────────────────────────────┴───────────────┴─────────┘

REPORTING BUGS

       Report bugs to <elfutils-devel@sourceware.org> or https://sourceware.org/bugzilla/.

Libelf                                             2024-08-14                                  ELF32_XLATETOM(3)