Using Qscan to generate a target manifest

Updated: September 12, 2023

The Qscan tool, qscan.sh, lets you generate a manifest for the QNX OS image on your target system.

The manifests generated by Qscan are in the CSV-based target manifest format, so it's easy to process them with the Reports feature of the QNX Software Center or with your existing data analysis tools.

Installing Qscan

To install the Qscan tool onto your development host:

  1. Launch the QNX Software Center and click Install New Packages.

  2. In the Available tab, expand QNX Software Development Platform, then expand Tools.

  3. Select the Qscan Tool package and click Install.

    The QNX Software Center installs the tool as qscan.sh under installation_directory/target/qnx7/architecture/usr/bin/, where installation_directory is the location of your QNX SDP installation and architecture is the processor architecture of your target (for instance, x86_64).

Generating a manifest

To run the Qscan tool on your target and generate a manifest:

  1. Make sure that the qscan.sh script and the find, openssl, and use utilities all reside on the target. (The qscan.sh uses these other utilities to generate its output.)
  2. Run qscan.sh, passing it the directory to search under. For example, this command tells qscan.sh to search the entire filesystem:

    ksh qscan.sh / > /tmp/targetscan.txt

    By default, qscan.sh writes to standard output, but in this example, we are redirecting the output to a file called targetscan.txt.

    If you also wish to redirect the standard error stream, specify a different file. Otherwise, the output file could be mixed with error messages that prevent you from importing it into the QNX Software Center.

    Because qscan.sh calculates checksums, the output may take several minutes to generate.

  3. Once you've generated the manifest, you can import it into the Reports feature of the QNX Software Center. See Create a manifest report for details.