cdmtConvert(CDMT)

cdmtConvert -- convert list of relative pathnames to CDMT input files

Syntax

cdmtConvert [-f] [-inputDir directory] [-defaultPerms] [-version version]
[-exportMacro macroName] packageCode*.files

Description

cdmtConvert reads in a list of relative pathnames generated with find(C), and converts them to CDMT input files. The developer can use these input files unmodified as input to cdmtParse or customize the input files before using them. For each package, the developer redirects the output of find to a file called packageCode.file, where packageCode is the package code of the package.

The cdmtConvert utility:

reads the $CDMT_DIR/cdmt.config file, if it exists, for additional configuration information. See cdmt.config(CDMT).
creates a .config file, containing macros that define default values. You can edit this file as needed and use it instead of $CDMT_DIR/cdmt.config when running the CDMT tools (using the -config command-line option).
outputs the CDMT input files to the $CDMT_DIR/input directory, unless specified otherwise.
To change the output directory, specify the new directory either on the command line with the -inputDir option or by setting the inputDir attribute in the CONFIG record in cdmt.config.

To convert a list of filenames to CDMT input files, run find and cdmtConvert from the top-level directory containing the files in the product. For example:

find . -print > /tmp/product.files
cdmtConvert /tmp/product.files

By default, cdmtConvert treats all files in the *.files file as access type SHARED and not exported:

To specify files as access type CLIENT, copy the pathnames to packageCode.CLIENT.
To specify files to be exported, copy the pathnames to packageCode.export.

In the example above, cdmtConvert loads in the files /tmp/product.CLIENT and /tmp/product.export, if they exist.

Specify any subpackages by listing them after the parent package and enclosing the entire list in braces. For example:

cdmtConvert {WServer.files WServerExamples.files WServerMan.files}

In this example, the WServer product contains the subpackages WServerExamples and WServerMan. The first package in the list, WServer.files is the component, or root, package. The package code for the root package is used as the component code.

Use braces to group a package and its subpackages. To denote subpackages of subpackages, use braces recursively.

cdmtConvert accepts the following options:

-f: do not prompt user when removing previous files and directories
-inputDir directory: specify the directory to put the generated CDMT input files
-defaultPerms: ignore the file permissions on the actual files. Use default values set in the *.cmpnt file.
-version version: specify the version of the product and components
-exportMacro macroName: specify the name of a macro to precede all export paths. This allows ``late binding'' of the actual export location.

Exit values

If execution was successful, cdmtConvert exits with a value of 0. If execution failed, cdmtConvert exits with a non-zero number.

Files

/usr/bin/cdmtConvert

Standards conformance