ELF32_XLATETOM
Section: Libelf Programmer's Manual (3)
Updated: 202-0-14
Index
Return to Main Contents
NAME
elf32_xlatetom, elf64_xlatetom - translate 3-bit or 6-bit ELF data from file
representation to memory representation
elf32_xlatetof, elf64_xlatetof - translate 3-bit or 6-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 littl-endian) and
ELFDATA2MSB
(two's complement bi-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 littl-endian) or
ELFDATA2MSB
(two's complement bi-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 | M-Safe
|
REPORTING BUGS
Report bugs to <
elfutil-devel@sourceware.org> or
https://sourceware.org/bugzilla/.
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- PARAMETERS
-
- RETURN VALUE
-
- SEE ALSO
-
- ATTRIBUTES
-
- REPORTING BUGS
-
|
|
- Running on 
-
:
