From 9f03ebd14b6beb00a9bed52c0568a13f8d5ebb08 Mon Sep 17 00:00:00 2001 From: Edward Thomson Date: Mon, 29 Nov 2021 13:44:42 -0500 Subject: object: introduce a raw content validation function Users may want to validate raw object content; provide them a function to do so. --- include/git2/object.h | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) (limited to 'include/git2/object.h') diff --git a/include/git2/object.h b/include/git2/object.h index 984dbb7ac..dbf480ed6 100644 --- a/include/git2/object.h +++ b/include/git2/object.h @@ -224,6 +224,28 @@ GIT_EXTERN(int) git_object_peel( */ GIT_EXTERN(int) git_object_dup(git_object **dest, git_object *source); +/** + * Analyzes a buffer of raw object content and determines its validity. + * Tree, commit, and tag objects will be parsed and ensured that they + * are valid, parseable content. (Blobs are always valid by definition.) + * An error message will be set with an informative message if the object + * is not valid. + * + * @warning This function is experimental and its signature may change in + * the future. + * + * @param valid Output pointer to set with validity of the object content + * @param buf The contents to validate + * @param len The length of the buffer + * @param type The type of the object in the buffer + * @return 0 on success or an error code + */ +GIT_EXTERN(int) git_object_rawcontent_is_valid( + int *valid, + const char *buf, + size_t len, + git_object_t type); + /** @} */ GIT_END_DECL -- cgit v1.2.1