Admin

name	type	size	perms	modified	actions
[parent directory]
__pycache__/	dir	-	0755	2026-08-19 08:37:46
licenses/	dir	-	0755	2026-08-19 08:37:46
__init__.py	file	494 B	0644	2025-01-30 00:00:00	edit
_elffile.py	file	3,306 B	0644	2025-01-30 00:00:00	edit
_manylinux.py	file	9,612 B	0644	2025-01-30 00:00:00	edit
_musllinux.py	file	2,694 B	0644	2025-01-30 00:00:00	edit
_parser.py	file	10,236 B	0644	2025-01-30 00:00:00	edit
_structures.py	file	1,431 B	0644	2025-01-30 00:00:00	edit
_tokenizer.py	file	5,273 B	0644	2025-01-30 00:00:00	edit
markers.py	file	10,561 B	0644	2025-01-30 00:00:00	edit
metadata.py	file	34,762 B	0644	2025-01-30 00:00:00	edit
py.typed	file	0 B	0644	2025-01-30 00:00:00	edit
requirements.py	file	2,947 B	0644	2025-01-30 00:00:00	edit
specifiers.py	file	40,074 B	0644	2025-01-30 00:00:00	edit
tags.py	file	21,014 B	0644	2025-01-30 00:00:00	edit
utils.py	file	5,050 B	0644	2025-01-30 00:00:00	edit
version.py	file	16,676 B	0644	2025-01-30 00:00:00	edit

editing: _elffile.py

"""
ELF file parser.

This provides a class ``ELFFile`` that parses an ELF executable in a similar
interface to ``ZipFile``. Only the read interface is implemented.

Based on: https://gist.github.com/lyssdod/f51579ae8d93c8657a5564aefc2ffbca
ELF header: https://refspecs.linuxfoundation.org/elf/gabi4+/ch4.eheader.html
"""

from __future__ import annotations

import enum
import os
import struct
from typing import IO

class ELFInvalid(ValueError):
    pass

class EIClass(enum.IntEnum):
    C32 = 1
    C64 = 2

class EIData(enum.IntEnum):
    Lsb = 1
    Msb = 2

class EMachine(enum.IntEnum):
    I386 = 3
    S390 = 22
    Arm = 40
    X8664 = 62
    AArc64 = 183

class ELFFile:
    """
    Representation of an ELF executable.
    """

def __init__(self, f: IO[bytes]) -> None:
        self._f = f

try:
            ident = self._read("16B")
        except struct.error as e:
            raise ELFInvalid("unable to parse identification") from e
        magic = bytes(ident[:4])
        if magic != b"\x7fELF":
            raise ELFInvalid(f"invalid magic: {magic!r}")

self.capacity = ident[4]  # Format for program header (bitness).
        self.encoding = ident[5]  # Data structure encoding (endianness).

try:
            # e_fmt: Format for program header.
            # p_fmt: Format for section header.
            # p_idx: Indexes to find p_type, p_offset, and p_filesz.
            e_fmt, self._p_fmt, self._p_idx = {
                (1, 1): ("<HHIIIIIHHH", "<IIIIIIII", (0, 1, 4)),  # 32-bit LSB.
                (1, 2): (">HHIIIIIHHH", ">IIIIIIII", (0, 1, 4)),  # 32-bit MSB.
                (2, 1): ("<HHIQQQIHHH", "<IIQQQQQQ", (0, 2, 5)),  # 64-bit LSB.
                (2, 2): (">HHIQQQIHHH", ">IIQQQQQQ", (0, 2, 5)),  # 64-bit MSB.
            }[(self.capacity, self.encoding)]
        except KeyError as e:
            raise ELFInvalid(
                f"unrecognized capacity ({self.capacity}) or "
                f"encoding ({self.encoding})"
            ) from e

try:
            (
                _,
                self.machine,  # Architecture type.
                _,
                _,
                self._e_phoff,  # Offset of program header.
                _,
                self.flags,  # Processor-specific flags.
                _,
                self._e_phentsize,  # Size of section.
                self._e_phnum,  # Number of sections.
            ) = self._read(e_fmt)
        except struct.error as e:
            raise ELFInvalid("unable to parse machine and section information") from e

def _read(self, fmt: str) -> tuple[int, ...]:
        return struct.unpack(fmt, self._f.read(struct.calcsize(fmt)))

@property
    def interpreter(self) -> str | None:
        """
        The path recorded in the ``PT_INTERP`` section header.
        """
        for index in range(self._e_phnum):
            self._f.seek(self._e_phoff + self._e_phentsize * index)
            try:
                data = self._read(self._p_fmt)
            except struct.error:
                continue
            if data[self._p_idx[0]] != 3:  # Not PT_INTERP.
                continue
            self._f.seek(data[self._p_idx[1]])
            return os.fsdecode(self._f.read(data[self._p_idx[2]])).strip("\0")
        return None

cancel