Apendix D

Available Tags for
--queryformat

The following tags are all the ones defined at the time this book was written. For the latest list of available queryformat tags, issue the following command:

rpm --querytags

Keep in mind that the list of tags produced by the --querytags option is the complete list of all tags used by RPM internally (for instance, during package builds). Because of this, some tags do not produce meaningful output when used in a --queryformat format string.

D.1. List of --queryformat Tags

For every tag in this section, there can be as many as three different pieces of information:

• A short description of the tag.
• Whether the data specified by the tag is an array, and, if so, how many members are present in the array.
• What modifiers can be used with the tag.

The NAME Tag

The NAME tag is used to display the name of the package.

Array: No

Used with modifiers: N/A

The VERSION Tag

The VERSION tag is used to display the version of the packaged software.

Array: No

Used with modifiers: N/A

The RELEASE Tag

The RELEASE tag is used to display the release number of the package.

Array: No

Used with modifiers: N/A

The SERIAL Tag

The SERIAL tag is used to display the serial number of the package.

Array: No

Used with modifiers: N/A

The SUMMARY Tag

The SUMMARY tag is used to display a one-line summation of the packaged software.

Array: No

Used with modifiers: N/A

The DESCRIPTION Tag

The DESCRIPTION tag is used to display a detailed summation of the packaged software.

Array: No

Used with modifiers: N/A

The BUILDTIME Tag

The BUILDTIME tag is used to display the time and date the package was created.

Array: No

Used with modifiers: :date

The BUILDHOST Tag

The BUILDHOST tag is used to display the hostname of the system that built the package.

Array: No

Used with modifiers: N/A

The INSTALLTIME Tag

The INSTALLTIME tag is used to display the time and date the package was installed.

Array: No

Used with modifiers: :date

The SIZE Tag

The SIZE tag is used to display the total size, in bytes, of every file installed by this package.

Array: No

Used with modifiers: N/A

The DISTRIBUTION Tag

The DISTRIBUTION tag is used to display the distribution this package is a part of.

Array: No

Used with modifiers: N/A

The VENDOR Tag

The VENDOR tag is used to display the organization responsible for marketing the package.

Array: No

Used with modifiers: N/A

The GIF Tag

The GIF tag is not available for use with --queryformat.

The XPM Tag

The XPM tag is not available for use with --queryformat.

The COPYRIGHT Tag

The COPYRIGHT tag is used to display the copyright terms of the package.

Array: No

Used with modifiers: N/A

The PACKAGER Tag

The PACKAGER tag is used to display the person or persons responsible for creating the package.

Array: No

Used with modifiers: N/A

The GROUP Tag

The GROUP tag is used to display the group to which the package belongs.

Array: No

Used with modifiers: N/A

The CHANGELOG Tag

The CHANGELOG tag is reserved for a future version of RPM.

The SOURCE Tag

The SOURCE tag is used to display the source archives contained in the source package file.

Array: Yes (Size: One entry per source)

Used with modifiers: N/A

The PATCH Tag

The PATCH tag is used to display the patch files contained in the source package file.

Array: Yes (Size: One entry per patch)

Used with modifiers: N/A

The URL Tag

The URL tag is used to display the uniform resource locator that points to additional information about the packaged software.

Array: No

Used with modifiers: N/A

The OS Tag

The OS tag is used to display the operating system for which the package was built.

Array: No

Used with modifiers: N/A

The ARCH Tag

The ARCH tag is used to display the architecture for which the package was built.

Array: No

Used with modifiers: N/A

The PREIN Tag

The PREIN tag is used to display the package's preinstall script.

Array: No

Used with modifiers: N/A

The POSTIN Tag

The POSTIN tag is used to display the package's postinstall script.

Array: No

Used with modifiers: N/A

The PREUN Tag

The PREUN tag is used to display the package's preuninstall script.

Array: No

Used with modifiers: N/A

The POSTUN Tag

The POSTUN tag is used to display the package's postuninstall script.

Array: No

Used with modifiers: N/A

The FILENAMES Tag

The FILENAMES tag is used to display the names of the files that comprise the package.

Array: Yes (Size: One entry per file)

Used with modifiers: N/A

The FILESIZES Tag

The FILESIZES tag is used to display the size, in bytes, of each of the files that comprise the package.

Array: Yes (Size: One entry per file)

Used with modifiers: N/A

The FILESTATES Tag

The FILESTATES tag is used to display the state of each of the files that comprise the package.

Array: Yes (Size: One entry per file)

Used with modifiers: N/A

Since there is no modifier to display the file states in human-readable form, it will be necessary to manually interpret the flag values, based on the RPMFILE_STATE_xxx #defines contained in rpmlib.h. This file is part of the rpm-devel package and is also present in the RPM source package.

The FILEMODES Tag

The FILEMODES tag is used to display the permissions of each of the files that comprise the package.

Array: Yes (Size: One entry per file)

Used with modifiers: :perms

The FILEUIDS Tag

The FILEUIDS tag is used to display the user ID, in numeric form, of each of the files that comprise the package.

Array: Yes (Size: One entry per file)

Used with modifiers: N/A

The FILEGIDS Tag

The FILEGIDS tag is used to display the group ID, in numeric form, of each of the files that comprise the package.

Array: Yes (Size: One entry per file)

Used with modifiers: N/A

The FILERDEVS Tag

The FILERDEVS tag is used to display the major and minor numbers for each of the files that comprise the package. It will only be non-zero for device special files.

Array: Yes (Size: One entry per file)

Used with modifiers: N/A

The FILEMTIMES Tag

The FILEMTIMES tag is used to display the modification time and date for each of the files that comprise the package.

Array: Yes (Size: One entry per file)

Used with modifiers: :date

The FILEMD5S Tag

The FILEMD5S tag is used to display the MD5 checksum for each of the files that comprise the package.

Array: Yes (Size: One entry per file)

Used with modifiers: N/A

The FILELINKTOS Tag

The FILELINKTOS tag is used to display the link string for symlinks.

Array: Yes (Size: One entry per file)

Used with modifiers: N/A

The FILEFLAGS Tag

The FILEFLAGS tag is used to indicate whether the files that comprise the package have been flagged as being documentation or configuration.

Array: Yes (Size: One entry per file)

Used with modifiers: :fflags

The ROOT Tag

The ROOT tag is not available for use with --queryformat.

The FILEUSERNAME Tag

The FILEUSERNAME tag is used to display the owner, in alphanumeric form, of each of the files that comprise the package.

Array: No

Used with modifiers: N/A

The FILEGROUPNAME Tag

The FILEGROUPNAME tag is used to display the group, in alphanumeric form, of each of the files that comprise the package.

Array: Yes (Size: One entry per file)

Used with modifiers: N/A

The EXCLUDE Tag

The EXCLUDE tag is deprecated and should no longer be used.

The EXCLUSIVE Tag

The EXCLUSIVE tag is deprecated and should no longer be used.

The ICON Tag

The ICON tag is not available for use with --queryformat.

The SOURCERPM Tag

The SOURCERPM tag is used to display the name of the source package from which this binary package was built.

Array: No

Used with modifiers: N/A

The FILEVERIFYFLAGS Tag

The FILEVERIFYFLAGS tag is used to display the numeric value of the file verification flags for each of the files that comprise the package.

Array: Yes (Size: One entry per file)

Used with modifiers: N/A

Since there is no modifier to display the verification flags in human-readable form, it will be necessary to manually interpret the flag values based on the RPMVERIFY_xxx #defines contained in rpmlib.h. This file is part of the rpm-devel package and is also present in the RPM source package.

The ARCHIVESIZE Tag

The ARCHIVESIZE tag is used to display the size, in bytes, of the archive portion of the original package file.

Array: No

Used with modifiers: N/A

The PROVIDES Tag

The PROVIDES tag is used to display the capabilities the package provides.

Array: Yes (Size: One entry per provide)

Used with modifiers: N/A

The REQUIREFLAGS Tag

The REQUIREFLAGS tag is used to display the requirement flags for each capability the package requires.

Array: Yes (Size: One entry per require)

Used with modifiers: :depflags

The REQUIRENAME Tag

The REQUIRENAME tag is used to display the capabilities the package requires.

Array: Yes (Size: One entry per require)

Used with modifiers: N/A

The REQUIREVERSION Tag

The REQUIREVERSION tag is used to display the version-related aspect of each capability the package requires.

Array: Yes (Size: One entry per require)

Used with modifiers: N/A

The NOSOURCE Tag

The NOSOURCE tag is used to display the source archives that are not contained in the source package file.

Array: Yes (Size: One entry per nosource)

Used with modifiers: N/A

The NOPATCH Tag

The NOPATCH tag is used to display the patch files that are not contained in the source package file.

Array: Yes (Size: One entry per nopatch)

Used with modifiers: N/A

The CONFLICTFLAGS Tag

The CONFLICTFLAGS tag is used to display the conflict flags for each capability the package conflicts with.

Array: Yes (Size: One entry per conflict)

Used with modifiers: :depflags

The CONFLICTNAME Tag

The CONFLICTNAME tag is used to display the capabilities that the package conflicts with.

Array: Yes (Size: One entry per conflict)

Used with modifiers: N/A

The CONFLICTVERSION Tag

The CONFLICTVERSION tag is used to display the version-related aspect of each capability the package conflicts with.

Array: Yes (Size: One entry per conflict)

Used with modifiers: N/A

The DEFAULTPREFIX Tag

The DEFAULTPREFIX tag is used to display the path that will, by default, be used to install a relocatable package.

Array: No

Used with modifiers: N/A

The BUILDROOT Tag

The BUILDROOT tag is not available for use with --queryformat.

The INSTALLPREFIX Tag

The INSTALLPREFIX tag is used to display the actual path used when a relocatable package was installed.

Array: No

Used with modifiers: N/A

The EXCLUDEARCH Tag

The EXCLUDEARCH tag is used to display the architectures that should not install this package.

Array: Yes (Size: One entry per excludearch)

Used with modifiers: N/A

The EXCLUDEOS Tag

The EXCLUDEOS tag is used to display the operating systems that should not install this package.

Array: Yes (Size: One entry per excludeos)

Used with modifiers: N/A

The EXCLUSIVEARCH Tag

The EXCLUSIVEARCH tag is used to display the architectures that are the only ones that should install this package.

Array: Yes (Size: One entry per exclusivearch)

Used with modifiers: N/A

The EXCLUSIVEOS Tag

The EXCLUSIVEOS tag is used to display the operating systems that are the only ones that should install this package.

Array: Yes (Size: One entry per exclusiveos)

Used with modifiers: N/A

The AUTOREQPROV Tag

The AUTOREQPROV tag is not available for use with --queryformat.

The RPMVERSION Tag

The RPMVERSION tag is used to display the version of RPM that was used to build the package.

Array: No

Used with modifiers: N/A

The TRIGGERSCRIPTS Tag

The TRIGGERSCRIPTS tag is reserved for a future version of RPM.

The TRIGGERNAME Tag

The TRIGGERNAME tag is reserved for a future version of RPM.

The TRIGGERVERSION Tag

The TRIGGERVERSION tag is reserved for a future version of RPM.

The TRIGGERFLAGS Tag

The TRIGGERFLAGS tag is reserved for a future version of RPM.

The TRIGGERINDEX Tag

The TRIGGERINDEX tag is reserved for a future version of RPM.

The VERIFYSCRIPT Tag

The VERIFYSCRIPT tag is used to display the script to be used for package verification.

Array: No

Used with modifiers: N/A