bionic (1) package-tracker.1.gz

Provided by: open-infrastructure-package-tracker_20170515-3_all bug

NAME
       package-tracker - Compare and track package versions in debian repositories


SYNOPSIS
       package-tracker READ COMPARE [OPTIONS]


DESCRIPTION
       package-tracker is designed to compare apt(1) archives from a derrivate (debian extending repositories)
       against their parent ones. As such it is possible to track changes of package versions in other archives.

       The comparison mechanism in use is the one from the Python APT library. package-tracker checks all binary
       packages in regards of their source packages.

       Traversing multiple suites is done as follows.

       stable, stable-updates, stable-security are checked against their corresponding suites in the parent
       archive (source and their binary packages).

       stable-backports, stable-backports-extras are checked agains the unstable (sid) ones (source and their
       binary packages).

       stable-extras and stable-backports-extras have a check for a existing source package in any of the parent
       distribution suites.

       Within all version checks there is a test for a existing binary Non-Maintainer Upload (binNMU).

       package-tracker internally uses the default suite names given from apt and does not use codenames.
       Anyway, you may configure package-tracker with apt sources.list files with codenames (see CONFIGURATION
       for more information). A such it will be assumed, that your (current) archive is in stable release state.
       For a case of a debian freeze, package-tracker will try to use the testing release suites of the parent
       archive. Regardless of a debian repository freeze, your derrivative suites can be also in testing suite
       state.

       The --ignore-tag parameter is used to bypass the version comparison mechanism of apt. It is not been
       intended to use release tags for a derrivative version naming scheme. As such you can specify this
       version part and package-tracker will strip the tag from the end of each version string before using apt
       library comparison function. For example;

           foo-1.2-4 (a debian upstream package)
           foo-1.1-1~myderrivative1 (backports package from a debian derrivative)

       As such package foo-1.1-1 will be compared against foo-1.2-4.


OPTIONS
       The following package-tracker common options are available:

       READ
           Specify apt sources file wich will been read to compare. See CONFIGURATION for more information.

       COMPARE
           Specify apt souces file wich will been compared against. See CONFIGURATION for more information.

       -t, --filter-type={all|lower|obsolete|ok}
           Specify a filter for items to display. Defaults to all.

       -o, --output-type={stdout|html}
           Output defaults to stdout. A html report can be written to a file.

       -f, --file=FILE
           Specify file name to write a report to. Defaults to report.html in current working directory.

       -i, --ignore-tag=STRING
           In case of packages with additional version tag, this string will been regarded like a revision tag.
           As such it will been not regarded in time of the version comparison against the parent archive.

       -v, --verbose
           Print more information.

       -d, --debug
           Set log level to DEBUG instead of INFO.


CONFIGURATION
       package-tracker uses sources.list(5) configuration files, as used by apt(1). Archives from READ
       configuration file will be compared against the archives in COMPARE. There is no need to include apt-src
       repositories.

       There is no limitation in comparison to default apt sources.list(5) files usage. You may have to ensure
       to define same components for the to read and the compare configuration files. To ensure that
       package-tracker can check against the unstable (sid) release packages, include this one in your
       configuration file.

       See /usr/share/doc/package-tracker for configuration examples.


FILES
       The following files/directories are used:

       /etc/package-tracker/*.list
           Apt sources configuration files.

       /var/lib/package-tracker
           This is a separated directory for apt to ensure to not use default apt instance on your host.

       /var/log/package-tracker/package-tracker.log
           This is were the log file is placed.

       /usr/share/package-tracker/templates/report.html
           HTML template wich will been used to generate the report. Can be modified for your own use.

       /usr/share/doc/package-tracker
           Configuration examples.


SEE ALSO
       package-tracker(7), apt(1), sources.list(5).


HOMEPAGE
       More information about package-tracker and the Open Infrastructure project can be found on the homepage
       at https://open-infrastructure.net.


CONTACT
       Bug reports, feature requests, help, patches, support and everything else are welcome on the Open
       Infrastructure Software Mailing List <software@lists.open-infrastructure.net>.

       Debian specific bugs can also be reported in the Debian Bug Tracking System at https://bugs.debian.org.


AUTHORS
       package-tracker was written by Andreas Kreuzer <andreas.kreuzer@open-infrastructure.net>.