mirror of
https://github.com/astral-sh/uv.git
synced 2025-07-07 13:25:00 +00:00
dd7da6af5f
Whew this is a lot. The user-facing changes are: - `uv toolchain` to `uv python` e.g. `uv python find`, `uv python install`, ... - `UV_TOOLCHAIN_DIR` to` UV_PYTHON_INSTALL_DIR` - `<UV_STATE_DIR>/toolchains` to `<UV_STATE_DIR>/python` (with [automatic migration](https://github.com/astral-sh/uv/pull/4735/files#r1663029330)) - User-facing messages no longer refer to toolchains, instead using "Python", "Python versions" or "Python installations" The internal changes are: - `uv-toolchain` crate to `uv-python` - `Toolchain` no longer referenced in type names - Dropped unused `SystemPython` type (previously replaced) - Clarified the type names for "managed Python installations" - (more little things)
110 lines
3.2 KiB
Python
110 lines
3.2 KiB
Python
"""
|
|
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:
|
|
raise ELFInvalid("unable to parse identification")
|
|
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:
|
|
raise ELFInvalid(
|
|
f"unrecognized capacity ({self.capacity}) or "
|
|
f"encoding ({self.encoding})"
|
|
)
|
|
|
|
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
|