net/sched/cls_flower.c

File Facts

System

Linux kernel

Corpus path

net/sched/cls_flower.c

Extension

.c

Size

112623 bytes

Lines

3871

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.
• 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/kernel.h
• linux/init.h
• linux/module.h
• linux/rhashtable.h
• linux/workqueue.h
• linux/refcount.h
• linux/bitfield.h
• linux/if_ether.h
• linux/in6.h
• linux/ip.h
• linux/mpls.h
• linux/ppp_defs.h
• net/sch_generic.h
• net/pkt_cls.h
• net/pkt_sched.h
• net/ip.h
• net/flow_dissector.h
• net/geneve.h
• net/vxlan.h
• net/erspan.h
• net/gtp.h
• net/pfcp.h
• net/tc_wrapper.h
• net/dst.h
• net/dst_metadata.h
• uapi/linux/netfilter/nf_conntrack_common.h

Detected Declarations

• struct fl_flow_key
• struct fl_flow_mask_range
• struct fl_flow_mask
• struct fl_flow_tmplt
• struct cls_fl_head
• struct cls_fl_filter
• function fl_mask_range
• function fl_mask_update_range
• function fl_set_masked_key
• function fl_mask_fits_tmplt
• function fl_clear_masked_range
• function fl_range_port_dst_cmp
• function fl_range_port_src_cmp
• function list_for_each_entry_rcu
• function fl_classify
• function list_for_each_entry_rcu
• function fl_init
• function fl_mask_free
• function fl_mask_free_work
• function fl_uninit_mask_free_work
• function fl_mask_put
• function __fl_destroy_filter
• function fl_destroy_filter_work
• function fl_hw_destroy_filter
• function fl_hw_replace_filter
• function fl_hw_update_stats
• function __fl_put
• function __fl_delete
• function fl_destroy_sleepable
• function fl_destroy
• function list_for_each_entry_safe
• function fl_put
• function fl_set_key_val
• function fl_set_key_spi
• function fl_set_key_port_range
• function ntohs
• function ntohs
• function fl_set_key_mpls_lse
• function fl_set_key_mpls_opts
• function nla_for_each_nested
• function fl_set_key_mpls
• function fl_set_key_vlan
• function fl_set_key_pppoe
• function fl_set_key_flag
• function fl_set_key_flags
• function fl_set_key_ip
• function fl_set_geneve_opt
• function fl_set_vxlan_opt

Annotated Snippet

module_init(cls_fl_init);
module_exit(cls_fl_exit);

MODULE_AUTHOR("Jiri Pirko <jiri@resnulli.us>");
MODULE_DESCRIPTION("Flower classifier");
MODULE_LICENSE("GPL v2");

Annotation

• Immediate include surface: `linux/kernel.h`, `linux/init.h`, `linux/module.h`, `linux/rhashtable.h`, `linux/workqueue.h`, `linux/refcount.h`, `linux/bitfield.h`, `linux/if_ether.h`.
• Detected declarations: `struct fl_flow_key`, `struct fl_flow_mask_range`, `struct fl_flow_mask`, `struct fl_flow_tmplt`, `struct cls_fl_head`, `struct cls_fl_filter`, `function fl_mask_range`, `function fl_mask_update_range`, `function fl_set_masked_key`, `function fl_mask_fits_tmplt`.
• Atlas domain: Networking Core / Sockets, Protocols, Packet Path, And Network Policy.
• Implementation status: integration implementation candidate.
• 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.