objutils 0.10.4__tar.gz → 0.10.5__tar.gz

{objutils-0.10.4 → objutils-0.10.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: objutils
-Version: 0.10.4
+Version: 0.10.5
 Summary: Objectfile library for Python
 License: GPLv2
 License-File: LICENSE

{objutils-0.10.4 → objutils-0.10.5}/objutils/__init__.py

@@ -13,7 +13,7 @@ Registers CODECS and implements an interface to them.
 The first parameter is always the codec name.
 """
 
-__version__ = "0.10.4"
+__version__ = "0.10.5"
 
 __all__ = [
     "Image",

objutils-0.10.5/objutils/scripts/oj_dwarf_info.py

@@ -0,0 +1,143 @@
+#!/usr/bin/env python
+"""DWARF database inspector (read-only).
+
+Lists compilation units or traverses DIE attributes from an existing ``.prgdb``
+database. This script intentionally does **not** perform DWARF import; use
+``oj-dwarf-import`` to build the database first.
+"""
+
+from __future__ import annotations
+
+import argparse
+from collections.abc import Iterable
+from pathlib import Path
+from typing import Any
+
+from sqlalchemy.exc import SQLAlchemyError
+
+from objutils.dwarf.constants import Tag
+from objutils.dwarf.traverser import AttributeParser
+from objutils.elf import model
+
+
+def _parse_offset(text: str) -> int:
+    try:
+        return int(text, 0)
+    except ValueError as exc:
+        raise argparse.ArgumentTypeError(f"Invalid offset '{text}'") from exc
+
+
+def _attr_value(die: Any, name: str) -> Any:
+    attrs = getattr(die, "attributes_map", {}) or {}
+    attr = attrs.get(name)
+    return None if attr is None else getattr(attr, "raw_value", None)
+
+
+def _print_cus(cus: Iterable[Any], *, quiet: bool) -> None:
+    if quiet:
+        return
+    print("Compilation Units:")
+    print("-------------------")
+    for idx, cu in enumerate(cus, 1):
+        name = _attr_value(cu, "name") or ""
+        low_pc = _attr_value(cu, "low_pc")
+        high_pc = _attr_value(cu, "high_pc")
+        low_pc_str = f"0x{int(low_pc):08x}" if low_pc is not None else "-"
+        high_pc_str = f"0x{int(high_pc):08x}" if high_pc is not None else "-"
+        print(f"[{idx:03d}] off=0x{int(cu.offset):08x} name={name} range={low_pc_str}..{high_pc_str}")
+
+
+def _print_summary(session, *, quiet: bool) -> None:
+    if quiet:
+        return
+    die_count = session.query(model.DebugInformationEntry).count()
+    attr_count = session.query(model.DIEAttribute).count()
+    print(f"DIEs: {die_count:,}")
+    print(f"Attributes: {attr_count:,}")
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = argparse.ArgumentParser(description="Inspect DWARF debug info stored in a .prgdb database (no import).")
+    parser.add_argument("db", help="Path to .prgdb database generated by oj-dwarf-import")
+    parser.add_argument("--quiet", "-q", action="store_true", help="Suppress non-error output")
+    parser.add_argument("--list-cus", action="store_true", help="List compile units")
+    parser.add_argument("--summary", action="store_true", help="Print DIE/attribute counts")
+    parser.add_argument(
+        "--walk-attrs",
+        action="store_true",
+        help="Traverse DIE attributes with AttributeParser (starts at first DIE unless --offset is set).",
+    )
+    parser.add_argument(
+        "--offset",
+        type=_parse_offset,
+        help="Absolute DIE offset (decimal or 0x-prefixed hex) used for --walk-attrs start point.",
+    )
+    args = parser.parse_args(argv)
+
+    db_path = Path(args.db)
+    if db_path.suffix.lower() != model.DB_EXTENSION:
+        parser.error(f"Expected a '{model.DB_EXTENSION}' database; got '{db_path}'")
+    if not db_path.exists():
+        parser.error(f"Database not found: {db_path}")
+
+    post_actions = args.list_cus or args.summary or args.walk_attrs
+    if not post_actions:
+        args.list_cus = True
+
+    try:
+        db = model.Model(str(db_path))
+    except (OSError, SQLAlchemyError, ValueError) as exc:
+        if not args.quiet:
+            print(f"Failed to open database '{db_path}': {exc}")
+        return 4
+
+    try:
+        session = db.session
+        if args.summary:
+            _print_summary(session, quiet=args.quiet)
+
+        if args.list_cus or args.walk_attrs:
+            DIE = model.DebugInformationEntry
+            raw_cus = session.query(DIE).filter(DIE.tag == Tag.compile_unit).order_by(DIE.offset, DIE.cu_start).all()
+            seen = set()
+            cus = []
+            for cu in raw_cus:
+                key = (cu.offset, cu.cu_start)
+                if key in seen:
+                    continue
+                seen.add(key)
+                cus.append(cu)
+            if args.list_cus:
+                _print_cus(cus, quiet=args.quiet)
+
+            if args.walk_attrs:
+                ap = AttributeParser(session)
+                if args.offset is not None:
+                    start_die = session.query(DIE).filter(DIE.offset == int(args.offset)).first()
+                    if start_die is None:
+                        if not args.quiet:
+                            print(f"No DIE found at offset 0x{int(args.offset):08x}.")
+                        return 5
+                    ap.traverse_tree(start_die)
+                else:
+                    if not cus:
+                        if not args.quiet:
+                            print("No DebugInformationEntry available in the database to traverse.")
+                        return 5
+                    for cu in cus:
+                        ap.traverse_tree(cu)
+    except (OSError, SQLAlchemyError, RuntimeError, ValueError) as exc:
+        if not args.quiet:
+            print(f"Traversal failed: {exc}")
+        return 5
+    finally:
+        try:
+            db.close()
+        except SQLAlchemyError:
+            pass
+
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

{objutils-0.10.4 → objutils-0.10.5}/objutils/version.py

@@ -1,3 +1,3 @@
 """objutils version module"""
 
-__version__ = "0.10.4"
+__version__ = "0.10.5"

{objutils-0.10.4 → objutils-0.10.5}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "objutils"
-version = "0.10.4"
+version = "0.10.5"
 description = "Objectfile library for Python"
 authors = ["Christoph Schueler <cpu12.gems@googlemail.com>"]
 license = "GPLv2"
@@ -121,7 +121,7 @@ skip = ["*_i686", "*-musllinux*"]
 build-frontend = "build"
 
 [tool.bumpver]
-current_version = "0.10.4"
+current_version = "0.10.5"
 version_pattern = "MAJOR.MINOR.PATCH"
 commit_message = "bump version {old_version} -> {new_version}"
 commit = true