• Logo
    Ubuntu project
  • documentation.ubuntu.com
  • More resources
    • Discourse
    • Matrix
    • GitHub
Contents Menu Expand Light mode Dark mode Auto light/dark, in light mode Auto light/dark, in dark mode Skip to content
Ubuntu project documentation
Ubuntu project documentation
  • How Ubuntu is made
    • The Ubuntu Community
      • Community support
      • Matrix
        • Rooms and spaces
        • Room publishing
        • Moderation and defense of our Matrix community
        • Moderator bot
        • Bridging and integrations
      • Contribute to Ubuntu
        • App development
        • Art and design
        • Documentation
        • Discourse
        • QA and testing
        • Translation
        • Patch Pilots
    • Ubuntu Policy Manual
      • 1. About this manual
      • 2. The Ubuntu Archive
      • 3. Binary Packages
      • 4. Source Packages
      • 5. Control files and their fields
      • 6. Package maintainer scripts and installation procedure
      • 7. Declaring relationships between packages
      • 8. Shared libraries
      • 9. The Operating System
      • 10. Files
      • 11. Customized programs
      • 12. Documentation
      • A. Introduction and scope of these appendices
      • B. Binary packages
      • C. Source packages
      • D. Control files and their fields
      • E. Configuration file handling
      • F. Alternative versions of an interface - ``update-alternatives``
      • G. Diversions - overriding a package's version of a file
    • Project governance
      • Ethos
        • Ubuntu Code of Conduct
        • Diversity policy
        • Our Mission
      • Canonical
      • Debian
      • Delegation
    • Key concepts
      • Ubuntu releases
      • Upstream and downstream
      • Supported architectures
      • Policy on 3rd-party software sources
      • Launchpad
      • Package archive
      • Package format
      • Package lifecycle
      • Version string format
      • Patches
      • Phased updates
      • DEP 3 - patch file headers
      • Debian policy
      • debian/ directory
      • The Maintainer field
      • Filesystem hierarchy standard
    • Process overviews
      • Lifecycle of a change
      • Release cycle
      • Freezes
      • Freeze exceptions
      • New packages
      • Merges & syncs
      • Transitions
      • Backports
      • Automatic package testing: autopkgtest
      • Sponsorship
      • git-ubuntu
        • Changes file headers
        • Empty directories
      • Proposed migration
        • Failure to Build From Source (FTBFS)
        • Autopkgtest regressions
        • Issues preventing migration
        • Special migration cases
      • Stable Release Updates (SRU)
        • Principles
        • Requirements
        • Overview of the SRU pipeline
        • Standard processes
        • Non-standard processes
        • Reasons for requirements
        • Reference
          • SRU bug template
          • Status pages
          • Requirements
          • Special types of SRU
          • Package-specific notes
            • Kernel security and update policy for post-release trees
            • Apt Updates
            • azure-proxy-agent Updates
            • azure-vm-utils Updates
            • Bind9 Updates
            • Certbot Updates
            • cloud-init Updates
            • Curtin Updates
            • DPDK Updates
            • Container Stack Updates
            • GNOME Updates
            • Process for SRUing GRUB
            • HAProxy Updates
            • Intel Graphics Stack Updates
            • Landscape updates
            • MariaDB and Galera Updates
            • multipath-tools Updates
            • Nvidia GPU Driver Updates
            • Netplan Updates
            • OEM Meta Package Updates
            • OpenJDK Updates
            • OpenLDAP Updates
            • Stable Release Updates for OpenStack and the Ubuntu Cloud Archive
            • OpenVMTools Updates
            • OpenVPN Updates
            • Postfix Updates
            • PostgreSQL Updates
            • Snapcraft Updates
            • Snapd Glib Updates
            • Snapd Updates
            • Sos / SosReport Updates
            • Squid Updates
            • Ubuntu-Advantage-Tools / Ubuntu-Pro-Client Updates
            • UbuntuDevTools Updates
            • ubuntu-image Updates
            • Stable Release Updates for Virtualbox Updates
            • autopkgtest Updates
            • ec2-hibinit-agent Updates
            • Firmware Updates
            • GCE compute image packages update
            • Google Compute Engine Updates
            • Google Compute Engine OSlogin Updates
            • Google Guest Agent Updates
            • Google OSconfig Agent Updates
            • rax-nova-agent Updates
            • Valkey Updates
            • walinuxagent Updates
            • wslu Updates
          • Groups of SRU interest
          • Defined Exceptions
          • Historical removals
          • Team rota
        • Internal SRU team docs
      • Main Inclusion Review (MIR)
        • MIR roles and steps
        • Process states
        • MIR exception - font packages
        • MIR exception - OEM packages
        • MIR - re-reviews
        • MIR - promoting in other releases
        • MIR - Rust code in main
      • Ubuntu on Github
    • List of releases
  • Contributors
    • Getting started
      • Set up for Ubuntu development
      • Get the source of a package
      • Consider PGP key storage recommendations
      • Understand the tools
    • Triaging bugs
      • Bug types
      • Bug status
      • Bug tags
      • Bug importance
      • Bug responses
      • Assign a bug to a package
    • QA and testing
      • Report a bug
      • Application testing
      • Manual ISO testing
      • Hardware testing
      • Upgrade testing
      • Pre-release testing
    • Debugging
      • Debug an Apport crash
    • Fixing bugs
      • Get a new upstream version
      • Extract packages
      • Install built packages
      • Fix a bug in a package
      • Build packages in a PPA
      • Build packages locally
      • Propose changes
      • Run package tests
      • Bug fixing checklist
    • Patching
      • Make changes to a package
      • Manage patches
      • Work with Debian patches
      • Commit changes
      • Submit a merge proposal
      • Dual maintenance with Salsa and git-ubuntu
    • Merging
      • Preliminary steps
      • Merge process
      • Fix the changelog
      • Upload a PPA
      • Test the new build
      • git-ubuntu merge proposal
      • Merge manually
      • Merge cheat sheet
    • Uploading
      • Find a sponsor
      • Request an upload
      • Request a sync
    • Contribute new packages
      • Create a new package
      • Upload packages to a PPA
      • Request an SRU
    • Stable Release Updates
      • Introduction to SRU
      • Perform a standard SRU
      • Get an SRU released from proposed
      • Prepare a special type of SRU
      • Special types of SRU
      • Check for common issues with your SRU
      • Handle an autopkgtest failure
      • Investigate a halted phased update
      • Handle a regression
      • Contact the SRU team
    • Check accessibility
    • Contribute docs
    • Using Matrix
      • Getting started with Matrix
      • Completing your Matrix setup
      • Register a Matrix account on :ubuntu.com
      • Using multiple Matrix accounts
      • Matrix bug reporting
      • Dealing with spam
      • How to report abuse
      • Matrix ignore list
    • Advanced tasks
      • Check publication history
      • Checking reverse dependencies
      • Handle git-ubuntu contributions
      • Upload with rich history
      • Review a merge proposal
      • Sponsor an upload
      • Sponsor a sync
      • Resolve a migration issue
      • +1 Maintenance
      • +1 Maintenance report template
      • Request a package removal
      • Request a freeze exception
      • MIR bug request template
      • Use MIR templates
    • Set up a mirror
      • Mirror scripts
      • Push mirroring
  • Maintainers
    • Matrix management
      • Matrix room creation
        • Create a public room
        • Create a private room
        • Create a public space
        • Create a private space
        • Publish your room or space
      • Matrix room ownership
        • Room properties
        • Recommended room settings
        • Configure room for announcements
        • Rename or delete a room
        • Change the main room address
        • Regain control of a room
      • Matrix moderation
        • Making rooms official
        • Room moderation and policies
        • Mjolnir commands
    • Uploader tasks
      • Sponsoring
      • How to update seeds
      • How to work with the upload queue
    • Handling MIR reviews
      • MIR reviewer's template
    • SRU tasks
      • How to review an SRU
    • Archive Admin tasks
      • NEW review
      • Remove a package
      • Package overrides
      • Priority mismatches
      • Signing bootloaders
      • Change phasing on delivering SRU updates
      • i386
      • Archive-related services
      • Check contributions to AA process and documentation
    • Niche package maintenance
      • Ubuntu Desktop packaging
        • Set up Git for Ubuntu Desktop work
        • Maintain Ubuntu Desktop software
      • llvm and clang packaging
        • Package LLVM
        • Common issues
        • LLVM and Clang FAQ
      • rustc packaging
        • Update Rust
        • Patch Rust
        • Backport Rust
        • Rust version strings
        • Packaging FAQ
        • rustc-debian repository
        • Common Lintian issues
  • Who makes Ubuntu
    • Councils and Boards
      • Community Council
        • Conflict resolution
        • Code of Conduct enforcement process
      • Communications Council
        • Ubuntu Matrix Council
        • Matrix Operators
        • Matrix Defenders
        • Matrix Moderators
      • Technical Board
      • Ubuntu Membership Board
      • Developer Membership Board
        • DMB meetings
        • DMB Manage packagesets
        • DMB seed packagesets exceptions
        • DMB restaffing
        • DMB rules
        • DMB selection process
    • Roles and responsibilities
      • About the uploaders role
        • Uploaders service level agreement
      • About the MIR role
        • MIR team weekly status meeting
        • MIR Service Level Objectives
      • About the SRU role
      • Archive Administration
      • The Release Team
    • Ubuntu Developers
      • Ubuntu Prospective Developers
      • Ubuntu Contributing Developers
      • Per-Package Uploaders
      • Packageset uploaders
      • Delegated Developers
      • MOTU
      • SRU Developers
      • Core Developers
      • Developer Membership application process
        • DMB application knowledge requirements
        • Aspects of a good DMB application
    • Ubuntu Membership
      • Membership perks
      • Membership requirements
      • Membership application process
      • Ubuntu Member email alias
    • Ubuntu teams
      • Rocks community
      • High-Performance Computing team
    • Specialist teams
      • The Bug Squad
      • Ubuntu Bug Control
    • Ubuntu Local Communities
      • Starting a Local Community
      • Local Community handovers
      • Local Community FAQ
  • Glossary
  • Staging/preview area
    • Boards index
      • Ubuntu development
      • DMB knowledge base
    • Seeds
    • Seed management
    • Germinate
    • Partner archive
    • Archive Admin museum
    • Content that doesn’t belong to AA
Back to top
Contribute to this page

Appendix G - Diversions - overriding a package’s version of a file (from old Packaging Manual)¶

(Shared with Debian, see: Debian Policy Manual, Appendix 7)

← (Appendix F) | (Ubuntu Policy Manual) →

© 2026 CC-BY-SA, Canonical Ltd.
Last updated on Mar 17, 2026
Contents
  • Appendix G - Diversions - overriding a package’s version of a file (from old Packaging Manual)