include/linux/sunrpc/debug.h
Source file repositories/reference/linux-study-clean/include/linux/sunrpc/debug.h
File Facts
- System
- Linux kernel
- Corpus path
include/linux/sunrpc/debug.h- Extension
.h- Size
- 2498 bytes
- Lines
- 117
- Domain
- Core OS
- Bucket
- Core Kernel Interface
- Inferred role
- Core OS: implementation source
- Status
- source implementation candidate
Why This File Exists
Core operating-system implementation surface: boot, tasks, memory, VFS, syscall-facing interfaces, synchronization, credentials, and isolation.
- Core operating-system implementation surface: boot, tasks, memory, VFS, syscall-facing interfaces, synchronization, credentials, and isolation.
- Uses kernel synchronization; read lock ordering, sleepability, and interrupt context assumptions before translating.
- Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.
Dependency Surface
uapi/linux/sunrpc/debug.h
Detected Declarations
struct rpc_clntstruct rpc_xprtfunction sunrpc_debugfs_initfunction sunrpc_debugfs_exitfunction rpc_clnt_debugfs_registerfunction rpc_clnt_debugfs_unregisterfunction rpc_xprt_debugfs_registerfunction rpc_xprt_debugfs_unregister
Annotated Snippet
#ifndef _LINUX_SUNRPC_DEBUG_H_
#define _LINUX_SUNRPC_DEBUG_H_
#include <uapi/linux/sunrpc/debug.h>
/*
* Debugging macros etc
*/
extern unsigned int rpc_debug;
extern unsigned int nfs_debug;
extern unsigned int nfsd_debug;
extern unsigned int nlm_debug;
#define dprintk(fmt, ...) \
dfprintk(FACILITY, fmt, ##__VA_ARGS__)
#define dprintk_rcu(fmt, ...) \
dfprintk_rcu(FACILITY, fmt, ##__VA_ARGS__)
#undef ifdebug
#if IS_ENABLED(CONFIG_SUNRPC_DEBUG)
# define ifdebug(fac) if (unlikely(rpc_debug & RPCDBG_##fac))
# if IS_ENABLED(CONFIG_SUNRPC_DEBUG_TRACE)
# define __sunrpc_printk(fmt, ...) trace_printk(fmt, ##__VA_ARGS__)
# else
# define __sunrpc_printk(fmt, ...) printk(KERN_DEFAULT fmt, ##__VA_ARGS__)
# endif
# define dfprintk(fac, fmt, ...) \
do { \
ifdebug(fac) \
__sunrpc_printk(fmt, ##__VA_ARGS__); \
else \
no_printk(fmt, ##__VA_ARGS__); \
} while (0)
# define dfprintk_rcu(fac, fmt, ...) \
do { \
ifdebug(fac) { \
rcu_read_lock(); \
__sunrpc_printk(fmt, ##__VA_ARGS__); \
rcu_read_unlock(); \
} else { \
no_printk(fmt, ##__VA_ARGS__); \
} \
} while (0)
#else
# define ifdebug(fac) if (0)
# define dfprintk(fac, fmt, ...) no_printk(fmt, ##__VA_ARGS__)
# define dfprintk_rcu(fac, fmt, ...) no_printk(fmt, ##__VA_ARGS__)
#endif
/*
* Sysctl interface for RPC debugging
*/
struct rpc_clnt;
struct rpc_xprt;
#if IS_ENABLED(CONFIG_SUNRPC_DEBUG)
void rpc_register_sysctl(void);
void rpc_unregister_sysctl(void);
void sunrpc_debugfs_init(void);
void sunrpc_debugfs_exit(void);
void rpc_clnt_debugfs_register(struct rpc_clnt *);
void rpc_clnt_debugfs_unregister(struct rpc_clnt *);
void rpc_xprt_debugfs_register(struct rpc_xprt *);
void rpc_xprt_debugfs_unregister(struct rpc_xprt *);
#else
static inline void
sunrpc_debugfs_init(void)
{
return;
}
static inline void
sunrpc_debugfs_exit(void)
{
return;
}
static inline void
rpc_clnt_debugfs_register(struct rpc_clnt *clnt)
{
return;
}
static inline void
rpc_clnt_debugfs_unregister(struct rpc_clnt *clnt)
Annotation
- Immediate include surface: `uapi/linux/sunrpc/debug.h`.
- Detected declarations: `struct rpc_clnt`, `struct rpc_xprt`, `function sunrpc_debugfs_init`, `function sunrpc_debugfs_exit`, `function rpc_clnt_debugfs_register`, `function rpc_clnt_debugfs_unregister`, `function rpc_xprt_debugfs_register`, `function rpc_xprt_debugfs_unregister`.
- Atlas domain: Core OS / Core Kernel Interface.
- Implementation status: source implementation candidate.
- Synchronization appears in or near this file; preserve lock ordering, sleepability, and interrupt-context constraints.
Implementation Notes
- This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
- Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
- Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.