Ticket #287: accept-late-buckets.darcspatch.txt

File accept-late-buckets.darcspatch.txt, 58.8 KB (added by zooko, at 2010-02-01T03:59:43Z)
Line 
11 patch for repository zooko@dev.allmydata.com:/home/darcs/tahoe/trunk:
2
3Sun Jan 31 20:53:26 MST 2010  zooko@zooko.com
4  * immutable: downloader accepts notifications of buckets even if those notifications arrive after he has begun downloading shares.
5  This can be useful if one of the ones that he has already begun downloading fails. See #287 for discussion. This fixes part of #287 which part was a regression caused by #928, namely this fixes fail-over in case a share is corrupted (or the server returns an error or disconnects). This does not fix the related issue mentioned in #287 if a server hangs and doesn't reply to requests for blocks.
6 
7
8New patches:
9
10[immutable: downloader accepts notifications of buckets even if those notifications arrive after he has begun downloading shares.
11zooko@zooko.com**20100201035326
12 Ignore-this: 933ae33e5c18dcf6e9590fc4bc13a21a
13 This can be useful if one of the ones that he has already begun downloading fails. See #287 for discussion. This fixes part of #287 which part was a regression caused by #928, namely this fixes fail-over in case a share is corrupted (or the server returns an error or disconnects). This does not fix the related issue mentioned in #287 if a server hangs and doesn't reply to requests for blocks.
14 
15] {
16hunk ./src/allmydata/immutable/download.py 792
17 
18         self.active_buckets = {} # k: shnum, v: bucket
19         self._share_buckets = {} # k: sharenum, v: list of buckets
20-        self._share_vbuckets = {} # k: shnum, v: set of ValidatedBuckets
21+
22+        # _download_all_segments() will set this to:
23+        # self._share_vbuckets = {} # k: shnum, v: set of ValidatedBuckets
24+        self._share_vbuckets = None
25 
26         self._fetch_failures = {"uri_extension": 0, "crypttext_hash_tree": 0, }
27 
28hunk ./src/allmydata/immutable/download.py 815
29         # self._responses_received = 0
30         # self._queries_failed = 0
31 
32+        # This is solely for the use of unit tests. It will be triggered when
33+        # we start downloading shares.
34+        self._stage_4_d = defer.Deferred()
35+
36     def pauseProducing(self):
37         if self._paused:
38             return
39hunk ./src/allmydata/immutable/download.py 948
40                 reactor.callLater(0, self._wait_for_enough_buckets_d.callback, True)
41                 self._wait_for_enough_buckets_d = None
42 
43+            if self._share_vbuckets is not None:
44+                for bucket in buckets:
45+                    vbucket = ValidatedReadBucketProxy(sharenum, bucket, self._share_hash_tree, self._vup.num_segments, self._vup.block_size, self._vup.share_size)
46+                    self._share_vbuckets.setdefault(sharenum, set()).add(vbucket)
47+
48             if self._results:
49                 if peerid not in self._results.servermap:
50                     self._results.servermap[peerid] = set()
51hunk ./src/allmydata/immutable/download.py 1103
52 
53 
54     def _download_all_segments(self, res):
55+        # From now on if new buckets are received then I will notice that
56+        # self._share_vbuckets is not None and generate a vbucket for that new
57+        # bucket and add it in to _share_vbuckets. (We had to wait because we
58+        # didn't have self._vup and self._share_hash_tree earlier. We didn't
59+        # need validated buckets until now -- now that we are ready to download
60+        # shares.)
61+        self._share_vbuckets = {}
62         for sharenum, buckets in self._share_buckets.iteritems():
63             for bucket in buckets:
64                 vbucket = ValidatedReadBucketProxy(sharenum, bucket, self._share_hash_tree, self._vup.num_segments, self._vup.block_size, self._vup.share_size)
65hunk ./src/allmydata/immutable/download.py 1131
66             # this pause, at the end of write, prevents pre-fetch from
67             # happening until the consumer is ready for more data.
68             d.addCallback(self._check_for_pause)
69+
70+        self._stage_4_d.callback(None)
71         return d
72 
73     def _check_for_pause(self, res):
74hunk ./src/allmydata/test/no_network.py 255
75 
76     def break_server(self, serverid):
77         # mark the given server as broken, so it will throw exceptions when
78-        # asked to hold a share
79+        # asked to hold a share or serve a share
80         self.servers_by_id[serverid].broken = True
81 
82     def hang_server(self, serverid, until=defer.Deferred()):
83hunk ./src/allmydata/test/no_network.py 259
84-        # hang the given server until 'until' fires
85-        self.servers_by_id[serverid].hung_until = until
86+        # hang the given server
87+        ss = self.servers_by_id[serverid]
88+        assert ss.hung_until is None
89+        ss.hung_until = until
90+
91+    def unhang_server(self, serverid):
92+        # unhang the given server
93+        ss = self.servers_by_id[serverid]
94+        assert ss.hung_until is not None
95+        ss.hung_until.callback(None)
96+        ss.hung_until = None
97 
98 
99 class GridTestMixin:
100hunk ./src/allmydata/test/test_hung_server.py 11
101 from allmydata.mutable.common import UnrecoverableFileError
102 from allmydata.storage.common import storage_index_to_dir
103 from allmydata.test.no_network import GridTestMixin
104-from allmydata.test.common import ShouldFailMixin
105+from allmydata.test.common import ShouldFailMixin, _corrupt_share_data
106 from allmydata.interfaces import NotEnoughSharesError
107 
108 immutable_plaintext = "data" * 10000
109hunk ./src/allmydata/test/test_hung_server.py 28
110         for (id, ss) in servers:
111             self.g.hang_server(id, **kwargs)
112 
113+    def _unhang(self, servers, **kwargs):
114+        for (id, ss) in servers:
115+            self.g.unhang_server(id, **kwargs)
116+
117     def _delete_all_shares_from(self, servers):
118         serverids = [id for (id, ss) in servers]
119         for (i_shnum, i_serverid, i_sharefile) in self.shares:
120hunk ./src/allmydata/test/test_hung_server.py 38
121             if i_serverid in serverids:
122                 os.unlink(i_sharefile)
123 
124+    def _corrupt_all_shares_in(self, servers, corruptor_func):
125+        serverids = [id for (id, ss) in servers]
126+        for (i_shnum, i_serverid, i_sharefile) in self.shares:
127+            if i_serverid in serverids:
128+                self._corrupt_share((i_shnum, i_sharefile), corruptor_func)
129+
130     def _copy_all_shares_from(self, from_servers, to_server):
131         serverids = [id for (id, ss) in from_servers]
132         for (i_shnum, i_serverid, i_sharefile) in self.shares:
133hunk ./src/allmydata/test/test_hung_server.py 65
134          self.failUnless((sharenum, ss.original.my_nodeid, new_sharefile)
135                          in self.shares)
136 
137+    def _corrupt_share(self, share, corruptor_func):
138+        (sharenum, sharefile) = share
139+        data = open(sharefile, "rb").read()
140+        newdata = corruptor_func(data)
141+        os.unlink(sharefile)
142+        wf = open(sharefile, "wb")
143+        wf.write(newdata)
144+        wf.close()
145+
146     def _set_up(self, mutable, testdir, num_clients=1, num_servers=10):
147         self.mutable = mutable
148         if mutable:
149hunk ./src/allmydata/test/test_hung_server.py 102
150             d.addCallback(_uploaded_immutable)
151         return d
152 
153-    def _check_download(self):
154+    def _start_download(self):
155         n = self.c0.create_node_from_uri(self.uri)
156         if self.mutable:
157             d = n.download_best_version()
158hunk ./src/allmydata/test/test_hung_server.py 106
159-            expected_plaintext = mutable_plaintext
160+            stage_4_d = None # currently we aren't doing any tests which require this for mutable files
161+        else:
162+            d = download_to_data(n)
163+            stage_4_d = n._downloader._all_downloads.keys()[0]._stage_4_d # too ugly! FIXME
164+        return (d, stage_4_d,)
165+
166+    def _wait_for_data(self, n):
167+        if self.mutable:
168+            d = n.download_best_version()
169         else:
170             d = download_to_data(n)
171hunk ./src/allmydata/test/test_hung_server.py 117
172-            expected_plaintext = immutable_plaintext
173-        def _got_data(data):
174-            self.failUnlessEqual(data, expected_plaintext)
175-        d.addCallback(_got_data)
176+        return d
177+
178+    def _check(self, resultingdata):
179+        if self.mutable:
180+            self.failUnlessEqual(resultingdata, mutable_plaintext)
181+        else:
182+            self.failUnlessEqual(resultingdata, immutable_plaintext)
183+
184+    def _download_and_check(self):
185+        d, stage4d = self._start_download()
186+        d.addCallback(self._check)
187         return d
188 
189     def _should_fail_download(self):
190hunk ./src/allmydata/test/test_hung_server.py 134
191         if self.mutable:
192             return self.shouldFail(UnrecoverableFileError, self.basedir,
193                                    "no recoverable versions",
194-                                   self._check_download)
195+                                   self._download_and_check)
196         else:
197             return self.shouldFail(NotEnoughSharesError, self.basedir,
198                                    "Failed to get enough shareholders",
199hunk ./src/allmydata/test/test_hung_server.py 138
200-                                   self._check_download)
201+                                   self._download_and_check)
202 
203 
204     def test_10_good_sanity_check(self):
205hunk ./src/allmydata/test/test_hung_server.py 145
206         d = defer.succeed(None)
207         for mutable in [False, True]:
208             d.addCallback(lambda ign: self._set_up(mutable, "test_10_good_sanity_check"))
209-            d.addCallback(lambda ign: self._check_download())
210+            d.addCallback(lambda ign: self._download_and_check())
211         return d
212 
213     def test_10_good_copied_share(self):
214hunk ./src/allmydata/test/test_hung_server.py 153
215         for mutable in [False, True]:
216             d.addCallback(lambda ign: self._set_up(mutable, "test_10_good_copied_share"))
217             d.addCallback(lambda ign: self._copy_all_shares_from(self.servers[2:3], self.servers[0]))
218-            d.addCallback(lambda ign: self._check_download())
219+            d.addCallback(lambda ign: self._download_and_check())
220             return d
221 
222     def test_3_good_7_noshares(self):
223hunk ./src/allmydata/test/test_hung_server.py 161
224         for mutable in [False, True]:
225             d.addCallback(lambda ign: self._set_up(mutable, "test_3_good_7_noshares"))
226             d.addCallback(lambda ign: self._delete_all_shares_from(self.servers[3:]))
227-            d.addCallback(lambda ign: self._check_download())
228+            d.addCallback(lambda ign: self._download_and_check())
229         return d
230 
231     def test_2_good_8_broken_fail(self):
232hunk ./src/allmydata/test/test_hung_server.py 186
233             d.addCallback(lambda ign: self._set_up(mutable, "test_2_good_8_broken_copied_share"))
234             d.addCallback(lambda ign: self._copy_all_shares_from(self.servers[2:3], self.servers[0]))
235             d.addCallback(lambda ign: self._break(self.servers[2:]))
236-            d.addCallback(lambda ign: self._check_download())
237+            d.addCallback(lambda ign: self._download_and_check())
238         return d
239 
240     def test_2_good_8_broken_duplicate_share_fail(self):
241hunk ./src/allmydata/test/test_hung_server.py 205
242         for mutable in [False]:
243             d.addCallback(lambda ign: self._set_up(mutable, "test_3_good_7_hung"))
244             d.addCallback(lambda ign: self._hang(self.servers[3:]))
245-            d.addCallback(lambda ign: self._check_download())
246+            d.addCallback(lambda ign: self._download_and_check())
247         return d
248 
249     def test_2_good_8_hung_then_1_recovers(self):
250hunk ./src/allmydata/test/test_hung_server.py 213
251         for mutable in [False]:
252             recovered = defer.Deferred()
253             d.addCallback(lambda ign: self._set_up(mutable, "test_2_good_8_hung_then_1_recovers"))
254-            d.addCallback(lambda ign: self._hang(self.servers[2:3], until=recovered))
255+            d.addCallback(lambda ign: self._hang(self.servers[2:3]))
256             d.addCallback(lambda ign: self._hang(self.servers[3:]))
257hunk ./src/allmydata/test/test_hung_server.py 215
258-            d.addCallback(lambda ign: reactor.callLater(5, recovered.callback, None))
259-            d.addCallback(lambda ign: self._check_download())
260+            d.addCallback(lambda ign: self._unhang(self.servers[2:3]))
261+            d.addCallback(lambda ign: self._download_and_check())
262         return d
263 
264     def test_2_good_8_hung_then_1_recovers_with_2_shares(self):
265hunk ./src/allmydata/test/test_hung_server.py 225
266             recovered = defer.Deferred()
267             d.addCallback(lambda ign: self._set_up(mutable, "test_2_good_8_hung_then_1_recovers_with_2_shares"))
268             d.addCallback(lambda ign: self._copy_all_shares_from(self.servers[0:1], self.servers[2]))
269-            d.addCallback(lambda ign: self._hang(self.servers[2:3], until=recovered))
270+            d.addCallback(lambda ign: self._hang(self.servers[2:3]))
271+            d.addCallback(lambda ign: self._hang(self.servers[3:]))
272+            d.addCallback(lambda ign: self._unhang(self.servers[2:3]))
273+            d.addCallback(lambda ign: self._download_and_check())
274+        return d
275+
276+    def test_failover_during_stage_4(self):
277+        # See #287
278+        d = defer.succeed(None)
279+        for mutable in [False]:
280+            recovered = defer.Deferred()
281+            d.addCallback(lambda ign: self._set_up(mutable, "test_failover_during_stage_4"))
282+            d.addCallback(lambda ign: self._corrupt_all_shares_in(self.servers[2:3], _corrupt_share_data))
283+            d.addCallback(lambda ign: self._set_up(mutable, "test_failover_during_stage_4"))
284             d.addCallback(lambda ign: self._hang(self.servers[3:]))
285hunk ./src/allmydata/test/test_hung_server.py 240
286-            d.addCallback(lambda ign: reactor.callLater(5, recovered.callback, None))
287-            d.addCallback(lambda ign: self._check_download())
288+            d.addCallback(lambda ign: self._start_download())
289+            def _after_starting_download((doned, started4d)):
290+                started4d.addCallback(lambda ign: self._unhang(self.servers[3:4]))
291+                doned.addCallback(self._check)
292+                return doned
293+            d.addCallback(_after_starting_download)
294+
295         return d
296}
297
298Context:
299
300[Improvements to test_unknownnode to cover invalid cap URIs with known prefixes
301david-sarah@jacaranda.org**20100130063908
302 Ignore-this: e1a298942c21207473e418ea5efd6276
303]
304[Fix invalid trailing commas in JSON example
305david-sarah@jacaranda.org**20100129201742
306 Ignore-this: d99e0a8ead4fafabf39a1daf11ec450b
307]
308[Improvements to test_hung_server, and fix for status updates in download.py
309david-sarah@jacaranda.org**20100130064303
310 Ignore-this: dd889c643afdcf0f86d55855aafda6ad
311]
312[immutable: fix bug in tests, change line-endings to unix style, add comment
313zooko@zooko.com**20100129184237
314 Ignore-this: f6bd875fe974c55c881e05eddf8d3436
315]
316[New tests for #928
317david-sarah@jacaranda.org**20100129123845
318 Ignore-this: 5c520f40141f0d9c000ffb05a4698995
319]
320[immutable: download from the first servers which provide at least K buckets instead of waiting for all servers to reply
321zooko@zooko.com**20100127233417
322 Ignore-this: c855355a40d96827e1d0c469a8d8ab3f
323 This should put an end to the phenomenon I've been seeing that a single hung server can cause all downloads on a grid to hang.  Also it should speed up all downloads by (a) not-waiting for responses to queries that it doesn't need, and (b) downloading shares from the servers which answered the initial query the fastest.
324 Also, do not count how many buckets you've gotten when deciding whether the download has enough shares or not -- instead count how many buckets to *unique* shares that you've gotten.  This appears to improve a slightly weird behavior in the current download code in which receiving >= K different buckets all to the same sharenumber would make it think it had enough to download the file when in fact it hadn't.
325 This patch needs tests before it is actually ready for trunk.
326]
327[Eliminate 'foo if test else bar' syntax that isn't supported by Python 2.4
328david-sarah@jacaranda.org**20100129035210
329 Ignore-this: 70eafd487b4b6299beedd63b4a54a0c
330]
331[Fix example JSON in webapi.txt that cannot occur in practice
332david-sarah@jacaranda.org**20100129032742
333 Ignore-this: 361a1ba663d77169aeef93caef870097
334]
335[Add mutable field to t=json output for unknown nodes, when mutability is known
336david-sarah@jacaranda.org**20100129031424
337 Ignore-this: 1516d63559bdfeb6355485dff0f5c04e
338]
339[Show -IMM and -RO suffixes for types of immutable and read-only unknown nodes in directory listings
340david-sarah@jacaranda.org**20100128220800
341 Ignore-this: dc5c17c0a566398f88e4303c41321e66
342]
343[Fix inaccurate comment in test_mutant_dirnodes_are_omitted
344david-sarah@jacaranda.org**20100128202456
345 Ignore-this: 9fa17ed7feac9e4d084f1b2338c76fca
346]
347[docs: update relnotes.txt for Tahoe-LAFS v1.6
348zooko@zooko.com**20100128171257
349 Ignore-this: 920df92152aead69ef861b9b2e8ff218
350]
351[Address comments by Kevan on 833 and add test for stripping spaces
352david-sarah@jacaranda.org**20100127230642
353 Ignore-this: de36aeaf4afb3ba05dbeb49a5e9a6b26
354]
355[Miscellaneous documentation, test, and code formatting tweaks.
356david-sarah@jacaranda.org**20100127070309
357 Ignore-this: 84ca7e4bb7c64221ae2c61144ef5edef
358]
359[Prevent mutable objects from being retrieved from an immutable directory, and associated forward-compatibility improvements.
360david-sarah@jacaranda.org**20100127064430
361 Ignore-this: 5ef6a3554cf6bef0bf0712cc7d6c0252
362]
363[test_runner: cleanup, refactor common code into a non-executable method
364Brian Warner <warner@lothar.com>**20100127224040
365 Ignore-this: 4cb4aada87777771f688edfd8129ffca
366 
367 Having both test_node() and test_client() (one of which calls the other) felt
368 confusing to me, so I changed it to have test_node(), test_client(), and a
369 common do_create() helper method.
370]
371[scripts/runner.py: simplify David-Sarah's clever grouped-commands usage trick
372Brian Warner <warner@lothar.com>**20100127223758
373 Ignore-this: 70877ebf06ae59f32960b0aa4ce1d1ae
374]
375[tahoe backup: skip all symlinks, with warning. Fixes #850, addresses #641.
376Brian Warner <warner@lothar.com>**20100127223517
377 Ignore-this: ab5cf05158d32a575ca8efc0f650033f
378]
379[NEWS: update with all recent user-visible changes
380Brian Warner <warner@lothar.com>**20100127222209
381 Ignore-this: 277d24568018bf4f3fb7736fda64eceb
382]
383["tahoe backup": fix --exclude-vcs docs to include Git
384Brian Warner <warner@lothar.com>**20100127201044
385 Ignore-this: 756a58dde21bdc65aa62b81803605b5
386]
387[docs: fix references to --no-storage, explanation of [storage] section
388Brian Warner <warner@lothar.com>**20100127200956
389 Ignore-this: f4be1763a585e1ac6299a4f1b94a59e0
390]
391[docs: further CREDITS level-ups for Nils, Kevan, David-Sarah
392zooko@zooko.com**20100126170021
393 Ignore-this: 1e513e85cf7b7abf57f056e6d7544b38
394]
395[Patch to accept t=set-children as well as t=set_children
396david-sarah@jacaranda.org**20100124030020
397 Ignore-this: 2c061f12af817cdf77feeeb64098ec3a
398]
399[Fix boodlegrid use of set_children
400david-sarah@jacaranda.org**20100126063414
401 Ignore-this: 3aa2d4836f76303b2bacecd09611f999
402]
403[ftpd: clearer error message if Twisted needs a patch (by Nils Durner)
404zooko@zooko.com**20100126143411
405 Ignore-this: 440e6831ae6da5135c1edd081c93871f
406]
407[Add 'docs/performance.txt', which (for the moment) describes mutable file performance issues
408Kevan Carstensen <kevan@isnotajoke.com>**20100115204500
409 Ignore-this: ade4e500217db2509aee35aacc8c5dbf
410]
411[docs: more CREDITS for François, Kevan, and David-Sarah
412zooko@zooko.com**20100126132133
413 Ignore-this: f37d4977c13066fcac088ba98a31b02e
414]
415[tahoe_backup.py: display warnings on errors instead of stopping the whole backup. Fix #729.
416francois@ctrlaltdel.ch**20100120094249
417 Ignore-this: 7006ea4b0910b6d29af6ab4a3997a8f9
418 
419 This patch displays a warning to the user in two cases:
420   
421   1. When special files like symlinks, fifos, devices, etc. are found in the
422      local source.
423   
424   2. If files or directories are not readables by the user running the 'tahoe
425      backup' command.
426 
427 In verbose mode, the number of skipped files and directories is printed at the
428 end of the backup.
429 
430 Exit status returned by 'tahoe backup':
431 
432   - 0 everything went fine
433   - 1 the backup failed
434   - 2 files were skipped during the backup
435 
436]
437[Warn about test failures due to setting FLOG* env vars
438david-sarah@jacaranda.org**20100124220629
439 Ignore-this: 1c25247ca0f0840390a1b7259a9f4a3c
440]
441[Message saying that we couldn't find bin/tahoe should say where we looked
442david-sarah@jacaranda.org**20100116204556
443 Ignore-this: 1068576fd59ea470f1e19196315d1bb
444]
445[Change running.html to describe 'tahoe run'
446david-sarah@jacaranda.org**20100112044409
447 Ignore-this: 23ad0114643ce31b56e19bb14e011e4f
448]
449[cli: merge the better version of David-Sarah's split-usage-and-help patch with the earlier version that I mistakenly committed
450zooko@zooko.com**20100126044559
451 Ignore-this: 284d188e13b7901013cbb650168e6447
452]
453[Split tahoe --help options into groups.
454david-sarah@jacaranda.org**20100112043935
455 Ignore-this: 610f9c41b00e6863e3cd047379733e3a
456]
457[cli: split usage strings into groups (patch by David-Sarah Hopwood)
458zooko@zooko.com**20100126043921
459 Ignore-this: 51928d266a7292b873f87f7d53c9a01e
460]
461[Add create-node CLI command, and make create-client equivalent to create-node --no-storage (fixes #760)
462david-sarah@jacaranda.org**20100116052055
463 Ignore-this: 47d08b18c69738685e13ff365738d5a
464]
465[Remove replace= parameter to mkdir-immutable and mkdir-with-children
466david-sarah@jacaranda.org**20100124224325
467 Ignore-this: 25207bcc946c0c43d9528718e76ba7b
468]
469[contrib/fuse/runtests.py: Fix #888, configure settings in tahoe.cfg and don't treat warnings as failure
470francois@ctrlaltdel.ch**20100109123010
471 Ignore-this: 2590d44044acd7dfa3690c416cae945c
472 
473 Fix a few bitrotten pieces in the FUSE test script.  It now configures tahoe
474 node settings by editing tahoe.cfg which is the new supported method.
475 
476 It alos tolerate warnings issued by the mount command, the cause of these
477 warnings is the same as in #876 (contrib/fuse/runtests.py doesn't tolerate
478 deprecations warnings).
479 
480]
481[Fix webapi t=mkdir with multpart/form-data, as on the Welcome page. Closes #919.
482Brian Warner <warner@lothar.com>**20100121065052
483 Ignore-this: 1f20ea0a0f1f6d6c1e8e14f193a92c87
484]
485[tahoe_add_alias.py: minor refactoring
486Brian Warner <warner@lothar.com>**20100115064220
487 Ignore-this: 29910e81ad11209c9e493d65fd2dab9b
488]
489[test_dirnode.py: reduce scope of a Client instance, suggested by Kevan.
490Brian Warner <warner@lothar.com>**20100115062713
491 Ignore-this: b35efd9e6027e43de6c6f509bfb4ccaa
492]
493[test_provisioning: STAN is not always a list. Fix by David-Sarah Hopwood.
494Brian Warner <warner@lothar.com>**20100115014632
495 Ignore-this: 9989de7f1e00907706d2b63153138219
496]
497[web/directory.py mkdir-immutable: hush pyflakes, add TODO for #903 behavior
498Brian Warner <warner@lothar.com>**20100114222804
499 Ignore-this: 717cd3b9a1c8aeee76938c9641db7356
500]
501[hush pyflakes-0.4.0 warnings: slightly less-trivial fixes. Closes #900.
502Brian Warner <warner@lothar.com>**20100114221719
503 Ignore-this: f774f4637e256ad55502659413a811a8
504 
505 This includes one fix (in test_web) which was testing the wrong thing.
506]
507[hush pyflakes-0.4.0 warnings: remove trivial unused variables. For #900.
508Brian Warner <warner@lothar.com>**20100114221529
509 Ignore-this: e96106c8f1a99fbf93306fbfe9a294cf
510]
511[tahoe add-alias/create-alias: don't corrupt non-newline-terminated alias
512Brian Warner <warner@lothar.com>**20100114210246
513 Ignore-this: 9c994792e53a85159d708760a9b1b000
514 file. Closes #741.
515]
516[change docs and --help to use "grid" instead of "virtual drive": closes #892.
517Brian Warner <warner@lothar.com>**20100114201119
518 Ignore-this: a20d4a4dcc4de4e3b404ff72d40fc29b
519 
520 Thanks to David-Sarah Hopwood for the patch.
521]
522[backupdb.txt: fix ST_CTIME reference
523Brian Warner <warner@lothar.com>**20100114194052
524 Ignore-this: 5a189c7a1181b07dd87f0a08ea31b6d3
525]
526[client.py: fix/update comments on KeyGenerator
527Brian Warner <warner@lothar.com>**20100113004226
528 Ignore-this: 2208adbb3fd6a911c9f44e814583cabd
529]
530[Clean up log.err calls, for one of the issues in #889.
531Brian Warner <warner@lothar.com>**20100112013343
532 Ignore-this: f58455ce15f1fda647c5fb25d234d2db
533 
534 allmydata.util.log.err() either takes a Failure as the first positional
535 argument, or takes no positional arguments and must be invoked in an
536 exception handler. Fixed its signature to match both foolscap.logging.log.err
537 and twisted.python.log.err . Included a brief unit test.
538]
539[tidy up DeadReferenceError handling, ignore them in add_lease calls
540Brian Warner <warner@lothar.com>**20100112000723
541 Ignore-this: 72f1444e826fd0b9db6d318f89603c38
542 
543 Stop checking separately for ConnectionDone/ConnectionLost, since those have
544 been folded into DeadReferenceError since foolscap-0.3.1 . Write
545 rrefutil.trap_deadref() in terms of rrefutil.trap_and_discard() to improve
546 code coverage.
547]
548[NEWS: improve "tahoe backup" notes, mention first-backup-after-upgrade duration
549Brian Warner <warner@lothar.com>**20100111190132
550 Ignore-this: 10347c590b3375964579ba6c2b0edb4f
551 
552 Thanks to Francois Deppierraz for the suggestion.
553]
554[test_repairer: add (commented-out) test_each_byte, to see exactly what the
555Brian Warner <warner@lothar.com>**20100110203552
556 Ignore-this: 8e84277d5304752edeff052b97821815
557 Verifier misses
558 
559 The results (described in #819) match our expectations: it misses corruption
560 in unused share fields and in most container fields (which are only visible
561 to the storage server, not the client). 1265 bytes of a 2753 byte
562 share (hosting a 56-byte file with an artifically small segment size) are
563 unused, mostly in the unused tail of the overallocated UEB space (765 bytes),
564 and the allocated-but-unwritten plaintext_hash_tree (480 bytes).
565]
566[repairer: fix some wrong offsets in the randomized verifier tests, debugged by Brian
567zooko@zooko.com**20100110203721
568 Ignore-this: 20604a609db8706555578612c1c12feb
569 fixes #819
570]
571[test_repairer: fix colliding basedir names, which caused test inconsistencies
572Brian Warner <warner@lothar.com>**20100110084619
573 Ignore-this: b1d56dd27e6ab99a7730f74ba10abd23
574]
575[contrib/fuse/runtests.py: Tolerate the tahoe CLI returning deprecation warnings
576francois@ctrlaltdel.ch**20100109175946
577 Ignore-this: 419c354d9f2f6eaec03deb9b83752aee
578 
579 Depending on the versions of external libraries such as Twisted of Foolscap,
580 the tahoe CLI can display deprecation warnings on stdout.  The tests should
581 not interpret those warnings as a failure if the node is in fact correctly
582 started.
583   
584 See http://allmydata.org/trac/tahoe/ticket/859 for an example of deprecation
585 warnings.
586 
587 fixes #876
588]
589[contrib: fix fuse_impl_c to use new Python API
590zooko@zooko.com**20100109174956
591 Ignore-this: 51ca1ec7c2a92a0862e9b99e52542179
592 original patch by Thomas Delaet, fixed by François, reviewed by Brian, committed by me
593]
594[repairer: add deterministic test for #819, mark as TODO
595zooko@zooko.com**20100110013619
596 Ignore-this: 4cb8bb30b25246de58ed2b96fa447d68
597]
598[docs: CREDITS: add David-Sarah to the CREDITS file
599zooko@zooko.com**20100109060435
600 Ignore-this: 896062396ad85f9d2d4806762632f25a
601]
602[mutable/publish: don't loop() right away upon DeadReferenceError. Closes #877
603Brian Warner <warner@lothar.com>**20100102220841
604 Ignore-this: b200e707b3f13aa8251981362b8a3e61
605 
606 The bug was that a disconnected server could cause us to re-enter the initial
607 loop() call, sending multiple queries to a single server, provoking an
608 incorrect UCWE. To fix it, stall the loop() with an eventual.fireEventually()
609]
610[immutable/checker.py: oops, forgot some imports. Also hush pyflakes.
611Brian Warner <warner@lothar.com>**20091229233909
612 Ignore-this: 4d61bd3f8113015a4773fd4768176e51
613]
614[mutable repair: return successful=False when numshares<k (thus repair fails),
615Brian Warner <warner@lothar.com>**20091229233746
616 Ignore-this: d881c3275ff8c8bee42f6a80ca48441e
617 instead of weird errors. Closes #874 and #786.
618 
619 Previously, if the file had 0 shares, this would raise TypeError as it tried
620 to call download_version(None). If the file had some shares but fewer than
621 'k', it would incorrectly raise MustForceRepairError.
622 
623 Added get_successful() to the IRepairResults API, to give repair() a place to
624 report non-code-bug problems like this.
625]
626[node.py/interfaces.py: minor docs fixes
627Brian Warner <warner@lothar.com>**20091229230409
628 Ignore-this: c86ad6342ef0f95d50639b4f99cd4ddf
629]
630[NEWS: fix 1.4.1 announcement w.r.t. add-lease behavior in older releases
631Brian Warner <warner@lothar.com>**20091229230310
632 Ignore-this: bbbbb9c961f3bbcc6e5dbe0b1594822
633]
634[checker: don't let failures in add-lease affect checker results. Closes #875.
635Brian Warner <warner@lothar.com>**20091229230108
636 Ignore-this: ef1a367b93e4d01298c2b1e6ca59c492
637 
638 Mutable servermap updates and the immutable checker, when run with
639 add_lease=True, send both the do-you-have-block and add-lease commands in
640 parallel, to avoid an extra round trip time. Many older servers have problems
641 with add-lease and raise various exceptions, which don't generally matter.
642 The client-side code was catching+ignoring some of them, but unrecognized
643 exceptions were passed through to the DYHB code, concealing the DYHB results
644 from the checker, making it think the server had no shares.
645 
646 The fix is to separate the code paths. Both commands are sent at the same
647 time, but the errback path from add-lease is handled separately. Known
648 exceptions are ignored, the others (both unknown-remote and all-local) are
649 logged (log.WEIRD, which will trigger an Incident), but neither will affect
650 the DYHB results.
651 
652 The add-lease message is sent first, and we know that the server handles them
653 synchronously. So when the checker is done, we can be sure that all the
654 add-lease messages have been retired. This makes life easier for unit tests.
655]
656[test_cli: verify fix for "tahoe get" not creating empty file on error (#121)
657Brian Warner <warner@lothar.com>**20091227235444
658 Ignore-this: 6444d52413b68eb7c11bc3dfdc69c55f
659]
660[addendum to "Fix 'tahoe ls' on files (#771)"
661Brian Warner <warner@lothar.com>**20091227232149
662 Ignore-this: 6dd5e25f8072a3153ba200b7fdd49491
663 
664 tahoe_ls.py: tolerate missing metadata
665 web/filenode.py: minor cleanups
666 test_cli.py: test 'tahoe ls FILECAP'
667]
668[Fix 'tahoe ls' on files (#771). Patch adapted from Kevan Carstensen.
669Brian Warner <warner@lothar.com>**20091227225443
670 Ignore-this: 8bf8c7b1cd14ea4b0ebd453434f4fe07
671 
672 web/filenode.py: also serve edge metadata when using t=json on a
673                  DIRCAP/childname object.
674 tahoe_ls.py: list file objects as if we were listing one-entry directories.
675              Show edge metadata if we have it, which will be true when doing
676              'tahoe ls DIRCAP/filename' and false when doing 'tahoe ls
677              FILECAP'
678]
679[tahoe_get: don't create the output file on error. Closes #121.
680Brian Warner <warner@lothar.com>**20091227220404
681 Ignore-this: 58d5e793a77ec6e87d9394ade074b926
682]
683[webapi: don't accept zero-length childnames during traversal. Closes #358, #676.
684Brian Warner <warner@lothar.com>**20091227201043
685 Ignore-this: a9119dec89e1c7741f2289b0cad6497b
686 
687 This forbids operations that would implicitly create a directory with a
688 zero-length (empty string) name, like what you'd get if you did "tahoe put
689 local /oops/blah" (#358) or "POST /uri/CAP//?t=mkdir" (#676). The error
690 message is fairly friendly too.
691 
692 Also added code to "tahoe put" to catch this error beforehand and suggest the
693 correct syntax (i.e. without the leading slash).
694]
695[CLI: send 'Accept:' header to ask for text/plain tracebacks. Closes #646.
696Brian Warner <warner@lothar.com>**20091227195828
697 Ignore-this: 44c258d4d4c7dac0ed58adb22f73331
698 
699 The webapi has been looking for an Accept header since 1.4.0, but it treats a
700 missing header as equal to */* (to honor RFC2616). This change finally
701 modifies our CLI tools to ask for "text/plain, application/octet-stream",
702 which seems roughly correct (we either want a plain-text traceback or error
703 message, or an uninterpreted chunk of binary data to save to disk). Some day
704 we'll figure out how JSON fits into this scheme.
705]
706[Makefile: upload-tarballs: switch from xfer-client to flappclient, closes #350
707Brian Warner <warner@lothar.com>**20091227163703
708 Ignore-this: 3beeecdf2ad9c2438ab57f0e33dcb357
709 
710 I've also set up a new flappserver on source@allmydata.org to receive the
711 tarballs. We still need to replace the gutsy buildslave (which is where the
712 tarballs used to be generated+uploaded) and give it the new FURL.
713]
714[misc/ringsim.py: make it deterministic, more detail about grid-is-full behavior
715Brian Warner <warner@lothar.com>**20091227024832
716 Ignore-this: a691cc763fb2e98a4ce1767c36e8e73f
717]
718[misc/ringsim.py: tool to discuss #302
719Brian Warner <warner@lothar.com>**20091226060339
720 Ignore-this: fc171369b8f0d97afeeb8213e29d10ed
721]
722[docs: fix helper.txt to describe new config style
723zooko@zooko.com**20091224223522
724 Ignore-this: 102e7692dc414a4b466307f7d78601fe
725]
726[docs/stats.txt: add TOC, notes about controlling gatherer's listening port
727Brian Warner <warner@lothar.com>**20091224202133
728 Ignore-this: 8eef63b0e18db5aa8249c2eafde02c05
729 
730 Thanks to Jody Harris for the suggestions.
731]
732[Add docs/stats.py, explaining Tahoe stats, the gatherer, and the munin plugins.
733Brian Warner <warner@lothar.com>**20091223052400
734 Ignore-this: 7c9eeb6e5644eceda98b59a67730ccd5
735]
736[more #859: avoid deprecation warning for unit tests too, hush pyflakes
737Brian Warner <warner@lothar.com>**20091215000147
738 Ignore-this: 193622e24d31077da825a11ed2325fd3
739 
740 * factor maybe-import-sha logic into util.hashutil
741]
742[use hashlib module if available, thus avoiding a DeprecationWarning for importing the old sha module; fixes #859
743zooko@zooko.com**20091214212703
744 Ignore-this: 8d0f230a4bf8581dbc1b07389d76029c
745]
746[docs: reflow architecture.txt to 78-char lines
747zooko@zooko.com**20091208232943
748 Ignore-this: 88f55166415f15192e39407815141f77
749]
750[mutable/retrieve.py: stop reaching into private MutableFileNode attributes
751Brian Warner <warner@lothar.com>**20091208172921
752 Ignore-this: 61e548798c1105aed66a792bf26ceef7
753]
754[mutable/servermap.py: stop reaching into private MutableFileNode attributes
755Brian Warner <warner@lothar.com>**20091208172608
756 Ignore-this: b40a6b62f623f9285ad96fda139c2ef2
757]
758[mutable/servermap.py: oops, query N+e servers in MODE_WRITE, not k+e
759Brian Warner <warner@lothar.com>**20091208171156
760 Ignore-this: 3497f4ab70dae906759007c3cfa43bc
761 
762 under normal conditions, this wouldn't cause any problems, but if the shares
763 are really sparse (perhaps because new servers were added), then
764 file-modifies might stop looking too early and leave old shares in place
765]
766[control.py: fix speedtest: use download_best_version (not read) on mutable nodes
767Brian Warner <warner@lothar.com>**20091207060512
768 Ignore-this: 7125eabfe74837e05f9291dd6414f917
769]
770[FTP-and-SFTP.txt: fix ssh-keygen pointer
771Brian Warner <warner@lothar.com>**20091207052803
772 Ignore-this: bc2a70ee8c58ec314e79c1262ccb22f7
773]
774[remove MutableFileNode.download(), prefer download_best_version() instead
775Brian Warner <warner@lothar.com>**20091201225438
776 Ignore-this: 5733eb373a902063e09fd52cc858dec0
777]
778[Simplify immutable download API: use just filenode.read(consumer, offset, size)
779Brian Warner <warner@lothar.com>**20091201225330
780 Ignore-this: bdedfb488ac23738bf52ae6d4ab3a3fb
781 
782 * remove Downloader.download_to_data/download_to_filename/download_to_filehandle
783 * remove download.Data/FileName/FileHandle targets
784 * remove filenode.download/download_to_data/download_to_filename methods
785 * leave Downloader.download (the whole Downloader will go away eventually)
786 * add util.consumer.MemoryConsumer/download_to_data, for convenience
787   (this is mostly used by unit tests, but it gets used by enough non-test
788    code to warrant putting it in allmydata.util)
789 * update tests
790 * removes about 180 lines of code. Yay negative code days!
791 
792 Overall plan is to rewrite immutable/download.py and leave filenode.read() as
793 the sole read-side API.
794]
795[server.py: undo my bogus 'correction' of David-Sarah's comment fix
796Brian Warner <warner@lothar.com>**20091201024607
797 Ignore-this: ff4bb58f6a9e045b900ac3a89d6f506a
798 
799 and move it to a better line
800]
801[Implement more coherent behavior when copying with dircaps/filecaps (closes #761). Patch by Kevan Carstensen.
802"Brian Warner <warner@lothar.com>"**20091130211009]
803[storage.py: update comment
804"Brian Warner <warner@lothar.com>"**20091130195913]
805[storage server: detect disk space usage on Windows too (fixes #637)
806david-sarah@jacaranda.org**20091121055644
807 Ignore-this: 20fb30498174ce997befac7701fab056
808]
809[make status of finished operations consistently "Finished"
810david-sarah@jacaranda.org**20091121061543
811 Ignore-this: 97d483e8536ccfc2934549ceff7055a3
812]
813[docs: update the about.html a little
814zooko@zooko.com**20091208212737
815 Ignore-this: 3fe2d9653c6de0727d3e82bd70f2a8ed
816]
817[docs: remove obsolete doc file "codemap.txt"
818zooko@zooko.com**20091113163033
819 Ignore-this: 16bc21a1835546e71d1b344c06c61ebb
820 I started to update this to reflect the current codebase, but then I thought (a) nobody seemed to notice that it hasn't been updated since December 2007, and (b) it will just bit-rot again, so I'm removing it.
821]
822[setup: ignore _darcs in the "test-clean" test and make the "clean" step remove all .egg's in the root dir
823zooko@zooko.com**20091206184835
824 Ignore-this: 6066bd160f0db36d7bf60aba405558d2
825]
826[NEWS: update with all user-visible changes since the last release
827Brian Warner <warner@lothar.com>**20091127224217
828 Ignore-this: 741da6cd928e939fb6d21a61ea3daf0b
829]
830[update "tahoe backup" docs, and webapi.txt's mkdir-with-children
831Brian Warner <warner@lothar.com>**20091127055900
832 Ignore-this: defac1fb9a2335b0af3ef9dbbcc67b7e
833]
834[Add dirnodes to backupdb and "tahoe backup", closes #606.
835Brian Warner <warner@lothar.com>**20091126234257
836 Ignore-this: fa88796fcad1763c6a2bf81f56103223
837 
838 * backups now share dirnodes with any previous backup, in any location,
839   so renames and moves are handled very efficiently
840 * "tahoe backup" no longer bothers reading the previous snapshot
841 * if you switch grids, you should delete ~/.tahoe/private/backupdb.sqlite,
842   to force new uploads of all files and directories
843]
844[webapi: fix t=check for DIR2-LIT (i.e. empty immutable directories)
845Brian Warner <warner@lothar.com>**20091126232731
846 Ignore-this: 8513c890525c69c1eca0e80d53a231f8
847]
848[PipelineError: fix str() on python2.4 . Closes #842.
849Brian Warner <warner@lothar.com>**20091124212512
850 Ignore-this: e62c92ea9ede2ab7d11fe63f43b9c942
851]
852[test_uri.py: s/NewDirnode/Dirnode/ , now that they aren't "new" anymore
853Brian Warner <warner@lothar.com>**20091120075553
854 Ignore-this: 61c8ef5e45a9d966873a610d8349b830
855]
856[interface name cleanups: IFileNode, IImmutableFileNode, IMutableFileNode
857Brian Warner <warner@lothar.com>**20091120075255
858 Ignore-this: e3d193c229e2463e1d0b0c92306de27f
859 
860 The proper hierarchy is:
861  IFilesystemNode
862  +IFileNode
863  ++IMutableFileNode
864  ++IImmutableFileNode
865  +IDirectoryNode
866 
867 Also expand test_client.py (NodeMaker) to hit all IFilesystemNode types.
868]
869[class name cleanups: s/FileNode/ImmutableFileNode/
870Brian Warner <warner@lothar.com>**20091120072239
871 Ignore-this: 4b3218f2d0e585c62827e14ad8ed8ac1
872 
873 also fix test/bench_dirnode.py for recent dirnode changes
874]
875[Use DIR-IMM and t=mkdir-immutable for "tahoe backup", for #828
876Brian Warner <warner@lothar.com>**20091118192813
877 Ignore-this: a4720529c9bc6bc8b22a3d3265925491
878]
879[web/directory.py: use "DIR-IMM" to describe immutable directories, not DIR-RO
880Brian Warner <warner@lothar.com>**20091118191832
881 Ignore-this: aceafd6ab4bf1cc0c2a719ef7319ac03
882]
883[web/info.py: hush pyflakes
884Brian Warner <warner@lothar.com>**20091118191736
885 Ignore-this: edc5f128a2b8095fb20686a75747c8
886]
887[make get_size/get_current_size consistent for all IFilesystemNode classes
888Brian Warner <warner@lothar.com>**20091118191624
889 Ignore-this: bd3449cf96e4827abaaf962672c1665a
890 
891 * stop caching most_recent_size in dirnode, rely upon backing filenode for it
892 * start caching most_recent_size in MutableFileNode
893 * return None when you don't know, not "?"
894 * only render None as "?" in the web "more info" page
895 * add get_size/get_current_size to UnknownNode
896]
897[ImmutableDirectoryURIVerifier: fix verifycap handling
898Brian Warner <warner@lothar.com>**20091118164238
899 Ignore-this: 6bba5c717b54352262eabca6e805d590
900]
901[Add t=mkdir-immutable to the webapi. Closes #607.
902Brian Warner <warner@lothar.com>**20091118070900
903 Ignore-this: 311e5fab9a5f28b9e8a28d3d08f3c0d
904 
905 * change t=mkdir-with-children to not use multipart/form encoding. Instead,
906   the request body is all JSON. t=mkdir-immutable uses this format too.
907 * make nodemaker.create_immutable_dirnode() get convergence from SecretHolder,
908   but let callers override it
909 * raise NotDeepImmutableError instead of using assert()
910 * add mutable= argument to DirectoryNode.create_subdirectory(), default True
911]
912[move convergence secret into SecretHolder, next to lease secret
913Brian Warner <warner@lothar.com>**20091118015444
914 Ignore-this: 312f85978a339f2d04deb5bcb8f511bc
915]
916[nodemaker: implement immutable directories (internal interface), for #607
917Brian Warner <warner@lothar.com>**20091112002233
918 Ignore-this: d09fccf41813fdf7e0db177ed9e5e130
919 
920 * nodemaker.create_from_cap() now handles DIR2-CHK and DIR2-LIT
921 * client.create_immutable_dirnode() is used to create them
922 * no webapi yet
923]
924[stop using IURI()/etc as an adapter
925Brian Warner <warner@lothar.com>**20091111224542
926 Ignore-this: 9611da7ea6a4696de2a3b8c08776e6e0
927]
928[clean up uri-vs-cap terminology, emphasize cap instances instead of URI strings
929Brian Warner <warner@lothar.com>**20091111222619
930 Ignore-this: 93626385f6e7f039ada71f54feefe267
931 
932  * "cap" means a python instance which encapsulates a filecap/dircap (uri.py)
933  * "uri" means a string with a "URI:" prefix
934  * FileNode instances are created with (and retain) a cap instance, and
935    generate uri strings on demand
936  * .get_cap/get_readcap/get_verifycap/get_repaircap return cap instances
937  * .get_uri/get_readonly_uri return uri strings
938 
939 * add filenode.download_to_filename() for control.py, should find a better way
940 * use MutableFileNode.init_from_cap, not .init_from_uri
941 * directory URI instances: use get_filenode_cap, not get_filenode_uri
942 * update/cleanup bench_dirnode.py to match, add Makefile target to run it
943]
944[add parser for immutable directory caps: DIR2-CHK, DIR2-LIT, DIR2-CHK-Verifier
945Brian Warner <warner@lothar.com>**20091104181351
946 Ignore-this: 854398cc7a75bada57fa97c367b67518
947]
948[tests: bump up the timeout on test_repairer to see if 120 seconds was too short for François's ARM box to do the test even when it was doing it right.
949zooko@zooko.com**20091027224800
950 Ignore-this: 95e93dc2e018b9948253c2045d506f56
951]
952[dirnode.pack_children(): add deep_immutable= argument
953Brian Warner <warner@lothar.com>**20091026162809
954 Ignore-this: d5a2371e47662c4bc6eff273e8181b00
955 
956 This will be used by DIR2:CHK to enforce the deep-immutability requirement.
957]
958[wui: s/TahoeLAFS/Tahoe-LAFS/
959zooko@zooko.com**20091029035050
960 Ignore-this: 901e64cd862e492ed3132bd298583c26
961]
962[webapi: use t=mkdir-with-children instead of a children= arg to t=mkdir .
963Brian Warner <warner@lothar.com>**20091026011321
964 Ignore-this: 769cab30b6ab50db95000b6c5a524916
965 
966 This is safer: in the earlier API, an old webapi server would silently ignore
967 the initial children, and clients trying to set them would have to fetch the
968 newly-created directory to discover the incompatibility. In the new API,
969 clients using t=mkdir-with-children against an old webapi server will get a
970 clear error.
971]
972[nodemaker.create_new_mutable_directory: pack_children() in initial_contents=
973Brian Warner <warner@lothar.com>**20091020005118
974 Ignore-this: bd43c4eefe06fd32b7492bcb0a55d07e
975 instead of creating an empty file and then adding the children later.
976 
977 This should speed up mkdir(initial_children) considerably, removing two
978 roundtrips and an entire read-modify-write cycle, probably bringing it down
979 to a single roundtrip. A quick test (against the volunteergrid) suggests a
980 30% speedup.
981 
982 test_dirnode: add new tests to enforce the restrictions that interfaces.py
983 claims for create_new_mutable_directory(): no UnknownNodes, metadata dicts
984]
985[test_dirnode.py: add tests of initial_children= args to client.create_dirnode
986Brian Warner <warner@lothar.com>**20091017194159
987 Ignore-this: 2e2da28323a4d5d815466387914abc1b
988 and nodemaker.create_new_mutable_directory
989]
990[update many dirnode interfaces to accept dict-of-nodes instead of dict-of-caps
991Brian Warner <warner@lothar.com>**20091017192829
992 Ignore-this: b35472285143862a856bf4b361d692f0
993 
994 interfaces.py: define INodeMaker, document argument values, change
995                create_new_mutable_directory() to take dict-of-nodes. Change
996                dirnode.set_nodes() and dirnode.create_subdirectory() too.
997 nodemaker.py: use INodeMaker, update create_new_mutable_directory()
998 client.py: have create_dirnode() delegate initial_children= to nodemaker
999 dirnode.py (Adder): take dict-of-nodes instead of list-of-nodes, which
1000                     updates set_nodes() and create_subdirectory()
1001 web/common.py (convert_initial_children_json): create dict-of-nodes
1002 web/directory.py: same
1003 web/unlinked.py: same
1004 test_dirnode.py: update tests to match
1005]
1006[dirnode.py: move pack_children() out to a function, for eventual use by others
1007Brian Warner <warner@lothar.com>**20091017180707
1008 Ignore-this: 6a823fb61f2c180fd38d6742d3196a7a
1009]
1010[move dirnode.CachingDict to dictutil.AuxValueDict, generalize method names,
1011Brian Warner <warner@lothar.com>**20091017180005
1012 Ignore-this: b086933cf429df0fcea16a308d2640dd
1013 improve tests. Let dirnode _pack_children accept either dict or AuxValueDict.
1014]
1015[test/common.py: update FakeMutableFileNode to new contents= callable scheme
1016Brian Warner <warner@lothar.com>**20091013052154
1017 Ignore-this: 62f00a76454a2190d1c8641c5993632f
1018]
1019[The initial_children= argument to nodemaker.create_new_mutable_directory is
1020Brian Warner <warner@lothar.com>**20091013031922
1021 Ignore-this: 72e45317c21f9eb9ec3bd79bd4311f48
1022 now enabled.
1023]
1024[client.create_mutable_file(contents=) now accepts a callable, which is
1025Brian Warner <warner@lothar.com>**20091013031232
1026 Ignore-this: 3c89d2f50c1e652b83f20bd3f4f27c4b
1027 invoked with the new MutableFileNode and is supposed to return the initial
1028 contents. This can be used by e.g. a new dirnode which needs the filenode's
1029 writekey to encrypt its initial children.
1030 
1031 create_mutable_file() still accepts a bytestring too, or None for an empty
1032 file.
1033]
1034[webapi: t=mkdir now accepts initial children, using the same JSON that t=json
1035Brian Warner <warner@lothar.com>**20091013023444
1036 Ignore-this: 574a46ed46af4251abf8c9580fd31ef7
1037 emits.
1038 
1039 client.create_dirnode(initial_children=) now works.
1040]
1041[replace dirnode.create_empty_directory() with create_subdirectory(), which
1042Brian Warner <warner@lothar.com>**20091013021520
1043 Ignore-this: 6b57cb51bcfcc6058d0df569fdc8a9cf
1044 takes an initial_children= argument
1045]
1046[dirnode.set_children: change return value: fire with self instead of None
1047Brian Warner <warner@lothar.com>**20091013015026
1048 Ignore-this: f1d14e67e084e4b2a4e25fa849b0e753
1049]
1050[dirnode.set_nodes: change return value: fire with self instead of None
1051Brian Warner <warner@lothar.com>**20091013014546
1052 Ignore-this: b75b3829fb53f7399693f1c1a39aacae
1053]
1054[dirnode.set_children: take a dict, not a list
1055Brian Warner <warner@lothar.com>**20091013002440
1056 Ignore-this: 540ce72ce2727ee053afaae1ff124e21
1057]
1058[dirnode.set_uri/set_children: change signature to take writecap+readcap
1059Brian Warner <warner@lothar.com>**20091012235126
1060 Ignore-this: 5df617b2d379a51c79148a857e6026b1
1061 instead of a single cap. The webapi t=set_children call benefits too.
1062]
1063[replace Client.create_empty_dirnode() with create_dirnode(), in anticipation
1064Brian Warner <warner@lothar.com>**20091012224506
1065 Ignore-this: cbdaa4266ecb3c6496ffceab4f95709d
1066 of adding initial_children= argument.
1067 
1068 Includes stubbed-out initial_children= support.
1069]
1070[test_web.py: use a less-fake client, making test harness smaller
1071Brian Warner <warner@lothar.com>**20091012222808
1072 Ignore-this: 29e95147f8c94282885c65b411d100bb
1073]
1074[webapi.txt: document t=set_children, other small edits
1075Brian Warner <warner@lothar.com>**20091009200446
1076 Ignore-this: 4d7e76b04a7b8eaa0a981879f778ea5d
1077]
1078[Verifier: check the full cryptext-hash tree on each share. Removed .todos
1079Brian Warner <warner@lothar.com>**20091005221849
1080 Ignore-this: 6fb039c5584812017d91725e687323a5
1081 from the last few test_repairer tests that were waiting on this.
1082]
1083[Verifier: check the full block-hash-tree on each share
1084Brian Warner <warner@lothar.com>**20091005214844
1085 Ignore-this: 3f7ccf6d253f32340f1bf1da27803eee
1086 
1087 Removed the .todo from two test_repairer tests that check this. The only
1088 remaining .todos are on the three crypttext-hash-tree tests.
1089]
1090[Verifier: check the full share-hash chain on each share
1091Brian Warner <warner@lothar.com>**20091005213443
1092 Ignore-this: 3d30111904158bec06a4eac22fd39d17
1093 
1094 Removed the .todo from two test_repairer tests that check this.
1095]
1096[test_repairer: rename Verifier test cases to be more precise and less verbose
1097Brian Warner <warner@lothar.com>**20091005201115
1098 Ignore-this: 64be7094e33338c7c2aea9387e138771
1099]
1100[immutable/checker.py: rearrange code a little bit, make it easier to follow
1101Brian Warner <warner@lothar.com>**20091005200252
1102 Ignore-this: 91cc303fab66faf717433a709f785fb5
1103]
1104[test/common.py: wrap docstrings to 80cols so I can read them more easily
1105Brian Warner <warner@lothar.com>**20091005200143
1106 Ignore-this: b180a3a0235cbe309c87bd5e873cbbb3
1107]
1108[immutable/download.py: wrap to 80cols, no functional changes
1109Brian Warner <warner@lothar.com>**20091005192542
1110 Ignore-this: 6b05fe3dc6d78832323e708b9e6a1fe
1111]
1112[CHK-hashes.svg: cross out plaintext hashes, since we don't include
1113Brian Warner <warner@lothar.com>**20091005010803
1114 Ignore-this: bea2e953b65ec7359363aa20de8cb603
1115 them (until we finish #453)
1116]
1117[docs: a few licensing clarifications requested by Ubuntu
1118zooko@zooko.com**20090927033226
1119 Ignore-this: 749fc8c9aeb6dc643669854a3e81baa7
1120]
1121[setup: remove binary WinFUSE modules
1122zooko@zooko.com**20090924211436
1123 Ignore-this: 8aefc571d2ae22b9405fc650f2c2062
1124 I would prefer to have just source code, or indications of what 3rd-party packages are required, under revision control, and have the build process generate o
1125 r acquire the binaries as needed.  Also, having these in our release tarballs is interfering with getting Tahoe-LAFS uploaded into Ubuntu Karmic.  (Technicall
1126 y, they would accept binary modules as long as they came with the accompanying source so that they could satisfy their obligations under GPL2+ and TGPPL1+, bu
1127 t it is easier for now to remove the binaries from the source tree.)
1128 In this case, the binaries are from the tahoe-w32-client project: http://allmydata.org/trac/tahoe-w32-client , from which you can also get the source.
1129]
1130[setup: remove binary _fusemodule.so 's
1131zooko@zooko.com**20090924211130
1132 Ignore-this: 74487bbe27d280762ac5dd5f51e24186
1133 I would prefer to have just source code, or indications of what 3rd-party packages are required, under revision control, and have the build process generate or acquire the binaries as needed.  Also, having these in our release tarballs is interfering with getting Tahoe-LAFS uploaded into Ubuntu Karmic.  (Technically, they would accept binary modules as long as they came with the accompanying source so that they could satisfy their obligations under GPL2+ and TGPPL1+, but it is easier for now to remove the binaries from the source tree.)
1134 In this case, these modules come from the MacFUSE project: http://code.google.com/p/macfuse/
1135]
1136[doc: add a copy of LGPL2 for documentation purposes for ubuntu
1137zooko@zooko.com**20090924054218
1138 Ignore-this: 6a073b48678a7c84dc4fbcef9292ab5b
1139]
1140[setup: remove a convenience copy of figleaf, to ease inclusion into Ubuntu Karmic Koala
1141zooko@zooko.com**20090924053215
1142 Ignore-this: a0b0c990d6e2ee65c53a24391365ac8d
1143 We need to carefully document the licence of figleaf in order to get Tahoe-LAFS into Ubuntu Karmic Koala.  However, figleaf isn't really a part of Tahoe-LAFS per se -- this is just a "convenience copy" of a development tool.  The quickest way to make Tahoe-LAFS acceptable for Karmic then, is to remove figleaf from the Tahoe-LAFS tarball itself.  People who want to run figleaf on Tahoe-LAFS (as everyone should want) can install figleaf themselves.  I haven't tested this -- there may be incompatibilities between upstream figleaf and the copy that we had here...
1144]
1145[docs: Shawn Willden grants permission for his contributions under GPL2+|TGPPL1+
1146zooko@zooko.com**20090921164651
1147 Ignore-this: ef1912010d07ff2ffd9678e7abfd0d57
1148]
1149[docs: Csaba Henk granted permission to license fuse.py under the same terms as Tahoe-LAFS itself
1150zooko@zooko.com**20090921154659
1151 Ignore-this: c61ba48dcb7206a89a57ca18a0450c53
1152]
1153[setup: mark setup.py as having utf-8 encoding in it
1154zooko@zooko.com**20090920180343
1155 Ignore-this: 9d3850733700a44ba7291e9c5e36bb91
1156]
1157[doc: licensing cleanups
1158zooko@zooko.com**20090920171631
1159 Ignore-this: 7654f2854bf3c13e6f4d4597633a6630
1160 Use nice utf-8 © instead of "(c)". Remove licensing statements on utility modules that have been assigned to allmydata.com by their original authors. (Nattraverso was not assigned to allmydata.com -- it was LGPL'ed -- but I checked and src/allmydata/util/iputil.py was completely rewritten and doesn't contain any line of code from nattraverso.)  Add notes to misc/debian/copyright about licensing on files that aren't just allmydata.com-licensed.
1161]
1162[build-deb.py: run darcsver early, otherwise we get the wrong version later on
1163Brian Warner <warner@lothar.com>**20090918033620
1164 Ignore-this: 6635c5b85e84f8aed0d8390490c5392a
1165]
1166[setup: shebang for misc/build-deb.py to fail quickly
1167zooko@zooko.com**20090819135626
1168 Ignore-this: 5a1b893234d2d0bb7b7346e84b0a6b4d
1169 Without this patch, when I ran "chmod +x ./misc/build-deb.py && ./misc/build-deb.py" then it hung indefinitely.  (I wonder what it was doing.)
1170]
1171[new approach for debian packaging, sharing pieces across distributions. Still experimental, still only works for sid.
1172warner@lothar.com**20090818190527
1173 Ignore-this: a75eb63db9106b3269badbfcdd7f5ce1
1174]
1175[new experimental deb-packaging rules. Only works for sid so far.
1176Brian Warner <warner@lothar.com>**20090818014052
1177 Ignore-this: 3a26ad188668098f8f3cc10a7c0c2f27
1178]
1179[setup.py: read _version.py and pass to setup(version=), so more commands work
1180Brian Warner <warner@lothar.com>**20090818010057
1181 Ignore-this: b290eb50216938e19f72db211f82147e
1182 like "setup.py --version" and "setup.py --fullname"
1183]
1184[test/check_speed.py: fix shbang line
1185Brian Warner <warner@lothar.com>**20090818005948
1186 Ignore-this: 7f3a37caf349c4c4de704d0feb561f8d
1187]
1188[setup: remove bundled version of darcsver-1.2.1
1189zooko@zooko.com**20090816233432
1190 Ignore-this: 5357f26d2803db2d39159125dddb963a
1191 That version of darcsver emits a scary error message when the darcs executable or the _darcs subdirectory is not found.
1192 This error is hidden (unless the --loud option is passed) in darcsver >= 1.3.1.
1193 Fixes #788.
1194]
1195[de-Service-ify Helper, pass in storage_broker and secret_holder directly.
1196Brian Warner <warner@lothar.com>**20090815201737
1197 Ignore-this: 86b8ac0f90f77a1036cd604dd1304d8b
1198 This makes it more obvious that the Helper currently generates leases with
1199 the Helper's own secrets, rather than getting values from the client, which
1200 is arguably a bug that will likely be resolved with the Accounting project.
1201]
1202[immutable.Downloader: pass StorageBroker to constructor, stop being a Service
1203Brian Warner <warner@lothar.com>**20090815192543
1204 Ignore-this: af5ab12dbf75377640a670c689838479
1205 child of the client, access with client.downloader instead of
1206 client.getServiceNamed("downloader"). The single "Downloader" instance is
1207 scheduled for demolition anyways, to be replaced by individual
1208 filenode.download calls.
1209]
1210[stop making History be a Service, it wasn't necessary
1211Brian Warner <warner@lothar.com>**20090815114415
1212 Ignore-this: b60449231557f1934a751c7effa93cfe
1213]
1214[Overhaul IFilesystemNode handling, to simplify tests and use POLA internally.
1215Brian Warner <warner@lothar.com>**20090815112846
1216 Ignore-this: 1db1b9c149a60a310228aba04c5c8e5f
1217 
1218 * stop using IURI as an adapter
1219 * pass cap strings around instead of URI instances
1220 * move filenode/dirnode creation duties from Client to new NodeMaker class
1221 * move other Client duties to KeyGenerator, SecretHolder, History classes
1222 * stop passing Client reference to dirnode/filenode constructors
1223   - pass less-powerful references instead, like StorageBroker or Uploader
1224 * always create DirectoryNodes by wrapping a filenode (mutable for now)
1225 * remove some specialized mock classes from unit tests
1226 
1227 Detailed list of changes (done one at a time, then merged together)
1228 
1229 always pass a string to create_node_from_uri(), not an IURI instance
1230 always pass a string to IFilesystemNode constructors, not an IURI instance
1231 stop using IURI() as an adapter, switch on cap prefix in create_node_from_uri()
1232 client.py: move SecretHolder code out to a separate class
1233 test_web.py: hush pyflakes
1234 client.py: move NodeMaker functionality out into a separate object
1235 LiteralFileNode: stop storing a Client reference
1236 immutable Checker: remove Client reference, it only needs a SecretHolder
1237 immutable Upload: remove Client reference, leave SecretHolder and StorageBroker
1238 immutable Repairer: replace Client reference with StorageBroker and SecretHolder
1239 immutable FileNode: remove Client reference
1240 mutable.Publish: stop passing Client
1241 mutable.ServermapUpdater: get StorageBroker in constructor, not by peeking into Client reference
1242 MutableChecker: reference StorageBroker and History directly, not through Client
1243 mutable.FileNode: removed unused indirection to checker classes
1244 mutable.FileNode: remove Client reference
1245 client.py: move RSA key generation into a separate class, so it can be passed to the nodemaker
1246 move create_mutable_file() into NodeMaker
1247 test_dirnode.py: stop using FakeClient mockups, use NoNetworkGrid instead. This simplifies the code, but takes longer to run (17s instead of 6s). This should come down later when other cleanups make it possible to use simpler (non-RSA) fake mutable files for dirnode tests.
1248 test_mutable.py: clean up basedir names
1249 client.py: move create_empty_dirnode() into NodeMaker
1250 dirnode.py: get rid of DirectoryNode.create
1251 remove DirectoryNode.init_from_uri, refactor NodeMaker for customization, simplify test_web's mock Client to match
1252 stop passing Client to DirectoryNode, make DirectoryNode.create_with_mutablefile the normal DirectoryNode constructor, start removing client from NodeMaker
1253 remove Client from NodeMaker
1254 move helper status into History, pass History to web.Status instead of Client
1255 test_mutable.py: fix minor typo
1256]
1257[docs: edits for docs/running.html from Sam Mason
1258zooko@zooko.com**20090809201416
1259 Ignore-this: 2207e80449943ebd4ed50cea57c43143
1260]
1261[tests: double the timeout on test_runner.RunNode.test_introducer since feisty hit a timeout
1262zooko@zooko.com**20090815160512
1263 Ignore-this: ca7358bce4bdabe8eea75dedc39c0e67
1264 I'm not sure if this is an actual timing issue (feisty is running on an overloaded VM if I recall correctly), or it there is a deeper bug.
1265]
1266[docs: install.html: instruct Debian users to use this document and not to go find the DownloadDebianPackages page, ignore the warning at the top of it, and try it
1267zooko@zooko.com**20090804123840
1268 Ignore-this: 49da654f19d377ffc5a1eff0c820e026
1269 http://allmydata.org/pipermail/tahoe-dev/2009-August/002507.html
1270]
1271[docs: relnotes.txt: reflow to 63 chars wide because google groups and some web forms seem to wrap to that
1272zooko@zooko.com**20090802135016
1273 Ignore-this: 53b1493a0491bc30fb2935fad283caeb
1274]
1275[docs: about.html: fix English usage noticed by Amber
1276zooko@zooko.com**20090802050533
1277 Ignore-this: 89965c4650f9bd100a615c401181a956
1278]
1279[docs: fix mis-spelled word in about.html
1280zooko@zooko.com**20090802050320
1281 Ignore-this: fdfd0397bc7cef9edfde425dddeb67e5
1282]
1283[TAG allmydata-tahoe-1.5.0
1284zooko@zooko.com**20090802031303
1285 Ignore-this: 94e5558e7225c39a86aae666ea00f166
1286]
1287Patch bundle hash:
1288b325dde254c881292b545b20cbf9f86e3490bd21