21
21
aggregate source */
25
/* result type for functions that have multiple failure modes */
27
DELTA_OK, /* Success */
28
DELTA_OUT_OF_MEMORY, /* Could not allocate required memory */
29
DELTA_INDEX_NEEDED, /* A delta_index must be passed */
30
DELTA_SOURCE_EMPTY, /* A source_info had no content */
31
DELTA_SOURCE_BAD, /* A source_info had invalid or corrupt content */
32
DELTA_BUFFER_EMPTY, /* A buffer pointer and size */
33
DELTA_SIZE_TOO_BIG, /* Delta data is larger than the max requested */
25
38
* create_delta_index: compute index data from given buffer
27
* This returns a pointer to a struct delta_index that should be passed to
28
* subsequent create_delta() calls, or to free_delta_index(). A NULL pointer
29
* is returned on failure. The given buffer must not be freed nor altered
30
* before free_delta_index() is called. The returned pointer must be freed
31
* using free_delta_index().
40
* Returns a delta_result status, when DELTA_OK then *fresh is set to a struct
41
* delta_index that should be passed to subsequent create_delta() calls, or to
42
* free_delta_index(). Other values are a failure, and *fresh is unset.
43
* The given buffer must not be freed nor altered before free_delta_index() is
44
* called. The resultant struct must be freed using free_delta_index().
33
extern struct delta_index *
34
47
create_delta_index(const struct source_info *src,
35
struct delta_index *old);
48
struct delta_index *old,
49
struct delta_index **fresh);
39
53
* create_delta_index_from_delta: compute index data from given buffer
41
* This returns a pointer to a struct delta_index that should be passed to
42
* subsequent create_delta() calls, or to free_delta_index(). A NULL pointer
43
* is returned on failure.
55
* Returns a delta_result status, when DELTA_OK then *fresh is set to a struct
56
* delta_index that should be passed to subsequent create_delta() calls, or to
57
* free_delta_index(). Other values are a failure, and *fresh is unset.
44
58
* The bytes must be in the form of a delta structure, as generated by
45
59
* create_delta(). The generated index will only index the insert bytes, and
46
60
* not any of the control structures.
48
extern struct delta_index *
49
63
create_delta_index_from_delta(const struct source_info *delta,
50
struct delta_index *old);
64
struct delta_index *old,
65
struct delta_index **fresh);
52
67
* free_delta_index: free the index created by create_delta_index()
68
83
* This function may be called multiple times with different buffers using
69
84
* the same delta_index pointer. If max_delta_size is non-zero and the
70
* resulting delta is to be larger than max_delta_size then NULL is returned.
71
* On success, a non-NULL pointer to the buffer with the delta data is
72
* returned and *delta_size is updated with its size. The returned buffer
73
* must be freed by the caller.
85
* resulting delta is to be larger than max_delta_size then DELTA_SIZE_TOO_BIG
86
* is returned. Otherwise on success, DELTA_OK is returned and *delta_data is
87
* set to a new buffer with the delta data and *delta_size is updated with its
88
* size. That buffer must be freed by the caller.
76
91
create_delta(const struct delta_index *index,
77
const void *buf, unsigned long bufsize,
78
unsigned long *delta_size, unsigned long max_delta_size);
92
const void *buf, unsigned long bufsize,
93
unsigned long *delta_size, unsigned long max_delta_size,
80
96
/* the smallest possible delta size is 3 bytes
81
97
* Target size, Copy command, Copy length
added
removed
bzrlib/delta.h
