X-Git-Url: http://git.efficios.com/?p=lttng-tools.git;a=blobdiff_plain;f=include%2Flttng%2Fkernel-probe.h;fp=include%2Flttng%2Fkernel-probe.h;h=4536fd5ef82317fac5dd36164cce9f802ee4d037;hp=0000000000000000000000000000000000000000;hb=808cb744a46310d2e5fbbe9ab025cd427bcfc0a8;hpb=48c24aea283e0f749e844c2aecc1139b7560fff1

diff --git a/include/lttng/kernel-probe.h b/include/lttng/kernel-probe.h
new file mode 100644
index 000000000..4536fd5ef
--- /dev/null
+++ b/include/lttng/kernel-probe.h
@@ -0,0 +1,87 @@
+/*
+ * Copyright (C) 2020 Jonathan Rajotte <jonathan.rajotte-julien@efficios.com>
+ *
+ * SPDX-License-Identifier: LGPL-2.1-only
+ *
+ */
+
+#ifndef LTTNG_KERNEL_PROBE_H
+#define LTTNG_KERNEL_PROBE_H
+
+#include <stdint.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+struct lttng_kernel_probe_location;
+
+enum lttng_kernel_probe_location_status {
+	LTTNG_KERNEL_PROBE_LOCATION_STATUS_OK		= 0,
+	/* Invalid parameters provided. */
+	LTTNG_KERNEL_PROBE_LOCATION_STATUS_INVALID	= -1,
+};
+
+enum lttng_kernel_probe_location_type {
+	LTTNG_KERNEL_PROBE_LOCATION_TYPE_UNKNOWN	= -1,
+	/* Location derived from a symbol and an offset. */
+	LTTNG_KERNEL_PROBE_LOCATION_TYPE_SYMBOL_OFFSET	= 0,
+	/* Location derived from an address. */
+	LTTNG_KERNEL_PROBE_LOCATION_TYPE_ADDRESS	= 1,
+};
+
+/*
+ * Get the type of the kernel probe location.
+ */
+extern enum lttng_kernel_probe_location_type
+lttng_kernel_probe_location_get_type(
+		const struct lttng_kernel_probe_location *location);
+
+/*
+ * Destroy the kernel probe location.
+ */
+extern void lttng_kernel_probe_location_destroy(
+		struct lttng_kernel_probe_location *location);
+
+/*
+ * Create a symbol derived probe location.
+ * On failure, NULL is returned.
+ */
+extern struct lttng_kernel_probe_location *
+lttng_kernel_probe_location_symbol_create(const char *symbol_name,
+		uint64_t offset);
+
+/*
+ * Get the symbol name of a symbol derived probe location.
+ */
+extern const char *lttng_kernel_probe_location_symbol_get_name(
+		const struct lttng_kernel_probe_location *location);
+
+/*
+ * Get the offset of a symbol derived location.
+ */
+extern enum lttng_kernel_probe_location_status
+lttng_kernel_probe_location_symbol_get_offset(
+		const struct lttng_kernel_probe_location *location,
+		uint64_t *offset);
+
+/*
+ * Create an address derived probe location.
+ * On failure, NULL is returned.
+ */
+extern struct lttng_kernel_probe_location *
+lttng_kernel_probe_location_address_create(uint64_t address);
+
+/*
+ * Get the address of an address derived probe location.
+ */
+extern enum lttng_kernel_probe_location_status
+lttng_kernel_probe_location_address_get_address(
+		const struct lttng_kernel_probe_location *location,
+		uint64_t *offset);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* LTTNG_KERNEL_PROBE_H */