Specify the path to the abicompat program to use. By default, in the absence of this option, the abicompat program found in directories listed in the $PATH environment is used.

Specify the path to the abidw program to use. By default, in the absence of this option, the abidw program found in directories listed in the $PATH environment is used.

Specify the git branch for the abixml files in the git repo. The default is a string like DISTRO/VERSION/ARCHITECTURE, computed from the running environment.

Specify the preexisting git working tree for abidb to submit to or check against. The default is the current working directory. It may be used concurrently by multiple “check” operations, but only one “submit” operation.

Display a short help about the command and exit.

Specify the diagnostic level for messages to stderr. One of debug, info, warning, error, or critical; case-insensitive. The default is info.

Specify a maximum limit to the execution time (in seconds) allowed for the abidw and abicompat programs that are executed. By default, no limit is set for the execution time of these programs.

Designate PATH names with a .EXT suffix to be treated as archives. If CMD is present, pipe the PATH through the given shell command, otherwise pass as if through cat. The resulting stream is then opened by libarchive, to enumerate the contents of a wide variety of possible archive file format. Process each file in the archive individually into abixml.

For example, -Z .zip will process each file in a zip file, and -Z .deb='dpkg-deb --fsys-tarfile' will process each payload file in a Debian archive.

Limit files selected for abixml extraction to those that match the given regular expression. The default is /lib.*\.so, as a heuristic to identify shared libraries.

Using abidw, extract abixml for each of the listed files, generally shared libraries, subject to the filename filter and the archive decoding options. Save the output of each abidw run into the selected distrobranch of the selected git repo. If --submit and --check are both given, do submit operations first.

Using abidiff, compare each of the listed file, generally executables, against abixml documents for selected versions for all shared libraries needed by the executable. These are listed by enumerating the dynamic segment tags DT_NEEDED of the executable.

Select the search paths for abixml documents used to locate any particular SONAME . The first given directory wins. However, all versions of the same SONAME in that directory are selected for comparison. The default is unspecified, which means to search for all matching SONAME entries in the distrobranch, regardless of specific directory.