From 679993ac0f756155c593ef7ba5e7426ce815edae Mon Sep 17 00:00:00 2001 From: Micah Snyder Date: Mon, 24 Oct 2022 16:55:23 -0700 Subject: [PATCH] Add file inspection callback stability disclaimer to libclamav header --- libclamav/clamav.h | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/libclamav/clamav.h b/libclamav/clamav.h index f1d94b3ec5..39a2da731a 100644 --- a/libclamav/clamav.h +++ b/libclamav/clamav.h @@ -497,7 +497,10 @@ extern void cl_engine_set_clcb_pre_cache(struct cl_engine *engine, clcb_pre_cach #define LAYER_ATTRIBUTES_DECRYPTED 0x2 /** Decryption was used to extract this layer. I.e. had to decrypt some previous layer. */ /** - * @brief Pre-scan callback. + * @brief File inspection callback. + * + * DISCLAIMER: This interface is to be considered unstable while we continue to evaluate it. + * We may change this interface in the future. * * Called for each NEW file (inner and outer). * Provides capability to record embedded file information during a scan. @@ -522,6 +525,9 @@ typedef cl_error_t (*clcb_file_inspection)(int fd, const char *type, const char /** * @brief Set a custom file inspection callback function. * + * DISCLAIMER: This interface is to be considered unstable while we continue to evaluate it. + * We may change this interface in the future. + * * Caution: changing options for an engine that is in-use is not thread-safe! * * @param engine The initialized scanning engine.