DPKG-DIVERTSection: dpkg utilities (8)
Updated: December 1999
Return to Main Contents
NAMEdpkg-divert -- override a package's version of a file
SYNOPSISdpkg-divert [options] [--add] <file>
dpkg-divert [options] --remove <file>
dpkg-divert [options] --list <glob-pattern> dpkg-divert [options] --truename <file>
DESCRIPTIONFile `diversions' are a way of forcing dpkg not to install a file into its location, but to a `diverted' location. Diversions can be used through the Debian package scripts to move a file away when it causes a conflict. System administrators can also use it to override some package's configuration file, or whenever some files (which aren't marked as 'conffiles') need to be preserved by dpkg, when installing a newer version of a package which contains those files.
dpkg-divert is the utility used to set up and update the list of diversions. It functions in three basic modes - adding, removing, and listing diversions. The options are --add, --remove, and --list, respectively. Additionally, it can print out the real name for a diverted file. Other options (listed below) may also be specified.
NOTESWhen adding, default is --local and --divert <original>.distrib. When removing, --package or --local and --divert must match if specified.
Directories can't be diverted with dpkg-divert.
AUTHORCopyright (C) 1995 Ian Jackson.
This is free software; see the GNU General Public Licence version 2 or later for copying conditions. There is NO warranty.
This document was created by man2html, using the manual pages.
Time: 06:02:34 GMT, October 23, 2021