oxmc
f6176009b1
Stages TWRP's GUI engine and standalone tooling as PawletOS-owned modules instead of a bootable/recovery fork, per the plugin-architecture finding in NOTES-ota-recovery-ab.md: stock recovery_main.cpp already dlopen()s librecovery_ui_ext.so and dlsym()s make_device() from it at runtime, so the UI layer doesn't require touching stock bootable/recovery at all. Confirmed via source grep that recovery.cpp/install.cpp have zero references into the partition manager/backup engine/GUI code and vice versa. recovery_ui/: TWRP's gui/, minuitwrp/, libpixelflinger/ (copied verbatim, GPL-3.0), plus a new device/ providing PawletTwrpUI (a ScreenRecoveryUI subclass) and make_device() — written from scratch against stock's RecoveryUI/ScreenRecoveryUI virtual-method contract, since TWRP's own fork never ships a make_device() (every real TWRP device provides its own, and no reference device tree was available to copy from). Top-level Android.bp defines librecovery_ui_pawlet_twrp, the module TARGET_RECOVERY_UI_LIB should point at. gui/Android.bp and minuitwrp/Android.bp had their include_dirs rewritten for the new paths. recovery_toolkit/: partition manager, backup engine (tar/digest/adbbu/apex), filesystem/format support (exfat/dosfstools/gpt/fuse/mtp/crypto), scripting (openrecoveryscript/orscmd/twrpinstall), shared helpers. Source only, no Android.bp yet for any of it. Known gap blocking recovery_ui from actually linking: gui/'s libguitwrp depends on libaosprecovery, built from recovery_toolkit/helpers/twrp.cpp via a Go Soong plugin (libaosprecovery_defaults.go) not yet ported. Neither repo has been build-tested — no local AOSP build environment available in this workspace. See each directory's README.md for a precise done/not-done breakdown.
80 lines
3.1 KiB
Plaintext
80 lines
3.1 KiB
Plaintext
.\" Copyright 2001 Andreas Dilger (adilger@turbolinux.com)
|
|
.\"
|
|
.\" This man page was created for libblkid.so.1.0 from e2fsprogs-1.24.
|
|
.\"
|
|
.\" This file may be copied under the terms of the GNU Lesser General Public
|
|
.\" License.
|
|
.\"
|
|
.\" Created Wed Sep 14 12:02:12 2001, Andreas Dilger
|
|
.TH LIBBLKID 3 "May 2009" "util-linux" "Programmer's Manual"
|
|
.SH NAME
|
|
libblkid \- block device identification library
|
|
.SH SYNOPSIS
|
|
.B #include <blkid.h>
|
|
.sp
|
|
.B cc
|
|
.I file.c
|
|
.B \-lblkid
|
|
.SH DESCRIPTION
|
|
The
|
|
.B libblkid
|
|
library is used to identify block devices (disks) as to their content (e.g.
|
|
filesystem type) as well as extracting additional information such as
|
|
filesystem labels/volume names, unique identifiers/serial numbers.
|
|
A common use is to allow use of LABEL= and UUID= tags instead of hard-coding
|
|
specific block device names into configuration files.
|
|
.P
|
|
The low-level part of the library also allows to extract information about
|
|
partitions and block device topology.
|
|
.P
|
|
The high-level part of the library keeps information about block devices in a
|
|
cache file and is verified to still be valid before being returned to the user
|
|
(if the user has read permission on the raw block device, otherwise not).
|
|
The cache file also allows unprivileged users (normally anyone other
|
|
than root, or those not in the "disk" group) to locate devices by label/id.
|
|
The standard location of the cache file can be overridden by the
|
|
environment variable BLKID_FILE.
|
|
.P
|
|
In situations where one is getting information about a single known device, it
|
|
does not impact performance whether the cache is used or not (unless you are
|
|
not able to read the block device directly).
|
|
.P
|
|
The high-level part of the library supports two methods to evaluate LABEL/UUID.
|
|
It reads information directly from a block device or read information from
|
|
/dev/disk/by-* udev symlinks. The udev is preferred method by default.
|
|
.P
|
|
If you are dealing with
|
|
multiple devices, use of the cache is highly recommended (even if empty) as
|
|
devices will be scanned at most one time and the on-disk cache will be
|
|
updated if possible.
|
|
.P
|
|
In some cases (modular kernels), block devices are not even visible until
|
|
after they are accessed the first time, so it is critical that there is
|
|
some way to locate these devices without enumerating only visible devices,
|
|
so the use of the cache file is
|
|
.B required
|
|
in this situation.
|
|
.SH CONFIGURATION FILE
|
|
The standard location of the
|
|
.I /etc/blkid.conf
|
|
config file can be overridden by the environment variable BLKID_CONF. For more
|
|
details about the config file see
|
|
.BR blkid (8)
|
|
man page.
|
|
.SH AUTHOR
|
|
.B libblkid
|
|
was written by Andreas Dilger for the ext2 filesystem utilties, with input
|
|
from Ted Ts'o. The library was subsequently heavily modified by Ted Ts'o.
|
|
|
|
The low-level probing code was rewritten by Karel Zak.
|
|
.SH COPYING
|
|
.B libblkid
|
|
is available under the terms of the GNU Library General Public License (LGPL),
|
|
version 2 (or at your discretion any later version).
|
|
.SH "SEE ALSO"
|
|
.BR blkid (8),
|
|
.BR findfs (8)
|
|
.SH AVAILABILITY
|
|
libblkid is part of the util-linux package since version 2.15 and is available from
|
|
ftp://ftp.kernel.org/pub/linux/utils/util-linux/.
|