package xdc.tools.check
index URL

Check compatibility of specified packages

This tools scans the specified repositories looking for package incompatibilities. [ more ... ]
XDCspec declarations sourced in xdc/tools/check/package.xdc
package xdc.tools.check [1, 0, 0] {
 
    module Main;
    // Command implementation
}
USAGE
xs xdc.tools.check [--help]
    [-[ax]] [-v] [-t target] [-e exclude_pattern] [-H header] [repository ...]
OPTIONS
-a
Return an array of strings
-v
Print informative messages during execution
-x
Return a Results struct as XML
-H
Prepend Header label to output
-e
Exclude packages or targets from checks

Do not check compatibility of packages or targets whose names match the regular expression exclude.

-m
Allow checking multiple versions of the same package

By default, when a package appears in more than repository named on the command line, this tool only checks the first occurance of the package. Setting this option forces all versions of all packages in the specified repositories to be included in the checks.

-t
Target to check

During the compatibility checks this tool ensures that for all targets used by all packages are compatible with the latest target referenced by any package. If this option is set, the check tool will only validate compatibility for the specified target. In addition, if the target string contains a target compatibility key, all packages that reference the target will be checked for compatibility with the specified key.

The format of this string is either 

      <target_name>:<target_key>

or 

      <target_name>

where <target_name> is the full name of a target and <target_key> is an optional target-specific compatibility key. The optional target compatibility key can be used to validate the set of packages against a specific compiler tool chain.

DETAILS
This tools scans the specified repositories looking for package incompatibilities.
By default, if a package appears in more than one repository, only the package in the first repository is added to the set of packages to check. This allows one to check the consistency of all packages that can be found along a specified package path by simply listing the package path repositories on the command line.
This tool performs the following checks:
  • the latest version of each target used by any package is compatible with all other versions used; and
  • the "built-with" versions of all packages are compatible with the versions of the packages contained in the specified repositories
If no repositories are specified, the repositories named in the current package path are checked.
generated on Tue, 24 Aug 2010 15:39:22 GMT