kiwi-ng image info

SYNOPSIS

kiwi-ng [global options] service <command> [<args>]

kiwi-ng image info -h | --help
kiwi-ng image info --description=<directory>
    [--resolve-package-list]
    [--list-profiles]
    [--print-kiwi-env]
    [--ignore-repos]
    [--add-repo=<source,type,alias,priority>...]
    [--print-xml|--print-yaml]
kiwi-ng image info help

DESCRIPTION

Provides information about the specified image description. If no specific info option is provided, the command lists basic information about the image. This information is also available in the image XML description file. Specifying an extension option like resolve-package-list makes a dependency resolver run through the list of packages, providing more detailed information about the image description.

OPTIONS

--add-repo=<source,type,alias,priority>

Adds a repository with the given source, type, alias, and priority.

--description=<directory>

The description must be a directory containing a kiwi XML description and optional metadata files.

--ignore-repos

Ignores all repository configurations from the XML description. This option is usually used together with the --add-repo option. Otherwise, there are no repositories available for processing the requested image information, which could lead to an error.

--list-profiles

Lists profiles available for the selected/default type.

NOTE: If the image description is designed in a way that there is no default build type configured and/or the main build type is also profiled, it’s required to provide this information to kiwi to list further profiles for this type. For example: kiwi-ng –profile top_level_entry_profile image info …

--print-kiwi-env

Prints kiwi profile environment variables. The listed variables are available in the shell environment of the kiwi hook scripts.

NOTE: The kiwi profile environment grows during the build process. When used in early stages, e.g., in a post_bootstrap.sh script, it can happen that not all variables have a value. The setup of the kiwi profile environment in the image info output can therefore also only list the static configuration values that are known at the beginning of a build process.

--resolve-package-list

Solves package dependencies and returns a list of all packages, including their attributes, for example, size, shasum, and more.

--print-xml

Prints the image description in the XML format. The specified image description is converted to XML and sent to the XSLT stylesheet processor. The result is then validated using the RelaxNG schema and the schematron rules. The command is normally used to convert an old image description to the latest schema.

--print-yaml

Behaves similarly to --print-xml, but after validation, the result is converted to the YAML format. The command can be used for different operations:

Conversion of the specified image description from or into different formats. This requires the anymarkup Python module to be installed. The module is not a hard requirement and is loaded on demand. If the module is missing, requests to convert to a format other than XML will fail.
Updates an old image description to the latest schema.