HAB_LOG_PARSER(1)

📦
version 4.0.1 · 2 versions
, in ubuntu stonking

💖 HAB_LOG_PARSER(1) 💖

okay so bestie, gather round, because today's main character is hab_log_parser, and she lives in the i.MX CST Documentation corner of the universe. This is the manual page for her. She reads and parses HAB audit events from NXP i.MX processors. She is, no cap, iconic. 🌟

quick PSA: the original manpage has a couple of teeny typos in it (same, honestly 💀) and I fixed them here so your brain doesn't trip. Every fact, flag and number is still 100% intact. periodt.

🌸 NAME 🌸

hab_log_parser — read and parse HAB audit events from NXP i.MX processors. that's it, that's the whole vibe. 🦋

✨ SYNOPSIS ✨

hab_log_parser [--sdp device | --input-bin file | --input-ascii file]
[--output file] [--verbose]

🎀 NOTE 🎀

okay so real talk, this manpage is just a short description of NXP hab_log_parser. For the full ✨lore✨ you gotta go elsewhere:

  • For usage: hit up the Code Signing Tool User Guide UG10106, section 5.8.
  • For the structures contained in image: hit up the High Assurance Boot Version 4 API Reference Manual RM00298, section 4.

Both of those docs can be obtained from www.nxp.com. They are excluded from Debian for copyright reasons, so don't come looking for them in your package manager, bestie, they are simply not invited to this party 😭.

💅 DESCRIPTION 💅

hab_log_parser is a tool that reads HAB persistent memory dumps from OCRAM of NXP i.MX SoCs — either through USB or from files — and then prints the parsed HAB events. she reads, she parses, she serves. 👑

🔥 OPTIONS 🔥

  • -s, --sdp device — selects Serial Downloader Protocol (SDP) mode, so you can download over USB. You must specify the device type, and it's gotta be one of: imx6s, imx6dl, imx6q, imx6d, imx6qp, imx6dp, imx6sl, imx6sll, imx6sx, imx6ul, imx6ull, imx7s, imx7d, imx7ulpa7, imx7ulpm4, imx8mq, imx8mm, imx8mn, imx8mp. pick your fighter 🎮
  • -b, --input-bin file — reads a HAB4 persistent memory content dump from a binary file. 🧚
  • -a, --input-ascii file — reads a HAB4 persistent memory content dump from an ASCII file. 🍓
  • -o, --output file — tells it which file to save the parsed output into. If you don't provide one, the logs get printed to stdout instead. no file, no problem. ✨
  • -b, --verbose — enables verbose output. 👀
not me pointing out that -b is listed twice in the original (once for --input-bin, once here for --verbose) 🙈 — that's literally how the source manpage has it, so I'm keeping it exactly as-is. iykyk.

🌈 EXAMPLES 🌈

🧚 Parsing memory dumps

Memory dumps may, for example, be retrieved from the u-boot console with the md.b command, or by using JTAG debuggers. many roads, one destination, slay.

To read persistent memory from an i.MX 6s SoC over USB and save the parsed logs to a text file:

hab_log_parser -s imx6s -o hab_log_parsed.txt

To read a binary file containing a memory dump and save the parsed logs to a text file:

hab_log_parser -b hab4_pers.bin -o hab_log_parsed.txt

and that's the whole page, bestie!! this little love letter came to you from i.MX CST Documentation, dated 2026-09-02. go parse some HAB events and be the main character of your own OCRAM dump. you ate that. no crumbs. 💖✨👑

HAB_LOG_PARSER(1) — out. 🫶

📦 where this page comes from