##// END OF EJS Templates
discovery: simplify the building of the children mapping...
marmoute -
r42049:1f069f37 default
parent child Browse files
Show More
@@ -1,363 +1,363 b''
1 # setdiscovery.py - improved discovery of common nodeset for mercurial
1 # setdiscovery.py - improved discovery of common nodeset for mercurial
2 #
2 #
3 # Copyright 2010 Benoit Boissinot <bboissin@gmail.com>
3 # Copyright 2010 Benoit Boissinot <bboissin@gmail.com>
4 # and Peter Arrenbrecht <peter@arrenbrecht.ch>
4 # and Peter Arrenbrecht <peter@arrenbrecht.ch>
5 #
5 #
6 # This software may be used and distributed according to the terms of the
6 # This software may be used and distributed according to the terms of the
7 # GNU General Public License version 2 or any later version.
7 # GNU General Public License version 2 or any later version.
8 """
8 """
9 Algorithm works in the following way. You have two repository: local and
9 Algorithm works in the following way. You have two repository: local and
10 remote. They both contains a DAG of changelists.
10 remote. They both contains a DAG of changelists.
11
11
12 The goal of the discovery protocol is to find one set of node *common*,
12 The goal of the discovery protocol is to find one set of node *common*,
13 the set of nodes shared by local and remote.
13 the set of nodes shared by local and remote.
14
14
15 One of the issue with the original protocol was latency, it could
15 One of the issue with the original protocol was latency, it could
16 potentially require lots of roundtrips to discover that the local repo was a
16 potentially require lots of roundtrips to discover that the local repo was a
17 subset of remote (which is a very common case, you usually have few changes
17 subset of remote (which is a very common case, you usually have few changes
18 compared to upstream, while upstream probably had lots of development).
18 compared to upstream, while upstream probably had lots of development).
19
19
20 The new protocol only requires one interface for the remote repo: `known()`,
20 The new protocol only requires one interface for the remote repo: `known()`,
21 which given a set of changelists tells you if they are present in the DAG.
21 which given a set of changelists tells you if they are present in the DAG.
22
22
23 The algorithm then works as follow:
23 The algorithm then works as follow:
24
24
25 - We will be using three sets, `common`, `missing`, `unknown`. Originally
25 - We will be using three sets, `common`, `missing`, `unknown`. Originally
26 all nodes are in `unknown`.
26 all nodes are in `unknown`.
27 - Take a sample from `unknown`, call `remote.known(sample)`
27 - Take a sample from `unknown`, call `remote.known(sample)`
28 - For each node that remote knows, move it and all its ancestors to `common`
28 - For each node that remote knows, move it and all its ancestors to `common`
29 - For each node that remote doesn't know, move it and all its descendants
29 - For each node that remote doesn't know, move it and all its descendants
30 to `missing`
30 to `missing`
31 - Iterate until `unknown` is empty
31 - Iterate until `unknown` is empty
32
32
33 There are a couple optimizations, first is instead of starting with a random
33 There are a couple optimizations, first is instead of starting with a random
34 sample of missing, start by sending all heads, in the case where the local
34 sample of missing, start by sending all heads, in the case where the local
35 repo is a subset, you computed the answer in one round trip.
35 repo is a subset, you computed the answer in one round trip.
36
36
37 Then you can do something similar to the bisecting strategy used when
37 Then you can do something similar to the bisecting strategy used when
38 finding faulty changesets. Instead of random samples, you can try picking
38 finding faulty changesets. Instead of random samples, you can try picking
39 nodes that will maximize the number of nodes that will be
39 nodes that will maximize the number of nodes that will be
40 classified with it (since all ancestors or descendants will be marked as well).
40 classified with it (since all ancestors or descendants will be marked as well).
41 """
41 """
42
42
43 from __future__ import absolute_import
43 from __future__ import absolute_import
44
44
45 import collections
45 import collections
46 import random
46 import random
47
47
48 from .i18n import _
48 from .i18n import _
49 from .node import (
49 from .node import (
50 nullid,
50 nullid,
51 nullrev,
51 nullrev,
52 )
52 )
53 from . import (
53 from . import (
54 error,
54 error,
55 util,
55 util,
56 )
56 )
57
57
58 def _updatesample(revs, heads, sample, parentfn, quicksamplesize=0):
58 def _updatesample(revs, heads, sample, parentfn, quicksamplesize=0):
59 """update an existing sample to match the expected size
59 """update an existing sample to match the expected size
60
60
61 The sample is updated with revs exponentially distant from each head of the
61 The sample is updated with revs exponentially distant from each head of the
62 <revs> set. (H~1, H~2, H~4, H~8, etc).
62 <revs> set. (H~1, H~2, H~4, H~8, etc).
63
63
64 If a target size is specified, the sampling will stop once this size is
64 If a target size is specified, the sampling will stop once this size is
65 reached. Otherwise sampling will happen until roots of the <revs> set are
65 reached. Otherwise sampling will happen until roots of the <revs> set are
66 reached.
66 reached.
67
67
68 :revs: set of revs we want to discover (if None, assume the whole dag)
68 :revs: set of revs we want to discover (if None, assume the whole dag)
69 :heads: set of DAG head revs
69 :heads: set of DAG head revs
70 :sample: a sample to update
70 :sample: a sample to update
71 :parentfn: a callable to resolve parents for a revision
71 :parentfn: a callable to resolve parents for a revision
72 :quicksamplesize: optional target size of the sample"""
72 :quicksamplesize: optional target size of the sample"""
73 dist = {}
73 dist = {}
74 visit = collections.deque(heads)
74 visit = collections.deque(heads)
75 seen = set()
75 seen = set()
76 factor = 1
76 factor = 1
77 while visit:
77 while visit:
78 curr = visit.popleft()
78 curr = visit.popleft()
79 if curr in seen:
79 if curr in seen:
80 continue
80 continue
81 d = dist.setdefault(curr, 1)
81 d = dist.setdefault(curr, 1)
82 if d > factor:
82 if d > factor:
83 factor *= 2
83 factor *= 2
84 if d == factor:
84 if d == factor:
85 sample.add(curr)
85 sample.add(curr)
86 if quicksamplesize and (len(sample) >= quicksamplesize):
86 if quicksamplesize and (len(sample) >= quicksamplesize):
87 return
87 return
88 seen.add(curr)
88 seen.add(curr)
89
89
90 for p in parentfn(curr):
90 for p in parentfn(curr):
91 if p != nullrev and (not revs or p in revs):
91 if p != nullrev and (not revs or p in revs):
92 dist.setdefault(p, d + 1)
92 dist.setdefault(p, d + 1)
93 visit.append(p)
93 visit.append(p)
94
94
95 def _limitsample(sample, desiredlen):
95 def _limitsample(sample, desiredlen):
96 """return a random subset of sample of at most desiredlen item"""
96 """return a random subset of sample of at most desiredlen item"""
97 if len(sample) > desiredlen:
97 if len(sample) > desiredlen:
98 sample = set(random.sample(sample, desiredlen))
98 sample = set(random.sample(sample, desiredlen))
99 return sample
99 return sample
100
100
101 class partialdiscovery(object):
101 class partialdiscovery(object):
102 """an object representing ongoing discovery
102 """an object representing ongoing discovery
103
103
104 Feed with data from the remote repository, this object keep track of the
104 Feed with data from the remote repository, this object keep track of the
105 current set of changeset in various states:
105 current set of changeset in various states:
106
106
107 - common: revs also known remotely
107 - common: revs also known remotely
108 - undecided: revs we don't have information on yet
108 - undecided: revs we don't have information on yet
109 - missing: revs missing remotely
109 - missing: revs missing remotely
110 (all tracked revisions are known locally)
110 (all tracked revisions are known locally)
111 """
111 """
112
112
113 def __init__(self, repo, targetheads):
113 def __init__(self, repo, targetheads):
114 self._repo = repo
114 self._repo = repo
115 self._targetheads = targetheads
115 self._targetheads = targetheads
116 self._common = repo.changelog.incrementalmissingrevs()
116 self._common = repo.changelog.incrementalmissingrevs()
117 self._undecided = None
117 self._undecided = None
118 self.missing = set()
118 self.missing = set()
119
119
120 def addcommons(self, commons):
120 def addcommons(self, commons):
121 """registrer nodes known as common"""
121 """registrer nodes known as common"""
122 self._common.addbases(commons)
122 self._common.addbases(commons)
123 if self._undecided is not None:
123 if self._undecided is not None:
124 self._common.removeancestorsfrom(self._undecided)
124 self._common.removeancestorsfrom(self._undecided)
125
125
126 def addmissings(self, missings):
126 def addmissings(self, missings):
127 """registrer some nodes as missing"""
127 """registrer some nodes as missing"""
128 newmissing = self._repo.revs('%ld::%ld', missings, self.undecided)
128 newmissing = self._repo.revs('%ld::%ld', missings, self.undecided)
129 if newmissing:
129 if newmissing:
130 self.missing.update(newmissing)
130 self.missing.update(newmissing)
131 self.undecided.difference_update(newmissing)
131 self.undecided.difference_update(newmissing)
132
132
133 def addinfo(self, sample):
133 def addinfo(self, sample):
134 """consume an iterable of (rev, known) tuples"""
134 """consume an iterable of (rev, known) tuples"""
135 common = set()
135 common = set()
136 missing = set()
136 missing = set()
137 for rev, known in sample:
137 for rev, known in sample:
138 if known:
138 if known:
139 common.add(rev)
139 common.add(rev)
140 else:
140 else:
141 missing.add(rev)
141 missing.add(rev)
142 if common:
142 if common:
143 self.addcommons(common)
143 self.addcommons(common)
144 if missing:
144 if missing:
145 self.addmissings(missing)
145 self.addmissings(missing)
146
146
147 def hasinfo(self):
147 def hasinfo(self):
148 """return True is we have any clue about the remote state"""
148 """return True is we have any clue about the remote state"""
149 return self._common.hasbases()
149 return self._common.hasbases()
150
150
151 def iscomplete(self):
151 def iscomplete(self):
152 """True if all the necessary data have been gathered"""
152 """True if all the necessary data have been gathered"""
153 return self._undecided is not None and not self._undecided
153 return self._undecided is not None and not self._undecided
154
154
155 @property
155 @property
156 def undecided(self):
156 def undecided(self):
157 if self._undecided is not None:
157 if self._undecided is not None:
158 return self._undecided
158 return self._undecided
159 self._undecided = set(self._common.missingancestors(self._targetheads))
159 self._undecided = set(self._common.missingancestors(self._targetheads))
160 return self._undecided
160 return self._undecided
161
161
162 def commonheads(self):
162 def commonheads(self):
163 """the heads of the known common set"""
163 """the heads of the known common set"""
164 # heads(common) == heads(common.bases) since common represents
164 # heads(common) == heads(common.bases) since common represents
165 # common.bases and all its ancestors
165 # common.bases and all its ancestors
166 return self._common.basesheads()
166 return self._common.basesheads()
167
167
168 def _parentsgetter(self):
168 def _parentsgetter(self):
169 getrev = self._repo.changelog.index.__getitem__
169 getrev = self._repo.changelog.index.__getitem__
170 def getparents(r):
170 def getparents(r):
171 return getrev(r)[5:6]
171 return getrev(r)[5:6]
172 return getparents
172 return getparents
173
173
174 def takequicksample(self, headrevs, size):
174 def takequicksample(self, headrevs, size):
175 """takes a quick sample of size <size>
175 """takes a quick sample of size <size>
176
176
177 It is meant for initial sampling and focuses on querying heads and close
177 It is meant for initial sampling and focuses on querying heads and close
178 ancestors of heads.
178 ancestors of heads.
179
179
180 :headrevs: set of head revisions in local DAG to consider
180 :headrevs: set of head revisions in local DAG to consider
181 :size: the maximum size of the sample"""
181 :size: the maximum size of the sample"""
182 revs = self.undecided
182 revs = self.undecided
183 if len(revs) <= size:
183 if len(revs) <= size:
184 return list(revs)
184 return list(revs)
185 sample = set(self._repo.revs('heads(%ld)', revs))
185 sample = set(self._repo.revs('heads(%ld)', revs))
186
186
187 if len(sample) >= size:
187 if len(sample) >= size:
188 return _limitsample(sample, size)
188 return _limitsample(sample, size)
189
189
190 _updatesample(None, headrevs, sample, self._parentsgetter(),
190 _updatesample(None, headrevs, sample, self._parentsgetter(),
191 quicksamplesize=size)
191 quicksamplesize=size)
192 return sample
192 return sample
193
193
194 def takefullsample(self, headrevs, size):
194 def takefullsample(self, headrevs, size):
195 revs = self.undecided
195 revs = self.undecided
196 if len(revs) <= size:
196 if len(revs) <= size:
197 return list(revs)
197 return list(revs)
198 repo = self._repo
198 repo = self._repo
199 sample = set(repo.revs('heads(%ld)', revs))
199 sample = set(repo.revs('heads(%ld)', revs))
200 parentrevs = self._parentsgetter()
200 parentrevs = self._parentsgetter()
201
201
202 # update from heads
202 # update from heads
203 revsheads = sample.copy()
203 revsheads = sample.copy()
204 _updatesample(revs, revsheads, sample, parentrevs)
204 _updatesample(revs, revsheads, sample, parentrevs)
205
205
206 # update from roots
206 # update from roots
207 revsroots = set(repo.revs('roots(%ld)', revs))
207 revsroots = set(repo.revs('roots(%ld)', revs))
208
208
209 # _updatesample() essentially does interaction over revisions to look
209 # _updatesample() essentially does interaction over revisions to look
210 # up their children. This lookup is expensive and doing it in a loop is
210 # up their children. This lookup is expensive and doing it in a loop is
211 # quadratic. We precompute the children for all relevant revisions and
211 # quadratic. We precompute the children for all relevant revisions and
212 # make the lookup in _updatesample() a simple dict lookup.
212 # make the lookup in _updatesample() a simple dict lookup.
213 #
213 #
214 # Because this function can be called multiple times during discovery,
214 # Because this function can be called multiple times during discovery,
215 # we may still perform redundant work and there is room to optimize
215 # we may still perform redundant work and there is room to optimize
216 # this by keeping a persistent cache of children across invocations.
216 # this by keeping a persistent cache of children across invocations.
217 children = {}
217 children = {}
218
218
219 for rev in sorted(revs):
219 for rev in sorted(revs):
220 # Always ensure revision has an entry so we don't need to worry
220 # Always ensure revision has an entry so we don't need to worry
221 # about missing keys.
221 # about missing keys.
222 children.setdefault(rev, [])
222 children[rev] = []
223
224 for prev in parentrevs(rev):
223 for prev in parentrevs(rev):
225 if prev == nullrev:
224 if prev == nullrev:
226 continue
225 continue
227
226 c = children.get(prev)
228 children.setdefault(prev, []).append(rev)
227 if c is not None:
228 c.append(rev)
229
229
230 _updatesample(revs, revsroots, sample, children.__getitem__)
230 _updatesample(revs, revsroots, sample, children.__getitem__)
231 assert sample
231 assert sample
232 sample = _limitsample(sample, size)
232 sample = _limitsample(sample, size)
233 if len(sample) < size:
233 if len(sample) < size:
234 more = size - len(sample)
234 more = size - len(sample)
235 sample.update(random.sample(list(revs - sample), more))
235 sample.update(random.sample(list(revs - sample), more))
236 return sample
236 return sample
237
237
238 def findcommonheads(ui, local, remote,
238 def findcommonheads(ui, local, remote,
239 initialsamplesize=100,
239 initialsamplesize=100,
240 fullsamplesize=200,
240 fullsamplesize=200,
241 abortwhenunrelated=True,
241 abortwhenunrelated=True,
242 ancestorsof=None):
242 ancestorsof=None):
243 '''Return a tuple (common, anyincoming, remoteheads) used to identify
243 '''Return a tuple (common, anyincoming, remoteheads) used to identify
244 missing nodes from or in remote.
244 missing nodes from or in remote.
245 '''
245 '''
246 start = util.timer()
246 start = util.timer()
247
247
248 roundtrips = 0
248 roundtrips = 0
249 cl = local.changelog
249 cl = local.changelog
250 clnode = cl.node
250 clnode = cl.node
251 clrev = cl.rev
251 clrev = cl.rev
252
252
253 if ancestorsof is not None:
253 if ancestorsof is not None:
254 ownheads = [clrev(n) for n in ancestorsof]
254 ownheads = [clrev(n) for n in ancestorsof]
255 else:
255 else:
256 ownheads = [rev for rev in cl.headrevs() if rev != nullrev]
256 ownheads = [rev for rev in cl.headrevs() if rev != nullrev]
257
257
258 # early exit if we know all the specified remote heads already
258 # early exit if we know all the specified remote heads already
259 ui.debug("query 1; heads\n")
259 ui.debug("query 1; heads\n")
260 roundtrips += 1
260 roundtrips += 1
261 sample = _limitsample(ownheads, initialsamplesize)
261 sample = _limitsample(ownheads, initialsamplesize)
262 # indices between sample and externalized version must match
262 # indices between sample and externalized version must match
263 sample = list(sample)
263 sample = list(sample)
264
264
265 with remote.commandexecutor() as e:
265 with remote.commandexecutor() as e:
266 fheads = e.callcommand('heads', {})
266 fheads = e.callcommand('heads', {})
267 fknown = e.callcommand('known', {
267 fknown = e.callcommand('known', {
268 'nodes': [clnode(r) for r in sample],
268 'nodes': [clnode(r) for r in sample],
269 })
269 })
270
270
271 srvheadhashes, yesno = fheads.result(), fknown.result()
271 srvheadhashes, yesno = fheads.result(), fknown.result()
272
272
273 if cl.tip() == nullid:
273 if cl.tip() == nullid:
274 if srvheadhashes != [nullid]:
274 if srvheadhashes != [nullid]:
275 return [nullid], True, srvheadhashes
275 return [nullid], True, srvheadhashes
276 return [nullid], False, []
276 return [nullid], False, []
277
277
278 # start actual discovery (we note this before the next "if" for
278 # start actual discovery (we note this before the next "if" for
279 # compatibility reasons)
279 # compatibility reasons)
280 ui.status(_("searching for changes\n"))
280 ui.status(_("searching for changes\n"))
281
281
282 knownsrvheads = [] # revnos of remote heads that are known locally
282 knownsrvheads = [] # revnos of remote heads that are known locally
283 for node in srvheadhashes:
283 for node in srvheadhashes:
284 if node == nullid:
284 if node == nullid:
285 continue
285 continue
286
286
287 try:
287 try:
288 knownsrvheads.append(clrev(node))
288 knownsrvheads.append(clrev(node))
289 # Catches unknown and filtered nodes.
289 # Catches unknown and filtered nodes.
290 except error.LookupError:
290 except error.LookupError:
291 continue
291 continue
292
292
293 if len(knownsrvheads) == len(srvheadhashes):
293 if len(knownsrvheads) == len(srvheadhashes):
294 ui.debug("all remote heads known locally\n")
294 ui.debug("all remote heads known locally\n")
295 return srvheadhashes, False, srvheadhashes
295 return srvheadhashes, False, srvheadhashes
296
296
297 if len(sample) == len(ownheads) and all(yesno):
297 if len(sample) == len(ownheads) and all(yesno):
298 ui.note(_("all local heads known remotely\n"))
298 ui.note(_("all local heads known remotely\n"))
299 ownheadhashes = [clnode(r) for r in ownheads]
299 ownheadhashes = [clnode(r) for r in ownheads]
300 return ownheadhashes, True, srvheadhashes
300 return ownheadhashes, True, srvheadhashes
301
301
302 # full blown discovery
302 # full blown discovery
303
303
304 disco = partialdiscovery(local, ownheads)
304 disco = partialdiscovery(local, ownheads)
305 # treat remote heads (and maybe own heads) as a first implicit sample
305 # treat remote heads (and maybe own heads) as a first implicit sample
306 # response
306 # response
307 disco.addcommons(knownsrvheads)
307 disco.addcommons(knownsrvheads)
308 disco.addinfo(zip(sample, yesno))
308 disco.addinfo(zip(sample, yesno))
309
309
310 full = False
310 full = False
311 progress = ui.makeprogress(_('searching'), unit=_('queries'))
311 progress = ui.makeprogress(_('searching'), unit=_('queries'))
312 while not disco.iscomplete():
312 while not disco.iscomplete():
313
313
314 if full or disco.hasinfo():
314 if full or disco.hasinfo():
315 if full:
315 if full:
316 ui.note(_("sampling from both directions\n"))
316 ui.note(_("sampling from both directions\n"))
317 else:
317 else:
318 ui.debug("taking initial sample\n")
318 ui.debug("taking initial sample\n")
319 samplefunc = disco.takefullsample
319 samplefunc = disco.takefullsample
320 targetsize = fullsamplesize
320 targetsize = fullsamplesize
321 else:
321 else:
322 # use even cheaper initial sample
322 # use even cheaper initial sample
323 ui.debug("taking quick initial sample\n")
323 ui.debug("taking quick initial sample\n")
324 samplefunc = disco.takequicksample
324 samplefunc = disco.takequicksample
325 targetsize = initialsamplesize
325 targetsize = initialsamplesize
326 sample = samplefunc(ownheads, targetsize)
326 sample = samplefunc(ownheads, targetsize)
327
327
328 roundtrips += 1
328 roundtrips += 1
329 progress.update(roundtrips)
329 progress.update(roundtrips)
330 ui.debug("query %i; still undecided: %i, sample size is: %i\n"
330 ui.debug("query %i; still undecided: %i, sample size is: %i\n"
331 % (roundtrips, len(disco.undecided), len(sample)))
331 % (roundtrips, len(disco.undecided), len(sample)))
332 # indices between sample and externalized version must match
332 # indices between sample and externalized version must match
333 sample = list(sample)
333 sample = list(sample)
334
334
335 with remote.commandexecutor() as e:
335 with remote.commandexecutor() as e:
336 yesno = e.callcommand('known', {
336 yesno = e.callcommand('known', {
337 'nodes': [clnode(r) for r in sample],
337 'nodes': [clnode(r) for r in sample],
338 }).result()
338 }).result()
339
339
340 full = True
340 full = True
341
341
342 disco.addinfo(zip(sample, yesno))
342 disco.addinfo(zip(sample, yesno))
343
343
344 result = disco.commonheads()
344 result = disco.commonheads()
345 elapsed = util.timer() - start
345 elapsed = util.timer() - start
346 progress.complete()
346 progress.complete()
347 ui.debug("%d total queries in %.4fs\n" % (roundtrips, elapsed))
347 ui.debug("%d total queries in %.4fs\n" % (roundtrips, elapsed))
348 msg = ('found %d common and %d unknown server heads,'
348 msg = ('found %d common and %d unknown server heads,'
349 ' %d roundtrips in %.4fs\n')
349 ' %d roundtrips in %.4fs\n')
350 missing = set(result) - set(knownsrvheads)
350 missing = set(result) - set(knownsrvheads)
351 ui.log('discovery', msg, len(result), len(missing), roundtrips,
351 ui.log('discovery', msg, len(result), len(missing), roundtrips,
352 elapsed)
352 elapsed)
353
353
354 if not result and srvheadhashes != [nullid]:
354 if not result and srvheadhashes != [nullid]:
355 if abortwhenunrelated:
355 if abortwhenunrelated:
356 raise error.Abort(_("repository is unrelated"))
356 raise error.Abort(_("repository is unrelated"))
357 else:
357 else:
358 ui.warn(_("warning: repository is unrelated\n"))
358 ui.warn(_("warning: repository is unrelated\n"))
359 return ({nullid}, True, srvheadhashes,)
359 return ({nullid}, True, srvheadhashes,)
360
360
361 anyincoming = (srvheadhashes != [nullid])
361 anyincoming = (srvheadhashes != [nullid])
362 result = {clnode(r) for r in result}
362 result = {clnode(r) for r in result}
363 return result, anyincoming, srvheadhashes
363 return result, anyincoming, srvheadhashes
General Comments 0
You need to be logged in to leave comments. Login now