forked from Mirror/pmbootstrap
198f302a36
Introduce a new module: pmb.core to contain explicitly typed pmbootstrap
API. The first component being Suffix and SuffixType. This explicitly
defines what suffixes are possible, future changes should aim to further
constrain this API (e.g. by validating against available device
codenames or architectures for buildroot suffixes).
Additionally, migrate the entire codebase over to using pathlib.Path.
This is a relatively new part of the Python standard library that uses a
more object oriented model for path handling. It also uses strong type
hinting and has other features that make it much cleaner and easier to
work with than pure f-strings. The Chroot class overloads the "/"
operator the same way the Path object does, allowing one to write paths
relative to a given chroot as:
builddir = chroot / "home/pmos/build"
The Chroot class also has a string representation ("native", or
"rootfs_valve-jupiter"), and a .path property for directly accessing the
absolute path (as a Path object).
The general idea here is to encapsulate common patterns into type hinted
code, and gradually reduce the amount of assumptions made around the
codebase so that future changes are easier to implement.
As the chroot suffixes are now part of the Chroot class, we also
implement validation for them, this encodes the rules on suffix naming
and will cause a runtime exception if a suffix doesn't follow the rules.
134 lines
4.1 KiB
Python
134 lines
4.1 KiB
Python
# Copyright 2023 Oliver Smith
|
|
# SPDX-License-Identifier: GPL-3.0-or-later
|
|
import fnmatch
|
|
import platform
|
|
import pmb.config
|
|
import pmb.parse.arch
|
|
|
|
from pmb.core.types import PmbArgs
|
|
from pmb.core import Chroot, ChrootType
|
|
|
|
def alpine_native():
|
|
machine = platform.machine()
|
|
|
|
return machine_type_to_alpine(machine)
|
|
|
|
|
|
def from_chroot_suffix(args: PmbArgs, chroot: Chroot) -> str:
|
|
if chroot == Chroot.native():
|
|
return pmb.config.arch_native
|
|
if chroot.name() == args.device:
|
|
return args.deviceinfo["arch"]
|
|
if chroot.type() == ChrootType.BUILDROOT:
|
|
return chroot.name()
|
|
|
|
raise ValueError(f"Invalid chroot suffix: {chroot}"
|
|
" (wrong device chosen in 'init' step?)")
|
|
|
|
|
|
def alpine_to_qemu(arch):
|
|
"""
|
|
Convert the architecture to the string used in the QEMU packaging.
|
|
This corresponds to the package name of e.g. qemu-system-aarch64.
|
|
"""
|
|
|
|
mapping = {
|
|
"x86": "i386",
|
|
"x86_64": "x86_64",
|
|
"armhf": "arm",
|
|
"armv7": "arm",
|
|
"aarch64": "aarch64",
|
|
"riscv64": "riscv64",
|
|
}
|
|
for pattern, arch_qemu in mapping.items():
|
|
if fnmatch.fnmatch(arch, pattern):
|
|
return arch_qemu
|
|
raise ValueError("Can not map Alpine architecture '" + arch + "'"
|
|
" to the right Debian architecture.")
|
|
|
|
|
|
def alpine_to_kernel(arch):
|
|
"""
|
|
Convert the architecture to the string used inside the kernel sources.
|
|
You can read the mapping from the linux-vanilla APKBUILD for example.
|
|
"""
|
|
mapping = {
|
|
"aarch64*": "arm64",
|
|
"arm*": "arm",
|
|
"ppc*": "powerpc",
|
|
"s390*": "s390",
|
|
"riscv64*": "riscv",
|
|
}
|
|
for pattern, arch_kernel in mapping.items():
|
|
if fnmatch.fnmatch(arch, pattern):
|
|
return arch_kernel
|
|
return arch
|
|
|
|
|
|
def alpine_to_hostspec(arch):
|
|
"""
|
|
See: abuild source code/functions.sh.in: arch_to_hostspec()
|
|
"""
|
|
mapping = {
|
|
"aarch64": "aarch64-alpine-linux-musl",
|
|
"armel": "armv5-alpine-linux-musleabi",
|
|
"armhf": "armv6-alpine-linux-musleabihf",
|
|
"armv7": "armv7-alpine-linux-musleabihf",
|
|
"loongarch32": "loongarch32-alpine-linux-musl",
|
|
"loongarchx32": "loongarchx32-alpine-linux-musl",
|
|
"loongarch64": "loongarch64-alpine-linux-musl",
|
|
"mips": "mips-alpine-linux-musl",
|
|
"mips64": "mips64-alpine-linux-musl",
|
|
"mipsel": "mipsel-alpine-linux-musl",
|
|
"mips64el": "mips64el-alpine-linux-musl",
|
|
"ppc": "powerpc-alpine-linux-musl",
|
|
"ppc64": "powerpc64-alpine-linux-musl",
|
|
"ppc64le": "powerpc64le-alpine-linux-musl",
|
|
"riscv32": "riscv32-alpine-linux-musl",
|
|
"riscv64": "riscv64-alpine-linux-musl",
|
|
"s390x": "s390x-alpine-linux-musl",
|
|
"x86": "i586-alpine-linux-musl",
|
|
"x86_64": "x86_64-alpine-linux-musl",
|
|
}
|
|
if arch in mapping:
|
|
return mapping[arch]
|
|
|
|
raise ValueError("Can not map Alpine architecture '" + arch + "'"
|
|
" to the right hostspec value")
|
|
|
|
|
|
def cpu_emulation_required(arch):
|
|
# Obvious case: host arch is target arch
|
|
if pmb.config.arch_native == arch:
|
|
return False
|
|
|
|
# Other cases: host arch on the left, target archs on the right
|
|
not_required = {
|
|
"x86_64": ["x86"],
|
|
"armv7": ["armel", "armhf"],
|
|
"aarch64": ["armv7"],
|
|
}
|
|
if pmb.config.arch_native in not_required:
|
|
if arch in not_required[pmb.config.arch_native]:
|
|
return False
|
|
|
|
# No match: then it's required
|
|
return True
|
|
|
|
|
|
def machine_type_to_alpine(machine_type: str) -> str:
|
|
"""Translate a machine type to an Alpine architecture. A machine type can come from
|
|
for example `$ uname -m` or platform.machine() from Python's standard library."""
|
|
mapping = {
|
|
"i686": "x86",
|
|
"x86_64": "x86_64",
|
|
"aarch64": "aarch64",
|
|
"arm64": "aarch64",
|
|
"armv6l": "armhf",
|
|
"armv7l": "armv7",
|
|
"armv8l": "armv7",
|
|
}
|
|
if machine_type in mapping:
|
|
return mapping[machine_type]
|
|
raise ValueError(f"Can not map machine type '{machine_type}'"
|
|
" to the right Alpine Linux architecture")
|