include/net/netfilter/nf_conntrack_labels.h
Source file repositories/reference/linux-study-clean/include/net/netfilter/nf_conntrack_labels.h
File Facts
- System
- Linux kernel
- Corpus path
include/net/netfilter/nf_conntrack_labels.h- Extension
.h- Size
- 1709 bytes
- Lines
- 63
- 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.
- 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
linux/netfilter/nf_conntrack_common.hlinux/netfilter/nf_conntrack_tuple_common.hlinux/types.hnet/net_namespace.hnet/netfilter/nf_conntrack.hnet/netfilter/nf_conntrack_extend.huapi/linux/netfilter/xt_connlabel.h
Detected Declarations
struct nf_conn_labelsfunction nf_connlabels_getfunction nf_connlabels_put
Annotated Snippet
struct nf_conn_labels {
unsigned long bits[NF_CT_LABELS_MAX_SIZE / sizeof(long)];
};
/* Can't use nf_ct_ext_find(), flow dissector cannot use symbols
* exported by nf_conntrack module.
*/
static inline struct nf_conn_labels *nf_ct_labels_find(const struct nf_conn *ct)
{
#ifdef CONFIG_NF_CONNTRACK_LABELS
struct nf_ct_ext *ext = ct->ext;
if (!ext || !__nf_ct_ext_exist(ext, NF_CT_EXT_LABELS))
return NULL;
return (void *)ct->ext + ct->ext->offset[NF_CT_EXT_LABELS];
#else
return NULL;
#endif
}
static inline struct nf_conn_labels *nf_ct_labels_ext_add(struct nf_conn *ct)
{
#ifdef CONFIG_NF_CONNTRACK_LABELS
struct net *net = nf_ct_net(ct);
if (atomic_read(&net->ct.labels_used) == 0)
return NULL;
return nf_ct_ext_add(ct, NF_CT_EXT_LABELS, GFP_ATOMIC);
#else
return NULL;
#endif
}
int nf_connlabels_replace(struct nf_conn *ct,
const u32 *data, const u32 *mask, unsigned int words);
#ifdef CONFIG_NF_CONNTRACK_LABELS
int nf_connlabels_get(struct net *net, unsigned int bit);
void nf_connlabels_put(struct net *net);
#else
static inline int nf_connlabels_get(struct net *net, unsigned int bit) { return 0; }
static inline void nf_connlabels_put(struct net *net) {}
#endif
#endif /* _NF_CONNTRACK_LABELS_H */
Annotation
- Immediate include surface: `linux/netfilter/nf_conntrack_common.h`, `linux/netfilter/nf_conntrack_tuple_common.h`, `linux/types.h`, `net/net_namespace.h`, `net/netfilter/nf_conntrack.h`, `net/netfilter/nf_conntrack_extend.h`, `uapi/linux/netfilter/xt_connlabel.h`.
- Detected declarations: `struct nf_conn_labels`, `function nf_connlabels_get`, `function nf_connlabels_put`.
- Atlas domain: Networking Core / Sockets, Protocols, Packet Path, And Network Policy.
- 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.