Added bfb-tool script

Tool for extracting and repackaging BFBs.
bfb-tool <action> --bfb <BFB> --psid <PSID>|--opn <OPN>|--all [-p|--profile <Profile>] [--output-dir <dir>] [-v|--verbose]

Signed-off-by: Vladimir Sokolovsky <[email protected]>

Author: vladsokolovsky

Makefile.am

@@ -9,6 +9,7 @@ confdir = $(sysconfdir)
 dist_conf_DATA = etc/rshim.conf
 dist_sbin_SCRIPTS = scripts/bfb-install \
                     scripts/bf-reg \
+                    scripts/bfb-tool \
                     scripts/mlx-mkbfb \
                     third_party/PLDM-unpack/fwpkg_unpack.py
 

man/Makefile.am

@@ -3,4 +3,4 @@
 #
 
 man1_MANS = mlx-mkbfb.1
-man8_MANS = rshim.8 bfb-install.8 bf-reg.8
+man8_MANS = rshim.8 bfb-install.8 bf-reg.8 bfb-tool.8

man/bfb-tool.8

@@ -0,0 +1,71 @@
+.\" Manpage for bfb-tool.
+.TH bfb-tool 8 "2025-03-13" "bfb-tool" "BFB Management Tool"
+
+.SH NAME
+bfb-tool - Tool for extracting and repackaging BFBs
+
+.SH SYNOPSIS
+bfb-tool <action> --bfb <BFB> --psid <PSID>|--opn <OPN>|--all [-p|--profile <Profile>] [--output-dir <dir>] [-v|--verbose]
+
+.SH DESCRIPTION
+The bfb-tool is used for managing BFBs (bf-bundle/bf-fwbundle). It supports two primary actions: extract and repack.
+
+The repack action involves extracting and building a new BFB for a specific OPN/PSID.
+
+.SH OPTIONS
+
+.TP
+.B action
+Specify the action to perform. Supported actions are: extract and repack
+.RS
+.TP
+.B extract
+Extract the payload from the BFB.
+.TP
+.B repack
+Extract and build a new BFB for a specific OPN/PSID.
+.RE
+
+.TP
+.B --bfb <BFB>
+Specify the BFB file (either bf-bundle or bf-fwbundle).
+
+.TP
+.B --psid <PSID>
+Specify the PSID of the DPU for payload extraction.
+
+.TP
+.B --opn <OPN>
+Specify the OPN of the DPU for payload extraction.
+
+.TP
+.B --all
+Extract or repack for all applicable configurations.
+
+.TP
+.B -p, --profile <Profile>
+Specify a configuration profile.
+
+.TP
+.B --output-dir <dir>
+Specify the directory where results will be stored.
+
+.TP
+.B -v, --verbose
+Enable verbose mode for detailed output.
+
+.SH EXAMPLES
+
+Extract payload from a BFB for a specific PSID:
+.sp
+bfb-tool extract --bfb bf-fwbundle-2.9.2-40_25.02-prod.bfb --psid MT_0000001070
+
+Repack a BFB for a specific OPN:
+.sp
+bfb-tool repack --bfb bf-fwbundle-2.9.2-40_25.02-prod.bfb --opn 900-9D3B6-F2SV-PA0_Ax
+
+.SH SEE ALSO
+mlx-mkbfb(8)
+
+.SH AUTHOR
+Written by Vladimir Sokolovsky <[email protected]>

rshim.spec.in

@@ -58,10 +58,12 @@ make
 %{__install} -d %{buildroot}%{_mandir}/man8
 %{__install} -m 0644 man/rshim.8 %{buildroot}%{_mandir}/man8
 %{__install} -m 0644 man/bfb-install.8 %{buildroot}%{_mandir}/man8
+%{__install} -m 0644 man/bfb-tool.8 %{buildroot}%{_mandir}/man8
 %{__install} -m 0644 man/bf-reg.8 %{buildroot}%{_mandir}/man8
 %{__install} -d %{buildroot}%{_sysconfdir}
 %{__install} -m 0644 etc/rshim.conf %{buildroot}%{_sysconfdir}
 %{__install} -m 0755 scripts/bfb-install %{buildroot}%{_sbindir}
+%{__install} -m 0755 scripts/bfb-tool %{buildroot}%{_sbindir}
 %{__install} -m 0755 scripts/mlx-mkbfb %{buildroot}%{_sbindir}
 %{__install} -m 0755 third_party/PLDM-unpack/fwpkg_unpack.py %{buildroot}%{_sbindir}
 %{__install} -m 0755 scripts/bf-reg %{buildroot}%{_sbindir}
@@ -129,12 +131,14 @@ fi
 %endif
 %{_sbindir}/rshim
 %{_sbindir}/bfb-install
+%{_sbindir}/bfb-tool
 %{_sbindir}/mlx-mkbfb
 %{_sbindir}/bf-reg
 %{_sbindir}/fwpkg_unpack.py
 %{_mandir}/man1/mlx-mkbfb.1.gz
 %{_mandir}/man8/rshim.8.gz
 %{_mandir}/man8/bfb-install.8.gz
+%{_mandir}/man8/bfb-tool.8.gz
 %{_mandir}/man8/bf-reg.8.gz
 %{_datadir}/selinux/packages/rshim-fix.te