subversion/include/svn_checksum.h

24  * @brief Subversion checksum routines
48   /** The checksum is (or should be set to) an MD5 checksum. */
51   /** The checksum is (or should be set to) a SHA1 checksum. */
56  * A generic checksum representation.
62   /** The bytes of the checksum. */
65   /** The type of the checksum.  This should never be changed by consumers
75 /** Return a new checksum structure of type @a kind, initialized to the all-
84 /** Set @a checksum->digest to all zeros, which, by convention, matches
90 svn_checksum_clear(svn_checksum_t *checksum);
104  * Return a deep copy of @a checksum, allocated in @a pool.  If @a
105  * checksum is NULL then NULL is returned.
110 svn_checksum_dup(const svn_checksum_t *checksum,
114 /** Return the hex representation of @a checksum, allocating the string
120 svn_checksum_to_cstring_display(const svn_checksum_t *checksum,
124 /** Return the hex representation of @a checksum, allocating the
125  * string in @a pool.  If @a checksum->digest is all zeros (that is,
126  * 0, not '0') then return NULL. In 1.7+, @a checksum may be NULL
130  * @note Passing NULL for @a checksum in 1.6 will cause a segfault.
133 svn_checksum_to_cstring(const svn_checksum_t *checksum,
137 /** Return a serialized representation of @a checksum, allocated in
140  * Note that @a checksum may not be NULL.
145 svn_checksum_serialize(const svn_checksum_t *checksum,
150 /** Return @a checksum from the serialized format at @a data. The checksum
157 svn_checksum_deserialize(const svn_checksum_t **checksum,
163 /** Parse the hex representation @a hex of a checksum of kind @a kind and
164  * set @a *checksum to the result, allocating in @a pool.
166  * If @a hex is @c NULL or is the all-zeros checksum, then set @a *checksum
172 svn_checksum_parse_hex(svn_checksum_t **checksum,
178  * Return in @a *checksum the checksum of type @a kind for the bytes beginning
179  * at @a data, and going for @a len.  @a *checksum is allocated in @a pool.
184 svn_checksum(svn_checksum_t **checksum,
192  * Return in @a pool a newly allocated checksum populated with the checksum
213  * Update the checksum represented by @a ctx, with @a len bytes starting at
225  * Finalize the checksum used when creating @a ctx, and put the resultant
226  * checksum in @a *checksum, allocated in @a pool.
231 svn_checksum_final(svn_checksum_t **checksum,
237  * Return the digest size of @a checksum.
242 svn_checksum_size(const svn_checksum_t *checksum);
245  * Return @c TRUE iff @a checksum matches the checksum for the empty
251 svn_checksum_is_empty_checksum(svn_checksum_t *checksum);