include/net/psample.h
Source file repositories/reference/linux-study-clean/include/net/psample.h
File Facts
- System
- Linux kernel
- Corpus path
include/net/psample.h- Extension
.h- Size
- 1180 bytes
- Lines
- 57
- Domain
- Networking Core
- Bucket
- Sockets, Protocols, Packet Path, And Network Policy
- Inferred role
- Networking Core: implementation source
- Status
- source implementation candidate
Why This File Exists
Networking stack implementation surface: socket APIs, protocol dispatch, packet flow, routing, filtering, and network namespaces.
- Networking stack implementation surface: socket APIs, protocol dispatch, packet flow, routing, filtering, and network namespaces.
- Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.
Dependency Surface
uapi/linux/psample.hlinux/list.h
Detected Declarations
struct psample_groupstruct psample_metadatastruct sk_bufffunction psample_sample_packet
Annotated Snippet
struct psample_group {
struct list_head list;
struct net *net;
u32 group_num;
u32 refcount;
u32 seq;
struct rcu_head rcu;
};
struct psample_metadata {
u32 trunc_size;
int in_ifindex;
int out_ifindex;
u16 out_tc;
u64 out_tc_occ; /* bytes */
u64 latency; /* nanoseconds */
u8 out_tc_valid:1,
out_tc_occ_valid:1,
latency_valid:1,
rate_as_probability:1,
unused:4;
const u8 *user_cookie;
u32 user_cookie_len;
};
struct psample_group *psample_group_get(struct net *net, u32 group_num);
void psample_group_take(struct psample_group *group);
void psample_group_put(struct psample_group *group);
struct sk_buff;
#if IS_ENABLED(CONFIG_PSAMPLE)
void psample_sample_packet(struct psample_group *group,
const struct sk_buff *skb, u32 sample_rate,
const struct psample_metadata *md);
#else
static inline void psample_sample_packet(struct psample_group *group,
const struct sk_buff *skb,
u32 sample_rate,
const struct psample_metadata *md)
{
}
#endif
#endif /* __NET_PSAMPLE_H */
Annotation
- Immediate include surface: `uapi/linux/psample.h`, `linux/list.h`.
- Detected declarations: `struct psample_group`, `struct psample_metadata`, `struct sk_buff`, `function psample_sample_packet`.
- Atlas domain: Networking Core / Sockets, Protocols, Packet Path, And Network Policy.
- Implementation status: source implementation candidate.
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.