---
name: "cif_compare_dics"
section: "1"
platform: "linux"
package: "cod-tools"
version: "3.11.0+dfsg-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/cif_compare_dics"
---

# cif\_compare\_dics(1)

checks a pair of DDL1/DDLm dictionaries for compatibility breaking differences. Discrepancies between corresponding enumeration sets, default values, permitted ranges as well as data items unique to one of the dictionaries are reported.

## NAME

cif\_compare\_dics - checks a pair of DDL1/DDLm dictionaries for compatibility breaking differences. Discrepancies between corresponding enumeration sets, default values, permitted ranges as well as data items unique to one of the dictionaries are reported.

## SYNOPSIS

cif\_compare\_dics --ddl1 cif\_core\_ddl1.dic --ddlm cif\_core\_ddlm.dic --options

## DESCRIPTION

Checks a pair of DDL1/DDLm dictionaries for compatibility breaking differences. Discrepancies between corresponding enumeration sets, default values, permitted ranges as well as data items unique to one of the dictionaries are reported.

## OPTIONS

\-1, --ddl1\
                   The name of the DDL1 conforming dictionary that should\
                   be used in the comparison.

\-m, --ddlm\
                   The name of the DDLm conforming dictionary that should\
                   be used in the comparison.

\-I, --add-ddlm-import-path './ddlm/cod/'\
                   Prepend an additional directory to the dictionary\
                   import path. The dictionary import path specifies\
                   a list of directories in which to look for files\
                   that are imported by DDLm-compliant CIF dictionaries.\
                   Directories provided using this option are assigned\
                   the highest priority and are searched prior to\
                   the directories listed in the COD\_TOOLS\_DDLM\_IMPORT\_PATH\
                   environment variable or the default import path\
                   (directory of the importing dictionary).

\--clear-ddlm-import-path\
                   Remove all directories from the dictionary import path\
                   that were added using the --add-ddlm-import-path option.\
                   Neither COD\_TOOLS\_DDLM\_IMPORT\_PATH environment variable\
                   nor the default import path is affected by this option.

\--legacy-dic-type ddl1\
                   The type of the dictionary that should treated as the\
                   legacy one. Accepted values: 'ddl1' (default), 'ddlm'.

\--help, --usage\
                   Output a short usage message (this message) and exit.

\--version\
                   Output version information and exit.

## ENVIRONMENT

COD\_TOOLS\_DDLM\_IMPORT\_PATH\
                   A list of directories in which to look for the\
                   DDLm-compliant CIF dictionaries that are imported\
                   by other DDLm-compliant CIF dictionaries. List\
                   elements are separated by the colon symbol (':').\
                   Directories listed in COD\_TOOLS\_DDLM\_IMPORT\_PATH\
                   have a lower priority than those provided using\
                   the command line option (--add-dictionary-import-path),\
                   but higher than the default import path directory\
                   (directory of the importing dictionary).

## REPORTING BUGS

Report cif\_compare\_dics bugs using e-mail: cod-bugs@ibt.lt