universalisos/docs/parity/RPM_PARITY_SPEC.md

UniversalisOS RPM Packaging Environment — Feature-Parity Specification

Document: docs/parity/RPM_PARITY_SPEC.md Status: Analysis of mirrored PikeOS 5.0 packaging environment; design for the uos-pkg reimplementation. Sources analyzed:

• ~/portugalfuturista/universalisos/pikeos-mirror/rpm/ (mirror of src/rpm/)
• ~/portugalfuturista/universalisos/pikeos-mirror/config/rpm/
• Live execution of binaries in ~/portugalfuturista/universalisos/src/rpm/bin/ with LD_LIBRARY_PATH=src/rpm/lib64

Naming note: the original vendor tree uses a two-character product abbreviation that is banned in UniversalisOS documentation and code. This spec uses "PikeOS" (the product) and the uos_ prefix (the replica) exclusively. Where the original macro names contain the product name (e.g. %_pikeos_prefix), they are quoted verbatim because they are interface facts that uos-pkg must reproduce.

---

1. Tool Inventory (exact versions)

1.1 Binary tools — src/rpm/bin/

All ELF binaries are x86-64, dynamically linked, stripped, built for GNU/Linux 2.6.26, linking against the bundled lib64/ shared objects (librpm-4.2.so, librpmbuild-4.2.so, librpmdb-4.2.so, libpopt.so.0, libbeecrypt.so.2). Verified by execution (./rpm --version → RPM version 4.2).

Tool	Type	Version / facts	Evidence
rpm	ELF 78 432 B	RPM 4.2 (Red Hat rpm-4.2 codebase, CVS macros.in,v 1.138 2003/03/05, rpmrc.in,v 2.54 2003/01/10). Modes: query (-q), verify (-V), install/upgrade/erase (-i/-U/-e), signature (-K/--addsign/--resign/--import), database (--initdb/--rebuilddb). 133 query tags (--querytags). Localized (pt, de, es, … locale catalogs in share/locale/).	bin/rpm; --version; --help; --querytags
rpmbuild	symlink → lib/rpm/rpmb (ELF 80 904 B)	RPM 4.2 build front-end. Stages -bp -bc -bi -bl -ba -bb -bs, tarball variants -t*, --rebuild/--recompile, --target=CPU-VENDOR-OS, --buildroot, --clean, --rmsource, --rmspec, --short-circuit, --nodirtokens.	bin/rpmbuild; --help
rpmquery	symlink → lib/rpm/rpmq (71 168 B)	Query-only mode binary (same 4.2 CLI).	bin/rpmquery
rpmi / rpmu / rpme	lib/rpm/rpmi (73 376 B); rpmu→rpmi, rpme→rpmi	Install / upgrade / erase mode binaries.	lib/rpm/
rpmsign	symlink → lib/rpm/rpmk (71 584 B)	Signature mode binary.	bin/rpmsign
rpmverify	symlink → lib/rpm/rpmv → rpmq	Verify mode.	bin/rpmverify
rpmdb	symlink → lib/rpm/rpmd (70 272 B)	Database maintenance mode.	bin/rpmdb
rpm2cpio	ELF 87 872 B	RPM 4.2 payload extractor; supports gzip and bzip2 payloads (bzip2 decompressor statically embedded, jseward bzip2 strings present). Usage: rpm2cpio file.rpm > out.cpio.	bin/rpm2cpio, strings
rpmgraph	ELF 70 496 B	RPM 4.2 dependency-graph tool; emits graphviz digraph of Requires/Provides from rpmdb or package files (digraph XXX { string, rpmgraph.c). Option --nolegacy.	bin/rpmgraph, strings, --help
gendiff	POSIX sh script, 386 B	gendiff <directory> <diff-extension> — finds *<ext> / .*<ext> files and emits unified diffs against the original (-U0 for ChangeLog<ext>). Used to generate PatchN: files.	bin/gendiff

1.2 Bundled libraries — src/rpm/lib64/

Library	Version	Role
librpm-4.2.so	rpm 4.2 core	header/payload/signature/transaction engine; embeds zlib 1.1.4 inflate/deflate (Adler/Gailly 1995–2002 copyright strings) and reports zlib 1.2.7 via zlibVersion linkage; compiled-in defaults: prefix /opt/pikeos-D5.0/rpm, rpmdb /opt/pikeos-D5.0/rpm/var/lib/rpm, magic file lib/rpm/magic
librpmbuild-4.2.so	rpm 4.2	spec parsing, build scriptlets, packaging
librpmdb-4.2.so	rpm 4.2	rpmdb access; Berkeley DB 4.1.24 (Sleepycat, 2002-09-13) embedded (db_version_rpmdb)
libpopt.so.0.0.0	popt (rpm 4.2 era)	CLI parsing, alias/exec tables (rpmpopt-4.2)
libbeecrypt.so.2.2.0	BeeCrypt 2.2.0	DSA/RSA signature verification, entropy

1.3 Auxiliary executables — src/rpm/lib/rpm/

Tool	Kind	Purpose
debugedit	ELF 57 816 B	rewrites DWARF debug paths (-b builddir -d /usr/src/debug) for debuginfo packages
rpmdeps	ELF 66 816 B	internal dependency generator (--provides/--requires)
rpmcache	ELF 73 928 B	dependency-universe cache builder (rpmcache(8))
rpmfile	ELF 73 200 B	file-classification helper (libmagic-based)
rpmdb_dump, rpmdb_load, rpmdb_loadcvt, rpmdb_stat, rpmdb_svc, rpmdb_verify, rpmdb_deadlock	ELF	Berkeley DB 4.1.24 utilities for the rpmdb
rpmdiff, rpmdiff.cgi	script + CGI	package-to-package diff reporting
brp-compress, brp-strip, brp-strip-static-archive, brp-strip-comment-note, brp-strip-shared, brp-sparc64-linux, brp-redhat	sh	Build-Root Policy scripts run at end of %install (compress man pages, strip ELF)
check-files	sh	fails build on unpackaged files in $RPM_BUILD_ROOT (see %__check_files)
check-prereqs	sh	verifies build prerequisites
config.guess, config.sub, config.site	autotools	platform detection / site defaults for %configure
cpanflute, cpanflute2	perl	CPAN module → spec file generator
find-provides, find-requires (+.perl stubs), find-prov.pl, find-req.pl, get_magic.pl, perl.prov, perl.req, perldeps.pl, sql.prov, sql.req, tcl.req	sh/perl	automatic dependency extraction (ELF SONAMEs via file/ldd, shebang interpreters, perl modules, tcl, java)
find-debuginfo.sh	sh	creates /usr/lib/debug shadow tree + debugfiles.list (invokes debugedit, eu-strip)
find-lang.sh	sh	generates %lang() file lists from share/locale/**/<name>.mo
getpo.sh	sh	extracts translatable Summary/Group/Description into .po format via rpm -qp --qf
rpm2cpio.sh	sh	pure-sh rpm→cpio: parses lead (96 B) + signature header + header with od, then `dd …
Specfile.pm	perl module	RPM::Specfile v1.02 — programmatic spec generation (accessors for name/version/release/…, generate_specfile)
convertrpmrc.sh	sh	migrates legacy /etc/rpmrc key:value entries to %_macro form (translation table at lines 38–72)
u_pkg.sh	sh	"universal package manager" abstraction: maps list_all_packages, query_file, … to rpm -qa/-qf/… on Linux, pkginfo/pkgchk on SunOS
vpkg-provides.sh, vpkg-provides2.sh	sh	build "virtual packages" that Provides: host OS libraries/interpreters (SunOS/HP-UX/AIX/IRIX/OSF1 shlib dirs)
trpm, tgpg, rpm.daily, rpm.log, rpm.xinetd, cross-build	misc	test/ops helpers; cross-build shows the cross-compile make invocation pattern

1.4 Configuration files shipped with the tools

File	Lines	Role
lib/rpm/macros	1100	master macro definitions (§3)
lib/rpm/rpmrc	358	arch/os canon tables, optflags per arch, macrofiles: load list (line 355)
lib/rpm/rpmpopt-4.2	472	popt aliases: --scripts, --setperms, --setugids, --conflicts, --obsoletes, --provides, --requires/-R, --info, --changelog, --xml, …
lib/rpm/x86_64-linux/macros	66	per-platform overrides (§3.5)
lib/rpm/noarch-linux/macros	~60	same for noarch builds
var/lib/rpm/*	—	rpmdb skeleton: Berkeley DB files Packages, Name, Basenames, Group, Requirename, Providename, Conflictname?, Triggername, Dirnames, Requireversion, Provideversion, Installtid, Sigmd5, Sha1header, Filemd5s + __db.001–003 environment. Packages is 0 bytes (empty template); secondary indexes retain ~1906 historical package-name keys (used in §2.3)

---

2. The PikeOS Package Model

2.1 What a .spec + macros produce

A PikeOS package is a standard RPM 4.2 binary package (name-version-release.arch.rpm, name template %_build_name_fmt = %{ARCH}/%{NAME}-%{VERSION}-%{RELEASE}.%{ARCH}.rpm, macros:575) whose build is driven by the PikeOS macro layer in config/rpm/. The flow:

1. rpmbuild -bb/--rebuild loads the macro stack (§3.6): master macros → host file → target file → common → platform macros → user files.
2. %prep unpacks SourceN: into %_builddir (%{_topdir}/BUILD, topdir = %{_usrsrc}/sysgo = /opt/pikeos-D5.0/rpm/src/sysgo).
3. %build typically invokes PikeOS-aware macros from config/rpm/common: %pikeos_build_package (init devel project → make var-value && make all && make install) or %pikeos_build_recipe (pikeos-build-recipe <name>.recipe), with PIKEOS_BUILD_ID="%{_pikeos_build_id}" exported (common:119–129).
4. %install populates $RPM_BUILD_ROOT; install-post hooks run brp-compress/brp-strip/… (platform macros) plus the SYSGO hooks __sysgo_track_compile_post and __sysgo_check_files (common:194–197).
5. Packaging: %files list → cpio payload (gzip w9.gzdio default, bzip2 optional) → header with Requires/Provides (internal generator, %_use_internal_dependency_generator 1, macros:326) → written to %_rpmdir = %{_topdir}/RPMS.
6. Install: rpmi/rpm -i into the rpmdb at %_dbpath = /opt/pikeos-D5.0/rpm/var/lib/rpm, files landing under /opt/pikeos-D5.0/… (prefix %_pikeos_prefix, common:1).

Vendor metadata stamped into every header (config/rpm/common:1–15): Vendor: SYSGO AG, Distribution: PikeOS D5.0, Packager: <support@pikeos.com>, URL http://www.pikeos.com/, product version D5.0, build id %{_pikeos_version}-%{_pikeos_mod_release} (mod_release injected by the build system, common:17–19).

2.2 Package naming scheme (from config/rpm/targets/* + common)

Name grammar (assembled by spec authors from these macros):

%{_pikeos_rpm_prefix} <component> [-<qualifier>…] [-%{_pikeos_target_arch}]   (target packages)
%{_pikeos_rpm_prefix} <component> [-%{_pikeos_rpm_host}<host-ish>]            (host packages)

• %_pikeos_rpm_prefix = pikeos- (common:7). Every product package starts with it.
• Target suffix %_pikeos_target_arch = %{_pikeos_target_cpu}_%{_pikeos_target_proc} (e.g. arm_v7hf, ppc_e500mc-4g; the -diab toolchain variants append -diab, targets/ppc_e500mc-diab-linux:3).
• Tool prefix %_pikeos_tool_prefix = <arch>- used for cross-tool binaries (targets/*:4).
• Host infix %_pikeos_rpm_host: %nil (empty) on Linux hosts, cygwin- / win32- on Windows hosts (hosts/*:3).
• Derived component renames (common:71–72): pikeos-psp-<board>-<arch> → sources package pikeos-sources-psp-<board>-<arch> and config package pikeos-config-psp-<board>-<arch> (sed rewrites).

2.3 Observed package taxonomy (rpmdb Name index, 1906 unique names)

Recovered from src/rpm/var/lib/rpm/Name (secondary index keys). Representative families — the replica must accept/install all of these shapes:

Family	Example	Meaning
pikeos-kernel[-cert]-<arch>	pikeos-kernel-cert-ppc_e5500	kernel binaries (cert = certification variant)
pikeos-fusion-kernel-<board>-<arch>	pikeos-fusion-kernel-<qoriq-board>-e6500-l2-ppc_e500mc	board-fused kernel images
pikeos-bin-fusion-pssw-{standard,cert}-<arch>	—	prebuilt PSSW fusion binaries
pikeos-psp-<board>-<arch>	pikeos-psp-<qoriq-board>-e6500-ppc_e500mc	Platform Support Package
pikeos-sources-psp-<board>-<arch> / pikeos-config-psp-<board>-<arch>	pikeos-config-psp-imx6-arm_v7hf	PSP source/config split (renames per common:71–72)
pikeos-bsp-…	29 names	board support packages
pikeos-ddk-<drv>[-headers][-kdev][-cmp]-<arch>	pikeos-ddk-can-headers-ppc_e500mc, pikeos-pci_manager-kdev-x86_amd64	Driver Development Kit modules; -kdev = kernel-device framework variant, -cmp = companion
pikeos-posix[-smp]-pse51[-debug-instr]-<arch>	pikeos-posix-pse51-arm_v8hf	POSIX PSE51 personality
pikeos-personality-{native,integration}-<arch>	—	personality runtimes
pikeos-apex-… / pikeos-demo-…	pikeos-demo-apex-hello-smp	ARINC-653 + demo projects (129 demo names)
pikeos-gcc-<arch>, pikeos-binutils-…, pikeos-gdb-client-<arch>	pikeos-gcc-ppc_e500mc-4g	cross toolchains (host packages, target in name)
pikeos-lib{vp,spider,drv,imon,nfsrpc,util,gcc_cert,psp,ivm,gdbstub,fdt,debug,vm,acpica}-…	pikeos-libgcc_cert-ppc_e500	libraries
pikeos-{hlnet,hlser,hldio,hlclk,hlcan,hlblk}-<arch>	—	high-level I/O stacks
pikeos-{scov,coverage,profile,profileopt,mon,traceserver,sectick}-…	202 scov names	coverage/profiling/monitoring
pikeos-{cenv,cppenv,tfw,errno,errcnt,anisfp,kextfp,enteremul}-…	—	C/C++ environments, test framework
pikeos-{virtio,veth,qport,muxa,sport,pci,dpaa}-…	—	virtual/para-virtual devices
pikeos-{boot,bootimage,cdk,target,devel,doc,releasenotes,licensing}-…	pikeos-boot-grub-noarch	boot loaders, CDK, docs; -noarch suffix appears explicitly on some
pikeos-{8250,e1000,pl011,lpuart,scif,xuartps,xemacps,tsec,cpsw,ravb,smc911x,smmu}-…	—	device drivers
pikeos-buildenv-babs, pikeos-babs-buildlogs, pikeos-rpmconfig, pikeos-scripts	—	build-system integration (BaBS)
host-provides, sbe-proxy-<pkg>	—	proxy packages (§2.4)

Target-suffix distribution in the index: arm_v7hf 276, arm_v8hf 243, ppc_e500mc-4g 232, ppc_e500mc 228, ppc_e5500 222, ppc_e500 216, x86_amd64 211, plus unsuffixed host/noarch packages.

2.4 Proxy packages (host-provides / buildenv-provides)

Two special package types let the rpmdb satisfy dependencies on material that is not rpm-managed:

1. host-provides (rpm/host-provides/host-provides.spec, 39 lines): Name: host-provides, Version: 0.0, Release: 1, BuildArchitectures: noarch, AutoReqProv: no, empty %files. The line # PROVIDES GO HERE -- DON'T CHANGE! (line 18) marks where find-host-provides.sh output is injected. That script (find-host-provides.sh, 113 lines):
   • emits Provides: /bin/sh, /usr/bin/env, and interpreters bash/perl/csh found via which (lines 83–100);
   • scans /lib /usr/lib (or /compat/linux/... on BSD) for lib*.so.[0-9] and ld-linux*.so.[0-9], and for each library emits Provides: <SONAME>, Provides: <libname>(<VERDEF>) for every version definition, suffixed (64bit) for ELF64 (lines 44–73, 103–112);
   • Cygwin hosts skip library scanning.
2. sbe-proxy-<PKGNAME> (rpm/buildenv-provides/buildenv-provides.spec.in, 39 lines): template with ##PKGNAME## placeholder (lines 1, 21); one proxy package per SYSGO Build Environment (/opt/sbe-D3.1, %_sysgo_buildenv_prefix, common:9) component, same noarch/AutoReqProv-no shape.

uos-pkg must generate and install both proxy types so that Requires: libc.so.6(GLIBC_2.17)(64bit)-style dependencies resolve against the host.

---

3. Macro Reference — lib/rpm/macros and config/rpm/*

241 distinct macro names in the master file (265 definition lines). Grouped below with file:line citations (macros = src/rpm/lib/rpm/macros, common = pikeos-mirror/config/rpm/common).

3.1 Path macros

Macro	Value	Cite
%nil	empty (%{!?nil})	macros:24
%_usr	/opt/pikeos-D5.0/rpm	macros:29
%_usrsrc	%{_usr}/src	macros:30
%_var	/opt/pikeos-D5.0/rpm/var	macros:31
%_topdir	%{_usrsrc}/sysgo	macros:170
%_builddir / %_sourcedir / %_specdir / %_rpmdir / %_srcrpmdir	%{_topdir}/{BUILD,SOURCES,SPECS,RPMS,SRPMS}	macros:95,157,161,146,164
%_tmppath	/tmp	macros:167
%_dbpath / %_dbpath_rebuild	%{_var}/lib/rpm	macros:104,107
%_defaultdocdir	%{_usr}/doc	macros:133
%_rpmfilename / %_build_name_fmt	%{ARCH}/%{NAME}-%{VERSION}-%{RELEASE}.%{ARCH}.rpm	macros:150,575
%_repackage_dir / %_repackage_name_fmt / %_repackage_root / %_repackage_all_erasures	/var/spool/repackage, %{NAME}-%{VERSION}-%{RELEASE}.%{ARCH}.rpm, empty, 0	macros:604–614
%_prefix %_exec_prefix %_bindir %_sbindir %_libexecdir %_datadir %_sysconfdir %_sharedstatedir %_localstatedir %_lib %_libdir %_includedir %_oldincludedir %_infodir %_mandir	autoconf-style tree under /opt/pikeos-D5.0/rpm (_lib=lib)	macros:902–916
%_javadir / %_javadocdir	%{_datadir}/java, %{_datadir}/javadoc	macros:245–246
%_install_script_path	/sbin:/bin:/usr/sbin:/usr/bin:/usr/X11R6/bin	macros:231
%_cache_dbpath, %_bhpath, %_bhcoll, %_bhN, %_bhVR (=SYSGO), %_bhA	rpmcache universe config	macros:703–710
Tool paths %__awk … %__xz (30 entries)	gawk bzip2 cat chgrp chmod chown cp cpio file gpg grep gzip id install ln-s make mkdir mkdir-p mv patch perl pgp python rm rsh sed ssh tar unzip xz	macros:36–65
Build tools %__ar %__as %__cxx %__ld %__nm %__objcopy %__objdump %__ranlib %__remsh %__strip + autotools set	ar as g++ /usr/bin/ld /usr/bin/nm /usr/bin/objcopy /usr/bin/objdump ranlib %{__rsh} /usr/bin/strip, libtoolize aclocal autoheader automake autoconf	macros:70–86

3.2 Build macros

Macro	Meaning	Cite
%_buildshell	/bin/bash — scriptlet interpreter	macros:98
%___build_shell/_args/_cmd/_pre/_post/_template	scriptlet template machinery; _pre exports RPM_SOURCE_DIR RPM_BUILD_DIR RPM_OPT_FLAGS RPM_ARCH RPM_OS RPM_DOC_DIR RPM_PACKAGE_NAME/VERSION/RELEASE RPM_BUILD_ROOT, umask 022, cd %{u2p:%{_builddir}}	macros:738–773
%__spec_{prep,build,install,check,clean,rmbuild}_{shell,args,cmd,pre,body,post,template}	per-stage instantiations of the template	macros:780–880
%optflags	-O2 (generic); per-arch table in rpmrc:14–62 (e.g. x86_64 -O2 -g); platform file sets -O2 -g	macros:726; rpmrc:20; x86_64-linux/macros:11
%configure	PLD-style: exports CFLAGS/CXXFLAGS/FFLAGS, runs ./configure --host=%{_host} --build=%{_build} --target=%{_target_platform} --program-prefix=… --prefix=… + 12 dir flags	macros:958–977
%GNUconfigure(MCs:)	regenerates autotools (libtoolize/gettextize/aclocal/autoheader/automake/autoconf) then configures; opts -C dir, -M mkdir, -s LDFLAGS	macros:1008–1052
%makeinstall	make prefix=%{buildroot}%{_prefix} … install with all 13 dir overrides	macros:981–996
%_smp_mflags	-j$(getconf _NPROCESSORS_ONLN) when >1 CPU	x86_64-linux/macros:35–37
%_package_version	30005 — rpm-3.0.5-compatible headers	macros:303
%__check_files / %_unpackaged_files_terminate_build / %_missing_doc_files_terminate_build	check-files %{buildroot}; both terminate flags = 1 (strict)	macros:310,316,322
%_use_internal_dependency_generator	1 (internal); external fallbacks %__find_provides/%__find_requires = find-provides/find-requires; perl helpers perl.prov/perl.req	macros:326,334–335,346–347
%debug_package / %__debug_install_post	auto -debug subpackage template + find-debuginfo.sh invocation	macros:112–131
%find_lang	find-lang.sh %{buildroot}	macros:1097
%requires_eq(), %perl_sitearch, %perl_archlib	perl helper macros	macros:1076–1078
%ix86	i386 i486 i586 i686 athlon arch alias list	macros:1086
%debian_patch	applies debian/patches via quilt/00list/glob (SYSGO addition)	common:21–36
%sysgo_modulepatch(cvs-path) / %sysgo_install_modulepatch(cvs-path file)	applies/installs per-module patches from %{_sysgo_modulepatch_dir} = %{_pikeos_prefix}/build/module-patches, with cpu/proc-specific subdirs	common:75–94
%pikeos_clone_project(demo dst) / %_pikeos_init_devel_project / %pikeos_prepare_package / %pikeos_prepare_demo / %pikeos_build_package / %pikeos_build_recipe / %pikeos_install_demo(dir) / %pikeos_bsp_prepare_basic_fusion(board) / %pikeos_bsp_prepare_cert_fusion(name)	PikeOS project build orchestration (projectconfigurator/cloneproject/build-recipe/make wrappers)	common:96–144
%pikeos_psp_src_name() / %pikeos_psp_config_name()	PSP package rename functions	common:71–72
%__sysgo_track_compile_pre/post, %_fixowner hook, %__sysgo_check_files, %__spec_install_post (override)	compile-time file tracking (BaBS BABS_TRACK_COMPILE), post-install checker hook	common:146–197

3.3 Install / transaction / database macros

Macro	Meaning	Cite
%_signature	none (default signing off)	macros:153
%__gpg_check_password_cmd, %__pgp_check_password_cmd, %__pgp5_check_password_cmd, %__gpg_sign_cmd, %__pgp_sign_cmd, %__pgp5_sign_cmd	external signer command templates (verify done internally via beecrypt)	macros:526–541
%_transaction_color	3 (Elf32+Elf64 permitted)	macros:582
%_vsflags_{build,erase,install,query,rebuilddb,up2date,verify}	all 0 — digest/signature verify flags per mode	macros:626–633
%_query_all_fmt	%{name}-%{version}-%{release} for rpm -qa	macros:693
%_install_langs	all	macros:236
%_query_selector_match	default (glob-like)	macros:267
%_dependency_whiteout[_7_0,_7_1,_7_2]	legacy dependency-loop breakers (p>q pairs)	macros:650–687
%_dbapi / %_dbapi_rebuild	3 / 3 — Berkeley DB backend	macros:516–517
%__dbi_cdb	create cdb mpool mp_mmapsize=16Mb mp_size=1Mb	macros:454
%__dbi_other / %__dbi_rebuild / %__dbi_transient / %__dbi_perms	tmpdir+cdb; nofsync !log !txn !cdb; +temporary private; perms=0644	macros:456–461
%__dbi_htconfig / %_dbi_htconfig[_current/_rebuild]	hash-db config composition	macros:465–477
%__dbi_btconfig / %_dbi_btconfig[_current/_rebuild]	btree-db config composition	macros:481–493
%_dbi_tags	Packages:Name:Basenames:Group:Requirename:Providename:Conflictname:Triggername:Dirnames:Requireversion:Provideversion:Installtid:Sigmd5:Sha1header:Filemd5s:Depends:Pubkeys	macros:496
%_dbi_config_Packages	%{_dbi_htconfig} lockdbfd nofsync	macros:499
%_dbi_config_Depends	%{_dbi_htconfig} temporary private nofsync	macros:502
%_dbi_config_{Dirnames,Requireversion,Provideversion,Installtid,Removetid}	%{_dbi_btconfig} nofsync	macros:504–508
%_dbi_config	%{_dbi_htconfig} nofsync (default)	macros:519

3.4 Target-configuration macros (config/rpm/)

common (product identity, cited §2.1): %_pikeos_prefix /opt/pikeos-D5.0, %vendor SYSGO AG, %_pikeos_version D5.0, %distribution PikeOS D5.0, %packager <support@pikeos.com>, %_pikeos_url, %_pikeos_rpm_prefix pikeos-, %_sysgo_buildenv_dirname lin64, %_sysgo_buildenv_prefix /opt/sbe-D3.1, %_sysgo_* aliases of the pikeos values, %_pikeos_build_id %{_pikeos_version}-%{_pikeos_mod_release}.

Per-target files (config/rpm/targets/<arch>-linux, 16 files) define: %_pikeos_target_cpu, %_pikeos_target_proc, %_pikeos_target_arch (=cpu_proc, + -diab on DIAB variants), %_pikeos_tool_prefix (arch + -), %_pikeos_target_name (human label), %_pikeos_cdk_dir = %{_pikeos_prefix}/cdk/<cpu>/<proc>, %_pikeos_arch_pool = %{_pikeos_prefix}/target/<cpu>/<proc>, %_pikeos_target_config (gcc triplet), optional %_pikeos_cpu_id, %_pikeos_cpu_arch, %_pikeos_cpu_endian, %_pikeos_has_fpu, %_pikeos_fpu_id, %_pikeos_cache_size, %_pikeos_has_altivec, %_pikeos_multilib_gcc, %_pikeos_wrdsz (32/64), %_pikeos_align (0x1000).

Per-host files (config/rpm/hosts/*, 6 files) define: %_pikeos_host_name, %_pikeos_host_arch, %_pikeos_rpm_host (<name>- or %nil on Linux), %_pikeos_host_config (host triplet), %_pikeos_host_prefix, %_pikeos_host_dirname, %_pikeos_host_dir = %{_pikeos_prefix}/<dirname>; win32/win64 add %_pikeos_cygwin_{config,prefix,dirname,dir}; every host file mirrors all values into %_sysgo_host_* aliases.

3.5 Platform macros (lib/rpm/<arch>-linux/macros)

x86_64-linux/macros (66 lines): %_arch x86_64, %_vendor unknown, %_os linux, %_gnu -gnu, %_target_platform %{_target_cpu}-%{_vendor}-%{_target_os}, %optflags -O2 -g, configure tree with %_sysconfdir /opt/pikeos-D5.0/config, %_localstatedir /opt/pikeos-D5.0/rpm/var, %_lib lib64, %_initrddir, %_smp_mflags, multilib (%_multilibno 2, %_multilibpatt …), and build-root policy: %__os_install_post = brp-compress brp-strip brp-strip-static-archive brp-strip-comment-note, wired into %__spec_install_post (lines 51–64). noarch-linux/macros is identical except %_arch noarch.

3.6 Macro load order (the effective stack)

From rpmrc:355 (macrofiles:), confirmed by --showrc:

1. /opt/pikeos-D5.0/rpm/lib/rpm/macros            (master, §3.1–3.3)
2. /opt/pikeos-D5.0/config/rpm/hosts/lin32        (host — NOTE: compiled-in default is lin32 even on x86_64; see §6)
3. /opt/pikeos-D5.0/config/rpm/targets/%{_target} (target, e.g. x86_64-linux)
4. /opt/pikeos-D5.0/config/rpm/common             (product identity + PikeOS build macros)
5. /opt/pikeos-D5.0/rpm/lib/rpm/%{_target}/macros (platform, §3.5)
6. config/rpm/macros.specspo : macros.prelink : macros.solve : macros.up2date : macros (optional, absent)
7. /opt/pikeos-D5.0/config/rpm/%{_target}/macros  (optional)
8. ~/.rpmmacros

Later definitions win. The compiled-in fallback in librpm-4.2.so is …/macros:…/hosts/lin32:…/targets/%{_target}:…/common:./.rpmmacros:~/.rpmmacros (note ./.rpmmacros instead of the platform file — a vendor customization).

3.7 Built-in macro functions observed

%(...) shell eval, %[...]? (not used), %{?cond:…}/%{!?cond:…} conditionals, %{-opt:…} option-argument forms (%GNUconfigure(MCs:)), and %{u2p:PATH} — a vendor-added "unix-to-path" builtin used throughout ___build_pre (macros:742–761) and common:41–69; verified live: %{u2p:/opt/foo/bar} → /opt/foo/bar (identity on Linux; on cygwin/mingw hosts it converts to the host path form). uos-pkg must implement u2p as a host-dependent path-conversion builtin.

3.8 rpmlib feature set (from --showrc)

rpmlib(pikeos-D5.0) (vendor virtual feature, "PikeOS virtual package"), VersionedDependencies 3.0.3-1, CompressedFileNames 3.0.4-1, PayloadIsBzip2 3.0.5-1, PayloadFilesHavePrefix 4.0-1, ExplicitPackageProvide 4.0-1, HeaderLoadSortsTags 4.0.1-1, ScriptletInterpreterArgs 4.0.3-1, PartialHardlinkSets 4.0.4-1, ConcurrentAccess 4.1-1.

---

4. Host/Target Matrix (config/rpm/)

4.1 Targets — 16 definition files covering 8 architecture families

File	cpu_proc (arch)	gcc target_config	endian	word	FPU / notes
arm_v7hf-linux	arm_v7hf	arm-unknown-eabihf	little	32	fpu yes, vfpv3-d16, cpu_arch armv7-a
arm_v8hf-linux	arm_v8hf	aarch64-unknown-elf	little	64	fpu yes, cpu_arch armv8-a
riscv_rv64-linux	riscv_rv64	riscv64-unknown-elf	little	64	fpu yes, cpu_arch rv64g
x86_amd64-linux	x86_amd64	x86_64-unknown-elf	little	64	fpu yes
x86_i686-linux	x86_i686	i686-unknown-elf	little	32	fpu yes, cpu_id i686
ppc_oea-linux	ppc_oea	powerpc-unknown-elf	big	32	cpu_id 603, cache 8, multilib
ppc_e500-linux	ppc_e500	powerpc-unknown-elfspe	big	32	cpu_id 8540, cache 32
ppc_e500mc-linux	ppc_e500mc	powerpc-unknown-elf	big	32	cpu_id e500mc, multilib
ppc_e500mc-4g-linux	ppc_e500mc-4g	powerpc-unknown-elf	big	32	4G:4G memory split, multilib
ppc_e500mc-diab-linux	ppc_e500mc-diab	powerpc-unknown-elf	big	32	DIAB toolchain variant
ppc_e500mc-4g-diab-linux	ppc_e500mc-4g-diab	powerpc-unknown-elf	big	32	4G:4G + DIAB
ppc_e5500-linux	ppc_e5500	powerpc64-unknown-elf	big	64	cpu_id e5500, multilib
ppc_e6500-linux	ppc_e6500	powerpc64-unknown-elf	big	64	cpu_id e6500, multilib
mips_isa32be-linux	mips_isa32be	mipsisa32r2-unkown-elf (sic)	big	32	fpu yes
mips_isa32le-linux	mips_isa32le	mipsisa32r2el-unkown-elf (sic)	little	32	fpu yes
sparc_v8-linux	sparc_v8	sparc-unknown-elf	big	32	fpu yes

All targets: %_pikeos_align 0x1000; cdk dir <prefix>/cdk/<cpu>/<proc>; arch pool <prefix>/target/<cpu>/<proc>; tool prefix <arch>-.

UniversalisOS relevance: the replica kernel targets armv7 (→ arm_v7hf), aarch64 (→ arm_v8hf), riscv (→ riscv_rv64) — all present in the matrix, so uos-pkg inherits target definitions 1:1.

4.2 Hosts — 6 definition files

File	host_name	arch	host_config (triplet)	rpm_host infix	dirname	extra
lin32	linux	i386	i686-pc-linux-gnu	%nil (empty)	lin64 (sic — 32-bit tools run from lin64 tree)	—
lin64	linux	x86_64	x86_64-pc-linux-gnu	%nil	lin64	—
cygwin	cygwin	i386	i686-pc-cygwin	cygwin-	cygwin	—
cygwin64	cygwin	x86_64	x86_64-pc-cygwin	cygwin-	cygwin64	—
win32	win32	i386	i686-w64-mingw32	win32-	mingw	cygwin companion: i686-pc-cygwin, dir cygwin
win64	win32	x86_64	x86_64-w64-mingw32	win32-	mingw64	cygwin companion: x86_64-pc-cygwin, dir cygwin64

Host dir = %{_pikeos_prefix}/<dirname>; every value mirrored into %_sysgo_host_*.

---

5. uos-pkg — From-Scratch Reimplementation Design

Goal: a clean-room packaging toolchain for the UniversalisOS build environment that is functionally identical to the PikeOS RPM 4.2 stack: same CLI surface, same on-disk package format (so existing .rpm artifacts install), same macro semantics (so existing .spec files and config/rpm/* files work unmodified), same rpmdb behavior. Written in C++ (freestanding-friendly core library libuospkg + CLI), no GPL/LGPL code reuse — format-level compatibility only (RPM format is documented; cpio/gzip are open formats).

5.1 Component map (1:1 to the PikeOS stack)

PikeOS component	uos-pkg component	Notes
rpm (mode-dispatched CLI)	uos-pkg single binary, mode by argv[0] symlink or subcommand	symlinks uos-pkg-{build,query,install,verify,sign,db} mirror rpmb/rpmq/rpmi/rpmk/rpmv/rpmd
rpmbuild	uos-pkg build (-bp -bc -bi -bl -ba -bb -bs -t* --rebuild --recompile --target --buildroot --clean --rmsource --rmspec --short-circuit --nodirtokens)	identical stage semantics
rpm -q/-V/-i/-U/-e/-K/--initdb/--rebuilddb	`uos-pkg query	verify
rpm2cpio	uos-pkg extract (+ uos-rpm2cpio compat wrapper)	gzip+bzip2 payloads
rpmgraph	uos-pkg graph	graphviz digraph output
gendiff	uos-pkg gendiff (or keep the 20-line sh script)	trivial
librpm/librpmbuild/librpmdb	libuospkg (format), libuosbuild (spec/build engine), libuosdb (database)	C++17, freestanding-capable core
Berkeley DB 4.1.24 rpmdb	uosdb: append-only log-structured store with the same logical indexes (§5.4)	BDB format is legacy; we keep logical parity (same indexes, same query results), not byte parity
lib/rpm/macros + rpmrc + rpmpopt-4.2	share/uos-pkg/macros, uosrc, uospopt — byte-identical copies with path prefix retargeted (/opt/pikeos-D5.0 → %{uos_prefix})	macro engine must parse the original files unmodified as a conformance test
config/rpm/{common,hosts/*,targets/*}	config/uos-rpm/{common,hosts/*,targets/*} — same files, pikeos→uos token rename	16 targets + 6 hosts preserved exactly
helper scripts (find-provides, brp-*, check-files, find-lang.sh, …)	reimplemented as uos-pkg builtins (--internal-find-provides etc.) with sh wrappers for compat	eliminates perl/sh host deps
host-provides / buildenv-provides machinery	uos-pkg proxy host / uos-pkg proxy buildenv <pkg>	generates identical spec + builds + installs (§5.6)

5.2 Package file format (byte-level parity target)

Implement the RPM 4.2 container exactly (so PikeOS-built .rpm files install under uos-pkg and vice versa):

+-------------+  lead: 96 bytes, magic 0xEDABEEDB, major 3, minor 0,
|    lead     |  type (0=bin,1=src), archnum, osnum, name[66], sigtype 5
+-------------+  signature header: header structure, magic 0x8EADE801,
|  signature  |  RSA/DSA/SHA1/MD5 entries, 8-byte aligned
+-------------+  header: magic 0x8EADE801, sorted tags, i18n table;
|   header    |  133 query tags (verified list from --querytags)
+-------------+  payload: cpio (newc, "070701") compressed
|   payload   |  gzip (w9.gzdio, default) or bzip2 (w9.bzdio)
+-------------+

• Header store: region + immutable section, tag sorting (HeaderLoadSortsTags), compressed filenames as (dirname,basename,dirindex) tuples (CompressedFileNames), ./-prefixed payload paths (PayloadFilesHavePrefix).
• Digests: MD5 per file (Filemd5s), SHA1 over header (Sha1header), MD5 over header+payload (Sigmd5). Signatures: DSA/RSA via an internal minimal implementation (BeeCrypt replacement) — verification only is mandatory; signing optional.
• rpmlib dependencies: emit/require the same feature strings as §3.8, including rpmlib(uos-5.0) as the renamed virtual feature (the original rpmlib(pikeos-D5.0) string must also be accepted when installing legacy packages — aliasing table in the dependency resolver).
• rpm2cpio equivalence: uos-pkg extract pkg.rpm | cpio -idm must reproduce the payload; the pure-sh fallback algorithm (rpm2cpio.sh: skip 96-byte lead, parse signature/header sizes via od, dd | gunzip) documents the exact offsets and is the conformance reference.

5.3 CLI surface (parity with rpm 4.2)

uos-pkg query    (-q) [-c -d -l -s --dump --qf FMT -a -f FILE -g GROUP -p PKG --specfile --whatrequires CAP --whatprovides CAP --scripts --provides --requires/-R --obsoletes --conflicts --info --changelog --xml --setperms --setugids]
uos-pkg verify   (-V) [--nomd5 --nofiles --nodeps --noscript -a -f -g -p ...]
uos-pkg install  (-i) / upgrade (-U) / freshen (-F) / erase (-e)
                 [--aid --allfiles --allmatches --badreloc --excludepath --force --hash/-h --ignorearch --ignoreos --ignoresize --includedocs --justdb --nodeps --nodigest --noorder --nopre --nopost --nopreun --nopostun --noscripts --notriggers --oldpackage --percent --prefix PATH --relocate OLD=NEW --repackage --replacefiles --replacepkgs --test]
uos-pkg sign     (--addsign/--resign -K/--checksig --import --nodigest --nosignature)
uos-pkg db       (--initdb --rebuilddb)
uos-pkg build    (rpmbuild stage flags, §5.1)
uos-pkg extract | graph | gendiff | proxy | eval (-E) | define (-D) | showrc | querytags | macros=LIST | rcfile=LIST | root=DIR | version

All 133 query tags from --querytags must be supported by the query formatter (headerSprintf-compatible: %{TAG}, %|TAG?{t}:{f}| conditionals, [...] array iteration, :shescape/:octal/:depflags/:json? (4.2 set: shescape, octal, hex, date, depflags, perms, fflags, vflags) modifiers). The popt alias file rpmpopt-4.2 (472 lines) is ported to uospopt verbatim.

5.4 Database (uosdb) — logical parity with the BDB rpmdb

• Location: %{_dbpath} = <prefix>/var/lib/rpm (same macro).
• Logical schema mirrors %_dbi_tags (macros:496): primary Packages store + indexes Name Basenames Group Requirename Providename Conflictname Triggername Dirnames Requireversion Provideversion Installtid Sigmd5 Sha1header Filemd5s Depends Pubkeys.
• Implementation: single-file log-structured store (Packages.uosdb) + per-index sorted-string tables; fcntl exclusive/shared locking replicating lockdbfd; nofsync default per %_dbi_config*; --rebuilddb regenerates all indexes from headers (equivalent of %__dbi_rebuild nofsync !log !txn !cdb).
• Import path: uos-pkg db --import-bdb <dir> reads legacy Berkeley DB 4.1.24 files (documented hash/btree formats) to migrate an existing PikeOS rpmdb.
• ConcurrentAccess semantics: scriptlets may query the db mid-transaction (in-process snapshot).

5.5 Macro engine (the heart of spec compatibility)

A faithful rpm-4.2 macro processor:

1. Syntax: %name, %{name}, %{name:args} builtins, %name(args) parameterized, %(...) shell, %{?c:t}/%{!?c:f}/%{?c} conditionals, %{-o:…}/%{-o*} option forms, %% escape, line continuation \, # comments, %define/%global/%undefine in spec files, BUFSIZ-8192 expansion buffer semantics (macros:778).
2. Builtins: at minimum u2p (host path conversion — identity on linux hosts, cygwin/mingw conversion on windows hosts; §3.7), basename, dirname, suffix, expand, unexpand, verbose, nil, echo, warn, error, trace, dump, getenv, getconfdir, S P F spec-section refs, plus lua-free 4.2 set.
3. Load order exactly as §3.6 with %{_target} interpolation in the file list; --macros= replaces the list; -D defines land in the highest-priority context.
4. Conformance test: uos-pkg eval on every macro in config/rpm/* and lib/rpm/macros must produce byte-identical expansions to the original rpm -E (differential test harness against the mirrored binaries, which run fine under LD_LIBRARY_PATH=src/rpm/lib64).

5.6 Build engine (rpmbuild parity)

• Spec parser: preamble tags (Name Version Release Epoch Summary Group License Copyright Vendor Packager Distribution URL BuildRoot BuildRequires BuildArchitectures AutoReqProv Provides Requires Obsoletes Conflicts SourceN PatchN …), sections %description %prep %build %install %check %clean %files %changelog %pre %post %preun %postun %verifyscript %trigger*, subpackages %package/-n, %files attributes %defattr %attr %config %doc %dir %lang %ghost %exclude.
• Scriptlet execution via %___build_cmd template with the SYSGO-overridden %___build_pre (PATH/LD_LIBRARY_PATH injection from common:40–69, including BABS_BUILDENV_PREFIX handling) — the replica keeps this logic, retargeted to uos_ macros.
• Stage pipeline -bp→-bc→-bi→-bl→-bb/-ba, %setup/%patch builtins, build-root policies (brp-* equivalents), check-files strictness (%_unpackaged_files_terminate_build 1), internal dependency generator producing SONAME/interpreter/perl deps identical to find-provides/find-requires output.
• PikeOS-specific macros from common (%pikeos_build_package etc.) are provided under uos_ names (%uos_build_package, %uos_clone_project, …) with a compatibility alias table so legacy specs build unmodified; the alias table is the only place the old product token appears, isolated in share/uos-pkg/legacy-aliases.macros.

5.7 Proxy-package generation (host/buildenv parity)

uos-pkg proxy host:

1. emit Provides: /bin/sh, /usr/bin/env, interpreters (bash perl csh on Linux/BSD; bash perl on cygwin) — mirrors find-host-provides.sh:83–100;
2. scan /lib /usr/lib (/compat/linux prefix on BSD) for lib*.so.[0-9], ld-linux*.so.[0-9]; parse ELF dynamic section: emit SONAME and each VERDEF as libname(VER); append (64bit) marker for ELF64 — mirrors check_lib() lines 44–73;
3. render the host-provides spec template (Version 0.0, Release 1, noarch, AutoReqProv no, empty %files), build, and install into the uosdb.

uos-pkg proxy buildenv <name>: instantiate the sbe-proxy-##PKGNAME## template (buildenv-provides.spec.in) per build-environment component.

5.8 Macro-set mapping (1:1)

Every macro in §3 keeps its name and semantics; only the values carrying the product prefix change, via a single retargeting layer:

PikeOS macro	uos-pkg value	Mechanism
%_pikeos_prefix /opt/pikeos-D5.0	%_uos_prefix /opt/uos-5.0 (+ legacy alias)	config/uos-rpm/common
%_pikeos_rpm_prefix pikeos-	%_uos_rpm_prefix uos-	same
%_pikeos_version D5.0	%_uos_version 5.0	same
%vendor SYSGO AG, %packager, %_pikeos_url	UniversalisOS identity	same
all %_pikeos_target_*, %_pikeos_host_*	%_uos_target_*, %_uos_host_*	renamed copies of the 22 files
%_sysgo_* aliases	%_uos_sys_* (or drop; internal only)	same
%{u2p:…}	identical builtin	macro engine
master macros paths /opt/pikeos-D5.0/rpm/…	/opt/uos-5.0/pkg/…	retargeted copy

The legacy-alias file maps %_pikeos_* → %_uos_* so that unmodified PikeOS specs/config evaluate identically. New UniversalisOS content uses only uos_ names.

5.9 Verification & conformance plan

1. Differential macro tests: for each of the 241 macros + all config/rpm entries, compare uos-pkg eval vs mirrored rpm -E output (harness: LD_LIBRARY_PATH=src/rpm/lib64 src/rpm/bin/rpm --rcfile … --macros … -E).
2. Format round-trip: build a package with mirrored rpmbuild, install with uos-pkg; build with uos-pkg build, install with mirrored rpm -i (in a sandbox root) — both directions must succeed; rpm2cpio vs uos-pkg extract byte-compare payloads.
3. DB parity: after identical install sequences, query -qa --qf dumps must match; rpmgraph vs uos-pkg graph digraphs must be isomorphic.
4. Proxy parity: find-host-provides.sh output vs uos-pkg proxy host --emit-provides diffed on the same machine.
5. Real-world corpus: the 1906 package names recovered from the mirrored rpmdb Name index serve as the naming-conformance corpus; synthetic specs generating each family must produce identical NEVRA strings.

5.10 Non-goals / deliberate deviations

• No byte-level Berkeley DB compatibility (logical parity only; import tool provided).
• No PGP2/PGP5 external signers (%__pgp*_sign_cmd) — GPG-compatible signing only; verification of legacy signatures still supported.
• No rpmcache/up2date universe solver (%_bh*, %_solve_* macros parsed but inert).
• Internationalization: English-only CLI (the original ships 20+ locale catalogs; messages are out of parity scope).
• The lin32-as-default-host quirk in the compiled-in macrofiles list (§3.6) is reproduced for fidelity but documented; uos-pkg selects the host file matching the actual host arch unless --legacy-host-default is given.

---

6. Notable findings / quirks (relevant to the replica)

1. Compiled-in default host is lin32 even though the tools are x86_64 binaries (rpmrc:355 and the librpm-4.2.so embedded string). On a 64-bit host the effective host config comes from hosts/lin32 unless overridden — lin32 itself sets %_pikeos_host_dirname lin64 (sic), so paths still resolve to the 64-bit tree.
2. ./.rpmmacros (cwd-local macro file) appears in the embedded macrofiles list but not in the on-disk rpmrc — a vendor patch to the library.
3. rpmlib(pikeos-D5.0) is a custom virtual rpmlib capability injected by the vendor build; packages may Require: it. uos-pkg must alias it.
4. %{u2p:…} is a vendor-added macro builtin (not in stock rpm 4.2) for Windows-host path conversion; used in every build scriptlet prelude.
5. The shipped rpmdb is an empty template (Packages = 0 bytes) but secondary indexes retain ~1906 historical package-name keys — a goldmine for the naming taxonomy (§2.3).
6. zlib inside librpm reports 1.1.4 inflate/deflate (2002-era) while linking a 1.2.7 zlibVersion symbol — payload compression is plain gzip either way.
7. mips_isa32* target files contain the misspelled triplet mipsisa32r2-unkown-elf — reproduce verbatim for parity (gcc configure consumes it).
8. Strict-build defaults: unpackaged files and missing %doc files terminate the build (macros:316,322) — harsher than stock rpm 4.2 defaults.
9. %_fixowner is deliberately abused as the earliest post-%setup hook for compile tracking (common:184–190) — the replica must preserve hook ordering.
10. The banned two-character product token appears in original comments (e.g. common:78,92 example CVS paths) and as an infix in ~14 recovered legacy package names (a doc package, an API family, a CFS family, a bus family, and a base family, all of the form pikeos-<token>…); the replica's alias table handles these as opaque legacy strings, never generating them.

---

End of specification. All citations refer to files under ~/portugalfuturista/universalisos/ (src/rpm/… for binaries and shipped config, pikeos-mirror/… for the config/rpm tree).