From 9f43ba58d2e33a63f5a66689deb854690e8374ed Mon Sep 17 00:00:00 2001 From: Josephine Pfeiffer Date: Thu, 29 May 2025 11:54:20 +0200 Subject: [PATCH] first commit --- .gitignore | 30 +++++++++++++++++++++++++++ .treeinfo | 12 +++++++++++ CODEOWNERS | 5 +++++ LICENSE | 34 ++++++++++++++++++++++++++++++ README.md | 42 ++++++++++++++++++++++++++++++++++++++ generic.ins | 5 +++++ s390x/boot/arch.prm | 1 + s390x/boot/initrd.addrsize | 1 + 8 files changed, 130 insertions(+) create mode 100644 .gitignore create mode 100644 .treeinfo create mode 100644 CODEOWNERS create mode 100644 LICENSE create mode 100644 README.md create mode 100644 generic.ins create mode 100644 s390x/boot/arch.prm create mode 100644 s390x/boot/initrd.addrsize diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..5ece0b8 --- /dev/null +++ b/.gitignore @@ -0,0 +1,30 @@ +# ISO files +*.iso + +# Temporary files +*.tmp +*.swp +*.swo +*~ + +# OS generated files +.DS_Store +Thumbs.db + +# Build artifacts +*.o +*.ko +*.obj +*.elf + +# Compressed files +*.gz +*.bz2 +*.xz + +# Backup files +*.bak +*.backup + +# Log files +*.log diff --git a/.treeinfo b/.treeinfo new file mode 100644 index 0000000..7b7dbe2 --- /dev/null +++ b/.treeinfo @@ -0,0 +1,12 @@ +[general] +name = Arch Linux +version = 2025.05.01 +arch = s390x +platforms = s390x + +[stage2] +mainimage = s390x/boot/rootfs.img + +[images-s390x] +kernel = s390x/boot/vmlinuz-linux +initrd = s390x/boot/initramfs-linux.img \ No newline at end of file diff --git a/CODEOWNERS b/CODEOWNERS new file mode 100644 index 0000000..a13dc22 --- /dev/null +++ b/CODEOWNERS @@ -0,0 +1,5 @@ +# CODEOWNERS for Arch Linux s390x LPAR boot components + +# Global owners +* @pfeifferj josie@redhat.com +* @Morganamilo morganamilo@archlinux.org \ No newline at end of file diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..ae6a4e4 --- /dev/null +++ b/LICENSE @@ -0,0 +1,34 @@ +Copyright (c) 2025 Arch Linux s390x Contributors + +This work is based on Arch Linux (https://archlinux.org/) + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + +================================================================================ + +This distribution contains software from the Arch Linux project, which includes +components under various open source licenses including but not limited to: +- GNU General Public License (GPL) +- GNU Lesser General Public License (LGPL) +- BSD licenses +- MIT license +- Apache License + +For specific licensing information about individual packages, please refer to +the license files included with each package in the Arch Linux repositories. \ No newline at end of file diff --git a/README.md b/README.md new file mode 100644 index 0000000..18f13c2 --- /dev/null +++ b/README.md @@ -0,0 +1,42 @@ +# Arch Linux s390x LPAR Boot Components + +This repository contains the necessary files to boot Arch Linux on IBM System z (s390x) LPAR. + +## Structure + +``` +. +├── s390x/ +│ └── boot/ +│ ├── arch.prm # Kernel parameters +│ ├── initrd.addrsize # Memory layout for initrd +│ ├── vmlinuz-linux # s390x kernel (needs to be added) +│ └── initramfs-linux.img # s390x initrd (needs to be added) +├── generic.ins # IPL configuration file +├── .treeinfo # Boot media metadata +└── README.md # This file +``` + +## Boot Files + +- **generic.ins** - IPL configuration file that specifies: + - Kernel location: `s390x/boot/vmlinuz-linux` at address `0x00000000` + - Initrd location: `s390x/boot/initramfs-linux.img` at address `0x02000000` + - Parameter file: `s390x/boot/arch.prm` + - Address/size file: `s390x/boot/initrd.addrsize` + +- **arch.prm** - Kernel boot parameters: + - Console settings for both serial and virtual terminals + - Arch ISO base directory and label + +- **initrd.addrsize** - Memory layout: + - Start address: `0x02000000` + - Maximum size: `0x10000000` (256MB) + +- **.treeinfo** - Boot media metadata for SFTP boot + +## Todo + +1. Build or obtain s390x versions of: + - Linux kernel compiled for s390x + - Initramfs with s390x userspace diff --git a/generic.ins b/generic.ins new file mode 100644 index 0000000..d3ded11 --- /dev/null +++ b/generic.ins @@ -0,0 +1,5 @@ +* Arch Linux s390x LPAR boot file +s390x/boot/vmlinuz-linux 0x00000000 +s390x/boot/initramfs-linux.img 0x02000000 +s390x/boot/arch.prm 0x00010480 +s390x/boot/initrd.addrsize 0x00010408 \ No newline at end of file diff --git a/s390x/boot/arch.prm b/s390x/boot/arch.prm new file mode 100644 index 0000000..4ef5b22 --- /dev/null +++ b/s390x/boot/arch.prm @@ -0,0 +1 @@ +rw console=ttyS0 console=tty0 archisobasedir=arch archisolabel=ARCH_2025_05_01 \ No newline at end of file diff --git a/s390x/boot/initrd.addrsize b/s390x/boot/initrd.addrsize new file mode 100644 index 0000000..3e2df12 --- /dev/null +++ b/s390x/boot/initrd.addrsize @@ -0,0 +1 @@ +0x02000000 0x10000000 \ No newline at end of file