drivers/net/wireless/realtek/rtw89/cam.c
Source file repositories/reference/linux-study-clean/drivers/net/wireless/realtek/rtw89/cam.c
File Facts
- System
- Linux kernel
- Corpus path
drivers/net/wireless/realtek/rtw89/cam.c- Extension
.c- Size
- 40441 bytes
- Lines
- 1277
- 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
cam.hdebug.hfw.hmac.hps.h
Detected Declarations
function rtw89_cam_get_sec_key_cmdfunction rtw89_cam_send_sec_key_cmdfunction rtw89_cam_get_avail_sec_camfunction rtw89_cam_get_addr_cam_key_idxfunction __rtw89_cam_detach_sec_camfunction for_each_set_bitfunction __rtw89_cam_attach_sec_camfunction rtw89_cam_attach_link_sec_camfunction rtw89_cam_detach_sec_camfunction rtw89_vif_for_each_linkfunction rtw89_cam_attach_sec_camfunction rtw89_sta_for_each_linkfunction rtw89_cam_sec_key_installfunction rtw89_cam_sec_key_addfunction rtw89_cam_sec_key_delfunction rtw89_cam_reset_key_iterfunction rtw89_cam_deinit_addr_camfunction rtw89_cam_deinit_bssid_camfunction rtw89_cam_deinitfunction rtw89_cam_reset_keysfunction rtw89_cam_get_avail_addr_camfunction rtw89_get_addr_cam_entry_sizefunction rtw89_cam_init_addr_camfunction rtw89_cam_get_avail_bssid_camfunction rtw89_cam_init_bssid_camfunction rtw89_cam_bssid_changedfunction rtw89_cam_initfunction rtw89_cam_fill_bssid_cam_infofunction rtw89_cam_addr_hashfunction rtw89_cam_fill_addr_cam_infofunction rtw89_cam_fill_dctl_sec_cam_info_v1function rtw89_cam_fill_dctl_sec_cam_info_v2function rtw89_cam_fill_dctl_sec_cam_info_v3
Annotated Snippet
if (sec_cam->type == RTW89_SEC_KEY_TYPE_BIP_CCMP128) {
idx = find_next_zero_bit(addr_cam->sec_cam_map,
RTW89_SEC_CAM_IN_ADDR_CAM, 5);
if (idx > 6)
return -EBUSY;
*key_idx = idx;
break;
}
if (key->flags & IEEE80211_KEY_FLAG_PAIRWISE) {
idx = find_next_zero_bit(addr_cam->sec_cam_map,
RTW89_SEC_CAM_IN_ADDR_CAM, 0);
if (idx > 1)
return -EBUSY;
*key_idx = idx;
break;
}
/* Group keys */
idx = find_next_zero_bit(addr_cam->sec_cam_map,
RTW89_SEC_CAM_IN_ADDR_CAM, 2);
if (idx > 4)
return -EBUSY;
*key_idx = idx;
break;
case RTW89_ADDR_CAM_SEC_4GROUP:
if (sec_cam->type == RTW89_SEC_KEY_TYPE_BIP_CCMP128) {
if (test_bit(6, addr_cam->sec_cam_map))
return -EINVAL;
*key_idx = 6;
break;
}
if (key->flags & IEEE80211_KEY_FLAG_PAIRWISE) {
idx = find_next_zero_bit(addr_cam->sec_cam_map,
RTW89_SEC_CAM_IN_ADDR_CAM, 0);
if (idx > 1)
return -EBUSY;
*key_idx = idx;
break;
}
/* Group keys */
idx = find_next_zero_bit(addr_cam->sec_cam_map,
RTW89_SEC_CAM_IN_ADDR_CAM, 2);
if (idx > 5)
return -EBUSY;
*key_idx = idx;
break;
}
return 0;
}
static int __rtw89_cam_detach_sec_cam(struct rtw89_dev *rtwdev,
struct rtw89_vif_link *rtwvif_link,
struct rtw89_sta_link *rtwsta_link,
const struct rtw89_sec_cam_entry *sec_cam,
bool inform_fw)
{
struct rtw89_addr_cam_entry *addr_cam;
unsigned int i;
int ret = 0;
addr_cam = rtw89_get_addr_cam_of(rtwvif_link, rtwsta_link);
for_each_set_bit(i, addr_cam->sec_cam_map, RTW89_SEC_CAM_IN_ADDR_CAM) {
if (addr_cam->sec_ent[i] != sec_cam->sec_cam_idx)
continue;
clear_bit(i, addr_cam->sec_cam_map);
}
if (inform_fw) {
ret = rtw89_chip_h2c_dctl_sec_cam(rtwdev, rtwvif_link, rtwsta_link);
if (ret)
rtw89_err(rtwdev,
"failed to update dctl cam del key: %d\n", ret);
ret = rtw89_fw_h2c_cam(rtwdev, rtwvif_link, rtwsta_link, NULL,
RTW89_ROLE_INFO_CHANGE);
if (ret)
rtw89_err(rtwdev, "failed to update cam del key: %d\n", ret);
}
return ret;
}
static int __rtw89_cam_attach_sec_cam(struct rtw89_dev *rtwdev,
struct rtw89_vif_link *rtwvif_link,
struct rtw89_sta_link *rtwsta_link,
Annotation
- Immediate include surface: `cam.h`, `debug.h`, `fw.h`, `mac.h`, `ps.h`.
- Detected declarations: `function rtw89_cam_get_sec_key_cmd`, `function rtw89_cam_send_sec_key_cmd`, `function rtw89_cam_get_avail_sec_cam`, `function rtw89_cam_get_addr_cam_key_idx`, `function __rtw89_cam_detach_sec_cam`, `function for_each_set_bit`, `function __rtw89_cam_attach_sec_cam`, `function rtw89_cam_attach_link_sec_cam`, `function rtw89_cam_detach_sec_cam`, `function rtw89_vif_for_each_link`.
- 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.