Using the command line

The QNX Software Center's qnxsoftwarecenter_clt script supports several command-line options for creating reports. These options let you:

• look up the latest server-defined properties for a file on your host or target
• import a target manifest and create a report
• apply a template to a report
• format the data of a report
• save a report to a file

Look up the latest server-defined properties for a file

The myQNX server maintains the latest properties (release status, OSS compliance, etc.) for files supplied by BlackBerry QNX. See more details about status field in status. To look up these server-defined properties for a specific file or set of files on your host or target, use one of the following options:

• -fileInfo path — searches for any file on the myQNX server that matches the specified path (the path must point to an existing file in the host filesystem)
• -fileSearch query — searches for any file on the myQNX server that matches the specified file properties

If either option finds a matching file on the myQNX server, it creates a manifest report that lists the file's server-defined properties.

The -fileSearch option is especially useful when you know some, but not all, of the attributes of a target file. For instance, it can search by build ID, Secure Hash Algorithm 512-bit checksum, or package ID.

For more information, see the entries for -fileInfo and -fileSearch in the “Using the QNX Software Center Command Line” chapter.

Import a target manifest and create a report

Like the GUI, the command line lets you create a report for a target manifest generated by a tool like Qscan (see “Generate a manifest” for more information). To import the target manifest and create a report, use the -reportImportQScan option.

This option checks whether properties listed for each file in the target scan match those defined on the myQNX server. The Errors field of the report flags any detected mismatches. See “Manifest report fields” for more information.

Apply a template to a report

To apply a predefined template to a report generated by -fileInfo, -fileSearch, or -reportImportQScan, use the -reportPresentation option. It supports the same templates as the QNX Software Center GUI.

Format the report data

By default, -fileInfo, -fileSearch, and -reportImportQScan generate a report in the comma-separated target manifest format. If you prefer a more human-readable format, use the -reportFormat option and specify the useinfo argument, which formats each property in the report as a field-value pair.

Save a report to a file

By default, -fileInfo, -fileSearch, and -reportImportQScan write the report to standard output (stdout). To redirect the report to a file, use the -reportSaveAs option.