Skip to content

Limitations

pydebuprep reports what it can see from the system, quickly and without changing anything. That sets its limits.

It doesn't know your intentions

A service that stopped, a repository that was disabled, a package that was removed: pydebuprep can see the change, not whether you wanted it. Comparisons with a snapshot are questions, not verdicts. Silence what's expected through the configuration.

It checks configuration and state, not function

  • An active service is a running process, not a working service. A database can run and refuse queries; a web server can run and serve errors.
  • A configured repository isn't necessarily a working one. pydebuprep checks keys, signatures and metadata from the last apt update, but never runs it, so whether a repository is reachable right now can't be known.
  • A loaded firewall ruleset is counted, not judged.
  • It doesn't test connectivity: no pings, no DNS lookups, no TLS handshakes.

It works from what's already on disk

Package checks use the package lists from the last apt update; if those are old, so are the results. apt-lists-age tells you how old they are.

Coverage

  • Supported: Debian 12–13 and Ubuntu 22.04–26.04. On other releases or derivatives, many checks work, but results may be incomplete and the os-release check reports it as unsupported.
  • Some areas aren't covered (yet): web servers' configuration (their test commands write), Podman, LXD and libvirt (their clients write on first use), snaps and Flatpaks, kernel command-line changes, RAID and SMART health.
  • Several checks need root; without it they're skipped.
  • In containers without systemd, checks that need systemd are skipped; a container also shares the host's kernel, clock and firewall, so those checks say more about the host.

Heuristics

Some checks judge by patterns: what counts as a "third-party" repository, which cron jobs guard themselves, which interfaces are virtual, which log messages are "the same". Each check's page lists its limitations; options let you adjust most of them.