libhfuzz/libhfuzz.h

#ifdef __cplusplus
extern "C" {
#endif

#include <stdbool.h>
#include <stddef.h>
#include <stdint.h>

/*
 * buf: input fuzzing data
 * len: size of the 'buf' data
 *
 * Return value: should return 0
 */
    int LLVMFuzzerTestOneInput(const uint8_t * buf, size_t len);

/*
 * argc: ptr to main's argc
 * argv: ptr to main's argv
 *
 * Return value: ignored
 */
    int LLVMFuzzerInitialize(int *argc, char ***argv);

/*
 * Data: data to mutate
 * Size: size of the data to mutate
 * MaxSize: maximum size of the destination buffer
 *
 * Return value: size of the mutated buffer
 */
    size_t LLVMFuzzerMutate(uint8_t * Data, size_t Size, size_t MaxSize);

/*
 *
 * An alternative for LLVMFuzzerTestOneInput()
 *
 * buf_ptr: will be set to input fuzzing data
 * len_ptr: will be set to the size of the input fuzzing data
 */
    void HF_ITER(const uint8_t ** buf_ptr, size_t * len_ptr);

/*
 * Update comparison map:
 *
 * addr: address of original comparison
 * n: new value (only if better than the old/current value)
 */
    void instrumentCmpMap(void *addr, unsigned int n);

/*
 * Instrumented comparison functions
 */
    int hfuzz_strcmp(const char *s1, const char *s2, void *addr);
    int hfuzz_strcasecmp(const char *s1, const char *s2, void *addr);
    int hfuzz_strncmp(const char *s1, const char *s2, size_t n, void *addr);
    int hfuzz_strncasecmp(const char *s1, const char *s2, size_t n, void *addr);
    char *hfuzz_strstr(const char *haystack, const char *needle, void *addr);
    char *hfuzz_strcasestr(const char *haystack, const char *needle, void *addr);
    int hfuzz_memcmp(const void *m1, const void *m2, size_t n, void *addr);

#if defined(__linux__)

#include <sched.h>

/*
 * Enter Linux namespaces
 *
 * cloneFlags: see 'man unshare'
 */
    bool linuxEnterNs(uintptr_t cloneFlags);
/*
 * Bring network interface up
 *
 * ifacename: name of the interface, typically "lo"
 */
    bool linuxIfaceUp(const char *ifacename);
/*
 * Mount tmpfs over a mount point
 *
 * dst: mount point for tmfs
 */
    bool linuxMountTmpfs(const char *dst);

#endif                          /* defined(__linux__) */

#ifdef __cplusplus
}                               /* extern "C" */
#endif