mirror of
https://github.com/git/git.git
synced 2025-12-12 20:36:24 +01:00
2b3362c10d
The `reftable_block` structure associates a byte slice with a block source. As such it only holds the data of a reftable block without actually encoding any of the details for how to access that data. Rename the structure to instead be called `reftable_block_data`. Besides clarifying that this really only holds data, it also allows us to rename the `reftable_block_reader` to `reftable_block` in the next commit, as this is the structure that actually encapsulates access to the reftable blocks. Rename the `struct reftable_block_reader::block` member accordingly. Signed-off-by: Patrick Steinhardt <ps@pks.im> Signed-off-by: Junio C Hamano <gitster@pobox.com>
47 lines
1.2 KiB
C
47 lines
1.2 KiB
C
/*
|
|
* Copyright 2020 Google LLC
|
|
*
|
|
* Use of this source code is governed by a BSD-style
|
|
* license that can be found in the LICENSE file or at
|
|
* https://developers.google.com/open-source/licenses/bsd
|
|
*/
|
|
|
|
#ifndef BLOCKSOURCE_H
|
|
#define BLOCKSOURCE_H
|
|
|
|
#include "system.h"
|
|
|
|
struct reftable_block_source;
|
|
struct reftable_block_data;
|
|
struct reftable_buf;
|
|
|
|
/*
|
|
* Close the block source and the underlying resource. This is a no-op in case
|
|
* the block source is zero-initialized.
|
|
*/
|
|
void block_source_close(struct reftable_block_source *source);
|
|
|
|
/*
|
|
* Read a block of length `size` from the source at the given `off`.
|
|
*/
|
|
ssize_t block_source_read_data(struct reftable_block_source *source,
|
|
struct reftable_block_data *dest, uint64_t off,
|
|
uint32_t size);
|
|
|
|
/*
|
|
* Return the total length of the underlying resource.
|
|
*/
|
|
uint64_t block_source_size(struct reftable_block_source *source);
|
|
|
|
/*
|
|
* Return a block to its original source, releasing any resources associated
|
|
* with it.
|
|
*/
|
|
void block_source_release_data(struct reftable_block_data *data);
|
|
|
|
/* Create an in-memory block source for reading reftables. */
|
|
void block_source_from_buf(struct reftable_block_source *bs,
|
|
struct reftable_buf *buf);
|
|
|
|
#endif
|