jetson-print-bsp-info

Prints a concise summary of a Jetson LinuxforTegra (BSP) tree on the host PC.

This skill is intended as a reference example for the jetson-bsp-skills repo and the NVIDIA-wide skills CI. It performs read-only inspection — no flashing, no rootfs changes.

Purpose

Capture a baseline snapshot of a LinuxforTegra BSP tree (release, board configs, rootfs state) before flashing, so issues like "wrong L4T version" or "rootfs never populated" are caught early.

When to use

• A user has unpacked a Jetson BSP tarball and wants to confirm the L4T version, supported boards, and rootfs state before flashing.
• You need a quick sanity check that a LinuxforTegra/ directory looks valid (expected scripts and config files present).

Prerequisites

• Running on the host PC (Linux), not on the Jetson target.
• A LinuxforTegra/ directory extracted from a Jetson BSP tarball.
• Standard CLIs available: ls, head, cat, paste, sed.

Inputs

• L4TROOT (optional): absolute path to the Linuxfor_Tegra/ directory. If unset, use the current working directory.

Instructions

Run each step in order and print the captured values into the report shown under [Output format](#output-format).

1. Resolve L4TROOT and validate the directory is a LinuxforTegra root — exit early otherwise. flash.sh and nvtegra/ are the two anchor artifacts that every BSP ships:

``bash L4TROOT="${L4TROOT:-$PWD}" if [ ! -f "$L4TROOT/flash.sh" ] || [ ! -d "$L4TROOT/nvtegra" ]; then echo "Not a LinuxforTegra root: '$L4TROOT' (missing flash.sh or nvtegra/)" exit 1 fi echo "$L4TROOT" ``

1. Extract the L4T release header line. The canonical host-side location is nvtegra/nvtegrarelease; the same file is copied into the rootfs by applybinaries.sh. Only the first line is useful — the rest is a long list of library SHAs:

``bash head -1 "$L4TROOT/nvtegra/nvtegrarelease" 2>/dev/null \ || head -1 "$L4TROOT/rootfs/etc/nvtegra_release" 2>/dev/null \ || echo "L4T release info not found" ``

1. List supported board config files and join them onto one comma-separated line:

``bash (cd "$L4T_ROOT" && ls *.conf 2>/dev/null) | paste -sd, - ``

1. Check whether the rootfs has been populated. An empty rootfs/ means apply_binaries.sh has not been run yet:

``bash if [ -f "$L4T_ROOT/rootfs/etc/passwd" ]; then echo "populated" else echo "empty" fi ``

Output format

Print a short report with these sections, one line each where possible:

L4T root:        <path>
L4T release:     <release header line>
Board configs:   <comma-separated list>
Rootfs:          populated | empty

Examples

Example output on an Orin AGX BSP (L4T R36):

L4T root:        $HOME/Linux_for_Tegra
L4T release:     # R36 (release), REVISION: 3.0
Board configs:   jetson-agx-orin-devkit.conf,jetson-orin-nano-devkit.conf
Rootfs:          populated

Example output on a freshly untarred BSP where apply_binaries.sh has not been run yet:

L4T root:        /tmp/Linux_for_Tegra
L4T release:     # R39 (release), REVISION: 0.0
Board configs:   jetson-agx-thor-devkit.conf
Rootfs:          empty

Error handling

Each command falls back to a clearly labeled "... not found" string if the underlying file is missing — the skill never errors out mid-report. If L4TROOT does not contain flash.sh and nvtegra/, exit early with a clear "not a LinuxforTegra root" message rather than printing misleading info.

Limitations

• Read-only inspection only — does not validate signatures, kernel images, or device-tree overlays.
• Only checks the presence of rootfs/etc/passwd as a populated-rootfs proxy; will not detect a half-populated rootfs.
• Lists all *.conf board configs in L4T_ROOT/; does not try to infer which one the user intends to flash.

Troubleshooting

• Error: Not a LinuxforTegra root: '...' (missing flash.sh or nv_tegra/)

Cause: L4TROOT points at a parent directory, an extracted rootfs, or an unrelated path. Solution: Point L4TROOT at the directory that contains flash.sh (typically LinuxforTegra/).

• Error: L4T release info not found

Cause: Neither nvtegra/nvtegrarelease nor rootfs/etc/nvtegrarelease exists — the BSP tarball may be incomplete or applybinaries.sh was never run. Solution: Re-extract the BSP tarball or run apply_binaries.sh to populate the rootfs.

Notes

• Do not modify any files. This skill is read-only.
• If multiple board config files exist, list all of them — do not try to guess which one the user intends to flash.