2 Copyright 2020 Google LLC
4 Use of this source code is governed by a BSD-style
5 license that can be found in the LICENSE file or at
6 https://developers.google.com/open-source/licenses/bsd
13 #include "constants.h"
17 #include "reftable-error.h"
18 #include "reftable-generic.h"
21 uint64_t block_source_size(struct reftable_block_source
*source
)
23 return source
->ops
->size(source
->arg
);
26 int block_source_read_block(struct reftable_block_source
*source
,
27 struct reftable_block
*dest
, uint64_t off
,
30 int result
= source
->ops
->read_block(source
->arg
, dest
, off
, size
);
31 dest
->source
= *source
;
35 void block_source_close(struct reftable_block_source
*source
)
41 source
->ops
->close(source
->arg
);
45 static struct reftable_reader_offsets
*
46 reader_offsets_for(struct reftable_reader
*r
, uint8_t typ
)
50 return &r
->ref_offsets
;
52 return &r
->log_offsets
;
54 return &r
->obj_offsets
;
59 static int reader_get_block(struct reftable_reader
*r
,
60 struct reftable_block
*dest
, uint64_t off
,
66 if (off
+ sz
> r
->size
) {
70 return block_source_read_block(&r
->source
, dest
, off
, sz
);
73 uint32_t reftable_reader_hash_id(struct reftable_reader
*r
)
78 const char *reader_name(struct reftable_reader
*r
)
83 static int parse_footer(struct reftable_reader
*r
, uint8_t *footer
,
87 uint8_t first_block_typ
;
89 uint32_t computed_crc
;
92 if (memcmp(f
, "REFT", 4)) {
93 err
= REFTABLE_FORMAT_ERROR
;
98 if (memcmp(footer
, header
, header_size(r
->version
))) {
99 err
= REFTABLE_FORMAT_ERROR
;
104 r
->block_size
= get_be24(f
);
107 r
->min_update_index
= get_be64(f
);
109 r
->max_update_index
= get_be64(f
);
112 if (r
->version
== 1) {
113 r
->hash_id
= GIT_SHA1_FORMAT_ID
;
115 r
->hash_id
= get_be32(f
);
116 switch (r
->hash_id
) {
117 case GIT_SHA1_FORMAT_ID
:
119 case GIT_SHA256_FORMAT_ID
:
122 err
= REFTABLE_FORMAT_ERROR
;
128 r
->ref_offsets
.index_offset
= get_be64(f
);
131 r
->obj_offsets
.offset
= get_be64(f
);
134 r
->object_id_len
= r
->obj_offsets
.offset
& ((1 << 5) - 1);
135 r
->obj_offsets
.offset
>>= 5;
137 r
->obj_offsets
.index_offset
= get_be64(f
);
139 r
->log_offsets
.offset
= get_be64(f
);
141 r
->log_offsets
.index_offset
= get_be64(f
);
144 computed_crc
= crc32(0, footer
, f
- footer
);
145 file_crc
= get_be32(f
);
147 if (computed_crc
!= file_crc
) {
148 err
= REFTABLE_FORMAT_ERROR
;
152 first_block_typ
= header
[header_size(r
->version
)];
153 r
->ref_offsets
.is_present
= (first_block_typ
== BLOCK_TYPE_REF
);
154 r
->ref_offsets
.offset
= 0;
155 r
->log_offsets
.is_present
= (first_block_typ
== BLOCK_TYPE_LOG
||
156 r
->log_offsets
.offset
> 0);
157 r
->obj_offsets
.is_present
= r
->obj_offsets
.offset
> 0;
163 int init_reader(struct reftable_reader
*r
, struct reftable_block_source
*source
,
166 struct reftable_block footer
= { NULL
};
167 struct reftable_block header
= { NULL
};
169 uint64_t file_size
= block_source_size(source
);
171 /* Need +1 to read type of first block. */
172 uint32_t read_size
= header_size(2) + 1; /* read v2 because it's larger. */
173 memset(r
, 0, sizeof(struct reftable_reader
));
175 if (read_size
> file_size
) {
176 err
= REFTABLE_FORMAT_ERROR
;
180 err
= block_source_read_block(source
, &header
, 0, read_size
);
181 if (err
!= read_size
) {
182 err
= REFTABLE_IO_ERROR
;
186 if (memcmp(header
.data
, "REFT", 4)) {
187 err
= REFTABLE_FORMAT_ERROR
;
190 r
->version
= header
.data
[4];
191 if (r
->version
!= 1 && r
->version
!= 2) {
192 err
= REFTABLE_FORMAT_ERROR
;
196 r
->size
= file_size
- footer_size(r
->version
);
198 r
->name
= xstrdup(name
);
201 err
= block_source_read_block(source
, &footer
, r
->size
,
202 footer_size(r
->version
));
203 if (err
!= footer_size(r
->version
)) {
204 err
= REFTABLE_IO_ERROR
;
208 err
= parse_footer(r
, footer
.data
, header
.data
);
210 reftable_block_done(&footer
);
211 reftable_block_done(&header
);
216 struct reftable_reader
*r
;
219 struct block_iter bi
;
222 #define TABLE_ITER_INIT \
224 .bi = {.last_key = STRBUF_INIT } \
227 static void table_iter_copy_from(struct table_iter
*dest
,
228 struct table_iter
*src
)
231 dest
->typ
= src
->typ
;
232 dest
->block_off
= src
->block_off
;
233 dest
->is_finished
= src
->is_finished
;
234 block_iter_copy_from(&dest
->bi
, &src
->bi
);
237 static int table_iter_next_in_block(struct table_iter
*ti
,
238 struct reftable_record
*rec
)
240 int res
= block_iter_next(&ti
->bi
, rec
);
241 if (res
== 0 && reftable_record_type(rec
) == BLOCK_TYPE_REF
) {
242 rec
->u
.ref
.update_index
+= ti
->r
->min_update_index
;
248 static void table_iter_block_done(struct table_iter
*ti
)
253 reftable_block_done(&ti
->bi
.br
->block
);
254 FREE_AND_NULL(ti
->bi
.br
);
256 ti
->bi
.last_key
.len
= 0;
260 static int32_t extract_block_size(uint8_t *data
, uint8_t *typ
, uint64_t off
,
266 data
+= header_size(version
);
270 if (reftable_is_block_type(*typ
)) {
271 result
= get_be24(data
+ 1);
276 int reader_init_block_reader(struct reftable_reader
*r
, struct block_reader
*br
,
277 uint64_t next_off
, uint8_t want_typ
)
279 int32_t guess_block_size
= r
->block_size
? r
->block_size
:
281 struct reftable_block block
= { NULL
};
282 uint8_t block_typ
= 0;
284 uint32_t header_off
= next_off
? 0 : header_size(r
->version
);
285 int32_t block_size
= 0;
287 if (next_off
>= r
->size
)
290 err
= reader_get_block(r
, &block
, next_off
, guess_block_size
);
294 block_size
= extract_block_size(block
.data
, &block_typ
, next_off
,
296 if (block_size
< 0) {
300 if (want_typ
!= BLOCK_TYPE_ANY
&& block_typ
!= want_typ
) {
305 if (block_size
> guess_block_size
) {
306 reftable_block_done(&block
);
307 err
= reader_get_block(r
, &block
, next_off
, block_size
);
313 err
= block_reader_init(br
, &block
, header_off
, r
->block_size
,
314 hash_size(r
->hash_id
));
316 reftable_block_done(&block
);
321 static int table_iter_next_block(struct table_iter
*dest
,
322 struct table_iter
*src
)
324 uint64_t next_block_off
= src
->block_off
+ src
->bi
.br
->full_block_size
;
325 struct block_reader br
= { 0 };
329 dest
->typ
= src
->typ
;
330 dest
->block_off
= next_block_off
;
332 err
= reader_init_block_reader(src
->r
, &br
, next_block_off
, src
->typ
);
334 dest
->is_finished
= 1;
340 struct block_reader
*brp
=
341 reftable_malloc(sizeof(struct block_reader
));
344 dest
->is_finished
= 0;
345 block_reader_start(brp
, &dest
->bi
);
350 static int table_iter_next(struct table_iter
*ti
, struct reftable_record
*rec
)
352 if (reftable_record_type(rec
) != ti
->typ
)
353 return REFTABLE_API_ERROR
;
356 struct table_iter next
= TABLE_ITER_INIT
;
358 if (ti
->is_finished
) {
362 err
= table_iter_next_in_block(ti
, rec
);
367 err
= table_iter_next_block(&next
, ti
);
371 table_iter_block_done(ti
);
375 table_iter_copy_from(ti
, &next
);
376 block_iter_close(&next
.bi
);
380 static int table_iter_next_void(void *ti
, struct reftable_record
*rec
)
382 return table_iter_next(ti
, rec
);
385 static void table_iter_close(void *p
)
387 struct table_iter
*ti
= p
;
388 table_iter_block_done(ti
);
389 block_iter_close(&ti
->bi
);
392 static struct reftable_iterator_vtable table_iter_vtable
= {
393 .next
= &table_iter_next_void
,
394 .close
= &table_iter_close
,
397 static void iterator_from_table_iter(struct reftable_iterator
*it
,
398 struct table_iter
*ti
)
402 it
->ops
= &table_iter_vtable
;
405 static int reader_table_iter_at(struct reftable_reader
*r
,
406 struct table_iter
*ti
, uint64_t off
,
409 struct block_reader br
= { 0 };
410 struct block_reader
*brp
= NULL
;
412 int err
= reader_init_block_reader(r
, &br
, off
, typ
);
416 brp
= reftable_malloc(sizeof(struct block_reader
));
419 ti
->typ
= block_reader_type(brp
);
421 block_reader_start(brp
, &ti
->bi
);
425 static int reader_start(struct reftable_reader
*r
, struct table_iter
*ti
,
426 uint8_t typ
, int index
)
428 struct reftable_reader_offsets
*offs
= reader_offsets_for(r
, typ
);
429 uint64_t off
= offs
->offset
;
431 off
= offs
->index_offset
;
435 typ
= BLOCK_TYPE_INDEX
;
438 return reader_table_iter_at(r
, ti
, off
, typ
);
441 static int reader_seek_linear(struct reftable_reader
*r
, struct table_iter
*ti
,
442 struct reftable_record
*want
)
444 struct reftable_record rec
=
445 reftable_new_record(reftable_record_type(want
));
446 struct strbuf want_key
= STRBUF_INIT
;
447 struct strbuf got_key
= STRBUF_INIT
;
448 struct table_iter next
= TABLE_ITER_INIT
;
451 reftable_record_key(want
, &want_key
);
454 err
= table_iter_next_block(&next
, ti
);
462 err
= block_reader_first_key(next
.bi
.br
, &got_key
);
466 if (strbuf_cmp(&got_key
, &want_key
) > 0) {
467 table_iter_block_done(&next
);
471 table_iter_block_done(ti
);
472 table_iter_copy_from(ti
, &next
);
475 err
= block_iter_seek(&ti
->bi
, &want_key
);
481 block_iter_close(&next
.bi
);
482 reftable_record_release(&rec
);
483 strbuf_release(&want_key
);
484 strbuf_release(&got_key
);
488 static int reader_seek_indexed(struct reftable_reader
*r
,
489 struct reftable_iterator
*it
,
490 struct reftable_record
*rec
)
492 struct reftable_record want_index
= {
493 .type
= BLOCK_TYPE_INDEX
, .u
.idx
= { .last_key
= STRBUF_INIT
}
495 struct reftable_record index_result
= {
496 .type
= BLOCK_TYPE_INDEX
,
497 .u
.idx
= { .last_key
= STRBUF_INIT
},
499 struct table_iter index_iter
= TABLE_ITER_INIT
;
500 struct table_iter next
= TABLE_ITER_INIT
;
503 reftable_record_key(rec
, &want_index
.u
.idx
.last_key
);
504 err
= reader_start(r
, &index_iter
, reftable_record_type(rec
), 1);
508 err
= reader_seek_linear(r
, &index_iter
, &want_index
);
510 err
= table_iter_next(&index_iter
, &index_result
);
511 table_iter_block_done(&index_iter
);
515 err
= reader_table_iter_at(r
, &next
, index_result
.u
.idx
.offset
,
520 err
= block_iter_seek(&next
.bi
, &want_index
.u
.idx
.last_key
);
524 if (next
.typ
== reftable_record_type(rec
)) {
529 if (next
.typ
!= BLOCK_TYPE_INDEX
) {
530 err
= REFTABLE_FORMAT_ERROR
;
534 table_iter_copy_from(&index_iter
, &next
);
538 struct table_iter empty
= TABLE_ITER_INIT
;
539 struct table_iter
*malloced
=
540 reftable_calloc(sizeof(struct table_iter
));
542 table_iter_copy_from(malloced
, &next
);
543 iterator_from_table_iter(it
, malloced
);
546 block_iter_close(&next
.bi
);
547 table_iter_close(&index_iter
);
548 reftable_record_release(&want_index
);
549 reftable_record_release(&index_result
);
553 static int reader_seek_internal(struct reftable_reader
*r
,
554 struct reftable_iterator
*it
,
555 struct reftable_record
*rec
)
557 struct reftable_reader_offsets
*offs
=
558 reader_offsets_for(r
, reftable_record_type(rec
));
559 uint64_t idx
= offs
->index_offset
;
560 struct table_iter ti
= TABLE_ITER_INIT
;
563 return reader_seek_indexed(r
, it
, rec
);
565 err
= reader_start(r
, &ti
, reftable_record_type(rec
), 0);
568 err
= reader_seek_linear(r
, &ti
, rec
);
572 struct table_iter
*p
=
573 reftable_malloc(sizeof(struct table_iter
));
575 iterator_from_table_iter(it
, p
);
581 static int reader_seek(struct reftable_reader
*r
, struct reftable_iterator
*it
,
582 struct reftable_record
*rec
)
584 uint8_t typ
= reftable_record_type(rec
);
586 struct reftable_reader_offsets
*offs
= reader_offsets_for(r
, typ
);
587 if (!offs
->is_present
) {
588 iterator_set_empty(it
);
592 return reader_seek_internal(r
, it
, rec
);
595 int reftable_reader_seek_ref(struct reftable_reader
*r
,
596 struct reftable_iterator
*it
, const char *name
)
598 struct reftable_record rec
= {
599 .type
= BLOCK_TYPE_REF
,
601 .refname
= (char *)name
,
604 return reader_seek(r
, it
, &rec
);
607 int reftable_reader_seek_log_at(struct reftable_reader
*r
,
608 struct reftable_iterator
*it
, const char *name
,
609 uint64_t update_index
)
611 struct reftable_record rec
= { .type
= BLOCK_TYPE_LOG
,
613 .refname
= (char *)name
,
614 .update_index
= update_index
,
616 return reader_seek(r
, it
, &rec
);
619 int reftable_reader_seek_log(struct reftable_reader
*r
,
620 struct reftable_iterator
*it
, const char *name
)
622 uint64_t max
= ~((uint64_t)0);
623 return reftable_reader_seek_log_at(r
, it
, name
, max
);
626 void reader_close(struct reftable_reader
*r
)
628 block_source_close(&r
->source
);
629 FREE_AND_NULL(r
->name
);
632 int reftable_new_reader(struct reftable_reader
**p
,
633 struct reftable_block_source
*src
, char const *name
)
635 struct reftable_reader
*rd
=
636 reftable_calloc(sizeof(struct reftable_reader
));
637 int err
= init_reader(rd
, src
, name
);
641 block_source_close(src
);
647 void reftable_reader_free(struct reftable_reader
*r
)
655 static int reftable_reader_refs_for_indexed(struct reftable_reader
*r
,
656 struct reftable_iterator
*it
,
659 struct reftable_record want
= {
660 .type
= BLOCK_TYPE_OBJ
,
663 .hash_prefix_len
= r
->object_id_len
,
666 struct reftable_iterator oit
= { NULL
};
667 struct reftable_record got
= {
668 .type
= BLOCK_TYPE_OBJ
,
672 struct indexed_table_ref_iter
*itr
= NULL
;
674 /* Look through the reverse index. */
675 err
= reader_seek(r
, &oit
, &want
);
679 /* read out the reftable_obj_record */
680 err
= iterator_next(&oit
, &got
);
684 if (err
> 0 || memcmp(want
.u
.obj
.hash_prefix
, got
.u
.obj
.hash_prefix
,
686 /* didn't find it; return empty iterator */
687 iterator_set_empty(it
);
692 err
= new_indexed_table_ref_iter(&itr
, r
, oid
, hash_size(r
->hash_id
),
694 got
.u
.obj
.offset_len
);
697 got
.u
.obj
.offsets
= NULL
;
698 iterator_from_indexed_table_ref_iter(it
, itr
);
701 reftable_iterator_destroy(&oit
);
702 reftable_record_release(&got
);
706 static int reftable_reader_refs_for_unindexed(struct reftable_reader
*r
,
707 struct reftable_iterator
*it
,
710 struct table_iter ti_empty
= TABLE_ITER_INIT
;
711 struct table_iter
*ti
= reftable_calloc(sizeof(struct table_iter
));
712 struct filtering_ref_iterator
*filter
= NULL
;
713 struct filtering_ref_iterator empty
= FILTERING_REF_ITERATOR_INIT
;
714 int oid_len
= hash_size(r
->hash_id
);
718 err
= reader_start(r
, ti
, BLOCK_TYPE_REF
, 0);
724 filter
= reftable_malloc(sizeof(struct filtering_ref_iterator
));
727 strbuf_add(&filter
->oid
, oid
, oid_len
);
728 reftable_table_from_reader(&filter
->tab
, r
);
729 filter
->double_check
= 0;
730 iterator_from_table_iter(&filter
->it
, ti
);
732 iterator_from_filtering_ref_iterator(it
, filter
);
736 int reftable_reader_refs_for(struct reftable_reader
*r
,
737 struct reftable_iterator
*it
, uint8_t *oid
)
739 if (r
->obj_offsets
.is_present
)
740 return reftable_reader_refs_for_indexed(r
, it
, oid
);
741 return reftable_reader_refs_for_unindexed(r
, it
, oid
);
744 uint64_t reftable_reader_max_update_index(struct reftable_reader
*r
)
746 return r
->max_update_index
;
749 uint64_t reftable_reader_min_update_index(struct reftable_reader
*r
)
751 return r
->min_update_index
;
754 /* generic table interface. */
756 static int reftable_reader_seek_void(void *tab
, struct reftable_iterator
*it
,
757 struct reftable_record
*rec
)
759 return reader_seek(tab
, it
, rec
);
762 static uint32_t reftable_reader_hash_id_void(void *tab
)
764 return reftable_reader_hash_id(tab
);
767 static uint64_t reftable_reader_min_update_index_void(void *tab
)
769 return reftable_reader_min_update_index(tab
);
772 static uint64_t reftable_reader_max_update_index_void(void *tab
)
774 return reftable_reader_max_update_index(tab
);
777 static struct reftable_table_vtable reader_vtable
= {
778 .seek_record
= reftable_reader_seek_void
,
779 .hash_id
= reftable_reader_hash_id_void
,
780 .min_update_index
= reftable_reader_min_update_index_void
,
781 .max_update_index
= reftable_reader_max_update_index_void
,
784 void reftable_table_from_reader(struct reftable_table
*tab
,
785 struct reftable_reader
*reader
)
788 tab
->ops
= &reader_vtable
;
789 tab
->table_arg
= reader
;
793 int reftable_reader_print_file(const char *tablename
)
795 struct reftable_block_source src
= { NULL
};
796 int err
= reftable_block_source_from_file(&src
, tablename
);
797 struct reftable_reader
*r
= NULL
;
798 struct reftable_table tab
= { NULL
};
802 err
= reftable_new_reader(&r
, &src
, tablename
);
806 reftable_table_from_reader(&tab
, r
);
807 err
= reftable_table_print(&tab
);
809 reftable_reader_free(r
);