partup - System Initialization Program

Dependencies

The following tools and libraries must be installed on the target system for partup to run:

• GLib (minimum version 2.66.0)
• libyaml
• libparted
• util-linux
• udev
• squashfs-tools
• dosfstools
• e2fsprogs

For building partup from source and generating its documentation the following additional dependencies are needed:

• Meson Build
• Sphinx

Building

Build partup using the Meson Build system:

meson setup build
meson compile -C build

Running

partup works in two steps:

1. Create a partup package by specifying a package name, the layout configuration file and all files that should be written to the target:

   partup package mypackage.partup u-boot.bin zImage rootfs.tar.gz layout.yaml

2. Install the package to the target:

   partup install mypackage.partup /dev/mmcblk0

Documentation

Install the dependencies needed for building the documentation:

virtualenv -v env
source env/bin/activate
pip install -r doc/requirements.txt

Configure the build directory for building the documentation:

meson setup --reconfigure build -Ddoc=true

Build the documentation:

meson compile -C build doc

Installation

From Source

Install partup on the current system. If enabled, the documentation will be installed as well:

meson install -C build

Ubuntu and Debian

For Debian-based systems (and most other Linux Distributions), it is easiest to install partup by downloading the latest statically built binary from the release page: https://github.com/phytec/partup/releases

Install the downloaded binary to a directory contained in $PATH, e.g. /usr/local/bin:

install -m 755 ~/Downloads/partup-v0.0.0-amd64 /usr/local/bin/

Make sure to specify the correct path you downloaded partup to, as the above is just an example.

Arch Linux

partup is available in the AUR (Arch Linux User Repository): https://aur.archlinux.org/packages/partup

Yocto

A Yocto recipe is available in meta-phytec.

License

partup is licensed under the GNU General Public License version 3. See LICENSE for more information.

partup - System Initialization Program

Copyright (C) 2023 PHYTEC Messtechnik GmbH

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see <https://www.gnu.org/licenses/>.