/* * Copyright (c) 2016 GitHub, Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef LIBBCC_USDT_H #define LIBBCC_USDT_H #ifdef __cplusplus extern "C" { #endif #include void *bcc_usdt_new_frompid(int pid, const char *path); void *bcc_usdt_new_frompath(const char *path); void bcc_usdt_close(void *usdt); struct bcc_usdt { const char *provider; const char *name; const char *bin_path; // Virtual address semaphore is found at uint64_t semaphore; int num_locations; int num_arguments; // Offset from start of file where semaphore is at uint64_t semaphore_offset; }; struct bcc_usdt_location { uint64_t address; const char *bin_path; }; #define BCC_USDT_ARGUMENT_NONE 0x0 #define BCC_USDT_ARGUMENT_CONSTANT 0x1 #define BCC_USDT_ARGUMENT_DEREF_OFFSET 0x2 #define BCC_USDT_ARGUMENT_DEREF_IDENT 0x4 #define BCC_USDT_ARGUMENT_BASE_REGISTER_NAME 0x8 #define BCC_USDT_ARGUMENT_INDEX_REGISTER_NAME 0x10 #define BCC_USDT_ARGUMENT_SCALE 0x20 struct bcc_usdt_argument { int size; int valid; long long constant; int deref_offset; const char *deref_ident; const char *base_register_name; const char *index_register_name; int scale; }; typedef void (*bcc_usdt_cb)(struct bcc_usdt *); void bcc_usdt_foreach(void *usdt, bcc_usdt_cb callback); int bcc_usdt_get_location(void *usdt, const char *provider_name, const char *probe_name, int index, struct bcc_usdt_location *location); int bcc_usdt_get_argument(void *usdt, const char *provider_name, const char *probe_name, int location_index, int argument_index, struct bcc_usdt_argument *argument); int bcc_usdt_enable_probe(void *, const char *, const char *); int bcc_usdt_addsem_probe(void *, const char *, const char *, int16_t); #define BCC_USDT_HAS_FULLY_SPECIFIED_PROBE int bcc_usdt_enable_fully_specified_probe(void *, const char *, const char *, const char *); int bcc_usdt_addsem_fully_specified_probe(void *, const char *, const char *, const char *, int16_t); const char *bcc_usdt_genargs(void **ctx_array, int len); const char *bcc_usdt_get_probe_argctype( void *ctx, const char* probe_name, const int arg_index ); const char *bcc_usdt_get_fully_specified_probe_argctype( void *ctx, const char* provider_name, const char* probe_name, const int arg_index ); typedef void (*bcc_usdt_uprobe_cb)(const char *, const char *, uint64_t, int); void bcc_usdt_foreach_uprobe(void *usdt, bcc_usdt_uprobe_cb callback); #ifdef __cplusplus } #endif #endif