dfsan_interface.h

Go to the documentation of this file.

//===-- dfsan_interface.h -------------------------------------------------===//
//
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
// See https://llvm.org/LICENSE.txt for license information.
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
//
//===----------------------------------------------------------------------===//
//
// This file is a part of DataFlowSanitizer.
//
// Public interface header.
//===----------------------------------------------------------------------===//
#ifndef DFSAN_INTERFACE_H
#define DFSAN_INTERFACE_H
 
#include <stddef.h>
#include <stdint.h>
#include <sanitizer/common_interface_defs.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
typedef uint16_t dfsan_label;
 
struct dfsan_label_info {
  // Fields for union labels, set to 0 for base labels.
  dfsan_label l1;
  dfsan_label l2;
 
  // Fields for base labels.
  const char *desc;
  void *userdata;
};
 
typedef void (*dfsan_write_callback_t)(int fd, const void *buf, size_t count);
 
dfsan_label dfsan_union(dfsan_label l1, dfsan_label l2);
 
dfsan_label dfsan_create_label(const char *desc, void *userdata);
 
void dfsan_set_label(dfsan_label label, void *addr, size_t size);
 
void dfsan_add_label(dfsan_label label, void *addr, size_t size);
 
dfsan_label dfsan_get_label(long data);
 
dfsan_label dfsan_read_label(const void *addr, size_t size);
 
const struct dfsan_label_info *dfsan_get_label_info(dfsan_label label);
 
int dfsan_has_label(dfsan_label label, dfsan_label elem);
 
dfsan_label dfsan_has_label_with_desc(dfsan_label label, const char *desc);
 
size_t dfsan_get_label_count(void);
 
void dfsan_flush(void);
 
void dfsan_set_write_callback(dfsan_write_callback_t labeled_write_callback);
 
void dfsan_dump_labels(int fd);
 
void dfsan_weak_hook_memcmp(void *caller_pc, const void *s1, const void *s2,
                            size_t n, dfsan_label s1_label,
                            dfsan_label s2_label, dfsan_label n_label);
void dfsan_weak_hook_strncmp(void *caller_pc, const char *s1, const char *s2,
                             size_t n, dfsan_label s1_label,
                             dfsan_label s2_label, dfsan_label n_label);
#ifdef __cplusplus
}  // extern "C"
 
template <typename T>
void dfsan_set_label(dfsan_label label, T &data) { // NOLINT
  dfsan_set_label(label, (void *)&data, sizeof(T));
}
 
#endif
 
#endif  // DFSAN_INTERFACE_H