X-Git-Url: https://git.lttng.org/?p=lttng-tools.git;a=blobdiff_plain;f=include%2Flttng%2Fuserspace-probe.h;h=7de667efcb5d0555d35f04d1491fe15b4dd56523;hp=b6fc13508a3c02f48db57c7596cfa915d0bf150e;hb=HEAD;hpb=4bd69c5f1161cd065f487da0f4c1aa03a73c47e4 diff --git a/include/lttng/userspace-probe.h b/include/lttng/userspace-probe.h index b6fc13508..7de667efc 100644 --- a/include/lttng/userspace-probe.h +++ b/include/lttng/userspace-probe.h @@ -21,10 +21,10 @@ extern "C" { struct lttng_userspace_probe_location_lookup_method; enum lttng_userspace_probe_location_lookup_method_type { - LTTNG_USERSPACE_PROBE_LOCATION_LOOKUP_METHOD_TYPE_UNKNOWN = -1, - LTTNG_USERSPACE_PROBE_LOCATION_LOOKUP_METHOD_TYPE_FUNCTION_DEFAULT = 0, - LTTNG_USERSPACE_PROBE_LOCATION_LOOKUP_METHOD_TYPE_FUNCTION_ELF = 1, - LTTNG_USERSPACE_PROBE_LOCATION_LOOKUP_METHOD_TYPE_TRACEPOINT_SDT = 2, + LTTNG_USERSPACE_PROBE_LOCATION_LOOKUP_METHOD_TYPE_UNKNOWN = -1, + LTTNG_USERSPACE_PROBE_LOCATION_LOOKUP_METHOD_TYPE_FUNCTION_DEFAULT = 0, + LTTNG_USERSPACE_PROBE_LOCATION_LOOKUP_METHOD_TYPE_FUNCTION_ELF = 1, + LTTNG_USERSPACE_PROBE_LOCATION_LOOKUP_METHOD_TYPE_TRACEPOINT_SDT = 2, }; /* @@ -32,13 +32,13 @@ enum lttng_userspace_probe_location_lookup_method_type { */ LTTNG_EXPORT extern enum lttng_userspace_probe_location_lookup_method_type lttng_userspace_probe_location_lookup_method_get_type( - const struct lttng_userspace_probe_location_lookup_method *lookup_method); + const struct lttng_userspace_probe_location_lookup_method *lookup_method); /* * Destroy a lookup method. */ LTTNG_EXPORT extern void lttng_userspace_probe_location_lookup_method_destroy( - struct lttng_userspace_probe_location_lookup_method *lookup_method); + struct lttng_userspace_probe_location_lookup_method *lookup_method); /* * Create a tracepoint ELF function lookup method struct. @@ -54,7 +54,6 @@ lttng_userspace_probe_location_lookup_method_function_elf_create(void); LTTNG_EXPORT extern struct lttng_userspace_probe_location_lookup_method * lttng_userspace_probe_location_lookup_method_tracepoint_sdt_create(void); - /* * Contains all the information needed to compute the instrumentation point in * the binary. It is used in conjonction with a lookup method. @@ -62,32 +61,30 @@ lttng_userspace_probe_location_lookup_method_tracepoint_sdt_create(void); struct lttng_userspace_probe_location; enum lttng_userspace_probe_location_status { - LTTNG_USERSPACE_PROBE_LOCATION_STATUS_OK = 0, + LTTNG_USERSPACE_PROBE_LOCATION_STATUS_OK = 0, /* Invalid parameters provided. */ - LTTNG_USERSPACE_PROBE_LOCATION_STATUS_INVALID = -1, + LTTNG_USERSPACE_PROBE_LOCATION_STATUS_INVALID = -1, }; enum lttng_userspace_probe_location_type { - LTTNG_USERSPACE_PROBE_LOCATION_TYPE_UNKNOWN = -1, + LTTNG_USERSPACE_PROBE_LOCATION_TYPE_UNKNOWN = -1, /* Function. */ - LTTNG_USERSPACE_PROBE_LOCATION_TYPE_FUNCTION = 0, + LTTNG_USERSPACE_PROBE_LOCATION_TYPE_FUNCTION = 0, /* SDT probe's callsites. */ - LTTNG_USERSPACE_PROBE_LOCATION_TYPE_TRACEPOINT = 1, + LTTNG_USERSPACE_PROBE_LOCATION_TYPE_TRACEPOINT = 1, }; /* * Get the type of the userspace probe location. */ LTTNG_EXPORT extern enum lttng_userspace_probe_location_type -lttng_userspace_probe_location_get_type( - const struct lttng_userspace_probe_location *location); +lttng_userspace_probe_location_get_type(const struct lttng_userspace_probe_location *location); /* * Destroy the userspace probe location. */ -LTTNG_EXPORT extern void lttng_userspace_probe_location_destroy( - struct lttng_userspace_probe_location *location); - +LTTNG_EXPORT extern void +lttng_userspace_probe_location_destroy(struct lttng_userspace_probe_location *location); enum lttng_userspace_probe_location_function_instrumentation_type { LTTNG_USERSPACE_PROBE_LOCATION_FUNCTION_INSTRUMENTATION_TYPE_UNKNOWN = -1, @@ -104,35 +101,36 @@ enum lttng_userspace_probe_location_function_instrumentation_type { * location. */ LTTNG_EXPORT extern struct lttng_userspace_probe_location * -lttng_userspace_probe_location_function_create(const char *binary_path, - const char *function_name, - struct lttng_userspace_probe_location_lookup_method *lookup_method); +lttng_userspace_probe_location_function_create( + const char *binary_path, + const char *function_name, + struct lttng_userspace_probe_location_lookup_method *lookup_method); /* * Get the target binary path of the probe location of the function type. */ LTTNG_EXPORT extern const char *lttng_userspace_probe_location_function_get_binary_path( - const struct lttng_userspace_probe_location *location); + const struct lttng_userspace_probe_location *location); /* * Get the target function type of the probe location of the function type. */ LTTNG_EXPORT extern const char *lttng_userspace_probe_location_function_get_function_name( - const struct lttng_userspace_probe_location *location); + const struct lttng_userspace_probe_location *location); /* * Get the FD to the target binary file to the probe location of the function * type. The FD is only valid for the duration of the lifetime of `location`. */ LTTNG_EXPORT extern int lttng_userspace_probe_location_function_get_binary_fd( - const struct lttng_userspace_probe_location *location); + const struct lttng_userspace_probe_location *location); /* * Get the instrumentation type of the function probe location. */ LTTNG_EXPORT extern enum lttng_userspace_probe_location_function_instrumentation_type lttng_userspace_probe_location_function_get_instrumentation_type( - const struct lttng_userspace_probe_location *location); + const struct lttng_userspace_probe_location *location); /* * Get the instrumentation type of the function probe location. @@ -145,8 +143,8 @@ lttng_userspace_probe_location_function_get_instrumentation_type( */ LTTNG_EXPORT extern enum lttng_userspace_probe_location_status lttng_userspace_probe_location_function_set_instrumentation_type( - const struct lttng_userspace_probe_location *location, - enum lttng_userspace_probe_location_function_instrumentation_type instrumentation_type); + const struct lttng_userspace_probe_location *location, + enum lttng_userspace_probe_location_function_instrumentation_type instrumentation_type); /* * Get the lookup method of the given userspace probe location. @@ -156,7 +154,7 @@ lttng_userspace_probe_location_function_set_instrumentation_type( */ LTTNG_EXPORT extern const struct lttng_userspace_probe_location_lookup_method * lttng_userspace_probe_location_get_lookup_method( - const struct lttng_userspace_probe_location *location); + const struct lttng_userspace_probe_location *location); /* * Create a probe location of the tracepoint type. @@ -168,35 +166,37 @@ lttng_userspace_probe_location_get_lookup_method( * location. */ LTTNG_EXPORT extern struct lttng_userspace_probe_location * -lttng_userspace_probe_location_tracepoint_create(const char *binary_path, - const char *probe_name, const char *provider_name, - struct lttng_userspace_probe_location_lookup_method *lookup_method); +lttng_userspace_probe_location_tracepoint_create( + const char *binary_path, + const char *probe_name, + const char *provider_name, + struct lttng_userspace_probe_location_lookup_method *lookup_method); /* * Get the target binary path of the probe location of the tracepoint type. */ LTTNG_EXPORT extern const char *lttng_userspace_probe_location_tracepoint_get_binary_path( - const struct lttng_userspace_probe_location *location); + const struct lttng_userspace_probe_location *location); /* * Get the target probe name of the probe location of the tracepoint type. */ LTTNG_EXPORT extern const char *lttng_userspace_probe_location_tracepoint_get_probe_name( - const struct lttng_userspace_probe_location *location); + const struct lttng_userspace_probe_location *location); /* * Get the target probe provider name of the probe location of the tracepoint * type. */ LTTNG_EXPORT extern const char *lttng_userspace_probe_location_tracepoint_get_provider_name( - const struct lttng_userspace_probe_location *location); + const struct lttng_userspace_probe_location *location); /* * Get the FD to the target binary file to the probe location of the tracepoint * type. The FD is only valid for the duration of the lifetime of `location`. */ LTTNG_EXPORT extern int lttng_userspace_probe_location_tracepoint_get_binary_fd( - const struct lttng_userspace_probe_location *location); + const struct lttng_userspace_probe_location *location); #ifdef __cplusplus }