*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Linux man pages -> dpkg-divert (8)              



NAME    [Toc]    [Back]

       dpkg-divert -- override a package's version of a file

SYNOPSIS    [Toc]    [Back]

       dpkg-divert [options] [--add] <file>
       dpkg-divert [options] --remove <file>
       dpkg-divert   [options]	--list	<glob-pattern>	dpkg-divert  [options]
       --truename <file>

DESCRIPTION    [Toc]    [Back]

       File `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.

OPTIONS    [Toc]    [Back]

       --admindir <directory>
	      Set  the	dpkg   data   directory   to   <directory>   (default:

       --divert <divert-to>
	      <divert-to> is the name used by other packages' versions.

       --help Output  the  version  and the short usage instructions, and exit

	      Specifies that all packages' versions are diverted.

       --package <package>
	      <package> is the name of a package whose copy of <file> will not
	      be diverted.

	      Quiet mode, i.e. no verbose output.

	      Actually	move  the file aside (or back). dpkg-divert will abort
	      operation in case the destination file already exists.

       --test Test mode, i.e. don't actually perform any changes, just	demonstrate.

	      Output program name and version and exit successfully.

NOTES    [Toc]    [Back]

       When  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.

FILES    [Toc]    [Back]

	      File which contains the current list of diversions of  the  system.
  It	is located in the dpkg administration directory, along
	      with other files important to dpkg, such as `status' or  `available'.

	      Note:  dpkg-divert  preserves  the  old  copy of this file, with
	      extension "-old", before replacing it with the new one.

SEE ALSO    [Toc]    [Back]


       Please read the Debian Packaging Manual,  section  11.,	"Diversions  -
       overriding a package's version of a file" for more information.

AUTHOR    [Toc]    [Back]

       Copyright (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.

Debian Project			 December 1999			DPKG-DIVERT(8)
[ Back ]
 Similar pages
Name OS Title
blib IRIX Use MakeMaker's uninstalled version of a package
group_override HP-UX The registry group override file.
passwd_override HP-UX The registry database override file
autoscan Linux help to create a configure.ac file for a software package
autoscan2.13 Linux help to create a configure.in file for a software package
xfs_chver IRIX change the version of a filesystem to enable the extent unwritten version.
versw Tru64 Manages the transition from the active version of the operating system to a new version
dpkg-statoverride Linux override ownership and mode of files
get IRIX get a version of an SCCS file
get HP-UX get a version of an SCCS file
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service