sphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextChinese (Simplified)}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget /translations/zh_CN/trace/fprobemodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget /translations/zh_TW/trace/fprobemodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget /translations/it_IT/trace/fprobemodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget /translations/ja_JP/trace/fprobemodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget /translations/ko_KR/trace/fprobemodnameN classnameN refexplicituh1hhh ubh)}(hhh]hPortuguese (Brazilian)}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget /translations/pt_BR/trace/fprobemodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget /translations/sp_SP/trace/fprobemodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageEnglishuh1h hh _documenthsourceNlineNubhcomment)}(h SPDX-License-Identifier: GPL-2.0h]h SPDX-License-Identifier: GPL-2.0}hhsbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1hhhhhh:/var/lib/git/docbuild/linux/Documentation/trace/fprobe.rsthKubhsection)}(hhh](htitle)}(h"Fprobe - Function entry/exit probeh]h"Fprobe - Function entry/exit probe}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh)}(h.Author: Masami Hiramatsu h]h.Author: Masami Hiramatsu }hhsbah}(h]h ]h"]h$]h&]hhuh1hhhhhhhhKubh)}(hhh](h)}(h Introductionh]h Introduction}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhK ubh paragraph)}(hXFprobe is a function entry/exit probe based on the function-graph tracing feature in ftrace. Instead of tracing all functions, if you want to attach callbacks on specific function entry and exit, similar to the kprobes and kretprobes, you can use fprobe. Compared with kprobes and kretprobes, fprobe gives faster instrumentation for multiple functions with single handler. This document describes how to use fprobe.h]hXFprobe is a function entry/exit probe based on the function-graph tracing feature in ftrace. Instead of tracing all functions, if you want to attach callbacks on specific function entry and exit, similar to the kprobes and kretprobes, you can use fprobe. Compared with kprobes and kretprobes, fprobe gives faster instrumentation for multiple functions with single handler. This document describes how to use fprobe.}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hhhhubeh}(h] introductionah ]h"] introductionah$]h&]uh1hhhhhhhhK ubh)}(hhh](h)}(hThe usage of fprobeh]hThe usage of fprobe}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hThe fprobe is a wrapper of ftrace (+ kretprobe-like return callback) to attach callbacks to multiple function entry and exit. User needs to set up the `struct fprobe` and pass it to `register_fprobe()`.h](hThe fprobe is a wrapper of ftrace (+ kretprobe-like return callback) to attach callbacks to multiple function entry and exit. User needs to set up the }(hj%hhhNhNubhtitle_reference)}(h`struct fprobe`h]h struct fprobe}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1j-hj%ubh and pass it to }(hj%hhhNhNubj.)}(h`register_fprobe()`h]hregister_fprobe()}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1j-hj%ubh.}(hj%hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hjTypically, `fprobe` data structure is initialized with the `entry_handler` and/or `exit_handler` as below.h](h Typically, }(hjYhhhNhNubj.)}(h`fprobe`h]hfprobe}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1j-hjYubh( data structure is initialized with the }(hjYhhhNhNubj.)}(h`entry_handler`h]h entry_handler}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1j-hjYubh and/or }(hjYhhhNhNubj.)}(h`exit_handler`h]h exit_handler}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j-hjYubh as below.}(hjYhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh literal_block)}(hnstruct fprobe fp = { .entry_handler = my_entry_callback, .exit_handler = my_exit_callback, };h]hnstruct fprobe fp = { .entry_handler = my_entry_callback, .exit_handler = my_exit_callback, };}hjsbah}(h]h ]h"]h$]h&]hhƌforcelanguagechighlight_args}uh1jhhhKhjhhubh)}(hTo enable the fprobe, call one of register_fprobe(), register_fprobe_ips(), and register_fprobe_syms(). These functions register the fprobe with different types of parameters.h]hTo enable the fprobe, call one of register_fprobe(), register_fprobe_ips(), and register_fprobe_syms(). These functions register the fprobe with different types of parameters.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK%hjhhubh)}(hThe register_fprobe() enables a fprobe by function-name filters. E.g. this enables @fp on "func*()" function except "func2()".::h]hThe register_fprobe() enables a fprobe by function-name filters. E.g. this enables @fp on “func*()” function except “func2()”.:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK)hjhhubj)}(h'register_fprobe(&fp, "func*", "func2");h]h'register_fprobe(&fp, "func*", "func2");}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhK,hjhhubh)}(hMThe register_fprobe_ips() enables a fprobe by ftrace-location addresses. E.g.h]hMThe register_fprobe_ips() enables a fprobe by ftrace-location addresses. E.g.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK.hjhhubj)}(hRunsigned long ips[] = { 0x.... }; register_fprobe_ips(&fp, ips, ARRAY_SIZE(ips));h]hRunsigned long ips[] = { 0x.... }; register_fprobe_ips(&fp, ips, ARRAY_SIZE(ips));}hjsbah}(h]h ]h"]h$]h&]hhjjjj}uh1jhhhK1hjhhubh)}(hEAnd the register_fprobe_syms() enables a fprobe by symbol names. E.g.h]hEAnd the register_fprobe_syms() enables a fprobe by symbol names. E.g.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK7hjhhubj)}(h^char syms[] = {"func1", "func2", "func3"}; register_fprobe_syms(&fp, syms, ARRAY_SIZE(syms));h]h^char syms[] = {"func1", "func2", "func3"}; register_fprobe_syms(&fp, syms, ARRAY_SIZE(syms));}hjsbah}(h]h ]h"]h$]h&]hhjjjj}uh1jhhhK:hjhhubh)}(h6To disable (remove from functions) this fprobe, call::h]h5To disable (remove from functions) this fprobe, call:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK@hjhhubj)}(hunregister_fprobe(&fp);h]hunregister_fprobe(&fp);}hj$sbah}(h]h ]h"]h$]h&]hhuh1jhhhKBhjhhubh)}(h1You can temporally (soft) disable the fprobe by::h]h0You can temporally (soft) disable the fprobe by:}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKDhjhhubj)}(hdisable_fprobe(&fp);h]hdisable_fprobe(&fp);}hj@sbah}(h]h ]h"]h$]h&]hhuh1jhhhKFhjhhubh)}(hand resume by::h]hand resume by:}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKHhjhhubj)}(henable_fprobe(&fp);h]henable_fprobe(&fp);}hj\sbah}(h]h ]h"]h$]h&]hhuh1jhhhKJhjhhubh)}(h.The above is defined by including the header::h]h-The above is defined by including the header:}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKLhjhhubj)}(h#include h]h#include }hjxsbah}(h]h ]h"]h$]h&]hhuh1jhhhKNhjhhubh)}(hSame as ftrace, the registered callbacks will start being called some time after the register_fprobe() is called and before it returns. See Documentation/trace/ftrace.rst.h]hSame as ftrace, the registered callbacks will start being called some time after the register_fprobe() is called and before it returns. See Documentation/trace/ftrace.rst.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKPhjhhubh)}(hAlso, the unregister_fprobe() will guarantee that both enter and exit handlers are no longer being called by functions after unregister_fprobe() returns as same as unregister_ftrace_function().h]hAlso, the unregister_fprobe() will guarantee that both enter and exit handlers are no longer being called by functions after unregister_fprobe() returns as same as unregister_ftrace_function().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKThjhhubeh}(h]the-usage-of-fprobeah ]h"]the usage of fprobeah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hThe fprobe entry/exit handlerh]hThe fprobe entry/exit handler}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKYubh)}(hAThe prototype of the entry/exit callback function are as follows:h]hAThe prototype of the entry/exit callback function are as follows:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK[hjhhubj)}(hXint entry_callback(struct fprobe *fp, unsigned long entry_ip, unsigned long ret_ip, struct ftrace_regs *fregs, void *entry_data); void exit_callback(struct fprobe *fp, unsigned long entry_ip, unsigned long ret_ip, struct ftrace_regs *fregs, void *entry_data);h]hXint entry_callback(struct fprobe *fp, unsigned long entry_ip, unsigned long ret_ip, struct ftrace_regs *fregs, void *entry_data); void exit_callback(struct fprobe *fp, unsigned long entry_ip, unsigned long ret_ip, struct ftrace_regs *fregs, void *entry_data);}hjsbah}(h]h ]h"]h$]h&]hhjjjj}uh1jhhhK]hjhhubh)}(hNote that the @entry_ip is saved at function entry and passed to exit handler. If the entry callback function returns !0, the corresponding exit callback will be cancelled.h]hNote that the @entry_ip is saved at function entry and passed to exit handler. If the entry callback function returns !0, the corresponding exit callback will be cancelled.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKchjhhubhdefinition_list)}(hhh](hdefinition_list_item)}(h@fp This is the address of `fprobe` data structure related to this handler. You can embed the `fprobe` to your data structure and get it by container_of() macro from @fp. The @fp must not be NULL. h](hterm)}(h@fph]h@fp}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhhhKkhjubh definition)}(hhh]h)}(hThis is the address of `fprobe` data structure related to this handler. You can embed the `fprobe` to your data structure and get it by container_of() macro from @fp. The @fp must not be NULL.h](hThis is the address of }(hjhhhNhNubj.)}(h`fprobe`h]hfprobe}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j-hjubh; data structure related to this handler. You can embed the }(hjhhhNhNubj.)}(h`fprobe`h]hfprobe}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j-hjubh^ to your data structure and get it by container_of() macro from @fp. The @fp must not be NULL.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKihjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhhhKkhjubj)}(h@entry_ip This is the ftrace address of the traced function (both entry and exit). Note that this may not be the actual entry address of the function but the address where the ftrace is instrumented. h](j)}(h @entry_iph]h @entry_ip}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jhhhKphjDubj)}(hhh]h)}(hThis is the ftrace address of the traced function (both entry and exit). Note that this may not be the actual entry address of the function but the address where the ftrace is instrumented.h]hThis is the ftrace address of the traced function (both entry and exit). Note that this may not be the actual entry address of the function but the address where the ftrace is instrumented.}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKnhjVubah}(h]h ]h"]h$]h&]uh1jhjDubeh}(h]h ]h"]h$]h&]uh1jhhhKphjhhubj)}(h@ret_ip This is the return address that the traced function will return to, somewhere in the caller. This can be used at both entry and exit. h](j)}(h@ret_iph]h@ret_ip}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1jhhhKthjsubj)}(hhh]h)}(hThis is the return address that the traced function will return to, somewhere in the caller. This can be used at both entry and exit.h]hThis is the return address that the traced function will return to, somewhere in the caller. This can be used at both entry and exit.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKshjubah}(h]h ]h"]h$]h&]uh1jhjsubeh}(h]h ]h"]h$]h&]uh1jhhhKthjhhubj)}(h@fregs This is the `ftrace_regs` data structure at the entry and exit. This includes the function parameters, or the return values. So user can access those values via appropriate `ftrace_regs_*` APIs. h](j)}(h@fregsh]h@fregs}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhhhKyhjubj)}(hhh]h)}(hThis is the `ftrace_regs` data structure at the entry and exit. This includes the function parameters, or the return values. So user can access those values via appropriate `ftrace_regs_*` APIs.h](h This is the }(hjhhhNhNubj.)}(h `ftrace_regs`h]h ftrace_regs}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j-hjubh data structure at the entry and exit. This includes the function parameters, or the return values. So user can access those values via appropriate }(hjhhhNhNubj.)}(h`ftrace_regs_*`h]h ftrace_regs_*}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j-hjubh APIs.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKwhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhhhKyhjhhubj)}(hX*@entry_data This is a local storage to share the data between entry and exit handlers. This storage is NULL by default. If the user specify `exit_handler` field and `entry_data_size` field when registering the fprobe, the storage is allocated and passed to both `entry_handler` and `exit_handler`. h](j)}(h @entry_datah]h @entry_data}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhhhKhjubj)}(hhh]h)}(hXThis is a local storage to share the data between entry and exit handlers. This storage is NULL by default. If the user specify `exit_handler` field and `entry_data_size` field when registering the fprobe, the storage is allocated and passed to both `entry_handler` and `exit_handler`.h](hThis is a local storage to share the data between entry and exit handlers. This storage is NULL by default. If the user specify }(hj hhhNhNubj.)}(h`exit_handler`h]h exit_handler}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j-hj ubh field and }(hj hhhNhNubj.)}(h`entry_data_size`h]hentry_data_size}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1j-hj ubhP field when registering the fprobe, the storage is allocated and passed to both }(hj hhhNhNubj.)}(h`entry_handler`h]h entry_handler}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1j-hj ubh and }(hj hhhNhNubj.)}(h`exit_handler`h]h exit_handler}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1j-hj ubh.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK|hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhhhKhjhhubeh}(h]h ]h"]h$]h&]uh1jhjhhhhhNubeh}(h]the-fprobe-entry-exit-handlerah ]h"]the fprobe entry/exit handlerah$]h&]uh1hhhhhhhhKYubh)}(hhh](h)}(h6Entry data size and exit handlers on the same functionh]h6Entry data size and exit handlers on the same function}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjzhhhhhKubh)}(hXSince the entry data is passed via per-task stack and it has limited size, the entry data size per probe is limited to `15 * sizeof(long)`. You also need to take care that the different fprobes are probing on the same function, this limit becomes smaller. The entry data size is aligned to `sizeof(long)` and each fprobe which has exit handler uses a `sizeof(long)` space on the stack, you should keep the number of fprobes on the same function as small as possible.h](hwSince the entry data is passed via per-task stack and it has limited size, the entry data size per probe is limited to }(hjhhhNhNubj.)}(h`15 * sizeof(long)`h]h15 * sizeof(long)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j-hjubh. You also need to take care that the different fprobes are probing on the same function, this limit becomes smaller. The entry data size is aligned to }(hjhhhNhNubj.)}(h`sizeof(long)`h]h sizeof(long)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j-hjubh/ and each fprobe which has exit handler uses a }(hjhhhNhNubj.)}(h`sizeof(long)`h]h sizeof(long)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j-hjubhe space on the stack, you should keep the number of fprobes on the same function as small as possible.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjzhhubeh}(h]6entry-data-size-and-exit-handlers-on-the-same-functionah ]h"]6entry data size and exit handlers on the same functionah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(h Share the callbacks with kprobesh]h Share the callbacks with kprobes}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hSince the recursion safeness of the fprobe (and ftrace) is a bit different from the kprobes, this may cause an issue if user wants to run the same code from the fprobe and the kprobes.h]hSince the recursion safeness of the fprobe (and ftrace) is a bit different from the kprobes, this may cause an issue if user wants to run the same code from the fprobe and the kprobes.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hXKprobes has per-cpu 'current_kprobe' variable which protects the kprobe handler from recursion in all cases. On the other hand, fprobe uses only ftrace_test_recursion_trylock(). This allows interrupt context to call another (or same) fprobe while the fprobe user handler is running.h]hXKprobes has per-cpu ‘current_kprobe’ variable which protects the kprobe handler from recursion in all cases. On the other hand, fprobe uses only ftrace_test_recursion_trylock(). This allows interrupt context to call another (or same) fprobe while the fprobe user handler is running.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hXThis is not a matter if the common callback code has its own recursion detection, or it can handle the recursion in the different contexts (normal/interrupt/NMI.) But if it relies on the 'current_kprobe' recursion lock, it has to check kprobe_running() and use kprobe_busy_*() APIs.h]hXThis is not a matter if the common callback code has its own recursion detection, or it can handle the recursion in the different contexts (normal/interrupt/NMI.) But if it relies on the ‘current_kprobe’ recursion lock, it has to check kprobe_running() and use kprobe_busy_*() APIs.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hFprobe has FPROBE_FL_KPROBE_SHARED flag to do this. If your common callback code will be shared with kprobes, please set FPROBE_FL_KPROBE_SHARED *before* registering the fprobe, like:h](hFprobe has FPROBE_FL_KPROBE_SHARED flag to do this. If your common callback code will be shared with kprobes, please set FPROBE_FL_KPROBE_SHARED }(hjhhhNhNubhemphasis)}(h*before*h]hbefore}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh registering the fprobe, like:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubj)}(hQfprobe.flags = FPROBE_FL_KPROBE_SHARED; register_fprobe(&fprobe, "func*", NULL);h]hQfprobe.flags = FPROBE_FL_KPROBE_SHARED; register_fprobe(&fprobe, "func*", NULL);}hj4sbah}(h]h ]h"]h$]h&]hhjjjj}uh1jhhhKhjhhubh)}(h(struct fprobe *fp, const char *filter, const char *notfilter)h](jw )}(hstruct fprobe *fph](jc)}(hjfh]hstruct}(hjhhhNhNubah}(h]h ]joah"]h$]h&]uh1jbhjubju)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jthjubh)}(hhh]j)}(hfprobeh]hfprobe}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNj j )}j ]j )}j jsbc.register_fprobeasbuh1hhjubju)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jthjubj )}(hj h]h*}(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjubj)}(hfph]hfp}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jv hjubjw )}(hconst char *filterh](jc)}(hconsth]hconst}(hj hhhNhNubah}(h]h ]joah"]h$]h&]uh1jbhjubju)}(h h]h }(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jthjubj9 )}(hcharh]hchar}(hj<hhhNhNubah}(h]h ]jE ah"]h$]h&]uh1j8 hjubju)}(h h]h }(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jthjubj )}(hj h]h*}(hjXhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjubj)}(hfilterh]hfilter}(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jv hjubjw )}(hconst char *notfilterh](jc)}(hj"h]hconst}(hj~hhhNhNubah}(h]h ]joah"]h$]h&]uh1jbhjzubju)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jthjzubj9 )}(hcharh]hchar}(hjhhhNhNubah}(h]h ]jE ah"]h$]h&]uh1j8 hjzubju)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jthjzubj )}(hj h]h*}(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjzubj)}(h notfilterh]h notfilter}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjzubeh}(h]h ]h"]h$]h&]noemphhhuh1jv hjubeh}(h]h ]h"]h$]h&]hhuh1jp hjmhhhjhMubeh}(h]h ]h"]h$]h&]hhjuh1j\jjhjihhhjhMubah}(h]jdah ](jjeh"]h$]h&]jj)jhuh1jVhjhMhjfhhubj)}(hhh]h)}(h%Register fprobe to ftrace by pattern.h]h%Register fprobe to ftrace by pattern.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/trace/fprobe:197: ./kernel/trace/fprobe.chMhjhhubah}(h]h ]h"]h$]h&]uh1jhjfhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jQhhhj/hNhNubj)}(hX**Parameters** ``struct fprobe *fp`` A fprobe data structure to be registered. ``const char *filter`` A wildcard pattern of probed symbols. ``const char *notfilter`` A wildcard pattern of NOT probed symbols. **Description** Register **fp** to ftrace for enabling the probe on the symbols matched to **filter**. If **notfilter** is not NULL, the symbols matched the **notfilter** are not probed. Return 0 if **fp** is registered successfully, -errno if not.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/trace/fprobe:197: ./kernel/trace/fprobe.chMhjubj)}(hhh](j)}(h@``struct fprobe *fp`` A fprobe data structure to be registered. h](j)}(h``struct fprobe *fp``h]j6)}(hj-h]hstruct fprobe *fp}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1j5hj+ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/trace/fprobe:197: ./kernel/trace/fprobe.chMhj'ubj)}(hhh]h)}(h)A fprobe data structure to be registered.h]h)A fprobe data structure to be registered.}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjBhMhjCubah}(h]h ]h"]h$]h&]uh1jhj'ubeh}(h]h ]h"]h$]h&]uh1jhjBhMhj$ubj)}(h=``const char *filter`` A wildcard pattern of probed symbols. h](j)}(h``const char *filter``h]j6)}(hjfh]hconst char *filter}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1j5hjdubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/trace/fprobe:197: ./kernel/trace/fprobe.chMhj`ubj)}(hhh]h)}(h%A wildcard pattern of probed symbols.h]h%A wildcard pattern of probed symbols.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj{hMhj|ubah}(h]h ]h"]h$]h&]uh1jhj`ubeh}(h]h ]h"]h$]h&]uh1jhj{hMhj$ubj)}(hD``const char *notfilter`` A wildcard pattern of NOT probed symbols. h](j)}(h``const char *notfilter``h]j6)}(hjh]hconst char *notfilter}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j5hjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/trace/fprobe:197: ./kernel/trace/fprobe.chMhjubj)}(hhh]h)}(h)A wildcard pattern of NOT probed symbols.h]h)A wildcard pattern of NOT probed symbols.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj$ubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/trace/fprobe:197: ./kernel/trace/fprobe.chMhjubh)}(hRegister **fp** to ftrace for enabling the probe on the symbols matched to **filter**. If **notfilter** is not NULL, the symbols matched the **notfilter** are not probed.h](h Register }(hjhhhNhNubj)}(h**fp**h]hfp}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh< to ftrace for enabling the probe on the symbols matched to }(hjhhhNhNubj)}(h **filter**h]hfilter}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh. If }(hjhhhNhNubj)}(h **notfilter**h]h notfilter}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh& is not NULL, the symbols matched the }(hjhhhNhNubj)}(h **notfilter**h]h notfilter}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh are not probed.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/trace/fprobe:197: ./kernel/trace/fprobe.chMhjubh)}(h=Return 0 if **fp** is registered successfully, -errno if not.h](h Return 0 if }(hjGhhhNhNubj)}(h**fp**h]hfp}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjGubh+ is registered successfully, -errno if not.}(hjGhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/trace/fprobe:197: ./kernel/trace/fprobe.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj/hhhNhNubjA)}(hhh]h}(h]h ]h"]h$]h&]entries](jM register_fprobe_ips (C function)c.register_fprobe_ipshNtauh1j@hj/hhhNhNubjR)}(hhh](jW)}(hJint register_fprobe_ips (struct fprobe *fp, unsigned long *addrs, int num)h]j])}(hIint register_fprobe_ips(struct fprobe *fp, unsigned long *addrs, int num)h](j9 )}(hinth]hint}(hjhhhNhNubah}(h]h ]jE ah"]h$]h&]uh1j8 hjhhhS/var/lib/git/docbuild/linux/Documentation/trace/fprobe:197: ./kernel/trace/fprobe.chMubju)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jthjhhhjhMubj)}(hregister_fprobe_ipsh]j)}(hregister_fprobe_ipsh]hregister_fprobe_ips}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhjhMubjq )}(h2(struct fprobe *fp, unsigned long *addrs, int num)h](jw )}(hstruct fprobe *fph](jc)}(hjfh]hstruct}(hjhhhNhNubah}(h]h ]joah"]h$]h&]uh1jbhjubju)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jthjubh)}(hhh]j)}(hfprobeh]hfprobe}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNj j )}j ]j )}j jsbc.register_fprobe_ipsasbuh1hhjubju)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jthjubj )}(hj h]h*}(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjubj)}(hfph]hfp}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jv hjubjw )}(hunsigned long *addrsh](j9 )}(hunsignedh]hunsigned}(hj7hhhNhNubah}(h]h ]jE ah"]h$]h&]uh1j8 hj3ubju)}(h h]h }(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jthj3ubj9 )}(hlongh]hlong}(hjShhhNhNubah}(h]h ]jE ah"]h$]h&,j]uh1j8 hj3ubju)}(h h]h }(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jthj3ubj )}(hj h]h*}(hjohhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj3ubj)}(haddrsh]haddrs}(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ubeh}(h]h ]h"]h$]h&]noemphhhuh1jv hjubjw )}(hint numh](j9 )}(hinth]hint}(hjhhhNhNubah}(h]h ]jE ah"]h$]h&]uh1j8 hjubju)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jthjubj)}(hnumh]hnum}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jv hjubeh}(h]h ]h"]h$]h&]hhuh1jp hjhhhjhMubeh}(h]h ]h"]h$]h&]hhjuh1j\jjhjhhhjhMubah}(h]j{ah ](jjeh"]h$]h&]jj)jhuh1jVhjhMhj}hhubj)}(hhh]h)}(h%Register fprobe to ftrace by address.h]h%Register fprobe to ftrace by address.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/trace/fprobe:197: ./kernel/trace/fprobe.chMhjhhubah}(h]h ]h"]h$]h&]uh1jhj}hhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jQhhhj/hNhNubj)}(hX***Parameters** ``struct fprobe *fp`` A fprobe data structure to be registered. ``unsigned long *addrs`` An array of target function address. ``int num`` The number of entries of **addrs**. **Description** Register **fp** to ftrace for enabling the probe on the address given by **addrs**. The **addrs** must be the addresses of ftrace location address, which may be the symbol address + arch-dependent offset. If you unsure what this mean, please use other registration functions. Return 0 if **fp** is registered successfully, -errno if not.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/trace/fprobe:197: ./kernel/trace/fprobe.chMhjubj)}(hhh](j)}(h@``struct fprobe *fp`` A fprobe data structure to be registered. h](j)}(h``struct fprobe *fp``h]j6)}(hjh]hstruct fprobe *fp}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j5hjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/trace/fprobe:197: ./kernel/trace/fprobe.chMhjubj)}(hhh]h)}(h)A fprobe data structure to be registered.h]h)A fprobe data structure to be registered.}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj1hMhj2ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj1hMhjubj)}(h>``unsigned long *addrs`` An array of target function address. h](j)}(h``unsigned long *addrs``h]j6)}(hjUh]hunsigned long *addrs}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1j5hjSubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/trace/fprobe:197: ./kernel/trace/fprobe.chMhjOubj)}(hhh]h)}(h$An array of target function address.h]h$An array of target function address.}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjjhMhjkubah}(h]h ]h"]h$]h&]uh1jhjOubeh}(h]h ]h"]h$]h&]uh1jhjjhMhjubj)}(h0``int num`` The number of entries of **addrs**. h](j)}(h ``int num``h]j6)}(hjh]hint num}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j5hjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/trace/fprobe:197: ./kernel/trace/fprobe.chMhjubj)}(hhh]h)}(h#The number of entries of **addrs**.h](hThe number of entries of }(hjhhhNhNubj)}(h **addrs**h]haddrs}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/trace/fprobe:197: ./kernel/trace/fprobe.chMhjubh)}(hXRegister **fp** to ftrace for enabling the probe on the address given by **addrs**. The **addrs** must be the addresses of ftrace location address, which may be the symbol address + arch-dependent offset. If you unsure what this mean, please use other registration functions.h](h Register }(hjhhhNhNubj)}(h**fp**h]hfp}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh: to ftrace for enabling the probe on the address given by }(hjhhhNhNubj)}(h **addrs**h]haddrs}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh. The }(hjhhhNhNubj)}(h **addrs**h]haddrs}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh must be the addresses of ftrace location address, which may be the symbol address + arch-dependent offset. If you unsure what this mean, please use other registration functions.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/trace/fprobe:197: ./kernel/trace/fprobe.chMhjubh)}(h=Return 0 if **fp** is registered successfully, -errno if not.h](h Return 0 if }(hj6hhhNhNubj)}(h**fp**h]hfp}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6ubh+ is registered successfully, -errno if not.}(hj6hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/trace/fprobe:197: ./kernel/trace/fprobe.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj/hhhNhNubjA)}(hhh]h}(h]h ]h"]h$]h&]entries](jM!register_fprobe_syms (C function)c.register_fprobe_symshNtauh1j@hj/hhhNhNubjR)}(hhh](jW)}(hHint register_fprobe_syms (struct fprobe *fp, const char **syms, int num)h]j])}(hGint register_fprobe_syms(struct fprobe *fp, const char **syms, int num)h](j9 )}(hinth]hint}(hjwhhhNhNubah}(h]h ]jE ah"]h$]h&]uh1j8 hjshhhS/var/lib/git/docbuild/linux/Documentation/trace/fprobe:197: ./kernel/trace/fprobe.chMubju)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jthjshhhjhMubj)}(hregister_fprobe_symsh]j)}(hregister_fprobe_symsh]hregister_fprobe_syms}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjshhhjhMubjq )}(h/(struct fprobe *fp, const char **syms, int num)h](jw )}(hstruct fprobe *fph](jc)}(hjfh]hstruct}(hjhhhNhNubah}(h]h ]joah"]h$]h&]uh1jbhjubju)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jthjubh)}(hhh]j)}(hfprobeh]hfprobe}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNj j )}j ]j )}j jsbc.register_fprobe_symsasbuh1hhjubju)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jthjubj )}(hj h]h*}(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjubj)}(hfph]hfp}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jv hjubjw )}(hconst char **symsh](jc)}(hj"h]hconst}(hj&hhhNhNubah}(h]h ]joah"]h$]h&]uh1jbhj"ubju)}(h h]h }(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jthj"ubj9 )}(hcharh]hchar}(hjAhhhNhNubah}(h]h ]jE ah"]h$]h&]uh1j8 hj"ubju)}(h h]h }(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jthj"ubj )}(hj h]h*}(hj]hhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj"ubj )}(hj h]h*}(hjjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj"ubj)}(hsymsh]hsyms}(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubeh}(h]h ]h"]h$]h&]noemphhhuh1jv hjubjw )}(hint numh](j9 )}(hinth]hint}(hjhhhNhNubah}(h]h ]jE ah"]h$]h&]uh1j8 hjubju)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jthjubj)}(hnumh]hnum}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jv hjubeh}(h]h ]h"]h$]h&]hhuh1jp hjshhhjhMubeh}(h]h ]h"]h$]h&]hhjuh1j\jjhjohhhjhMubah}(h]jjah ](jjeh"]h$]h&]jj)jhuh1jVhjhMhjlhhubj)}(hhh]h)}(h%Register fprobe to ftrace by symbols.h]h%Register fprobe to ftrace by symbols.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/trace/fprobe:197: ./kernel/trace/fprobe.chMhjhhubah}(h]h ]h"]h$]h&]uh1jhjlhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jQhhhj/hNhNubj)}(hX**Parameters** ``struct fprobe *fp`` A fprobe data structure to be registered. ``const char **syms`` An array of target symbols. ``int num`` The number of entries of **syms**. **Description** Register **fp** to the symbols given by **syms** array. This will be useful if you are sure the symbols exist in the kernel. Return 0 if **fp** is registered successfully, -errno if not.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/trace/fprobe:197: ./kernel/trace/fprobe.chMhjubj)}(hhh](j)}(h@``struct fprobe *fp`` A fprobe data structure to be registered. h](j)}(h``struct fprobe *fp``h]j6)}(hjh]hstruct fprobe *fp}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j5hjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/trace/fprobe:197: ./kernel/trace/fprobe.chMhjubj)}(hhh]h)}(h)A fprobe data structure to be registered.h]h)A fprobe data structure to be registered.}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj,hMhj-ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj,hMhjubj)}(h2``const char **syms`` An array of target symbols. h](j)}(h``const char **syms``h]j6)}(hjPh]hconst char **syms}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1j5hjNubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/trace/fprobe:197: ./kernel/trace/fprobe.chMhjJubj)}(hhh]h)}(hAn array of target symbols.h]hAn array of target symbols.}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1hhjehMhjfubah}(h]h ]h"]h$]h&]uh1jhjJubeh}(h]h ]h"]h$]h&]uh1jhjehMhjubj)}(h/``int num`` The number of entries of **syms**. h](j)}(h ``int num``h]j6)}(hjh]hint num}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j5hjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/trace/fprobe:197: ./kernel/trace/fprobe.chMhjubj)}(hhh]h)}(h"The number of entries of **syms**.h](hThe number of entries of }(hjhhhNhNubj)}(h**syms**h]hsyms}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/trace/fprobe:197: ./kernel/trace/fprobe.chMhjubh)}(h|Register **fp** to the symbols given by **syms** array. This will be useful if you are sure the symbols exist in the kernel.h](h Register }(hjhhhNhNubj)}(h**fp**h]hfp}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh to the symbols given by }(hjhhhNhNubj)}(h**syms**h]hsyms}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhL array. This will be useful if you are sure the symbols exist in the kernel.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/trace/fprobe:197: ./kernel/trace/fprobe.chMhjubh)}(h=Return 0 if **fp** is registered successfully, -errno if not.h](h Return 0 if }(hjhhhNhNubj)}(h**fp**h]hfp}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh+ is registered successfully, -errno if not.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/trace/fprobe:197: ./kernel/trace/fprobe.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj/hhhNhNubjA)}(hhh]h}(h]h ]h"]h$]h&]entries](jM$unregister_fprobe_async (C function)c.unregister_fprobe_asynchNtauh1j@hj/hhhNhNubjR)}(hhh](jW)}(h/int unregister_fprobe_async (struct fprobe *fp)h]j])}(h.int unregister_fprobe_async(struct fprobe *fp)h](j9 )}(hinth]hint}(hj`hhhNhNubah}(h]h ]jE ah"]h$]h&]uh1j8 hj\hhhS/var/lib/git/docbuild/linux/Documentation/trace/fprobe:197: ./kernel/trace/fprobe.chM^ubju)}(h h]h }(hjohhhNhNubah}(h]h ]jah"]h$]h&]uh1jthj\hhhjnhM^ubj)}(hunregister_fprobe_asynch]j)}(hunregister_fprobe_asynch]hunregister_fprobe_async}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj}ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj\hhhjnhM^ubjq )}(h(struct fprobe *fp)h]jw )}(hstruct fprobe *fph](jc)}(hjfh]hstruct}(hjhhhNhNubah}(h]h ]joah"]h$]h&]uh1jbhjubju)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jthjubh)}(hhh]j)}(hfprobeh]hfprobe}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNj j )}j ]j )}j jsbc.unregister_fprobe_asyncasbuh1hhjubju)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jthjubj )}(hj h]h*}(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hjubj)}(hfph]hfp}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jv hjubah}(h]h ]h"]h$]h&]hhuh1jp hj\hhhjnhM^ubeh}(h]h ]h"]h$]h&]hhjuh1j\jjhjXhhhjnhM^ubah}(h]jSah ](jjeh"]h$]h&]jj)jhuh1jVhjnhM^hjUhhubj)}(hhh]h)}(h%Unregister fprobe without RCU GP waith]h%Unregister fprobe without RCU GP wait}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/trace/fprobe:197: ./kernel/trace/fprobe.chM^hjhhubah}(h]h ]h"]h$]h&]uh1jhjUhhhjnhM^ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj8jj8jjjuh1jQhhhj/hNhNubj)}(hX-**Parameters** ``struct fprobe *fp`` A fprobe data structure to be unregistered. **Description** Unregister fprobe (and remove ftrace hooks from the function entries). This function will NOT wait until the fprobe is no longer used. Return 0 if **fp** is unregistered successfully, -errno if not.h](h)}(h**Parameters**h]j)}(hjBh]h Parameters}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj@ubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/trace/fprobe:197: ./kernel/trace/fprobe.chMbhj<ubj)}(hhh]j)}(hB``struct fprobe *fp`` A fprobe data structure to be unregistered. h](j)}(h``struct fprobe *fp``h]j6)}(hjah]hstruct fprobe *fp}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1j5hj_ubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/trace/fprobe:197: ./kernel/trace/fprobe.chM_hj[ubj)}(hhh]h)}(h+A fprobe data structure to be unregistered.h]h+A fprobe data structure to be unregistered.}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjvhM_hjwubah}(h]h ]h"]h$]h&]uh1jhj[ubeh}(h]h ]h"]h$]h&]uh1jhjvhM_hjXubah}(h]h ]h"]h$]h&]uh1jhj<ubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/trace/fprobe:197: ./kernel/trace/fprobe.chMahj<ubh)}(hUnregister fprobe (and remove ftrace hooks from the function entries). This function will NOT wait until the fprobe is no longer used.h]hUnregister fprobe (and remove ftrace hooks from the function entries). This function will NOT wait until the fprobe is no longer used.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/trace/fprobe:197: ./kernel/trace/fprobe.chM`hj<ubh)}(h?Return 0 if **fp** is unregistered successfully, -errno if not.h](h Return 0 if }(hjhhhNhNubj)}(h**fp**h]hfp}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh- is unregistered successfully, -errno if not.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/trace/fprobe:197: ./kernel/trace/fprobe.chMchj<ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj/hhhNhNubjA)}(hhh]h}(h]h ]h"]h$]h&]entries](jMunregister_fprobe (C function)c.unregister_fprobehNtauh1j@hj/hhhNhNubjR)}(hhh](jW)}(h)int unregister_fprobe (struct fprobe *fp)h]j])}(h(int unregister_fprobe(struct fprobe *fp)h](j9 )}(hinth]hint}(hjhhhNhNubah}(h]h ]jE ah"]h$]h&]uh1j8 hjhhhS/var/lib/git/docbuild/linux/Documentation/trace/fprobe:197: ./kernel/trace/fprobe.chMpubju)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jthjhhhjhMpubj)}(hunregister_fprobeh]j)}(hunregister_fprobeh]hunregister_fprobe}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhjhMpubjq )}(h(struct fprobe *fp)h]jw )}(hstruct fprobe *fph](jc)}(hjfh]hstruct}(hj?hhhNhNubah}(h]h ]joah"]h$]h&]uh1jbhj;ubju)}(h h]h }(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jthj;ubh)}(hhh]j)}(hfprobeh]hfprobe}(hj]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj_modnameN classnameNj j )}j ]j )}j j%sbc.unregister_fprobeasbuh1hhj;ubju)}(h h]h }(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jthj;ubj )}(hj h]h*}(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1j hj;ubj)}(hfph]hfp}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubeh}(h]h ]h"]h$]h&]noemphhhuh1jv hj7ubah}(h]h ]h"]h$]h&]hhuh1jp hjhhhjhMpubeh}(h]h ]h"]h$]h&]hhjuh1j\jjhjhhhjhMpubah}(h]jah ](jjeh"]h$]h&]jj)jhuh1jVhjhMphjhhubj)}(hhh]h)}(h"Unregister fprobe with RCU GP waith]h"Unregister fprobe with RCU GP wait}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/trace/fprobe:197: ./kernel/trace/fprobe.chMphjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhMpubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1jQhhhj/hNhNubj)}(hX***Parameters** ``struct fprobe *fp`` A fprobe data structure to be unregistered. **Description** Unregister fprobe (and remove ftrace hooks from the function entries). This function will block until the fprobe is no longer used. Return 0 if **fp** is unregistered successfully, -errno if not.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/trace/fprobe:197: ./kernel/trace/fprobe.chMthjubj)}(hhh]j)}(hB``struct fprobe *fp`` A fprobe data structure to be unregistered. h](j)}(h``struct fprobe *fp``h]j6)}(hjh]hstruct fprobe *fp}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j5hjubah}(h]h ]h"]h$]h&]uh1jhS/var/lib/git/docbuild/linux/Documentation/trace/fprobe:197: ./kernel/trace/fprobe.chMqhjubj)}(hhh]h)}(h+A fprobe data structure to be unregistered.h]h+A fprobe data structure to be unregistered.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMqhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMqhjubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hj>h]h Description}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj<ubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/trace/fprobe:197: ./kernel/trace/fprobe.chMshjubh)}(hUnregister fprobe (and remove ftrace hooks from the function entries). This function will block until the fprobe is no longer used.h]hUnregister fprobe (and remove ftrace hooks from the function entries). This function will block until the fprobe is no longer used.}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/trace/fprobe:197: ./kernel/trace/fprobe.chMrhjubh)}(h?Return 0 if **fp** is unregistered successfully, -errno if not.h](h Return 0 if }(hjchhhNhNubj)}(h**fp**h]hfp}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjcubh- is unregistered successfully, -errno if not.}(hjchhhNhNubeh}(h]h ]h"]h$]h&]uh1hhS/var/lib/git/docbuild/linux/Documentation/trace/fprobe:197: ./kernel/trace/fprobe.chMuhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj/hhhNhNubeh}(h]functions-and-structuresah ]h"]functions and structuresah$]h&]uh1hhhhhhhhKubeh}(h] fprobe-function-entry-exit-probeah ]h"]"fprobe - function entry/exit probeah$]h&]uh1hhhhhhhhKubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(hN generatorN datestampN source_linkN source_urlN toc_backlinksentryfootnote_backlinksK sectnum_xformKstrip_commentsNstrip_elements_with_classesN strip_classesN report_levelK halt_levelKexit_status_levelKdebugNwarning_streamN tracebackinput_encoding utf-8-siginput_encoding_error_handlerstrictoutput_encodingutf-8output_encoding_error_handlerjerror_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourcehnj _destinationN _config_files]7/var/lib/git/docbuild/linux/Documentation/docutils.confafile_insertion_enabled raw_enabledKline_length_limitM'pep_referencesN pep_base_urlhttps://peps.python.org/pep_file_url_templatepep-%04drfc_referencesN rfc_base_url&https://datatracker.ietf.org/doc/html/ tab_widthKtrim_footnote_reference_spacesyntax_highlightlong smart_quotessmartquotes_locales]character_level_inline_markupdoctitle_xform docinfo_xformKsectsubtitle_xform image_loadinglinkembed_stylesheetcloak_email_addressessection_self_linkenvNubreporterNindirect_targets]substitution_defs}substitution_names}refnames}refids}nameids}(jjjjjjjwjtjjjVjSj,j)jju nametypes}(jjjjwjjVj,juh}(jhjhjjjtjjjzjSjj)jYjj/jOjXjj j j j+ j0 j j jdjij{jjjjojSjXjju footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}Rparse_messages]transform_messages] transformerN include_log] decorationNhhub.