net/sched/cls_api.c

File Facts

System

Linux kernel

Corpus path

net/sched/cls_api.c

Extension

.c

Size

102610 bytes

Lines

4126

Domain

Networking Core

Bucket

Sockets, Protocols, Packet Path, And Network Policy

Inferred role

Networking Core: exported/initcall integration point

Status

integration 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.
• Exports symbols or registers init work; inspect boot/module ordering and who consumes the exported contract.
• Touches user memory; correctness depends on fault-safe copying and privilege boundary handling.
• Uses kernel synchronization; read lock ordering, sleepability, and interrupt context assumptions before translating.
• Touches IRQ or DMA behavior; this matters for the representative real-device path.
• Allocates kernel memory; connect allocation flags and lifetime to context constraints.
• Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.

Dependency Surface

• linux/module.h
• linux/types.h
• linux/kernel.h
• linux/string.h
• linux/errno.h
• linux/err.h
• linux/skbuff.h
• linux/init.h
• linux/kmod.h
• linux/slab.h
• linux/idr.h
• linux/jhash.h
• linux/rculist.h
• linux/rhashtable.h
• net/net_namespace.h
• net/sock.h
• net/netlink.h
• net/pkt_sched.h
• net/pkt_cls.h
• net/tc_act/tc_pedit.h
• net/tc_act/tc_mirred.h
• net/tc_act/tc_vlan.h
• net/tc_act/tc_tunnel_key.h
• net/tc_act/tc_csum.h
• net/tc_act/tc_gact.h
• net/tc_act/tc_police.h
• net/tc_act/tc_sample.h
• net/tc_act/tc_skbedit.h
• net/tc_act/tc_ct.h
• net/tc_act/tc_mpls.h
• net/tc_act/tc_gate.h
• net/flow_offload.h

Detected Declarations

• struct tcf_exts_miss_cookie_node
• struct tcf_filter_chain_list_item
• struct tcf_net
• struct tcf_block_owner_item
• struct tcf_chain_info
• struct tcf_dump_args
• function tcf_exts_miss_cookie_base_alloc
• function tcf_exts_miss_cookie_base_destroy
• function tcf_exts_miss_cookie_lookup
• function tcf_exts_miss_cookie_base_alloc
• function tcf_exts_miss_cookie_base_destroy
• function tc_skb_ext_tc_enable
• function tc_skb_ext_tc_disable
• function destroy_obj_hashfn
• function tcf_proto_signal_destroying
• function tcf_proto_cmp
• function tcf_proto_exists_destroying
• function tcf_proto_signal_destroyed
• function list_for_each_entry
• function tcf_proto_lookup_ops
• function register_tcf_proto_ops
• function unregister_tcf_proto_ops
• function tcf_queue_work
• function tcf_auto_prio
• function tcf_proto_check_kind
• function tcf_proto_is_unlocked
• function tcf_proto_get
• function tcf_proto_count_usesw
• function tcf_proto_destroy
• function tcf_proto_put
• function tcf_proto_check_delete
• function tcf_proto_mark_delete
• function tcf_proto_is_deleting
• function tcf_chain_head_change_item
• function tcf_chain0_head_change
• function tcf_chain_detach
• function tcf_block_destroy
• function tcf_chain_destroy
• function tcf_chain_hold
• function tcf_chain_held_by_acts_only
• function list_for_each_entry
• function list_for_each_entry_rcu
• function __tcf_chain_put
• function tcf_chain_put
• function tcf_chain_put_by_act
• function tcf_chain_put_explicitly_created
• function tcf_chain_flush
• function tcf_block_offload_init

Annotated Snippet

subsys_initcall(tc_filter_init);

Annotation

• Immediate include surface: `linux/module.h`, `linux/types.h`, `linux/kernel.h`, `linux/string.h`, `linux/errno.h`, `linux/err.h`, `linux/skbuff.h`, `linux/init.h`.
• Detected declarations: `struct tcf_exts_miss_cookie_node`, `struct tcf_filter_chain_list_item`, `struct tcf_net`, `struct tcf_block_owner_item`, `struct tcf_chain_info`, `struct tcf_dump_args`, `function tcf_exts_miss_cookie_base_alloc`, `function tcf_exts_miss_cookie_base_destroy`, `function tcf_exts_miss_cookie_lookup`, `function tcf_exts_miss_cookie_base_alloc`.
• Atlas domain: Networking Core / Sockets, Protocols, Packet Path, And Network Policy.
• Implementation status: integration implementation candidate.
• This snippet crosses the user/kernel memory boundary; validate fault handling and access checks before translating the pattern.
• Synchronization appears in or near this file; preserve lock ordering, sleepability, and interrupt-context constraints.
• IRQ or DMA behavior appears here, which is relevant to the selected PCIe/NVMe device path.

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.