libtracefs: Add tracefs_find_cid_pid() API
Subsystems (2)
PATCH 1/1 libtracefs: Add tracefs_find_cid_pid() API
From: "Steven Rostedt (Google)" <[email protected]>
Add tracefs_find_cid_pid() to make it easier to find the process ID of the main thread on the host that represents a guest. This can be used to find the directory of /sys/kernel/debug/kvm/<PID>/ that holds information of the given guest.
The above function will create an instance to work in. If that is undesired and control of what tracing instance should be used, then use tracefs_instance_find_cid_pid() to specify the instance to do the work in.
Signed-off-by Steven Rostedt (Google) <[email protected]>
--- Documentation/libtracefs-guest.txt | 123 +++++++++++++ Makefile | 7 + include/tracefs.h | 4 + samples/Makefile | 1 + src/Makefile | 3 + src/tracefs-vsock.c | 274 +++++++++++++++++++++++++++++ 6 files changed, 412 insertions(+) create mode 100644 Documentation/libtracefs-guest.txt create mode 100644 src/tracefs-vsock.c
Documentation/libtracefs-guest.txt new file +123 -0
@@ -0,0 +1,123 @@ +libtracefs(3) +============= + +NAME +---- +tracefs_find_cid_pid, tracefs_instance_find_cid_pid - +helper functions to handle tracing guests + +SYNOPSIS +-------- +[verse] +-- +*#include <tracefs.h>* + +char pass:[*]*tracefs_find_cid_pid*(int _cid_); +char pass:[*]*tracefs_instance_find_cid_pid*(struct tracefs_instance pass:[*]_instance_, int _cid_); +-- + +DESCRIPTION +----------- +The *tracefs_find_cid_pid*() will use tracing to follow the wakeups of connecting to +the given _cid_ in order to find the pid of the guest thread that belongs to the vsocket cid. +It will then read the proc file system to find the thread leader, and it will return +the pid of the thread leader. + +The *tracefs_instance_find_cid_pid*() is the same as *tracefs_find_cid_pid*() but defines +the instance to use to perform the tracing in. If NULL it will use the top level +buffer to perform the tracing. + +RETURN VALUE +------------ +Both *tracefs_find_cid_pid*() and *tracefs_instance_find_cid_pid*() will return the +pid of the guest main thread that belongs to the _cid_, or -1 on error (or not found). + +EXAMPLE +------- +[source,c] +-- +#include <stdlib.h> +#include <unistd.h> +#include <tracefs.h> + +#define MAX_CID 256 + +static void find_cid(struct tracefs_instance *instance, int cid) +{ + int pid; + + pid = tracefs_instance_find_cid_pid(instance, cid); + if (pid >= 0) + printf("%d\t%d\n", cid, pid); +} + +static int find_cids(void) +{ + struct tracefs_instance *instance; + char *name; + int cid; + int ret; + + ret = asprintf(&name, "vsock_find-%d\n", getpid()); + if (ret < 0) + return ret; + + instance = tracefs_instance_create(name); + free(name); + if (!instance) + return -1; + + for (cid = 0; cid < MAX_CID; cid++) + find_cid(instance, cid); + + tracefs_event_disable(instance, NULL, NULL); + tracefs_instance_destroy(instance); + tracefs_instance_free(instance); + return 0; +} + +int main(int argc, char *argv[]) +{ + find_cids(); + exit(0); +} +-- +FILES +----- +[verse] +-- +*tracefs.h* + Header file to include in order to have access to the library APIs. +*-ltracefs* + Linker switch to add when building a program that uses the library. +-- + +SEE ALSO +-------- +*libtracefs*(3), +*libtraceevent*(3), +*trace-cmd*(1) + +AUTHOR +------ +[verse] +-- +*Steven Rostedt* <[email protected]> +*Tzvetomir Stoyanov* <[email protected]> +-- +REPORTING BUGS +-------------- +Report bugs to <[email protected]> + +LICENSE +------- +libtracefs is Free Software licensed under the GNU LGPL 2.1 + +RESOURCES +--------- +https://git.kernel.org/pub/scm/libs/libtrace/libtracefs.git/ + +COPYING +------- +Copyright \(C) 2020 VMware, Inc. Free use of this software is granted under +the terms of the GNU Public License (GPL).
Makefile +7 -0
@@ -73,12 +73,19 @@ else endif endif +ifndef NO_VSOCK +VSOCK_DEFINED := $(shell if (echo "$(pound)include <linux/vm_sockets.h>" | $(CC) -E - >/dev/null 2>&1) ; then echo 1; else echo 0 ; fi) +else +VSOCK_DEFINED := 0 +endif + etcdir ?= /etc etcdir_SQ = '$(subst ','\'',$(etcdir))' export man_dir man_dir_SQ html_install html_install_SQ INSTALL export img_install img_install_SQ export DESTDIR DESTDIR_SQ +export VSOCK_DEFINED pound := \#
include/tracefs.h +4 -0
@@ -640,4 +640,8 @@ int tracefs_cpu_flush(struct tracefs_cpu *tcpu, void *buffer);int tracefs_cpu_flush_write (struct tracefs_cpu *tcpu,int wfd);int tracefs_cpu_pipe (struct tracefs_cpu *tcpu,int wfd,bool nonblock); +/* Mapping vsocket cids to pids using tracing */ +int tracefs_instance_find_cid_pid (struct tracefs_instance *instance,int cid); +int tracefs_find_cid_pid (int cid); +#endif /* _TRACE_FS_H */
samples/Makefile +1 -0
@@ -22,6 +22,7 @@ EXAMPLES += tracer EXAMPLES += stream EXAMPLES += instances-affinity EXAMPLES += cpu +EXAMPLES += guest TARGETS := TARGETS += sqlhist
src/Makefile +3 -0
@@ -15,6 +15,9 @@ OBJS += tracefs-dynevents.o OBJS += tracefs-eprobes.o OBJS += tracefs-uprobes.o OBJS += tracefs-record.o +ifeq ($(VSOCK_DEFINED), 1) +OBJS += tracefs-vsock.o +endif # Order matters for the the three below OBJS += sqlhist-lex.o
src/tracefs-vsock.c new file +274 -0
274 lines not on this page · raw message
Signature · 1 line
2.39.2