Files
git-mirror/reftable/reftable-fsck.h
Karthik Nayak 9051638519 reftable: add code to facilitate consistency checks
The `git refs verify` command is used to run consistency checks on the
reference backends. This command is also invoked when users run 'git
fsck'. While the files-backend has some fsck checks added, the reftable
backend lacks such checks. Let's add the required infrastructure and a
check to test for the files present in the reftable directory.

Since the reftable library is treated as an independent library we
should ensure that the library code works independently without
knowledge about Git's internals. To do this, add both 'reftable/fsck.c'
and 'reftable/reftable-fsck.h'. Which provide an entry point
'reftable_fsck_check' for running fsck checks over a provided reftable
stack. The callee provides the function with callbacks to handle issue
and information reporting.

The added check, goes over all tables in the reftable stack validates
that they have a valid name. It not, it raises an error.

While here, move 'reftable/error.o' in the Makefile to retain
lexicographic ordering.

Signed-off-by: Karthik Nayak <karthik.188@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
2025-10-07 09:22:58 -07:00

41 lines
1.2 KiB
C

#ifndef REFTABLE_FSCK_H
#define REFTABLE_FSCK_H
#include "reftable-stack.h"
enum reftable_fsck_error {
/* Invalid table name */
REFTABLE_FSCK_ERROR_TABLE_NAME = 0,
/* Used for bounds checking, must be last */
REFTABLE_FSCK_MAX_VALUE,
};
/* Represents an individual error encountered during the FSCK checks. */
struct reftable_fsck_info {
enum reftable_fsck_error error;
const char *msg;
const char *path;
};
typedef int reftable_fsck_report_fn(struct reftable_fsck_info *info,
void *cb_data);
typedef void reftable_fsck_verbose_fn(const char *msg, void *cb_data);
/*
* Given a reftable stack, perform consistency checks on the stack.
*
* If an issue is encountered, the issue is reported to the callee via the
* provided 'report_fn'. If the issue is non-recoverable the flow will not
* continue. If it is recoverable, the flow will continue and further issues
* will be reported as identified.
*
* The 'verbose_fn' will be invoked to provide verbose information about
* the progress and state of the consistency checks.
*/
int reftable_fsck_check(struct reftable_stack *stack,
reftable_fsck_report_fn report_fn,
reftable_fsck_verbose_fn verbose_fn,
void *cb_data);
#endif /* REFTABLE_FSCK_H */