drivers/net/ethernet/intel/ice/ice_flow.c

Source file repositories/reference/linux-study-clean/drivers/net/ethernet/intel/ice/ice_flow.c

File Facts

System: Linux kernel
Corpus path: drivers/net/ethernet/intel/ice/ice_flow.c
Extension: .c
Size: 99510 bytes
Lines: 3016
Domain: Driver Families
Bucket: drivers/net
Inferred role: Driver Families: implementation source
Status: source implementation candidate

Why This File Exists

Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.

Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.
Uses kernel synchronization; read lock ordering, sleepability, and interrupt context assumptions before translating.
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

ice_common.h
ice_flow.h
net/gre.h

Detected Declarations

struct ice_flow_field_info
struct ice_flow_prof_params
function ice_flow_val_hdrs
function ice_flow_calc_seg_sz
function ice_flow_proc_seg_hdrs
function ice_flow_xtract_fld
function ice_flow_xtract_raws
function ice_flow_create_xtrct_seq
function for_each_set_bit
function ice_flow_proc_segs
function ice_flow_find_prof_conds
function ice_flow_find_prof_id
function ice_flow_rem_entry_sync
function ice_flow_add_prof_sync
function ice_flow_rem_prof_sync
function list_for_each_entry_safe
function ice_flow_assoc_prof
function ice_flow_disassoc_prof
function ice_flow_set_parser_prof
function ice_flow_add_prof
function ice_flow_rem_prof
function ice_flow_add_entry
function ice_flow_rem_entry
function ice_flow_set_fld_ext
function ice_flow_set_fld
function ice_flow_add_fld_raw
function ice_flow_rem_vsi_prof
function list_for_each_entry_safe
function ice_flow_set_rss_seg_info
function ice_rem_vsi_rss_list
function ice_rem_vsi_rss_cfg
function ice_get_rss_hdr_type
function ice_rss_match_prof
function ice_rem_rss_list
function ice_add_rss_list
function ice_rss_config_xor_word
function ice_rss_config_xor
function ice_rss_set_symm
function ice_rss_cfg_raw_symm
function ice_rss_update_raw_symm
function ice_add_rss_cfg_sync
function ice_add_rss_cfg
function ice_rem_rss_cfg_sync
function ice_rem_rss_cfg
function BIT_ULL
function BIT_ULL
function BIT_ULL
function rss_cfg_symm_valid

Annotated Snippet

struct ice_flow_field_info {
	enum ice_flow_seg_hdr hdr;
	s16 off;	/* Offset from start of a protocol header, in bits */
	u16 size;	/* Size of fields in bits */
	u16 mask;	/* 16-bit mask for field */
};

#define ICE_FLOW_FLD_INFO(_hdr, _offset_bytes, _size_bytes) { \
	.hdr = _hdr, \
	.off = (_offset_bytes) * BITS_PER_BYTE, \
	.size = (_size_bytes) * BITS_PER_BYTE, \
	.mask = 0, \
}

/* QFI: 6-bit field in GTP-U PDU Session Container (3GPP TS 38.415) */
#define ICE_FLOW_FLD_INFO_MSK(_hdr, _offset_bytes, _size_bytes, _mask) { \
	.hdr = _hdr, \
	.off = (_offset_bytes) * BITS_PER_BYTE, \
	.size = (_size_bytes) * BITS_PER_BYTE, \
	.mask = _mask, \
}

/* Table containing properties of supported protocol header fields */
static const
struct ice_flow_field_info ice_flds_info[ICE_FLOW_FIELD_IDX_MAX] = {
	/* Ether */
	/* ICE_FLOW_FIELD_IDX_ETH_DA */
	ICE_FLOW_FLD_INFO(ICE_FLOW_SEG_HDR_ETH, 0, ETH_ALEN),
	/* ICE_FLOW_FIELD_IDX_ETH_SA */
	ICE_FLOW_FLD_INFO(ICE_FLOW_SEG_HDR_ETH, ETH_ALEN, ETH_ALEN),
	/* ICE_FLOW_FIELD_IDX_S_VLAN */
	ICE_FLOW_FLD_INFO(ICE_FLOW_SEG_HDR_VLAN, 12, sizeof(__be16)),
	/* ICE_FLOW_FIELD_IDX_C_VLAN */
	ICE_FLOW_FLD_INFO(ICE_FLOW_SEG_HDR_VLAN, 14, sizeof(__be16)),
	/* ICE_FLOW_FIELD_IDX_ETH_TYPE */
	ICE_FLOW_FLD_INFO(ICE_FLOW_SEG_HDR_ETH, 0, sizeof(__be16)),
	/* IPv4 / IPv6 */
	/* ICE_FLOW_FIELD_IDX_IPV4_DSCP */
	ICE_FLOW_FLD_INFO_MSK(ICE_FLOW_SEG_HDR_IPV4, 0, 1, 0x00fc),
	/* ICE_FLOW_FIELD_IDX_IPV6_DSCP */
	ICE_FLOW_FLD_INFO_MSK(ICE_FLOW_SEG_HDR_IPV6, 0, 1, 0x0ff0),
	/* ICE_FLOW_FIELD_IDX_IPV4_TTL */
	ICE_FLOW_FLD_INFO_MSK(ICE_FLOW_SEG_HDR_NONE, 8, 1, 0xff00),
	/* ICE_FLOW_FIELD_IDX_IPV4_PROT */
	ICE_FLOW_FLD_INFO_MSK(ICE_FLOW_SEG_HDR_NONE, 8, 1, 0x00ff),
	/* ICE_FLOW_FIELD_IDX_IPV6_TTL */
	ICE_FLOW_FLD_INFO_MSK(ICE_FLOW_SEG_HDR_NONE, 6, 1, 0x00ff),
	/* ICE_FLOW_FIELD_IDX_IPV6_PROT */
	ICE_FLOW_FLD_INFO_MSK(ICE_FLOW_SEG_HDR_NONE, 6, 1, 0xff00),
	/* ICE_FLOW_FIELD_IDX_IPV4_SA */
	ICE_FLOW_FLD_INFO(ICE_FLOW_SEG_HDR_IPV4, 12, sizeof(struct in_addr)),
	/* ICE_FLOW_FIELD_IDX_IPV4_DA */
	ICE_FLOW_FLD_INFO(ICE_FLOW_SEG_HDR_IPV4, 16, sizeof(struct in_addr)),
	/* ICE_FLOW_FIELD_IDX_IPV6_SA */
	ICE_FLOW_FLD_INFO(ICE_FLOW_SEG_HDR_IPV6, 8, sizeof(struct in6_addr)),
	/* ICE_FLOW_FIELD_IDX_IPV6_DA */
	ICE_FLOW_FLD_INFO(ICE_FLOW_SEG_HDR_IPV6, 24, ICE_FLOW_FLD_SZ_IPV6_ADDR),
	/* ICE_FLOW_FIELD_IDX_IPV4_CHKSUM */
	ICE_FLOW_FLD_INFO(ICE_FLOW_SEG_HDR_IPV4, 10, ICE_FLOW_FLD_SZ_IP_CHKSUM),
	/* ICE_FLOW_FIELD_IDX_IPV4_FRAG */
	ICE_FLOW_FLD_INFO(ICE_FLOW_SEG_HDR_IPV_FRAG, 4,
			  ICE_FLOW_FLD_SZ_IPV4_ID),
	/* ICE_FLOW_FIELD_IDX_IPV6_FRAG */
	ICE_FLOW_FLD_INFO(ICE_FLOW_SEG_HDR_IPV_FRAG, 4,
			  ICE_FLOW_FLD_SZ_IPV6_ID),
	/* ICE_FLOW_FIELD_IDX_IPV6_PRE32_SA */
	ICE_FLOW_FLD_INFO(ICE_FLOW_SEG_HDR_IPV6, 8,
			  ICE_FLOW_FLD_SZ_IPV6_PRE32_ADDR),
	/* ICE_FLOW_FIELD_IDX_IPV6_PRE32_DA */
	ICE_FLOW_FLD_INFO(ICE_FLOW_SEG_HDR_IPV6, 24,
			  ICE_FLOW_FLD_SZ_IPV6_PRE32_ADDR),
	/* ICE_FLOW_FIELD_IDX_IPV6_PRE48_SA */
	ICE_FLOW_FLD_INFO(ICE_FLOW_SEG_HDR_IPV6, 8,
			  ICE_FLOW_FLD_SZ_IPV6_PRE48_ADDR),
	/* ICE_FLOW_FIELD_IDX_IPV6_PRE48_DA */
	ICE_FLOW_FLD_INFO(ICE_FLOW_SEG_HDR_IPV6, 24,
			  ICE_FLOW_FLD_SZ_IPV6_PRE48_ADDR),
	/* ICE_FLOW_FIELD_IDX_IPV6_PRE64_SA */
	ICE_FLOW_FLD_INFO(ICE_FLOW_SEG_HDR_IPV6, 8,
			  ICE_FLOW_FLD_SZ_IPV6_PRE64_ADDR),
	/* ICE_FLOW_FIELD_IDX_IPV6_PRE64_DA */
	ICE_FLOW_FLD_INFO(ICE_FLOW_SEG_HDR_IPV6, 24,
			  ICE_FLOW_FLD_SZ_IPV6_PRE64_ADDR),
	/* Transport */
	/* ICE_FLOW_FIELD_IDX_TCP_SRC_PORT */
	ICE_FLOW_FLD_INFO(ICE_FLOW_SEG_HDR_TCP, 0, sizeof(__be16)),
	/* ICE_FLOW_FIELD_IDX_TCP_DST_PORT */
	ICE_FLOW_FLD_INFO(ICE_FLOW_SEG_HDR_TCP, 2, sizeof(__be16)),
	/* ICE_FLOW_FIELD_IDX_UDP_SRC_PORT */
	ICE_FLOW_FLD_INFO(ICE_FLOW_SEG_HDR_UDP, 0, sizeof(__be16)),

Annotation

Immediate include surface: `ice_common.h`, `ice_flow.h`, `net/gre.h`.
Detected declarations: `struct ice_flow_field_info`, `struct ice_flow_prof_params`, `function ice_flow_val_hdrs`, `function ice_flow_calc_seg_sz`, `function ice_flow_proc_seg_hdrs`, `function ice_flow_xtract_fld`, `function ice_flow_xtract_raws`, `function ice_flow_create_xtrct_seq`, `function for_each_set_bit`, `function ice_flow_proc_segs`.
Atlas domain: Driver Families / drivers/net.
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.