A port of the Qualcomm Android bootctrl HAL for musl/glibc userspace.

Eric Curtin 843aa92266 Change hdr_offset to signed value, so lseek64 return can be checked The lines: if (instance == PRIMARY_GPT) hdr_offset = block_size; else { hdr_offset = lseek64(fd, 0, SEEK_END) - block_size; } if (hdr_offset < 0) { fprintf(stderr, "%s: Failed to get gpt header offset\n", __func__); goto error; } are error checked. But previously hdr_offset could never be less than zero because it was unsigned.		2 years ago
.clang-format	cleanup, stub out tests	3 years ago
.gitignore	gitignore: compile_commands.json	2 years ago
LICENSE	cleanup, stub out tests	3 years ago
README.md	minor cleanups, improve error handling	3 years ago
bootctrl.h	cleanup, stub out tests	3 years ago
bootctrl_impl.cpp	Fix to << uint32_t has not been declared >>	2 years ago
bootctrl_test.cpp	cleanup, stub out tests	3 years ago
gpt-utils.cpp	Change hdr_offset to signed value, so lseek64 return can be checked	2 years ago
gpt-utils.h	add missing linux/limits.h	2 years ago
meson.build	cleanup, stub out tests	3 years ago
qbootctl.cpp	Fix to << uint32_t has not been declared >>	2 years ago
ufs-bsg.cpp	minor cleanups, improve error handling	3 years ago
ufs-bsg.h	minor cleanups, improve error handling	3 years ago
utils.h	its ALIIIIIIVE	3 years ago

README.md

Qualcomm bootctl HAL for Linux

This HAL was pulled from AOSP source code and bastardised to build and run on a musl/glibc system. This may or may not render any hardware you run it on unusable, you have been warned.

Dependencies

zlib-dev
meson
cmake
linux-headers

Building

qbootctl uses the meson build system

meson build
meson compile -C build

Usage

qbootctl: qcom bootctrl HAL port for Linux
-------------------------------------------
qbootctl [-c|-m|-s|-u|-b|-n|-x] [SLOT]

    <no args>        dump slot info (default)
    -h               this help text
    -c               get the current slot
    -b SLOT          check if SLOT is marked as bootable
    -n SLOT          check if SLOT is marked as successful
    -x [SLOT]        get the slot suffix for SLOT (default: current)
    -s SLOT          set to active slot to SLOT
    -m [SLOT]        mark a boot as successful (default: current)
    -u [SLOT]        mark SLOT as unbootable (default: current)

Debugging

Set DEBUG to 1 in utils.h to enable debug logging.

Documentation

A more details explanation and a list of devices where qbootctl has been validated can be found on the postmarketOS wiki: