~ [ source navigation ] ~ [ diff markup ] ~ [ identifier search ] ~

TOMOYO Linux Cross Reference
Linux/include/linux/debugobjects.h

Version: ~ [ linux-5.3-rc5 ] ~ [ linux-5.2.9 ] ~ [ linux-5.1.21 ] ~ [ linux-5.0.21 ] ~ [ linux-4.20.17 ] ~ [ linux-4.19.67 ] ~ [ linux-4.18.20 ] ~ [ linux-4.17.19 ] ~ [ linux-4.16.18 ] ~ [ linux-4.15.18 ] ~ [ linux-4.14.139 ] ~ [ linux-4.13.16 ] ~ [ linux-4.12.14 ] ~ [ linux-4.11.12 ] ~ [ linux-4.10.17 ] ~ [ linux-4.9.189 ] ~ [ linux-4.8.17 ] ~ [ linux-4.7.10 ] ~ [ linux-4.6.7 ] ~ [ linux-4.5.7 ] ~ [ linux-4.4.189 ] ~ [ linux-4.3.6 ] ~ [ linux-4.2.8 ] ~ [ linux-4.1.52 ] ~ [ linux-4.0.9 ] ~ [ linux-3.19.8 ] ~ [ linux-3.18.140 ] ~ [ linux-3.17.8 ] ~ [ linux-3.16.72 ] ~ [ linux-3.15.10 ] ~ [ linux-3.14.79 ] ~ [ linux-3.13.11 ] ~ [ linux-3.12.74 ] ~ [ linux-3.11.10 ] ~ [ linux-3.10.108 ] ~ [ linux-3.9.11 ] ~ [ linux-3.8.13 ] ~ [ linux-3.7.10 ] ~ [ linux-3.6.11 ] ~ [ linux-3.5.7 ] ~ [ linux-3.4.113 ] ~ [ linux-3.3.8 ] ~ [ linux-3.2.102 ] ~ [ linux-3.1.10 ] ~ [ linux-3.0.101 ] ~ [ linux-2.6.32.71 ] ~ [ linux-2.6.0 ] ~ [ linux-2.4.37.11 ] ~ [ unix-v6-master ] ~ [ ccs-tools-1.8.5 ] ~ [ policy-sample ] ~
Architecture: ~ [ i386 ] ~ [ alpha ] ~ [ m68k ] ~ [ mips ] ~ [ ppc ] ~ [ sparc ] ~ [ sparc64 ] ~

  1 #ifndef _LINUX_DEBUGOBJECTS_H
  2 #define _LINUX_DEBUGOBJECTS_H
  3 
  4 #include <linux/list.h>
  5 #include <linux/spinlock.h>
  6 
  7 enum debug_obj_state {
  8         ODEBUG_STATE_NONE,
  9         ODEBUG_STATE_INIT,
 10         ODEBUG_STATE_INACTIVE,
 11         ODEBUG_STATE_ACTIVE,
 12         ODEBUG_STATE_DESTROYED,
 13         ODEBUG_STATE_NOTAVAILABLE,
 14         ODEBUG_STATE_MAX,
 15 };
 16 
 17 struct debug_obj_descr;
 18 
 19 /**
 20  * struct debug_obj - representaion of an tracked object
 21  * @node:       hlist node to link the object into the tracker list
 22  * @state:      tracked object state
 23  * @astate:     current active state
 24  * @object:     pointer to the real object
 25  * @descr:      pointer to an object type specific debug description structure
 26  */
 27 struct debug_obj {
 28         struct hlist_node       node;
 29         enum debug_obj_state    state;
 30         unsigned int            astate;
 31         void                    *object;
 32         struct debug_obj_descr  *descr;
 33 };
 34 
 35 /**
 36  * struct debug_obj_descr - object type specific debug description structure
 37  *
 38  * @name:               name of the object typee
 39  * @debug_hint:         function returning address, which have associated
 40  *                      kernel symbol, to allow identify the object
 41  * @is_static_object:   return true if the obj is static, otherwise return false
 42  * @fixup_init:         fixup function, which is called when the init check
 43  *                      fails. All fixup functions must return true if fixup
 44  *                      was successful, otherwise return false
 45  * @fixup_activate:     fixup function, which is called when the activate check
 46  *                      fails
 47  * @fixup_destroy:      fixup function, which is called when the destroy check
 48  *                      fails
 49  * @fixup_free:         fixup function, which is called when the free check
 50  *                      fails
 51  * @fixup_assert_init:  fixup function, which is called when the assert_init
 52  *                      check fails
 53  */
 54 struct debug_obj_descr {
 55         const char              *name;
 56         void *(*debug_hint)(void *addr);
 57         bool (*is_static_object)(void *addr);
 58         bool (*fixup_init)(void *addr, enum debug_obj_state state);
 59         bool (*fixup_activate)(void *addr, enum debug_obj_state state);
 60         bool (*fixup_destroy)(void *addr, enum debug_obj_state state);
 61         bool (*fixup_free)(void *addr, enum debug_obj_state state);
 62         bool (*fixup_assert_init)(void *addr, enum debug_obj_state state);
 63 };
 64 
 65 #ifdef CONFIG_DEBUG_OBJECTS
 66 extern void debug_object_init      (void *addr, struct debug_obj_descr *descr);
 67 extern void
 68 debug_object_init_on_stack(void *addr, struct debug_obj_descr *descr);
 69 extern int debug_object_activate  (void *addr, struct debug_obj_descr *descr);
 70 extern void debug_object_deactivate(void *addr, struct debug_obj_descr *descr);
 71 extern void debug_object_destroy   (void *addr, struct debug_obj_descr *descr);
 72 extern void debug_object_free      (void *addr, struct debug_obj_descr *descr);
 73 extern void debug_object_assert_init(void *addr, struct debug_obj_descr *descr);
 74 
 75 /*
 76  * Active state:
 77  * - Set at 0 upon initialization.
 78  * - Must return to 0 before deactivation.
 79  */
 80 extern void
 81 debug_object_active_state(void *addr, struct debug_obj_descr *descr,
 82                           unsigned int expect, unsigned int next);
 83 
 84 extern void debug_objects_early_init(void);
 85 extern void debug_objects_mem_init(void);
 86 #else
 87 static inline void
 88 debug_object_init      (void *addr, struct debug_obj_descr *descr) { }
 89 static inline void
 90 debug_object_init_on_stack(void *addr, struct debug_obj_descr *descr) { }
 91 static inline int
 92 debug_object_activate  (void *addr, struct debug_obj_descr *descr) { return 0; }
 93 static inline void
 94 debug_object_deactivate(void *addr, struct debug_obj_descr *descr) { }
 95 static inline void
 96 debug_object_destroy   (void *addr, struct debug_obj_descr *descr) { }
 97 static inline void
 98 debug_object_free      (void *addr, struct debug_obj_descr *descr) { }
 99 static inline void
100 debug_object_assert_init(void *addr, struct debug_obj_descr *descr) { }
101 
102 static inline void debug_objects_early_init(void) { }
103 static inline void debug_objects_mem_init(void) { }
104 #endif
105 
106 #ifdef CONFIG_DEBUG_OBJECTS_FREE
107 extern void debug_check_no_obj_freed(const void *address, unsigned long size);
108 #else
109 static inline void
110 debug_check_no_obj_freed(const void *address, unsigned long size) { }
111 #endif
112 
113 #endif
114 

~ [ source navigation ] ~ [ diff markup ] ~ [ identifier search ] ~

kernel.org | git.kernel.org | LWN.net | Project Home | Wiki (Japanese) | Wiki (English) | SVN repository | Mail admin

Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.

osdn.jp