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/core-api/debug-objectsmodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget*/translations/zh_TW/core-api/debug-objectsmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget*/translations/it_IT/core-api/debug-objectsmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget*/translations/ja_JP/core-api/debug-objectsmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget*/translations/ko_KR/core-api/debug-objectsmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hPortuguese (Brazilian)}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget*/translations/pt_BR/core-api/debug-objectsmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget*/translations/sp_SP/core-api/debug-objectsmodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageEnglishuh1h hh _documenthsourceNlineNubhsection)}(hhh](htitle)}(h,The object-lifetime debugging infrastructureh]h,The object-lifetime debugging infrastructure}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhD/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects.rsthKubh field_list)}(hhh]hfield)}(hhh](h field_name)}(hAuthorh]hAuthor}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhKubh field_body)}(hThomas Gleixner h]h paragraph)}(hThomas Gleixnerh]hThomas Gleixner}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhubah}(h]h ]h"]h$]h&]uh1hhhubeh}(h]h ]h"]h$]h&]uh1hhhhKhhhhubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(h Introductionh]h Introduction}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhKubh)}(hwdebugobjects is a generic infrastructure to track the life time of kernel objects and validate the operations on those.h]hwdebugobjects is a generic infrastructure to track the life time of kernel objects and validate the operations on those.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hj hhubh)}(hAdebugobjects is useful to check for the following error patterns:h]hAdebugobjects is useful to check for the following error patterns:}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hj hhubh bullet_list)}(hhh](h list_item)}(h$Activation of uninitialized objects h]h)}(h#Activation of uninitialized objectsh]h#Activation of uninitialized objects}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjAubah}(h]h ]h"]h$]h&]uh1j?hj<hhhhhNubj@)}(h!Initialization of active objects h]h)}(h Initialization of active objectsh]h Initialization of active objects}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjYubah}(h]h ]h"]h$]h&]uh1j?hj<hhhhhNubj@)}(h!Usage of freed/destroyed objects h]h)}(h Usage of freed/destroyed objectsh]h Usage of freed/destroyed objects}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjqubah}(h]h ]h"]h$]h&]uh1j?hj<hhhhhNubeh}(h]h ]h"]h$]h&]bullet-uh1j:hhhKhj hhubh)}(hdebugobjects is not changing the data structure of the real object so it can be compiled in with a minimal runtime impact and enabled on demand with a kernel command line option.h]hdebugobjects is not changing the data structure of the real object so it can be compiled in with a minimal runtime impact and enabled on demand with a kernel command line option.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj hhubeh}(h] introductionah ]h"] introductionah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hHowto use debugobjectsh]hHowto use debugobjects}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hXA kernel subsystem needs to provide a data structure which describes the object type and add calls into the debug code at appropriate places. The data structure to describe the object type needs at minimum the name of the object type. Optional functions can and should be provided to fixup detected problems so the kernel can continue to work and the debug information can be retrieved from a live system instead of hard core debugging with serial consoles and stack trace transcripts from the monitor.h]hXA kernel subsystem needs to provide a data structure which describes the object type and add calls into the debug code at appropriate places. The data structure to describe the object type needs at minimum the name of the object type. Optional functions can and should be provided to fixup detected problems so the kernel can continue to work and the debug information can be retrieved from a live system instead of hard core debugging with serial consoles and stack trace transcripts from the monitor.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(h-The debug calls provided by debugobjects are:h]h-The debug calls provided by debugobjects are:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK%hjhhubj;)}(hhh](j@)}(hdebug_object_init h]h)}(hdebug_object_inith]hdebug_object_init}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK'hjubah}(h]h ]h"]h$]h&]uh1j?hjhhhhhNubj@)}(hdebug_object_init_on_stack h]h)}(hdebug_object_init_on_stackh]hdebug_object_init_on_stack}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK)hjubah}(h]h ]h"]h$]h&]uh1j?hjhhhhhNubj@)}(hdebug_object_activate h]h)}(hdebug_object_activateh]hdebug_object_activate}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK+hjubah}(h]h ]h"]h$]h&]uh1j?hjhhhhhNubj@)}(hdebug_object_deactivate h]h)}(hdebug_object_deactivateh]hdebug_object_deactivate}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK-hjubah}(h]h ]h"]h$]h&]uh1j?hjhhhhhNubj@)}(hdebug_object_destroy h]h)}(hdebug_object_destroyh]hdebug_object_destroy}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK/hj7ubah}(h]h ]h"]h$]h&]uh1j?hjhhhhhNubj@)}(hdebug_object_free h]h)}(hdebug_object_freeh]hdebug_object_free}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK1hjOubah}(h]h ]h"]h$]h&]uh1j?hjhhhhhNubj@)}(hdebug_object_assert_init h]h)}(hdebug_object_assert_inith]hdebug_object_assert_init}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK3hjgubah}(h]h ]h"]h$]h&]uh1j?hjhhhhhNubeh}(h]h ]h"]h$]h&]jjuh1j:hhhK'hjhhubh)}(hEach of these functions takes the address of the real object and a pointer to the object type specific debug description structure.h]hEach of these functions takes the address of the real object and a pointer to the object type specific debug description structure.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK5hjhhubh)}(h|Each detected error is reported in the statistics and a limited number of errors are printk'ed including a full stack trace.h]h~Each detected error is reported in the statistics and a limited number of errors are printk’ed including a full stack trace.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK8hjhhubh)}(hXThe statistics are available via /sys/kernel/debug/debug_objects/stats. They provide information about the number of warnings and the number of successful fixups along with information about the usage of the internal tracking objects and the state of the internal tracking objects pool.h]hXThe statistics are available via /sys/kernel/debug/debug_objects/stats. They provide information about the number of warnings and the number of successful fixups along with information about the usage of the internal tracking objects and the state of the internal tracking objects pool.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK;hjhhubeh}(h]howto-use-debugobjectsah ]h"]howto use debugobjectsah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hDebug functionsh]hDebug functions}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKAubhindex)}(hhh]h}(h]h ]h"]h$]h&]entries](singledebug_object_init (C function)c.debug_object_inithNtauh1jhjhhhNhNubhdesc)}(hhh](hdesc_signature)}(hHvoid debug_object_init (void *addr, const struct debug_obj_descr *descr)h]hdesc_signature_line)}(hGvoid debug_object_init(void *addr, const struct debug_obj_descr *descr)h](hdesc_sig_keyword_type)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]ktah"]h$]h&]uh1jhjhhhY/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:67: ./lib/debugobjects.chM9ubhdesc_sig_space)}(h h]h }(hjhhhNhNubah}(h]h ]wah"]h$]h&]uh1jhjhhhjhM9ubh desc_name)}(hdebug_object_inith]h desc_sig_name)}(hdebug_object_inith]hdebug_object_init}(hjhhhNhNubah}(h]h ]nah"]h$]h&]uh1jhjubah}(h]h ](sig-namedescnameeh"]h$]h&] xml:spacepreserveuh1j hjhhhjhM9ubhdesc_parameterlist)}(h1(void *addr, const struct debug_obj_descr *descr)h](hdesc_parameter)}(h void *addrh](j)}(hvoidh]hvoid}(hj:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6ubj)}(h h]h }(hjHhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj6ubhdesc_sig_punctuation)}(h*h]h*}(hjXhhhNhNubah}(h]h ]pah"]h$]h&]uh1jVhj6ubj)}(haddrh]haddr}(hjghhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj6ubeh}(h]h ]h"]h$]h&]noemphj,j-uh1j4hj0ubj5)}(h#const struct debug_obj_descr *descrh](hdesc_sig_keyword)}(hconsth]hconst}(hjhhhNhNubah}(h]h ]kah"]h$]h&]uh1jhj|ubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj|ubj)}(hstructh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|ubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj|ubh)}(hhh]j)}(hdebug_obj_descrh]hdebug_obj_descr}(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomaincreftype identifier reftargetjmodnameN classnameN c:parent_keysphinx.domains.c LookupKey)}data]j ASTIdentifier)}jjsbc.debug_object_initasbuh1hhj|ubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj|ubjW)}(hjZh]h*}(hjhhhNhNubah}(h]h ]jcah"]h$]h&]uh1jVhj|ubj)}(hdescrh]hdescr}(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj|ubeh}(h]h ]h"]h$]h&]noemphj,j-uh1j4hj0ubeh}(h]h ]h"]h$]h&]j,j-uh1j.hjhhhjhM9ubeh}(h]h ]h"]h$]h&]j,j- add_permalinkuh1jsphinx_line_type declaratorhjhhhjhM9ubah}(h]jah ](sig sig-objecteh"]h$]h&] is_multiline _toc_parts) _toc_namehuh1jhjhM9hjhhubh desc_content)}(hhh]h)}(h*debug checks when an object is initializedh]h*debug checks when an object is initialized}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:67: ./lib/debugobjects.chM9hj3hhubah}(h]h ]h"]h$]h&]uh1j1hjhhhjhM9ubeh}(h]h ](jfunctioneh"]h$]h&]domainjobjtypejNdesctypejNnoindex noindexentrynocontentsentryuh1jhhhjhNhNubh container)}(h**Parameters** ``void *addr`` address of the object ``const struct debug_obj_descr *descr`` pointer to an object specific debug description structureh](h)}(h**Parameters**h]hstrong)}(hj`h]h Parameters}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1jbhj^ubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:67: ./lib/debugobjects.chM=hjZubhdefinition_list)}(hhh](hdefinition_list_item)}(h%``void *addr`` address of the object h](hterm)}(h``void *addr``h]hliteral)}(hjh]h void *addr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:67: ./lib/debugobjects.chM:hjubh definition)}(hhh]h)}(haddress of the objecth]haddress of the object}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM:hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1j}hjhM:hjzubj~)}(ha``const struct debug_obj_descr *descr`` pointer to an object specific debug description structureh](j)}(h'``const struct debug_obj_descr *descr``h]j)}(hjh]h#const struct debug_obj_descr *descr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:67: ./lib/debugobjects.chM<hjubj)}(hhh]h)}(h9pointer to an object specific debug description structureh]h9pointer to an object specific debug description structure}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:67: ./lib/debugobjects.chM;hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1j}hjhM<hjzubeh}(h]h ]h"]h$]h&]uh1jxhjZubeh}(h]h ] kernelindentah"]h$]h&]uh1jXhjhhhNhNubh)}(hXThis function is called whenever the initialization function of a real object is called.h]hXThis function is called whenever the initialization function of a real object is called.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKFhjhhubh)}(hXWhen the real object is already tracked by debugobjects it is checked, whether the object can be initialized. Initializing is not allowed for active and destroyed objects. When debugobjects detects an error, then it calls the fixup_init function of the object type description structure if provided by the caller. The fixup function can correct the problem before the real initialization of the object happens. E.g. it can deactivate an active object in order to prevent damage to the subsystem.h]hXWhen the real object is already tracked by debugobjects it is checked, whether the object can be initialized. Initializing is not allowed for active and destroyed objects. When debugobjects detects an error, then it calls the fixup_init function of the object type description structure if provided by the caller. The fixup function can correct the problem before the real initialization of the object happens. E.g. it can deactivate an active object in order to prevent damage to the subsystem.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKIhjhhubh)}(hXWhen the real object is not yet tracked by debugobjects, debugobjects allocates a tracker object for the real object and sets the tracker object state to ODEBUG_STATE_INIT. It verifies that the object is not on the callers stack. If it is on the callers stack then a limited number of warnings including a full stack trace is printk'ed. The calling code must use debug_object_init_on_stack() and remove the object before leaving the function which allocated it. See next section.h]hXWhen the real object is not yet tracked by debugobjects, debugobjects allocates a tracker object for the real object and sets the tracker object state to ODEBUG_STATE_INIT. It verifies that the object is not on the callers stack. If it is on the callers stack then a limited number of warnings including a full stack trace is printk’ed. The calling code must use debug_object_init_on_stack() and remove the object before leaving the function which allocated it. See next section.}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKRhjhhubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j'debug_object_init_on_stack (C function)c.debug_object_init_on_stackhNtauh1jhjhhhNhNubj)}(hhh](j)}(hQvoid debug_object_init_on_stack (void *addr, const struct debug_obj_descr *descr)h]j)}(hPvoid debug_object_init_on_stack(void *addr, const struct debug_obj_descr *descr)h](j)}(hvoidh]hvoid}(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDhhhY/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:90: ./lib/debugobjects.chMGubj)}(h h]h }(hjWhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjDhhhjVhMGubj)}(hdebug_object_init_on_stackh]j)}(hdebug_object_init_on_stackh]hdebug_object_init_on_stack}(hjihhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjeubah}(h]h ](j'j(eh"]h$]h&]j,j-uh1j hjDhhhjVhMGubj/)}(h1(void *addr, const struct debug_obj_descr *descr)h](j5)}(h void *addrh](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjW)}(hjZh]h*}(hjhhhNhNubah}(h]h ]jcah"]h$]h&]uh1jVhjubj)}(haddrh]haddr}(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj,j-uh1j4hj}ubj5)}(h#const struct debug_obj_descr *descrh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubj)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubh)}(hhh]j)}(hdebug_obj_descrh]hdebug_obj_descr}(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj)}j]j)}jjksbc.debug_object_init_on_stackasbuh1hhjubj)}(h h]h }(hj hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjW)}(hjZh]h*}(hj.hhhNhNubah}(h]h ]jcah"]h$]h&]uh1jVhjubj)}(hdescrh]hdescr}(hj;hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj,j-uh1j4hj}ubeh}(h]h ]h"]h$]h&]j,j-uh1j.hjDhhhjVhMGubeh}(h]h ]h"]h$]h&]j,j-j#uh1jj$j%hj@hhhjVhMGubah}(h]j;ah ](j)j*eh"]h$]h&]j.j/)j0huh1jhjVhMGhj=hhubj2)}(hhh]h)}(h3debug checks when an object on stack is initializedh]h3debug checks when an object on stack is initialized}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:90: ./lib/debugobjects.chMGhjbhhubah}(h]h ]h"]h$]h&]uh1j1hj=hhhjVhMGubeh}(h]h ](jfunctioneh"]h$]h&]jRjjSj}jTj}jUjVjWuh1jhhhjhNhNubjY)}(h**Parameters** ``void *addr`` address of the object ``const struct debug_obj_descr *descr`` pointer to an object specific debug description structureh](h)}(h**Parameters**h]jc)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jbhjubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:90: ./lib/debugobjects.chMKhjubjy)}(hhh](j~)}(h%``void *addr`` address of the object h](j)}(h``void *addr``h]j)}(hjh]h void *addr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:90: ./lib/debugobjects.chMIhjubj)}(hhh]h)}(haddress of the objecth]haddress of the object}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMIhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1j}hjhMIhjubj~)}(ha``const struct debug_obj_descr *descr`` pointer to an object specific debug description structureh](j)}(h'``const struct debug_obj_descr *descr``h]j)}(hjh]h#const struct debug_obj_descr *descr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhY/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:90: ./lib/debugobjects.chMKhjubj)}(hhh]h)}(h9pointer to an object specific debug description structureh]h9pointer to an object specific debug description structure}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhY/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:90: ./lib/debugobjects.chMJhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1j}hjhMKhjubeh}(h]h ]h"]h$]h&]uh1jxhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jXhjhhhNhNubh)}(hsThis function is called whenever the initialization function of a real object which resides on the stack is called.h]hsThis function is called whenever the initialization function of a real object which resides on the stack is called.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK]hjhhubh)}(hXWhen the real object is already tracked by debugobjects it is checked, whether the object can be initialized. Initializing is not allowed for active and destroyed objects. When debugobjects detects an error, then it calls the fixup_init function of the object type description structure if provided by the caller. The fixup function can correct the problem before the real initialization of the object happens. E.g. it can deactivate an active object in order to prevent damage to the subsystem.h]hXWhen the real object is already tracked by debugobjects it is checked, whether the object can be initialized. Initializing is not allowed for active and destroyed objects. When debugobjects detects an error, then it calls the fixup_init function of the object type description structure if provided by the caller. The fixup function can correct the problem before the real initialization of the object happens. E.g. it can deactivate an active object in order to prevent damage to the subsystem.}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK`hjhhubh)}(hWhen the real object is not yet tracked by debugobjects debugobjects allocates a tracker object for the real object and sets the tracker object state to ODEBUG_STATE_INIT. It verifies that the object is on the callers stack.h]hWhen the real object is not yet tracked by debugobjects debugobjects allocates a tracker object for the real object and sets the tracker object state to ODEBUG_STATE_INIT. It verifies that the object is on the callers stack.}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKihjhhubh)}(hAn object which is on the stack must be removed from the tracker by calling debug_object_free() before the function which allocates the object returns. Otherwise we keep track of stale objects.h]hAn object which is on the stack must be removed from the tracker by calling debug_object_free() before the function which allocates the object returns. Otherwise we keep track of stale objects.}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKnhjhhubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j"debug_object_activate (C function)c.debug_object_activatehNtauh1jhjhhhNhNubj)}(hhh](j)}(hKint debug_object_activate (void *addr, const struct debug_obj_descr *descr)h]j)}(hJint debug_object_activate(void *addr, const struct debug_obj_descr *descr)h](j)}(hinth]hint}(hjqhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmhhhZ/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:114: ./lib/debugobjects.chMVubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjmhhhjhMVubj)}(hdebug_object_activateh]j)}(hdebug_object_activateh]hdebug_object_activate}(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubah}(h]h ](j'j(eh"]h$]h&]j,j-uh1j hjmhhhjhMVubj/)}(h1(void *addr, const struct debug_obj_descr *descr)h](j5)}(h void *addrh](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjW)}(hjZh]h*}(hjhhhNhNubah}(h]h ]jcah"]h$]h&]uh1jVhjubj)}(haddrh]haddr}(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj,j-uh1j4hjubj5)}(h#const struct debug_obj_descr *descrh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubj)}(hjh]hstruct}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubh)}(hhh]j)}(hdebug_obj_descrh]hdebug_obj_descr}(hj)hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj&ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj+modnameN classnameNjj)}j]j)}jjsbc.debug_object_activateasbuh1hhjubj)}(h h]h }(hjIhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjW)}(hjZh]h*}(hjWhhhNhNubah}(h]h ]jcah"]h$]h&]uh1jVhjubj)}(hdescrh]hdescr}(hjdhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj,j-uh1j4hjubeh}(h]h ]h"]h$]h&]j,j-uh1j.hjmhhhjhMVubeh}(h]h ]h"]h$]h&]j,j-j#uh1jj$j%hjihhhjhMVubah}(h]jdah ](j)j*eh"]h$]h&]j.j/)j0huh1jhjhMVhjfhhubj2)}(hhh]h)}(h(debug checks when an object is activatedh]h(debug checks when an object is activated}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:114: ./lib/debugobjects.chMVhjhhubah}(h]h ]h"]h$]h&]uh1j1hjfhhhjhMVubeh}(h]h ](jfunctioneh"]h$]h&]jRjjSjjTjjUjVjWuh1jhhhjhNhNubjY)}(h**Parameters** ``void *addr`` address of the object ``const struct debug_obj_descr *descr`` pointer to an object specific debug description structure Returns 0 for success, -EINVAL for check failed.h](h)}(h**Parameters**h]jc)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jbhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:114: ./lib/debugobjects.chMZhjubjy)}(hhh](j~)}(h%``void *addr`` address of the object h](j)}(h``void *addr``h]j)}(hjh]h void *addr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:114: ./lib/debugobjects.chMWhjubj)}(hhh]h)}(haddress of the objecth]haddress of the object}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMWhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1j}hjhMWhjubj~)}(h``const struct debug_obj_descr *descr`` pointer to an object specific debug description structure Returns 0 for success, -EINVAL for check failed.h](j)}(h'``const struct debug_obj_descr *descr``h]j)}(hj h]h#const struct debug_obj_descr *descr}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:114: ./lib/debugobjects.chMXhj ubj)}(hhh]h)}(hjpointer to an object specific debug description structure Returns 0 for success, -EINVAL for check failed.h]hjpointer to an object specific debug description structure Returns 0 for success, -EINVAL for check failed.}(hj! hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMXhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1j}hj hMXhjubeh}(h]h ]h"]h$]h&]uh1jxhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jXhjhhhNhNubh)}(hTThis function is called whenever the activation function of a real object is called.h]hTThis function is called whenever the activation function of a real object is called.}(hjH hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKuhjhhubh)}(hXWhen the real object is already tracked by debugobjects it is checked, whether the object can be activated. Activating is not allowed for active and destroyed objects. When debugobjects detects an error, then it calls the fixup_activate function of the object type description structure if provided by the caller. The fixup function can correct the problem before the real activation of the object happens. E.g. it can deactivate an active object in order to prevent damage to the subsystem.h]hXWhen the real object is already tracked by debugobjects it is checked, whether the object can be activated. Activating is not allowed for active and destroyed objects. When debugobjects detects an error, then it calls the fixup_activate function of the object type description structure if provided by the caller. The fixup function can correct the problem before the real activation of the object happens. E.g. it can deactivate an active object in order to prevent damage to the subsystem.}(hjV hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKxhjhhubh)}(hXcWhen the real object is not yet tracked by debugobjects then the fixup_activate function is called if available. This is necessary to allow the legitimate activation of statically allocated and initialized objects. The fixup function checks whether the object is valid and calls the debug_objects_init() function to initialize the tracking of this object.h]hXcWhen the real object is not yet tracked by debugobjects then the fixup_activate function is called if available. This is necessary to allow the legitimate activation of statically allocated and initialized objects. The fixup function checks whether the object is valid and calls the debug_objects_init() function to initialize the tracking of this object.}(hjd hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hqWhen the activation is legitimate, then the state of the associated tracker object is set to ODEBUG_STATE_ACTIVE.h]hqWhen the activation is legitimate, then the state of the associated tracker object is set to ODEBUG_STATE_ACTIVE.}(hjr hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j$debug_object_deactivate (C function)c.debug_object_deactivatehNtauh1jhjhhhNhNubj)}(hhh](j)}(hNvoid debug_object_deactivate (void *addr, const struct debug_obj_descr *descr)h]j)}(hMvoid debug_object_deactivate(void *addr, const struct debug_obj_descr *descr)h](j)}(hvoidh]hvoid}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhZ/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:139: ./lib/debugobjects.chMubj)}(h h]h }(hj hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj hhhj hMubj)}(hdebug_object_deactivateh]j)}(hdebug_object_deactivateh]hdebug_object_deactivate}(hj hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj ubah}(h]h ](j'j(eh"]h$]h&]j,j-uh1j hj hhhj hMubj/)}(h1(void *addr, const struct debug_obj_descr *descr)h](j5)}(h void *addrh](j)}(hvoidh]hvoid}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj ubjW)}(hjZh]h*}(hj hhhNhNubah}(h]h ]jcah"]h$]h&]uh1jVhj ubj)}(haddrh]haddr}(hj hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphj,j-uh1j4hj ubj5)}(h#const struct debug_obj_descr *descrh](j)}(hjh]hconst}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj% hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj ubj)}(hjh]hstruct}(hj3 hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj@ hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj ubh)}(hhh]j)}(hdebug_obj_descrh]hdebug_obj_descr}(hjQ hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjN ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjS modnameN classnameNjj)}j]j)}jj sbc.debug_object_deactivateasbuh1hhj ubj)}(h h]h }(hjq hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj ubjW)}(hjZh]h*}(hj hhhNhNubah}(h]h ]jcah"]h$]h&]uh1jVhj ubj)}(hdescrh]hdescr}(hj hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphj,j-uh1j4hj ubeh}(h]h ]h"]h$]h&]j,j-uh1j.hj hhhj hMubeh}(h]h ]h"]h$]h&]j,j-j#uh1jj$j%hj hhhj hMubah}(h]j ah ](j)j*eh"]h$]h&]j.j/)j0huh1jhj hMhj hhubj2)}(hhh]h)}(h*debug checks when an object is deactivatedh]h*debug checks when an object is deactivated}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:139: ./lib/debugobjects.chMhj hhubah}(h]h ]h"]h$]h&]uh1j1hj hhhj hMubeh}(h]h ](jfunctioneh"]h$]h&]jRjjSj jTj jUjVjWuh1jhhhjhNhNubjY)}(h**Parameters** ``void *addr`` address of the object ``const struct debug_obj_descr *descr`` pointer to an object specific debug description structureh](h)}(h**Parameters**h]jc)}(hj h]h Parameters}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jbhj ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:139: ./lib/debugobjects.chMhj ubjy)}(hhh](j~)}(h%``void *addr`` address of the object h](j)}(h``void *addr``h]j)}(hj h]h void *addr}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:139: ./lib/debugobjects.chMhj ubj)}(hhh]h)}(haddress of the objecth]haddress of the object}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1j}hj hMhj ubj~)}(ha``const struct debug_obj_descr *descr`` pointer to an object specific debug description structureh](j)}(h'``const struct debug_obj_descr *descr``h]j)}(hj0 h]h#const struct debug_obj_descr *descr}(hj2 hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj. ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:139: ./lib/debugobjects.chMhj* ubj)}(hhh]h)}(h9pointer to an object specific debug description structureh]h9pointer to an object specific debug description structure}(hjI hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:139: ./lib/debugobjects.chMhjF ubah}(h]h ]h"]h$]h&]uh1jhj* ubeh}(h]h ]h"]h$]h&]uh1j}hjE hMhj ubeh}(h]h ]h"]h$]h&]uh1jxhj ubeh}(h]h ] kernelindentah"]h$]h&]uh1jXhjhhhNhNubh)}(hVThis function is called whenever the deactivation function of a real object is called.h]hVThis function is called whenever the deactivation function of a real object is called.}(hjq hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hWhen the real object is tracked by debugobjects it is checked, whether the object can be deactivated. Deactivating is not allowed for untracked or destroyed objects.h]hWhen the real object is tracked by debugobjects it is checked, whether the object can be deactivated. Deactivating is not allowed for untracked or destroyed objects.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(huWhen the deactivation is legitimate, then the state of the associated tracker object is set to ODEBUG_STATE_INACTIVE.h]huWhen the deactivation is legitimate, then the state of the associated tracker object is set to ODEBUG_STATE_INACTIVE.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j!debug_object_destroy (C function)c.debug_object_destroyhNtauh1jhjhhhNhNubj)}(hhh](j)}(hKvoid debug_object_destroy (void *addr, const struct debug_obj_descr *descr)h]j)}(hJvoid debug_object_destroy(void *addr, const struct debug_obj_descr *descr)h](j)}(hvoidh]hvoid}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhZ/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:152: ./lib/debugobjects.chMubj)}(h h]h }(hj hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj hhhj hMubj)}(hdebug_object_destroyh]j)}(hdebug_object_destroyh]hdebug_object_destroy}(hj hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj ubah}(h]h ](j'j(eh"]h$]h&]j,j-uh1j hj hhhj hMubj/)}(h1(void *addr, const struct debug_obj_descr *descr)h](j5)}(h void *addrh](j)}(hvoidh]hvoid}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj ubjW)}(hjZh]h*}(hj hhhNhNubah}(h]h ]jcah"]h$]h&]uh1jVhj ubj)}(haddrh]haddr}(hj hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphj,j-uh1j4hj ubj5)}(h#const struct debug_obj_descr *descrh](j)}(hjh]hconst}(hj3 hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ ubj)}(h h]h }(hj@ hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj/ ubj)}(hjh]hstruct}(hjN hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ ubj)}(h h]h }(hj[ hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj/ ubh)}(hhh]j)}(hdebug_obj_descrh]hdebug_obj_descr}(hjl hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhji ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjn modnameN classnameNjj)}j]j)}jj sbc.debug_object_destroyasbuh1hhj/ ubj)}(h h]h }(hj hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj/ ubjW)}(hjZh]h*}(hj hhhNhNubah}(h]h ]jcah"]h$]h&]uh1jVhj/ ubj)}(hdescrh]hdescr}(hj hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj/ ubeh}(h]h ]h"]h$]h&]noemphj,j-uh1j4hj ubeh}(h]h ]h"]h$]h&]j,j-uh1j.hj hhhj hMubeh}(h]h ]h"]h$]h&]j,j-j#uh1jj$j%hj hhhj hMubah}(h]j ah ](j)j*eh"]h$]h&]j.j/)j0huh1jhj hMhj hhubj2)}(hhh]h)}(h(debug checks when an object is destroyedh]h(debug checks when an object is destroyed}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:152: ./lib/debugobjects.chMhj hhubah}(h]h ]h"]h$]h&]uh1j1hj hhhj hMubeh}(h]h ](jfunctioneh"]h$]h&]jRjjSj jTj jUjVjWuh1jhhhjhNhNubjY)}(h**Parameters** ``void *addr`` address of the object ``const struct debug_obj_descr *descr`` pointer to an object specific debug description structureh](h)}(h**Parameters**h]jc)}(hj h]h Parameters}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jbhj ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:152: ./lib/debugobjects.chMhj ubjy)}(hhh](j~)}(h%``void *addr`` address of the object h](j)}(h``void *addr``h]j)}(hj h]h void *addr}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:152: ./lib/debugobjects.chMhj ubj)}(hhh]h)}(haddress of the objecth]haddress of the object}(hj+ hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj' hMhj( ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1j}hj' hMhj ubj~)}(ha``const struct debug_obj_descr *descr`` pointer to an object specific debug description structureh](j)}(h'``const struct debug_obj_descr *descr``h]j)}(hjK h]h#const struct debug_obj_descr *descr}(hjM hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjI ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:152: ./lib/debugobjects.chMhjE ubj)}(hhh]h)}(h9pointer to an object specific debug description structureh]h9pointer to an object specific debug description structure}(hjd hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:152: ./lib/debugobjects.chMhja ubah}(h]h ]h"]h$]h&]uh1jhjE ubeh}(h]h ]h"]h$]h&]uh1j}hj` hMhj ubeh}(h]h ]h"]h$]h&]uh1jxhj ubeh}(h]h ] kernelindentah"]h$]h&]uh1jXhjhhhNhNubh)}(hThis function is called to mark an object destroyed. This is useful to prevent the usage of invalid objects, which are still available in memory: either statically allocated objects or objects which are freed later.h]hThis function is called to mark an object destroyed. This is useful to prevent the usage of invalid objects, which are still available in memory: either statically allocated objects or objects which are freed later.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hXWhen the real object is tracked by debugobjects it is checked, whether the object can be destroyed. Destruction is not allowed for active and destroyed objects. When debugobjects detects an error, then it calls the fixup_destroy function of the object type description structure if provided by the caller. The fixup function can correct the problem before the real destruction of the object happens. E.g. it can deactivate an active object in order to prevent damage to the subsystem.h]hXWhen the real object is tracked by debugobjects it is checked, whether the object can be destroyed. Destruction is not allowed for active and destroyed objects. When debugobjects detects an error, then it calls the fixup_destroy function of the object type description structure if provided by the caller. The fixup function can correct the problem before the real destruction of the object happens. E.g. it can deactivate an active object in order to prevent damage to the subsystem.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(huWhen the destruction is legitimate, then the state of the associated tracker object is set to ODEBUG_STATE_DESTROYED.h]huWhen the destruction is legitimate, then the state of the associated tracker object is set to ODEBUG_STATE_DESTROYED.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdebug_object_free (C function)c.debug_object_freehNtauh1jhjhhhNhNubj)}(hhh](j)}(hHvoid debug_object_free (void *addr, const struct debug_obj_descr *descr)h]j)}(hGvoid debug_object_free(void *addr, const struct debug_obj_descr *descr)h](j)}(hvoidh]hvoid}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhZ/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:171: ./lib/debugobjects.chMubj)}(h h]h }(hj hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj hhhj hMubj)}(hdebug_object_freeh]j)}(hdebug_object_freeh]hdebug_object_free}(hj hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj ubah}(h]h ](j'j(eh"]h$]h&]j,j-uh1j hj hhhj hMubj/)}(h1(void *addr, const struct debug_obj_descr *descr)h](j5)}(h void *addrh](j)}(hvoidh]hvoid}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjW)}(hjZh]h*}(hj(hhhNhNubah}(h]h ]jcah"]h$]h&]uh1jVhjubj)}(haddrh]haddr}(hj5hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphj,j-uh1j4hjubj5)}(h#const struct debug_obj_descr *descrh](j)}(hjh]hconst}(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJubj)}(h h]h }(hj[hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjJubj)}(hjh]hstruct}(hjihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJubj)}(h h]h }(hjvhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjJubh)}(hhh]j)}(hdebug_obj_descrh]hdebug_obj_descr}(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj)}j]j)}jj sbc.debug_object_freeasbuh1hhjJubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjJubjW)}(hjZh]h*}(hjhhhNhNubah}(h]h ]jcah"]h$]h&]uh1jVhjJubj)}(hdescrh]hdescr}(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjJubeh}(h]h ]h"]h$]h&]noemphj,j-uh1j4hjubeh}(h]h ]h"]h$]h&]j,j-uh1j.hj hhhj hMubeh}(h]h ]h"]h$]h&]j,j-j#uh1jj$j%hj hhhj hMubah}(h]j ah ](j)j*eh"]h$]h&]j.j/)j0huh1jhj hMhj hhubj2)}(hhh]h)}(h$debug checks when an object is freedh]h$debug checks when an object is freed}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:171: ./lib/debugobjects.chMhjhhubah}(h]h ]h"]h$]h&]uh1j1hj hhhj hMubeh}(h]h ](jfunctioneh"]h$]h&]jRjjSjjTjjUjVjWuh1jhhhjhNhNubjY)}(h**Parameters** ``void *addr`` address of the object ``const struct debug_obj_descr *descr`` pointer to an object specific debug description structureh](h)}(h**Parameters**h]jc)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jbhj ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:171: ./lib/debugobjects.chMhjubjy)}(hhh](j~)}(h%``void *addr`` address of the object h](j)}(h``void *addr``h]j)}(hj-h]h void *addr}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj+ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:171: ./lib/debugobjects.chMhj'ubj)}(hhh]h)}(haddress of the objecth]haddress of the object}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjBhMhjCubah}(h]h ]h"]h$]h&]uh1jhj'ubeh}(h]h ]h"]h$]h&]uh1j}hjBhMhj$ubj~)}(ha``const struct debug_obj_descr *descr`` pointer to an object specific debug description structureh](j)}(h'``const struct debug_obj_descr *descr``h]j)}(hjfh]h#const struct debug_obj_descr *descr}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjdubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:171: ./lib/debugobjects.chMhj`ubj)}(hhh]h)}(h9pointer to an object specific debug description structureh]h9pointer to an object specific debug description structure}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:171: ./lib/debugobjects.chMhj|ubah}(h]h ]h"]h$]h&]uh1jhj`ubeh}(h]h ]h"]h$]h&]uh1j}hj{hMhj$ubeh}(h]h ]h"]h$]h&]uh1jxhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jXhjhhhNhNubh)}(h2This function is called before an object is freed.h]h2This function is called before an object is freed.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hXWhen the real object is tracked by debugobjects it is checked, whether the object can be freed. Free is not allowed for active objects. When debugobjects detects an error, then it calls the fixup_free function of the object type description structure if provided by the caller. The fixup function can correct the problem before the real free of the object happens. E.g. it can deactivate an active object in order to prevent damage to the subsystem.h]hXWhen the real object is tracked by debugobjects it is checked, whether the object can be freed. Free is not allowed for active objects. When debugobjects detects an error, then it calls the fixup_free function of the object type description structure if provided by the caller. The fixup function can correct the problem before the real free of the object happens. E.g. it can deactivate an active object in order to prevent damage to the subsystem.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hNote that debug_object_free removes the object from the tracker. Later usage of the object is detected by the other debug checks.h]hNote that debug_object_free removes the object from the tracker. Later usage of the object is detected by the other debug checks.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j%debug_object_assert_init (C function)c.debug_object_assert_inithNtauh1jhjhhhNhNubj)}(hhh](j)}(hOvoid debug_object_assert_init (void *addr, const struct debug_obj_descr *descr)h]j)}(hNvoid debug_object_assert_init(void *addr, const struct debug_obj_descr *descr)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhZ/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:188: ./lib/debugobjects.chMubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjhhhjhMubj)}(hdebug_object_assert_inith]j)}(hdebug_object_assert_inith]hdebug_object_assert_init}(hj hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubah}(h]h ](j'j(eh"]h$]h&]j,j-uh1j hjhhhjhMubj/)}(h1(void *addr, const struct debug_obj_descr *descr)h](j5)}(h void *addrh](j)}(hvoidh]hvoid}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubj)}(h h]h }(hj5hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj#ubjW)}(hjZh]h*}(hjChhhNhNubah}(h]h ]jcah"]h$]h&]uh1jVhj#ubj)}(haddrh]haddr}(hjPhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj#ubeh}(h]h ]h"]h$]h&]noemphj,j-uh1j4hjubj5)}(h#const struct debug_obj_descr *descrh](j)}(hjh]hconst}(hjihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubj)}(h h]h }(hjvhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjeubj)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjeubh)}(hhh]j)}(hdebug_obj_descrh]hdebug_obj_descr}(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj)}j]j)}jj sbc.debug_object_assert_initasbuh1hhjeubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjeubjW)}(hjZh]h*}(hjhhhNhNubah}(h]h ]jcah"]h$]h&]uh1jVhjeubj)}(hdescrh]hdescr}(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjeubeh}(h]h ]h"]h$]h&]noemphj,j-uh1j4hjubeh}(h]h ]h"]h$]h&]j,j-uh1j.hjhhhjhMubeh}(h]h ]h"]h$]h&]j,j-j#uh1jj$j%hjhhhjhMubah}(h]jah ](j)j*eh"]h$]h&]j.j/)j0huh1jhjhMhjhhubj2)}(hhh]h)}(h*debug checks when object should be init-edh]h*debug checks when object should be init-ed}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:188: ./lib/debugobjects.chMhjhhubah}(h]h ]h"]h$]h&]uh1j1hjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jRjjSjjTjjUjVjWuh1jhhhjhNhNubjY)}(h**Parameters** ``void *addr`` address of the object ``const struct debug_obj_descr *descr`` pointer to an object specific debug description structureh](h)}(h**Parameters**h]jc)}(hj)h]h Parameters}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jbhj'ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:188: ./lib/debugobjects.chM hj#ubjy)}(hhh](j~)}(h%``void *addr`` address of the object h](j)}(h``void *addr``h]j)}(hjHh]h void *addr}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjFubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:188: ./lib/debugobjects.chMhjBubj)}(hhh]h)}(haddress of the objecth]haddress of the object}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1hhj]hMhj^ubah}(h]h ]h"]h$]h&]uh1jhjBubeh}(h]h ]h"]h$]h&]uh1j}hj]hMhj?ubj~)}(ha``const struct debug_obj_descr *descr`` pointer to an object specific debug description structureh](j)}(h'``const struct debug_obj_descr *descr``h]j)}(hjh]h#const struct debug_obj_descr *descr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:188: ./lib/debugobjects.chMhj{ubj)}(hhh]h)}(h9pointer to an object specific debug description structureh]h9pointer to an object specific debug description structure}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:188: ./lib/debugobjects.chMhjubah}(h]h ]h"]h$]h&]uh1jhj{ubeh}(h]h ]h"]h$]h&]uh1j}hjhMhj?ubeh}(h]h ]h"]h$]h&]uh1jxhj#ubeh}(h]h ] kernelindentah"]h$]h&]uh1jXhjhhhNhNubh)}(hFThis function is called to assert that an object has been initialized.h]hFThis function is called to assert that an object has been initialized.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hX9When the real object is not tracked by debugobjects, it calls fixup_assert_init of the object type description structure provided by the caller, with the hardcoded object state ODEBUG_NOT_AVAILABLE. The fixup function can correct the problem by calling debug_object_init and other specific initializing functions.h]hX9When the real object is not tracked by debugobjects, it calls fixup_assert_init of the object type description structure provided by the caller, with the hardcoded object state ODEBUG_NOT_AVAILABLE. The fixup function can correct the problem by calling debug_object_init and other specific initializing functions.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hFWhen the real object is already tracked by debugobjects it is ignored.h]hFWhen the real object is already tracked by debugobjects it is ignored.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h]debug-functionsah ]h"]debug functionsah$]h&]uh1hhhhhhhhKAubh)}(hhh](h)}(hFixup functionsh]hFixup functions}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hhh](h)}(h'Debug object type description structureh]h'Debug object type description structure}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdebug_obj (C struct) c.debug_objhNtauh1jhjhhhNhNubj)}(hhh](j)}(h debug_objh]j)}(hstruct debug_objh](j)}(hjh]hstruct}(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+hhhd/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:207: ./include/linux/debugobjects.hhKubj)}(h h]h }(hj=hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj+hhhj<hKubj)}(h debug_objh]j)}(hj)h]h debug_obj}(hjOhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjKubah}(h]h ](j'j(eh"]h$]h&]j,j-uh1j hj+hhhj<hKubeh}(h]h ]h"]h$]h&]j,j-j#uh1jj$j%hj'hhhj<hKubah}(h]j"ah ](j)j*eh"]h$]h&]j.j/)j0huh1jhj<hKhj$hhubj2)}(hhh]h)}(h#representation of an tracked objecth]h#representation of an tracked object}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1hhd/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:207: ./include/linux/debugobjects.hhKhjnhhubah}(h]h ]h"]h$]h&]uh1j1hj$hhhj<hKubeh}(h]h ](jstructeh"]h$]h&]jRjjSjjTjjUjVjWuh1jhhhjhNhNubjY)}(hX**Definition**:: struct debug_obj { struct hlist_node node; enum debug_obj_state state; unsigned int astate; union { void *object; struct hlist_node *batch_last; }; const struct debug_obj_descr *descr; }; **Members** ``node`` hlist node to link the object into the tracker list ``state`` tracked object state ``astate`` current active state ``{unnamed_union}`` anonymous ``object`` pointer to the real object ``batch_last`` pointer to the last hlist node in a batch ``descr`` pointer to an object type specific debug description structureh](h)}(h**Definition**::h](jc)}(h**Definition**h]h Definition}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jbhjubh:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhd/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:207: ./include/linux/debugobjects.hhKhjubh literal_block)}(hXstruct debug_obj { struct hlist_node node; enum debug_obj_state state; unsigned int astate; union { void *object; struct hlist_node *batch_last; }; const struct debug_obj_descr *descr; };h]hXstruct debug_obj { struct hlist_node node; enum debug_obj_state state; unsigned int astate; union { void *object; struct hlist_node *batch_last; }; const struct debug_obj_descr *descr; };}hjsbah}(h]h ]h"]h$]h&]j,j-uh1jhd/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:207: ./include/linux/debugobjects.hhKhjubh)}(h **Members**Auh]jc)}(hjh]hMembers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jbhjubah}(h]h ]h"]h$]h&]uh1hhd/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:207: ./include/linux/debugobjects.hhK&hjubjy)}(hhh](j~)}(h=``node`` hlist node to link the object into the tracker list h](j)}(h``node``h]j)}(hjh]hnode}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhd/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:207: ./include/linux/debugobjects.hhKhjubj)}(hhh]h)}(h3hlist node to link the object into the tracker listh]h3hlist node to link the object into the tracker list}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1j}hjhKhjubj~)}(h``state`` tracked object state h](j)}(h ``state``h]j)}(hjh]hstate}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhd/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:207: ./include/linux/debugobjects.hhKhjubj)}(hhh]h)}(htracked object stateh]htracked object state}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj.hKhj/ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1j}hj.hKhjubj~)}(h ``astate`` current active state h](j)}(h ``astate``h]j)}(hjRh]hastate}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jhjPubah}(h]h ]h"]h$]h&]uh1jhd/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:207: ./include/linux/debugobjects.hhKhjLubj)}(hhh]h)}(hcurrent active stateh]hcurrent active state}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjghKhjhubah}(h]h ]h"]h$]h&]uh1jhjLubeh}(h]h ]h"]h$]h&]uh1j}hjghKhjubj~)}(h``{unnamed_union}`` anonymous h](j)}(h``{unnamed_union}``h]j)}(hjh]h{unnamed_union}}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhd/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:207: ./include/linux/debugobjects.hhKhjubj)}(hhh]h)}(h anonymoush]h anonymous}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1j}hjhKhjubj~)}(h&``object`` pointer to the real object h](j)}(h ``object``h]j)}(hjh]hobject}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhd/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:207: ./include/linux/debugobjects.hhKhjubj)}(hhh]h)}(hpointer to the real objecth]hpointer to the real object}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1j}hjhKhjubj~)}(h9``batch_last`` pointer to the last hlist node in a batch h](j)}(h``batch_last``h]j)}(hjh]h batch_last}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhd/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:207: ./include/linux/debugobjects.hhKhjubj)}(hhh]h)}(h)pointer to the last hlist node in a batchh]h)pointer to the last hlist node in a batch}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1j}hjhKhjubj~)}(hH``descr`` pointer to an object type specific debug description structureh](j)}(h ``descr``h]j)}(hj6h]hdescr}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj4ubah}(h]h ]h"]h$]h&]uh1jhd/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:207: ./include/linux/debugobjects.hhKhj0ubj)}(hhh]h)}(h>pointer to an object type specific debug description structureh]h>pointer to an object type specific debug description structure}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1hhd/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:207: ./include/linux/debugobjects.hhKhjLubah}(h]h ]h"]h$]h&]uh1jhj0ubeh}(h]h ]h"]h$]h&]uh1j}hjKhKhjubeh}(h]h ]h"]h$]h&]uh1jxhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jXhjhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jdebug_obj_descr (C struct)c.debug_obj_descrhNtauh1jhjhhhNhNubj)}(hhh](j)}(hdebug_obj_descrh]j)}(hstruct debug_obj_descrh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhd/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:207: ./include/linux/debugobjects.hhK"ubj)}(h h]h }(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjhhhjhK"ubj)}(hdebug_obj_descrh]j)}(hjh]hdebug_obj_descr}(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubah}(h]h ](j'j(eh"]h$]h&]j,j-uh1j hjhhhjhK"ubeh}(h]h ]h"]h$]h&]j,j-j#uh1jj$j%hjhhhjhK"ubah}(h]jah ](j)j*eh"]h$]h&]j.j/)j0huh1jhjhK"hjhhubj2)}(hhh]h)}(h0object type specific debug description structureh]h0object type specific debug description structure}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhd/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:207: ./include/linux/debugobjects.hhK)hjhhubah}(h]h ]h"]h$]h&]uh1j1hjhhhjhK"ubeh}(h]h ](jstructeh"]h$]h&]jRjjSjjTjjUjVjWuh1jhhhjhNhNubjY)}(hX**Definition**:: struct debug_obj_descr { const char *name; void *(*debug_hint)(void *addr); bool (*is_static_object)(void *addr); bool (*fixup_init)(void *addr, enum debug_obj_state state); bool (*fixup_activate)(void *addr, enum debug_obj_state state); bool (*fixup_destroy)(void *addr, enum debug_obj_state state); bool (*fixup_free)(void *addr, enum debug_obj_state state); bool (*fixup_assert_init)(void *addr, enum debug_obj_state state); }; **Members** ``name`` name of the object typee ``debug_hint`` function returning address, which have associated kernel symbol, to allow identify the object ``is_static_object`` return true if the obj is static, otherwise return false ``fixup_init`` fixup function, which is called when the init check fails. All fixup functions must return true if fixup was successful, otherwise return false ``fixup_activate`` fixup function, which is called when the activate check fails ``fixup_destroy`` fixup function, which is called when the destroy check fails ``fixup_free`` fixup function, which is called when the free check fails ``fixup_assert_init`` fixup function, which is called when the assert_init check failsh](h)}(h**Definition**::h](jc)}(h**Definition**h]h Definition}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jbhjubh:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhd/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:207: ./include/linux/debugobjects.hhK-hjubj)}(hXstruct debug_obj_descr { const char *name; void *(*debug_hint)(void *addr); bool (*is_static_object)(void *addr); bool (*fixup_init)(void *addr, enum debug_obj_state state); bool (*fixup_activate)(void *addr, enum debug_obj_state state); bool (*fixup_destroy)(void *addr, enum debug_obj_state state); bool (*fixup_free)(void *addr, enum debug_obj_state state); bool (*fixup_assert_init)(void *addr, enum debug_obj_state state); };h]hXstruct debug_obj_descr { const char *name; void *(*debug_hint)(void *addr); bool (*is_static_object)(void *addr); bool (*fixup_init)(void *addr, enum debug_obj_state state); bool (*fixup_activate)(void *addr, enum debug_obj_state state); bool (*fixup_destroy)(void *addr, enum debug_obj_state state); bool (*fixup_free)(void *addr, enum debug_obj_state state); bool (*fixup_assert_init)(void *addr, enum debug_obj_state state); };}hjsbah}(h]h ]h"]h$]h&]j,j-uh1jhd/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:207: ./include/linux/debugobjects.hhK/hjubh)}(h **Members**h]jc)}(hj h]hMembers}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jbhjubah}(h]h ]h"]h$]h&]uh1hhd/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:207: ./include/linux/debugobjects.hhK:hjubjy)}(hhh](j~)}(h"``name`` name of the object typee h](j)}(h``name``h]j)}(hj?h]hname}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj=ubah}(h]h ]h"]h$]h&]uh1jhd/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:207: ./include/linux/debugobjects.hhK,hj9ubj)}(hhh]h)}(hname of the object typeeh]hname of the object typee}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjThK,hjUubah}(h]h ]h"]h$]h&]uh1jhj9ubeh}(h]h ]h"]h$]h&]uh1j}hjThK,hj6ubj~)}(hm``debug_hint`` function returning address, which have associated kernel symbol, to allow identify the object h](j)}(h``debug_hint``h]j)}(hjxh]h debug_hint}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjvubah}(h]h ]h"]h$]h&]uh1jhd/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:207: ./include/linux/debugobjects.hhK.hjrubj)}(hhh]h)}(h]function returning address, which have associated kernel symbol, to allow identify the objecth]h]function returning address, which have associated kernel symbol, to allow identify the object}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhd/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:207: ./include/linux/debugobjects.hhK-hjubah}(h]h ]h"]h$]h&]uh1jhjrubeh}(h]h ]h"]h$]h&]uh1j}hjhK.hj6ubj~)}(hN``is_static_object`` return true if the obj is static, otherwise return false h](j)}(h``is_static_object``h]j)}(hjh]his_static_object}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhd/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:207: ./include/linux/debugobjects.hhK/hjubj)}(hhh]h)}(h8return true if the obj is static, otherwise return falseh]h8return true if the obj is static, otherwise return false}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhK/hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1j}hjhK/hj6ubj~)}(h``fixup_init`` fixup function, which is called when the init check fails. All fixup functions must return true if fixup was successful, otherwise return false h](j)}(h``fixup_init``h]j)}(hjh]h fixup_init}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhd/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:207: ./include/linux/debugobjects.hhK2hjubj)}(hhh]h)}(hfixup function, which is called when the init check fails. All fixup functions must return true if fixup was successful, otherwise return falseh]hfixup function, which is called when the init check fails. All fixup functions must return true if fixup was successful, otherwise return false}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhd/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:207: ./include/linux/debugobjects.hhK0hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1j}hjhK2hj6ubj~)}(hQ``fixup_activate`` fixup function, which is called when the activate check fails h](j)}(h``fixup_activate``h]j)}(hj%h]hfixup_activate}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#ubah}(h]h ]h"]h$]h&]uh1jhd/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:207: ./include/linux/debugobjects.hhK4hjubj)}(hhh]h)}(h=fixup function, which is called when the activate check failsh]h=fixup function, which is called when the activate check fails}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhd/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:207: ./include/linux/debugobjects.hhK3hj;ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1j}hj:hK4hj6ubj~)}(hO``fixup_destroy`` fixup function, which is called when the destroy check fails h](j)}(h``fixup_destroy``h]j)}(hj_h]h fixup_destroy}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]ubah}(h]h ]h"]h$]h&]uh1jhd/var/lib/git/docbuild/linux/Documentation/core-api/debug-objects:207: ./include/linux/debugobjects.hhK6hjYubj)}(hhh]h)}(h