1
# Copyright (C) 2005, 2006 Canonical Ltd
1
# Copyright (C) 2004, 2005 by Martin Pool
2
# Copyright (C) 2005 by Canonical Ltd
3
4
# This program is free software; you can redistribute it and/or modify
4
5
# it under the terms of the GNU General Public License as published by
5
6
# the Free Software Foundation; either version 2 of the License, or
6
7
# (at your option) any later version.
8
9
# This program is distributed in the hope that it will be useful,
9
10
# but WITHOUT ANY WARRANTY; without even the implied warranty of
10
11
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11
12
# GNU General Public License for more details.
13
14
# You should have received a copy of the GNU General Public License
14
15
# along with this program; if not, write to the Free Software
15
16
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
17
# TODO: Check ancestries are correct for every revision: includes
18
# every committed so far, and in a reasonable order.
20
# TODO: Also check non-mainline revisions mentioned as parents.
22
# TODO: Check for extra files in the control directory.
24
# TODO: Check revision, inventory and entry objects have all
27
# TODO: Get every revision in the revision-store even if they're not
28
# referenced by history and make sure they're all valid.
30
# TODO: Perhaps have a way to record errors other than by raising exceptions;
31
# would perhaps be enough to accumulate exception objects in a list without
32
# raising them. If there's more than one exception it'd be good to see them
35
from bzrlib import errors, osutils
36
from bzrlib import repository as _mod_repository
37
from bzrlib import revision
38
from bzrlib.branch import Branch
39
from bzrlib.bzrdir import BzrDir
40
from bzrlib.errors import BzrCheckError
41
from bzrlib.repository import Repository
42
from bzrlib.symbol_versioning import deprecated_function, deprecated_in
43
from bzrlib.trace import log_error, note
45
from bzrlib.workingtree import WorkingTree
48
"""Check a repository"""
50
# The Check object interacts with InventoryEntry.check, etc.
52
def __init__(self, repository):
53
self.repository = repository
54
self.checked_text_cnt = 0
55
self.checked_rev_cnt = 0
57
self.repeated_text_cnt = 0
58
self.missing_parent_links = {}
59
self.missing_inventory_sha_cnt = 0
60
self.missing_revision_cnt = 0
61
# maps (file-id, version) -> sha1; used by InventoryFile._check
62
self.checked_texts = {}
63
self.checked_weaves = set()
64
self.unreferenced_versions = set()
65
self.inconsistent_parents = []
68
self.repository.lock_read()
69
self.progress = bzrlib.ui.ui_factory.nested_progress_bar()
71
self.progress.update('retrieving inventory', 0, 2)
72
# do not put in init, as it should be done with progess,
73
# and inside the lock.
74
self.inventory_weave = self.repository.inventories
75
self.progress.update('checking revision graph', 1)
76
self.check_revision_graph()
79
while revno < len(self.planned_revisions):
80
rev_id = self.planned_revisions[revno]
81
self.progress.update('checking revision', revno,
82
len(self.planned_revisions))
84
self.check_one_rev(rev_id)
85
# check_weaves is done after the revision scan so that
86
# revision index is known to be valid.
89
self.progress.finished()
90
self.repository.unlock()
92
def check_revision_graph(self):
93
if not self.repository.revision_graph_can_have_wrong_parents():
94
# This check is not necessary.
95
self.revs_with_bad_parents_in_index = None
97
bad_revisions = self.repository._find_inconsistent_revision_parents()
98
self.revs_with_bad_parents_in_index = list(bad_revisions)
100
def plan_revisions(self):
101
repository = self.repository
102
self.planned_revisions = repository.all_revision_ids()
103
self.progress.clear()
104
inventoried = set(key[-1] for key in self.inventory_weave.keys())
105
awol = set(self.planned_revisions) - inventoried
107
raise BzrCheckError('Stored revisions missing from inventory'
108
'{%s}' % ','.join([f for f in awol]))
110
def report_results(self, verbose):
111
note('checked repository %s format %s',
112
self.repository.bzrdir.root_transport,
113
self.repository._format)
114
note('%6d revisions', self.checked_rev_cnt)
115
note('%6d file-ids', len(self.checked_weaves))
116
note('%6d unique file texts', self.checked_text_cnt)
117
note('%6d repeated file texts', self.repeated_text_cnt)
118
note('%6d unreferenced text versions',
119
len(self.unreferenced_versions))
120
if self.missing_inventory_sha_cnt:
121
note('%6d revisions are missing inventory_sha1',
122
self.missing_inventory_sha_cnt)
123
if self.missing_revision_cnt:
124
note('%6d revisions are mentioned but not present',
125
self.missing_revision_cnt)
127
note('%6d ghost revisions', len(self.ghosts))
129
for ghost in self.ghosts:
131
if len(self.missing_parent_links):
132
note('%6d revisions missing parents in ancestry',
133
len(self.missing_parent_links))
135
for link, linkers in self.missing_parent_links.items():
136
note(' %s should be in the ancestry for:', link)
137
for linker in linkers:
138
note(' * %s', linker)
140
for file_id, revision_id in self.unreferenced_versions:
141
log_error('unreferenced version: {%s} in %s', revision_id,
143
if len(self.inconsistent_parents):
144
note('%6d inconsistent parents', len(self.inconsistent_parents))
146
for info in self.inconsistent_parents:
147
revision_id, file_id, found_parents, correct_parents = info
148
note(' * %s version %s has parents %r '
150
% (file_id, revision_id, found_parents,
152
if self.revs_with_bad_parents_in_index:
153
note('%6d revisions have incorrect parents in the revision index',
154
len(self.revs_with_bad_parents_in_index))
156
for item in self.revs_with_bad_parents_in_index:
157
revision_id, index_parents, actual_parents = item
159
' %s has wrong parents in index: '
161
revision_id, index_parents, actual_parents)
163
def check_one_rev(self, rev_id):
164
"""Check one revision.
166
rev_id - the one to check
168
rev = self.repository.get_revision(rev_id)
170
if rev.revision_id != rev_id:
171
raise BzrCheckError('wrong internal revision id in revision {%s}'
174
for parent in rev.parent_ids:
175
if not parent in self.planned_revisions:
176
missing_links = self.missing_parent_links.get(parent, [])
177
missing_links.append(rev_id)
178
self.missing_parent_links[parent] = missing_links
179
# list based so somewhat slow,
180
# TODO have a planned_revisions list and set.
181
if self.repository.has_revision(parent):
182
missing_ancestry = self.repository.get_ancestry(parent)
183
for missing in missing_ancestry:
184
if (missing is not None
185
and missing not in self.planned_revisions):
186
self.planned_revisions.append(missing)
22
"""Run consistency checks on a branch.
24
TODO: Also check non-mainline revisions mentioned as parents.
26
TODO: Check for extra files in the control directory.
28
from bzrlib.trace import mutter
29
from bzrlib.errors import BzrCheckError
30
from bzrlib.osutils import fingerprint_file
31
from bzrlib.progress import ProgressBar
36
pb = ProgressBar(show_spinner=True)
39
missing_inventory_sha_cnt = 0
40
missing_revision_sha_cnt = 0
42
history = branch.revision_history()
44
revcount = len(history)
47
# for all texts checked, text_id -> sha1
50
for rev_id in history:
52
pb.update('checking revision', revno, revcount)
53
mutter(' revision {%s}' % rev_id)
54
rev = branch.get_revision(rev_id)
55
if rev.revision_id != rev_id:
56
raise BzrCheckError('wrong internal revision id in revision {%s}'
59
# check the previous history entry is a parent of this entry
61
if last_rev_id is None:
62
raise BzrCheckError("revision {%s} has %d parents, but is the "
64
% (rev_id, len(rev.parents)))
65
for prr in rev.parents:
66
if prr.revision_id == last_rev_id:
188
self.ghosts.append(rev_id)
190
if rev.inventory_sha1:
191
inv_sha1 = self.repository.get_inventory_sha1(rev_id)
192
if inv_sha1 != rev.inventory_sha1:
193
raise BzrCheckError('Inventory sha1 hash doesn\'t match'
194
' value in revision {%s}' % rev_id)
195
self._check_revision_tree(rev_id)
196
self.checked_rev_cnt += 1
198
def check_weaves(self):
199
"""Check all the weaves we can get our hands on.
202
self.progress.update('checking inventory', 0, 2)
203
self.inventory_weave.check(progress_bar=self.progress)
204
self.progress.update('checking text storage', 1, 2)
205
self.repository.texts.check(progress_bar=self.progress)
206
weave_checker = self.repository._get_versioned_file_checker()
207
result = weave_checker.check_file_version_parents(
208
self.repository.texts, progress_bar=self.progress)
209
self.checked_weaves = weave_checker.file_ids
210
bad_parents, unused_versions = result
211
bad_parents = bad_parents.items()
212
for text_key, (stored_parents, correct_parents) in bad_parents:
213
# XXX not ready for id join/split operations.
214
weave_id = text_key[0]
215
revision_id = text_key[-1]
216
weave_parents = tuple([parent[-1] for parent in stored_parents])
217
correct_parents = tuple([parent[-1] for parent in correct_parents])
218
self.inconsistent_parents.append(
219
(revision_id, weave_id, weave_parents, correct_parents))
220
self.unreferenced_versions.update(unused_versions)
222
def _check_revision_tree(self, rev_id):
223
tree = self.repository.revision_tree(rev_id)
227
if file_id in seen_ids:
228
raise BzrCheckError('duplicated file_id {%s} '
229
'in inventory for revision {%s}'
231
seen_ids[file_id] = True
234
ie.check(self, rev_id, inv, tree)
236
for path, ie in inv.iter_entries():
237
if path in seen_names:
238
raise BzrCheckError('duplicated path %s '
239
'in inventory for revision {%s}'
69
raise BzrCheckError("previous revision {%s} not listed among "
71
% (last_rev_id, rev_id))
73
for prr in rev.parents:
74
if prr.revision_sha1 is None:
75
missing_revision_sha_cnt += 1
77
prid = prr.revision_id
78
actual_sha = branch.get_revision_sha1(prid)
79
if prr.revision_sha1 != actual_sha:
80
raise BzrCheckError("mismatched revision sha1 for "
81
"parent {%s} of {%s}: %s vs %s"
83
prr.revision_sha1, actual_sha))
85
raise BzrCheckError("revision {%s} has no parents listed but preceded "
87
% (rev_id, last_rev_id))
89
if rev.inventory_id != rev_id:
90
mismatch_inv_id.append(rev_id)
92
## TODO: Check all the required fields are present on the revision.
94
if rev.inventory_sha1:
95
inv_sha1 = branch.get_inventory_sha1(rev.inventory_id)
96
if inv_sha1 != rev.inventory_sha1:
97
raise BzrCheckError('Inventory sha1 hash doesn\'t match'
98
' value in revision {%s}' % rev_id)
100
missing_inventory_sha_cnt += 1
101
mutter("no inventory_sha1 on revision {%s}" % rev_id)
103
inv = branch.get_inventory(rev.inventory_id)
107
## p('revision %d/%d file ids' % (revno, revcount))
109
if file_id in seen_ids:
110
raise BzrCheckError('duplicated file_id {%s} '
111
'in inventory for revision {%s}'
113
seen_ids[file_id] = True
123
if ie.parent_id != None:
124
if ie.parent_id not in seen_ids:
125
raise BzrCheckError('missing parent {%s} in inventory for revision {%s}'
126
% (ie.parent_id, rev_id))
128
if ie.kind == 'file':
129
if ie.text_id in checked_texts:
130
fp = checked_texts[ie.text_id]
132
if not ie.text_id in branch.text_store:
133
raise BzrCheckError('text {%s} not in text_store' % ie.text_id)
135
tf = branch.text_store[ie.text_id]
136
fp = fingerprint_file(tf)
137
checked_texts[ie.text_id] = fp
139
if ie.text_size != fp['size']:
140
raise BzrCheckError('text {%s} wrong size' % ie.text_id)
141
if ie.text_sha1 != fp['sha1']:
142
raise BzrCheckError('text {%s} wrong sha1' % ie.text_id)
143
elif ie.kind == 'directory':
144
if ie.text_sha1 != None or ie.text_size != None or ie.text_id != None:
145
raise BzrCheckError('directory {%s} has text in revision {%s}'
149
for path, ie in inv.iter_entries():
150
if path in seen_names:
151
raise BzrCheckError('duplicated path %s '
152
'in inventory for revision {%s}'
241
154
seen_names[path] = True
244
@deprecated_function(deprecated_in((1,6,0)))
245
def check(branch, verbose):
246
"""Run consistency checks on a branch.
248
Results are reported through logging.
250
Deprecated in 1.6. Please use check_branch instead.
252
:raise BzrCheckError: if there's a consistency error.
254
check_branch(branch, verbose)
257
def check_branch(branch, verbose):
258
"""Run consistency checks on a branch.
260
Results are reported through logging.
262
:raise BzrCheckError: if there's a consistency error.
266
branch_result = branch.check()
269
branch_result.report_results(verbose)
272
def check_dwim(path, verbose, do_branch=False, do_repo=False, do_tree=False):
274
tree, branch, repo, relpath = \
275
BzrDir.open_containing_tree_branch_or_repository(path)
276
except errors.NotBranchError:
277
tree = branch = repo = None
281
note("Checking working tree at '%s'."
282
% (tree.bzrdir.root_transport.base,))
285
log_error("No working tree found at specified location.")
287
if branch is not None:
290
# The branch is in a shared repository
291
repo = branch.repository
293
elif repo is not None:
294
branches = repo.find_branches(using=True)
300
note("Checking repository at '%s'."
301
% (repo.bzrdir.root_transport.base,))
302
result = repo.check()
303
result.report_results(verbose)
306
log_error("No branch found at specified location.")
308
for branch in branches:
309
note("Checking branch at '%s'."
310
% (branch.bzrdir.root_transport.base,))
311
check_branch(branch, verbose)
316
log_error("No branch found at specified location.")
318
log_error("No repository found at specified location.")
162
print 'checked %d revisions, %d file texts' % (revcount, len(checked_texts))
164
if missing_inventory_sha_cnt:
165
print '%d revisions are missing inventory_sha1' % missing_inventory_sha_cnt
167
if missing_revision_sha_cnt:
168
print '%d parent links are missing revision_sha1' % missing_revision_sha_cnt
170
if (missing_inventory_sha_cnt
171
or missing_revision_sha_cnt):
172
print ' (use "bzr upgrade" to fix them)'
175
print '%d revisions have mismatched inventory ids:' % len(mismatch_inv_id)
176
for rev_id in mismatch_inv_id:
added
removed
bzrlib/check.py
