Movatterモバイル変換

tracefs_option_enable(3) — Linux manual page

LIBTRACEFS(3)               libtracefs ManualLIBTRACEFS(3)

NAME        top

       tracefs_option_enable, tracefs_option_disable, tracefs_option_name       - Various trace option functions.

SYNOPSIS        top

#include <tracefs.h>       inttracefs_option_enable(struct tracefs_instance *instance, enum tracefs_option_idid);       inttracefs_option_disable(struct tracefs_instance *instance, enum tracefs_option_idid);       const char *tracefs_option_name(enum tracefs_option_idid);

DESCRIPTION        top

       This set of APIs can be used to enable and disable ftrace options       and to get the name of an option.       Thetracefs_option_enable()function enables the option withid in       the giveninstance. Ifinstance is NULL, the option is enabled in       the top trace instance.       Thetracefs_option_disable()function disables the option withid       in the giveninstance. Ifinstance is NULL, the option is disabled       in the top trace instance.       Thetracefs_option_name()function returns a string, representing       the option withid. The string mustnotbe freed.

RETURN VALUE        top

       Thetracefs_option_enable()andtracefs_option_disable()functions       return 0 if the state of the option is set successfully, or -1 in       case of an error.       Thetracefs_option_name()function returns string with option       name, or "unknown" in case of an error. The returned string mustnotbe freed.

EXAMPLE        top

           #include <tracefs.h>           ...           if (tracefs_option_enable(NULL, TRACEFS_OPTION_ANNOTATE)) {                   /* Failed to enable annotate option in top trace instance */           }           ...           if (tracefs_option_disable(NULL, TRACEFS_OPTION_CONTEXT_INFO)) {                   /* Failed to disable context info option in top trace instance */           }           ...           char *name = tracefs_option_name(TRACEFS_OPTION_FUNC_STACKTRACE);           if (strcmp(name, "unknown")) {                   /* Cannot get the name of the option */           }

FILES        top

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        top

libtracefs(3),libtraceevent(3),trace-cmd(1)

AUTHOR        top

Steven Rostedt<rostedt@goodmis.org[1]>Tzvetomir Stoyanov<tz.stoyanov@gmail.com[2]>

REPORTING BUGS        top

       Report bugs to <linux-trace-devel@vger.kernel.org[3]>

LICENSE        top

       libtracefs is Free Software licensed under the GNU LGPL 2.1

RESOURCES        top

https://git.kernel.org/pub/scm/libs/libtrace/libtracefs.git/

COPYING        top

       Copyright (C) 2020 VMware, Inc. Free use of this software is       granted under the terms of the GNU Public License (GPL).

NOTES        top

        1. rostedt@goodmis.org           mailto:rostedt@goodmis.org        2. tz.stoyanov@gmail.com           mailto:tz.stoyanov@gmail.com        3. linux-trace-devel@vger.kernel.org           mailto:linux-trace-devel@vger.kernel.org

COLOPHON        top

       This page is part of thelibtracefs (Linux kernel trace file       system library) project.  Information about the project can be       found at ⟨https://www.trace-cmd.org/⟩.  If you have a bug report       for this manual page, see ⟨https://www.trace-cmd.org/⟩.  This page       was obtained from the project's upstream Git repository       ⟨https://git.kernel.org/pub/scm/libs/libtrace/libtracefs.git⟩ on       2025-08-11.  (At that time, the date of the most recent commit       that was found in the repository was 2025-06-02.)  If you discover       any rendering problems in this HTML version of the page, or you       believe there is a better or more up-to-date source for the page,       or you have corrections or improvements to the information in this       COLOPHON (which isnot part of the original manual page), send a       mail to man-pages@man7.orglibtracefs 1.7.0                12/22/2023LIBTRACEFS(3)

Pages that refer to this page:tracefs_filter_pid_function(3)

HTML rendering created 2025-09-06 byMichael Kerrisk, author ofThe Linux Programming Interface. For details of in-depthLinux/UNIX system programming training courses that I teach, lookhere. Hosting byjambit GmbH.