static_files: support for binary patching

Author: zestrada

Dockerfile

@@ -9,7 +9,7 @@ ARG CONSOLE_VERSION="1.0.5"
 ARG PENGUIN_PLUGINS_VERSION="1.5.15"
 ARG VPN_VERSION="1.0.24"
 ARG HYPERFS_VERSION="0.0.38"
-ARG GUESTHOPPER_VERSION="1.0.15"
+ARG GUESTHOPPER_VERSION="1.0.16"
 ARG GLOW_VERSION="1.5.1"
 ARG GUM_VERSION="0.14.5"
 ARG LTRACE_PROTOTYPES_VERSION="0.7.91"

docs/schema_doc.md

@@ -1115,6 +1115,41 @@ Copy a file from the host into the guest
 |__Type__|string|
 
 
+#### `static_files.<string>.<type=binary_patch>` Patch binary file
+
+
+##### `static_files.<string>.<type=binary_patch>.type` Type of file action (patch binary file)
+
+|||
+|-|-|
+|__Type__|`"binary_patch"`|
+
+
+##### `static_files.<string>.<type=binary_patch>.file_offset` File offset (integer)
+
+|||
+|-|-|
+|__Type__|integer|
+|__Default__|`null`|
+
+Offset in the file to patch, from the start of the file
+
+##### `static_files.<string>.<type=binary_patch>.hex_bytes` Bytes to write (hex string)
+
+|||
+|-|-|
+|__Type__|string|
+
+Hex string of bytes to write at the offset
+
+```yaml
+DEADBEEF
+```
+
+```yaml
+90 90
+```
+
 ## `plugins` Plugins
 
 

src/penguin/gen_image.py

@@ -386,6 +386,22 @@ def _modify_guestfs(g, file_path, file, project_dir):
             # Create a symlink to desired target
             symlink_file = {"type": "symlink", "target": file["target"]}
             _symlink_modify_guestfs(g, file_path, symlink_file)
+        elif action == "binary_patch":
+            file_offset = file.get("file_offset")
+            bytes_hex = file.get("hex_bytes")
+
+            # Convert hex string to bytes
+            patch_bytes = bytes.fromhex(bytes_hex.replace(" ", ""))
+            target_path = file_path
+
+            # Open the file and patch it
+            p = g.adjust_path(target_path)
+            if not os.path.isfile(p):
+                raise FileNotFoundError(f"Target file for binary_patch not found: {target_path}")
+
+            with open(p, "r+b") as f:
+                f.seek(file_offset)
+                f.write(patch_bytes)
 
         else:
             raise RuntimeError(f"Unknown file system action {action}")

src/penguin/penguin_config/structure.py

@@ -708,6 +708,31 @@ class LibInject(BaseModel):
                 ),
             ),
         ),
+        dict(
+            discrim_val="binary_patch",
+            title="Patch binary file",
+            description=None,
+            fields=(
+                (
+                    "file_offset",
+                    int,
+                    Field(
+                        default=None,
+                        title="File offset (integer)",
+                        description="Offset in the file to patch, from the start of the file"
+                    ),
+                ),
+                (
+                    "hex_bytes",
+                    str,
+                    Field(
+                        title="Bytes to write (hex string)",
+                        description="Hex string of bytes to write at the offset",
+                        examples=["DEADBEEF", "90 90"],
+                    ),
+                ),
+            ),
+        ),
     ),
 )