]>
Commit | Line | Data |
---|---|---|
1 | #ifndef GIT_FSCK_H | |
2 | #define GIT_FSCK_H | |
3 | ||
4 | #include "oidset.h" | |
5 | ||
6 | #define FSCK_ERROR 1 | |
7 | #define FSCK_WARN 2 | |
8 | #define FSCK_IGNORE 3 | |
9 | ||
10 | struct fsck_options; | |
11 | struct object; | |
12 | ||
13 | void fsck_set_msg_type(struct fsck_options *options, | |
14 | const char *msg_id, const char *msg_type); | |
15 | void fsck_set_msg_types(struct fsck_options *options, const char *values); | |
16 | int is_valid_msg_type(const char *msg_id, const char *msg_type); | |
17 | ||
18 | /* | |
19 | * callback function for fsck_walk | |
20 | * type is the expected type of the object or OBJ_ANY | |
21 | * the return value is: | |
22 | * 0 everything OK | |
23 | * <0 error signaled and abort | |
24 | * >0 error signaled and do not abort | |
25 | */ | |
26 | typedef int (*fsck_walk_func)(struct object *obj, int type, void *data, struct fsck_options *options); | |
27 | ||
28 | /* callback for fsck_object, type is FSCK_ERROR or FSCK_WARN */ | |
29 | typedef int (*fsck_error)(struct fsck_options *o, | |
30 | const struct object_id *oid, enum object_type object_type, | |
31 | int msg_type, const char *message); | |
32 | ||
33 | int fsck_error_function(struct fsck_options *o, | |
34 | const struct object_id *oid, enum object_type object_type, | |
35 | int msg_type, const char *message); | |
36 | ||
37 | struct fsck_options { | |
38 | fsck_walk_func walk; | |
39 | fsck_error error_func; | |
40 | unsigned strict:1; | |
41 | int *msg_type; | |
42 | struct oidset skiplist; | |
43 | kh_oid_map_t *object_names; | |
44 | }; | |
45 | ||
46 | #define FSCK_OPTIONS_DEFAULT { NULL, fsck_error_function, 0, NULL, OIDSET_INIT } | |
47 | #define FSCK_OPTIONS_STRICT { NULL, fsck_error_function, 1, NULL, OIDSET_INIT } | |
48 | ||
49 | /* descend in all linked child objects | |
50 | * the return value is: | |
51 | * -1 error in processing the object | |
52 | * <0 return value of the callback, which lead to an abort | |
53 | * >0 return value of the first signaled error >0 (in the case of no other errors) | |
54 | * 0 everything OK | |
55 | */ | |
56 | int fsck_walk(struct object *obj, void *data, struct fsck_options *options); | |
57 | ||
58 | /* | |
59 | * Blob objects my pass a NULL data pointer, which indicates they are too large | |
60 | * to fit in memory. All other types must pass a real buffer. | |
61 | */ | |
62 | int fsck_object(struct object *obj, void *data, unsigned long size, | |
63 | struct fsck_options *options); | |
64 | ||
65 | /* | |
66 | * fsck a tag, and pass info about it back to the caller. This is | |
67 | * exposed fsck_object() internals for git-mktag(1). | |
68 | */ | |
69 | int fsck_tag_standalone(const struct object_id *oid, const char *buffer, | |
70 | unsigned long size, struct fsck_options *options, | |
71 | struct object_id *tagged_oid, | |
72 | int *tag_type); | |
73 | ||
74 | /* | |
75 | * Some fsck checks are context-dependent, and may end up queued; run this | |
76 | * after completing all fsck_object() calls in order to resolve any remaining | |
77 | * checks. | |
78 | */ | |
79 | int fsck_finish(struct fsck_options *options); | |
80 | ||
81 | /* | |
82 | * Subsystem for storing human-readable names for each object. | |
83 | * | |
84 | * If fsck_enable_object_names() has not been called, all other functions are | |
85 | * noops. | |
86 | * | |
87 | * Use fsck_put_object_name() to seed initial names (e.g. from refnames); the | |
88 | * fsck code will extend that while walking trees, etc. | |
89 | * | |
90 | * Use fsck_get_object_name() to get a single name (or NULL if none). Or the | |
91 | * more convenient describe_object(), which always produces an output string | |
92 | * with the oid combined with the name (if any). Note that the return value | |
93 | * points to a rotating array of static buffers, and may be invalidated by a | |
94 | * subsequent call. | |
95 | */ | |
96 | void fsck_enable_object_names(struct fsck_options *options); | |
97 | const char *fsck_get_object_name(struct fsck_options *options, | |
98 | const struct object_id *oid); | |
99 | __attribute__((format (printf,3,4))) | |
100 | void fsck_put_object_name(struct fsck_options *options, | |
101 | const struct object_id *oid, | |
102 | const char *fmt, ...); | |
103 | const char *fsck_describe_object(struct fsck_options *options, | |
104 | const struct object_id *oid); | |
105 | ||
106 | /* | |
107 | * git_config() callback for use by fsck-y tools that want to support | |
108 | * fsck.<msg> fsck.skipList etc. | |
109 | */ | |
110 | int fsck_config_internal(const char *var, const char *value, void *cb, | |
111 | struct fsck_options *options); | |
112 | ||
113 | #endif |