include/net/netfilter/nf_conntrack_ecache.h
Source file repositories/reference/linux-study-clean/include/net/netfilter/nf_conntrack_ecache.h
File Facts
- System
- Linux kernel
- Corpus path
include/net/netfilter/nf_conntrack_ecache.h- Extension
.h- Size
- 4924 bytes
- Lines
- 188
- 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
net/netfilter/nf_conntrack.hnet/net_namespace.hnet/netfilter/nf_conntrack_expect.hlinux/netfilter/nf_conntrack_common.hlinux/netfilter/nf_conntrack_tuple_common.hnet/netfilter/nf_conntrack_extend.hasm/local64.h
Detected Declarations
struct nf_conntrack_ecachestruct nf_ct_eventstruct nf_exp_eventstruct nf_ct_event_notifierenum nf_ct_ecache_statefunction nf_ct_ecache_findfunction nf_ct_ecache_existfunction nf_ct_deliver_cached_eventsfunction nf_ct_ecache_ext_addfunction nf_conntrack_event_cachefunction nf_conntrack_event_reportfunction nf_conntrack_eventfunction nf_conntrack_ecache_dwork_pendingfunction nf_ct_expect_event_report
Annotated Snippet
struct nf_conntrack_ecache {
unsigned long cache; /* bitops want long */
#ifdef CONFIG_NF_CONNTRACK_TIMESTAMP
local64_t timestamp; /* event timestamp, in nanoseconds */
#endif
u16 ctmask; /* bitmask of ct events to be delivered */
u16 expmask; /* bitmask of expect events to be delivered */
u32 missed; /* missed events */
u32 portid; /* netlink portid of destroyer */
};
static inline struct nf_conntrack_ecache *
nf_ct_ecache_find(const struct nf_conn *ct)
{
#ifdef CONFIG_NF_CONNTRACK_EVENTS
return nf_ct_ext_find(ct, NF_CT_EXT_ECACHE);
#else
return NULL;
#endif
}
static inline bool nf_ct_ecache_exist(const struct nf_conn *ct)
{
#ifdef CONFIG_NF_CONNTRACK_EVENTS
return nf_ct_ext_exist(ct, NF_CT_EXT_ECACHE);
#else
return false;
#endif
}
#ifdef CONFIG_NF_CONNTRACK_EVENTS
/* This structure is passed to event handler */
struct nf_ct_event {
struct nf_conn *ct;
u32 portid;
int report;
};
struct nf_exp_event {
struct nf_conntrack_expect *exp;
u32 portid;
int report;
};
struct nf_ct_event_notifier {
int (*ct_event)(unsigned int events, const struct nf_ct_event *item);
int (*exp_event)(unsigned int events, const struct nf_exp_event *item);
};
void nf_conntrack_register_notifier(struct net *net,
const struct nf_ct_event_notifier *nb);
void nf_conntrack_unregister_notifier(struct net *net);
void nf_ct_deliver_cached_events(struct nf_conn *ct);
int nf_conntrack_eventmask_report(unsigned int eventmask, struct nf_conn *ct,
u32 portid, int report);
bool nf_ct_ecache_ext_add(struct nf_conn *ct, u16 ctmask, u16 expmask, gfp_t gfp);
#else
static inline void nf_ct_deliver_cached_events(const struct nf_conn *ct)
{
}
static inline int nf_conntrack_eventmask_report(unsigned int eventmask,
struct nf_conn *ct,
u32 portid,
int report)
{
return 0;
}
static inline bool nf_ct_ecache_ext_add(struct nf_conn *ct, u16 ctmask, u16 expmask, gfp_t gfp)
{
return false;
}
#endif
static inline void
nf_conntrack_event_cache(enum ip_conntrack_events event, struct nf_conn *ct)
{
#ifdef CONFIG_NF_CONNTRACK_EVENTS
struct net *net = nf_ct_net(ct);
struct nf_conntrack_ecache *e;
if (!rcu_access_pointer(net->ct.nf_conntrack_event_cb))
return;
e = nf_ct_ecache_find(ct);
Annotation
- Immediate include surface: `net/netfilter/nf_conntrack.h`, `net/net_namespace.h`, `net/netfilter/nf_conntrack_expect.h`, `linux/netfilter/nf_conntrack_common.h`, `linux/netfilter/nf_conntrack_tuple_common.h`, `net/netfilter/nf_conntrack_extend.h`, `asm/local64.h`.
- Detected declarations: `struct nf_conntrack_ecache`, `struct nf_ct_event`, `struct nf_exp_event`, `struct nf_ct_event_notifier`, `enum nf_ct_ecache_state`, `function nf_ct_ecache_find`, `function nf_ct_ecache_exist`, `function nf_ct_deliver_cached_events`, `function nf_ct_ecache_ext_add`, `function nf_conntrack_event_cache`.
- 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.