Penguin
Recent Changes
Blame: dpkg-divert(8)
EditPageHistoryDiffInfoLikePages
Annotated edit history of dpkg-divert(8) version 1, including all changes. View license author blame.
Rev Author # Line
1 perry 1 DPKG-DIVERT
2 !!!DPKG-DIVERT
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 OPTIONS
7 NOTES
8 FILES
9 SEE ALSO
10 AUTHOR
11 ----
12 !!NAME
13
14
15 dpkg-divert -- override a package's version of a file
16 !!SYNOPSIS
17
18
19 __dpkg-divert__ [[options] [[--add]
20 ''''__
21 dpkg-divert__ [[options] --remove
22 ''''__
23 dpkg-divert__ [[options] --list ''''
24 __dpkg-divert__ [[options] --truename
25 ''''
26 !!DESCRIPTION
27
28
29 File `diversions' are a way of forcing dpkg not to install a
30 file into its location, but to a `diverted' location.
31 Diversions can be used through the Debian package scripts to
32 move a file away when it causes a conflict. System
33 administrators can also use it to override some package's
34 configuration file, or whenever some files (which aren't
35 marked as 'conffiles') need to be preserved by dpkg, when
36 installing a newer version of a package which contains those
37 files.
38
39
40 __dpkg-divert__ is the utility used to set up and update
41 the list of diversions. It functions in three basic modes -
42 adding, removing, and listing diversions. The options are
43 --add, --remove, and --list, respectively. Additionally, it
44 can print out the real name for a diverted file. Other
45 options (listed below) may also be specified.
46 !!OPTIONS
47
48
49 ''--admindir ''
50
51
52 Set the dpkg data directory to
53
54
55 ''--divert ''
56
57
58
59
60 ''--help''
61
62
63 Output the version and the short usage instructions, and
64 exit successfully.
65
66
67 ''--local''
68
69
70 Specifies that all packages' versions are
71 diverted.
72
73
74 ''--package ''
75
76
77
78
79 ''--quiet''
80
81
82 Quiet mode, i.e. no verbose output.
83
84
85 ''--rename''
86
87
88 Actually move the file aside (or back). dpkg-divert will
89 abort operation in case the destination file already
90 exists.
91
92
93 ''--test''
94
95
96 Test mode, i.e. don't actually perform any changes, just
97 demonstrate.
98
99
100 ''--version''
101
102
103 Output program name and version and exit
104 successfully.
105 !!NOTES
106
107
108 When adding, default is --local and --divert
109 Directories can't be diverted with dpkg-divert.
110 !!FILES
111
112
113 ''/var/lib/dpkg/diversions''
114
115
116 File which contains the current list of diversions of the
117 system. It is located in the dpkg administration directory,
118 along with other files important to dpkg, such as `status'
119 or `available'.
120 Note: dpkg-divert preserves the old copy of this file, with
121 extension
122 !!SEE ALSO
123
124
125 dpkg(8).
126
127
128 Please read the Debian Packaging Manual, section 11.,
129 !!AUTHOR
130
131
132 Copyright (C) 1995 Ian Jackson.
133
134
135 This is free software; see the GNU General Public Licence
136 version 2 or later for copying conditions. There is NO
137 warranty.
138 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.