1 from zope.interface import implements
2 from twisted.trial import unittest
3 from twisted.internet import defer
4 from twisted.python.failure import Failure
5 from foolscap.api import fireEventually
6 from allmydata import uri
7 from allmydata.immutable import encode, upload, checker
8 from allmydata.util import hashutil
9 from allmydata.util.assertutil import _assert
10 from allmydata.util.consumer import download_to_data
11 from allmydata.interfaces import IStorageBucketWriter, IStorageBucketReader
12 from allmydata.test.no_network import GridTestMixin
14 class LostPeerError(Exception):
17 def flip_bit(good): # flips the last bit
18 return good[:-1] + chr(ord(good[-1]) ^ 0x01)
20 class FakeBucketReaderWriterProxy:
21 implements(IStorageBucketWriter, IStorageBucketReader)
22 # these are used for both reading and writing
23 def __init__(self, mode="good", peerid="peer"):
26 self.plaintext_hashes = []
27 self.crypttext_hashes = []
28 self.block_hashes = None
29 self.share_hashes = None
37 if self.mode == "lost-early":
38 f = Failure(LostPeerError("I went away early"))
39 return fireEventually(f)
40 return defer.succeed(self)
45 def put_block(self, segmentnum, data):
46 if self.mode == "lost-early":
47 f = Failure(LostPeerError("I went away early"))
48 return fireEventually(f)
50 assert not self.closed
51 assert segmentnum not in self.blocks
52 if self.mode == "lost" and segmentnum >= 1:
53 raise LostPeerError("I'm going away now")
54 self.blocks[segmentnum] = data
55 return defer.maybeDeferred(_try)
57 def put_crypttext_hashes(self, hashes):
59 assert not self.closed
60 assert not self.crypttext_hashes
61 self.crypttext_hashes = hashes
62 return defer.maybeDeferred(_try)
64 def put_block_hashes(self, blockhashes):
66 assert not self.closed
67 assert self.block_hashes is None
68 self.block_hashes = blockhashes
69 return defer.maybeDeferred(_try)
71 def put_share_hashes(self, sharehashes):
73 assert not self.closed
74 assert self.share_hashes is None
75 self.share_hashes = sharehashes
76 return defer.maybeDeferred(_try)
78 def put_uri_extension(self, uri_extension):
80 assert not self.closed
81 self.uri_extension = uri_extension
82 return defer.maybeDeferred(_try)
86 assert not self.closed
88 return defer.maybeDeferred(_try)
91 return defer.succeed(None)
93 def get_block_data(self, blocknum, blocksize, size):
95 def _try(unused=None):
96 assert isinstance(blocknum, (int, long))
97 if self.mode == "bad block":
98 return flip_bit(self.blocks[blocknum])
99 return self.blocks[blocknum]
103 def get_plaintext_hashes(self):
105 def _try(unused=None):
106 hashes = self.plaintext_hashes[:]
111 def get_crypttext_hashes(self):
113 def _try(unused=None):
114 hashes = self.crypttext_hashes[:]
115 if self.mode == "bad crypttext hashroot":
116 hashes[0] = flip_bit(hashes[0])
117 if self.mode == "bad crypttext hash":
118 hashes[1] = flip_bit(hashes[1])
123 def get_block_hashes(self, at_least_these=()):
125 def _try(unused=None):
126 if self.mode == "bad blockhash":
127 hashes = self.block_hashes[:]
128 hashes[1] = flip_bit(hashes[1])
130 return self.block_hashes
134 def get_share_hashes(self, at_least_these=()):
136 def _try(unused=None):
137 if self.mode == "bad sharehash":
138 hashes = self.share_hashes[:]
139 hashes[1] = (hashes[1][0], flip_bit(hashes[1][1]))
141 if self.mode == "missing sharehash":
142 # one sneaky attack would be to pretend we don't know our own
143 # sharehash, which could manage to frame someone else.
144 # download.py is supposed to guard against this case.
146 return self.share_hashes
150 def get_uri_extension(self):
152 def _try(unused=None):
153 if self.mode == "bad uri_extension":
154 return flip_bit(self.uri_extension)
155 return self.uri_extension
160 def make_data(length):
161 data = "happy happy joy joy" * 100
162 assert length <= len(data)
165 class ValidatedExtendedURIProxy(unittest.TestCase):
166 timeout = 240 # It takes longer than 120 seconds on Francois's arm box.
175 _TMP += (K - (_TMP % K))
177 _TMP = SIZE / SEGSIZE
178 if SIZE % SEGSIZE != 0:
181 mindict = { 'segment_size': SEGSIZE,
182 'crypttext_root_hash': '0'*hashutil.CRYPTO_VAL_SIZE,
183 'share_root_hash': '1'*hashutil.CRYPTO_VAL_SIZE }
184 optional_consistent = { 'crypttext_hash': '2'*hashutil.CRYPTO_VAL_SIZE,
186 'codec_params': "%d-%d-%d" % (SEGSIZE, K, M),
187 'tail_codec_params': "%d-%d-%d" % (TAIL_SEGSIZE, K, M),
188 'num_segments': NUM_SEGMENTS,
192 'plaintext_hash': "anything",
193 'plaintext_root_hash': "anything", }
194 # optional_inconsistent = { 'crypttext_hash': ('2'*(hashutil.CRYPTO_VAL_SIZE-1), "", 77),
195 optional_inconsistent = { 'crypttext_hash': (77,),
196 'codec_name': ("digital fountain", ""),
197 'codec_params': ("%d-%d-%d" % (SEGSIZE, K-1, M),
198 "%d-%d-%d" % (SEGSIZE-1, K, M),
199 "%d-%d-%d" % (SEGSIZE, K, M-1)),
200 'tail_codec_params': ("%d-%d-%d" % (TAIL_SEGSIZE, K-1, M),
201 "%d-%d-%d" % (TAIL_SEGSIZE-1, K, M),
202 "%d-%d-%d" % (TAIL_SEGSIZE, K, M-1)),
203 'num_segments': (NUM_SEGMENTS-1,),
205 'needed_shares': (K-1,),
206 'total_shares': (M-1,), }
208 def _test(self, uebdict):
209 uebstring = uri.pack_extension(uebdict)
210 uebhash = hashutil.uri_extension_hash(uebstring)
211 fb = FakeBucketReaderWriterProxy()
212 fb.put_uri_extension(uebstring)
213 verifycap = uri.CHKFileVerifierURI(storage_index='x'*16, uri_extension_hash=uebhash, needed_shares=self.K, total_shares=self.M, size=self.SIZE)
214 vup = checker.ValidatedExtendedURIProxy(fb, verifycap)
217 def _test_accept(self, uebdict):
218 return self._test(uebdict)
220 def _should_fail(self, res, expected_failures):
221 if isinstance(res, Failure):
222 res.trap(*expected_failures)
224 self.fail("was supposed to raise %s, not get '%s'" % (expected_failures, res))
226 def _test_reject(self, uebdict):
227 d = self._test(uebdict)
228 d.addBoth(self._should_fail, (KeyError, checker.BadURIExtension))
231 def test_accept_minimal(self):
232 return self._test_accept(self.mindict)
234 def test_reject_insufficient(self):
236 for k in self.mindict.iterkeys():
237 insuffdict = self.mindict.copy()
239 d = self._test_reject(insuffdict)
241 return defer.DeferredList(dl)
243 def test_accept_optional(self):
245 for k in self.optional_consistent.iterkeys():
246 mydict = self.mindict.copy()
247 mydict[k] = self.optional_consistent[k]
248 d = self._test_accept(mydict)
250 return defer.DeferredList(dl)
252 def test_reject_optional(self):
254 for k in self.optional_inconsistent.iterkeys():
255 for v in self.optional_inconsistent[k]:
256 mydict = self.mindict.copy()
258 d = self._test_reject(mydict)
260 return defer.DeferredList(dl)
262 class Encode(unittest.TestCase):
263 timeout = 2400 # It takes longer than 240 seconds on Zandr's ARM box.
265 def do_encode(self, max_segment_size, datalen, NUM_SHARES, NUM_SEGMENTS,
266 expected_block_hashes, expected_share_hashes):
267 data = make_data(datalen)
268 # force use of multiple segments
270 u = upload.Data(data, convergence="some convergence string")
271 u.set_default_encoding_parameters({'max_segment_size': max_segment_size,
272 'k': 25, 'happy': 75, 'n': 100})
273 eu = upload.EncryptAnUploadable(u)
274 d = e.set_encrypted_uploadable(eu)
276 all_shareholders = []
278 k,happy,n = e.get_param("share_counts")
279 _assert(n == NUM_SHARES) # else we'll be completely confused
280 numsegs = e.get_param("num_segments")
281 _assert(numsegs == NUM_SEGMENTS, numsegs, NUM_SEGMENTS)
282 segsize = e.get_param("segment_size")
283 _assert( (NUM_SEGMENTS-1)*segsize < len(data) <= NUM_SEGMENTS*segsize,
284 NUM_SEGMENTS, segsize,
285 (NUM_SEGMENTS-1)*segsize, len(data), NUM_SEGMENTS*segsize)
289 for shnum in range(NUM_SHARES):
290 peer = FakeBucketReaderWriterProxy()
291 shareholders[shnum] = peer
292 servermap.setdefault(shnum, set()).add(peer.get_peerid())
293 all_shareholders.append(peer)
294 e.set_shareholders(shareholders, servermap)
296 d.addCallback(_ready)
300 self.failUnless(isinstance(verifycap.uri_extension_hash, str))
301 self.failUnlessEqual(len(verifycap.uri_extension_hash), 32)
302 for i,peer in enumerate(all_shareholders):
303 self.failUnless(peer.closed)
304 self.failUnlessEqual(len(peer.blocks), NUM_SEGMENTS)
305 # each peer gets a full tree of block hashes. For 3 or 4
306 # segments, that's 7 hashes. For 5 segments it's 15 hashes.
307 self.failUnlessEqual(len(peer.block_hashes),
308 expected_block_hashes)
309 for h in peer.block_hashes:
310 self.failUnlessEqual(len(h), 32)
311 # each peer also gets their necessary chain of share hashes.
312 # For 100 shares (rounded up to 128 leaves), that's 8 hashes
313 self.failUnlessEqual(len(peer.share_hashes),
314 expected_share_hashes)
315 for (hashnum, h) in peer.share_hashes:
316 self.failUnless(isinstance(hashnum, int))
317 self.failUnlessEqual(len(h), 32)
318 d.addCallback(_check)
322 def test_send_74(self):
323 # 3 segments (25, 25, 24)
324 return self.do_encode(25, 74, 100, 3, 7, 8)
325 def test_send_75(self):
326 # 3 segments (25, 25, 25)
327 return self.do_encode(25, 75, 100, 3, 7, 8)
328 def test_send_51(self):
329 # 3 segments (25, 25, 1)
330 return self.do_encode(25, 51, 100, 3, 7, 8)
332 def test_send_76(self):
333 # encode a 76 byte file (in 4 segments: 25,25,25,1) to 100 shares
334 return self.do_encode(25, 76, 100, 4, 7, 8)
335 def test_send_99(self):
336 # 4 segments: 25,25,25,24
337 return self.do_encode(25, 99, 100, 4, 7, 8)
338 def test_send_100(self):
339 # 4 segments: 25,25,25,25
340 return self.do_encode(25, 100, 100, 4, 7, 8)
342 def test_send_124(self):
343 # 5 segments: 25, 25, 25, 25, 24
344 return self.do_encode(25, 124, 100, 5, 15, 8)
345 def test_send_125(self):
346 # 5 segments: 25, 25, 25, 25, 25
347 return self.do_encode(25, 125, 100, 5, 15, 8)
348 def test_send_101(self):
349 # 5 segments: 25, 25, 25, 25, 1
350 return self.do_encode(25, 101, 100, 5, 15, 8)
353 class Roundtrip(GridTestMixin, unittest.TestCase):
355 # a series of 3*3 tests to check out edge conditions. One axis is how the
356 # plaintext is divided into segments: kn+(-1,0,1). Another way to express
357 # this is n%k == -1 or 0 or 1. For example, for 25-byte segments, we
358 # might test 74 bytes, 75 bytes, and 76 bytes.
360 # on the other axis is how many leaves in the block hash tree we wind up
361 # with, relative to a power of 2, so 2^a+(-1,0,1). Each segment turns
362 # into a single leaf. So we'd like to check out, e.g., 3 segments, 4
363 # segments, and 5 segments.
365 # that results in the following series of data lengths:
367 # 4 segs: 99, 100, 76
368 # 5 segs: 124, 125, 101
370 # all tests encode to 100 shares, which means the share hash tree will
371 # have 128 leaves, which means that buckets will be given an 8-long share
374 # all 3-segment files will have a 4-leaf blockhashtree, and thus expect
375 # to get 7 blockhashes. 4-segment files will also get 4-leaf block hash
376 # trees and 7 blockhashes. 5-segment files will get 8-leaf block hash
377 # trees, which gets 15 blockhashes.
379 def test_74(self): return self.do_test_size(74)
380 def test_75(self): return self.do_test_size(75)
381 def test_51(self): return self.do_test_size(51)
382 def test_99(self): return self.do_test_size(99)
383 def test_100(self): return self.do_test_size(100)
384 def test_76(self): return self.do_test_size(76)
385 def test_124(self): return self.do_test_size(124)
386 def test_125(self): return self.do_test_size(125)
387 def test_101(self): return self.do_test_size(101)
389 def upload(self, data):
390 u = upload.Data(data, None)
391 u.max_segment_size = 25
392 u.encoding_param_k = 25
393 u.encoding_param_happy = 1
394 u.encoding_param_n = 100
395 d = self.c0.upload(u)
396 d.addCallback(lambda ur: self.c0.create_node_from_uri(ur.get_uri()))
400 def do_test_size(self, size):
401 self.basedir = self.mktemp()
403 self.c0 = self.g.clients[0]
405 d = self.upload(DATA)
406 d.addCallback(lambda n: download_to_data(n))
407 def _downloaded(newdata):
408 self.failUnlessEqual(newdata, DATA)
409 d.addCallback(_downloaded)