Jump to contentJump to page navigation: previous page [access key p]/next page [access key n]

32 Binary Package Tracking

Products and updates to them are often officially supported by a company. To allow giving such support, there is binary package tracking. This feature allows checking which exact version of a package was shipped at what time. This feature is often important for release managers, maintenance engineers, QA engineers and supporters.

OBS can track these binary packages and offer a database to search them.

32.1 Which Binaries Are Tracked?

All binaries which are released into projects providing kind=maintenance_release are tracked. In addition to that, the OBS administrator can configure additional projects via the packtrack setting in BSConfig.pm.

32.2 What Data Is Tracked?

In short the information to identify a binary, its building place and timestamps are tracked. In addition to that also information about possible successor versions or if the binary got removed in the meantime. If products do reference the repositories the search interface offers also a listing of products which are supposed to use it. Either as part of the product media itself or in one of its update repositories.

32.2.1 Binary Identifier

A binary is identified by the following information which is extracted from components of the file path of the binary:

  • Repository:  Where is the binary hosted?

  • Name:  Name of the binary file

  • Epoch:  The epoch version (optional, usually not used)

  • Version:  The version

  • Release:  The release number

  • Architecture:  The hardware architecture

  • Medium:  Name of the medium (exists only for product builds)

32.2.2 Binary Information

Additional information about a binary is information which gets updated when a binary gets added or replaced.

  • operation, got the binary added, removed or modified

  • publish time, aka the time when the repository gets published by OBS. This is not the same time as when the release action got invoked.

  • build time

  • obsolete time, exists only when a binary gets removed or replaced

  • supportstatus, meta information about the level of support which is granted for the binary at the time of releasing it.

  • updateinfo id from rpm-md repository

  • maintainer of the binary who has prepared this update

  • disturl, the exact identifier to the source and build repository

32.2.3 Product information

Additional information about products referencing to this binary.

  • updatefor: the listed products do reference the repository as update channel.

  • product: exists when the binary was part of a product medium

32.3 API Search Interface

The search of released binaries is provided via the following API endpoints:

  • /search/released/binary/id : short form, just listing the matched binary identifiers. See the reference documentation.

  • /search/released/binary : long form, provides all other tracked information as described above. See the reference documentation.

Please visit the before mentioned links to get details and several examples of how to use these API endpoints.

Print this page