cfg80211 Subsystem

cfg80211 subsystem 개요

`cfg80211`은 Linux 802.11 wireless 구성의 중심 subsystem입니다. 이 절은 `include/net/cfg80211.h`에 있는 `Introduction` kernel-doc 문단을 포함합니다.

.. kernel-doc:: include/net/cfg80211.h
   :doc: Introduction

device 등록

device registration 절은 `include/net/cfg80211.h`의 같은 이름 문단과 channel·rate·band capability, `wiphy`, `wireless_dev`, interface combination, wiphy 생성·등록·해제와 private data 접근 API의 kernel-doc을 포함합니다.

.. kernel-doc:: include/net/cfg80211.h
   :doc: Device registration

.. kernel-doc:: include/net/cfg80211.h
   :functions:
        ieee80211_channel_flags
        ieee80211_channel
        ieee80211_rate_flags
        ieee80211_rate
        ieee80211_sta_ht_cap
        ieee80211_supported_band
        cfg80211_signal_type
        wiphy_params_flags
        wiphy_flags
        wiphy
        wireless_dev
        wiphy_new
        wiphy_read_of_freq_limits
        wiphy_register
        wiphy_unregister
        wiphy_free
        wiphy_name
        wiphy_dev
        wiphy_priv
        priv_to_wiphy
        set_wiphy_dev
        wdev_priv
        ieee80211_iface_limit
        ieee80211_iface_combination
        cfg80211_check_combinations

동작과 구성

actions and configuration 절은 driver callback 집합 `cfg80211_ops`와 virtual interface, key, survey, beacon, AP, station, rate, monitor, mesh path, BSS, TX queue, crypto 설정 자료 구조를 포함합니다.

또한 인증·연결·association·deauthentication·disassociation·IBSS 요청과 응답, timeout, roaming, disconnect, remain-on-channel, 새 station, management frame, CQM, packet loss, Michael MIC failure를 보고하는 cfg80211 API의 kernel-doc을 포함합니다.

.. kernel-doc:: include/net/cfg80211.h
   :doc: Actions and configuration

.. kernel-doc:: include/net/cfg80211.h
   :functions:
        cfg80211_ops
        vif_params
        key_params
        survey_info_flags
        survey_info
        cfg80211_beacon_data
        cfg80211_ap_settings
        station_parameters
        rate_info_flags
        rate_info
        station_info
        monitor_flags
        mpath_info_flags
        mpath_info
        bss_parameters
        ieee80211_txq_params
        cfg80211_crypto_settings
        cfg80211_auth_request
        cfg80211_assoc_request
        cfg80211_deauth_request
        cfg80211_disassoc_request
        cfg80211_ibss_params
        cfg80211_connect_params
        cfg80211_pmksa
        cfg80211_rx_mlme_mgmt
        cfg80211_auth_timeout
        cfg80211_rx_assoc_resp
        cfg80211_assoc_timeout
        cfg80211_tx_mlme_mgmt
        cfg80211_ibss_joined
        cfg80211_connect_resp_params
        cfg80211_connect_done
        cfg80211_connect_result
        cfg80211_connect_bss
        cfg80211_connect_timeout
        cfg80211_roamed
        cfg80211_disconnected
        cfg80211_ready_on_channel
        cfg80211_remain_on_channel_expired
        cfg80211_new_sta
        cfg80211_rx_mgmt
        cfg80211_mgmt_tx_status
        cfg80211_cqm_rssi_notify
        cfg80211_cqm_pktloss_notify
        cfg80211_michael_mic_failure

scan과 BSS 목록 처리

scanning and BSS list handling 절은 SSID와 scan request, scan completion, `cfg80211_bss`, BSS·frame 정보를 알리는 함수, BSS unlink, information element 검색 API를 포함합니다.

.. kernel-doc:: include/net/cfg80211.h
   :doc: Scanning and BSS list handling

.. kernel-doc:: include/net/cfg80211.h
   :functions:
        cfg80211_ssid
        cfg80211_scan_request
        cfg80211_scan_done
        cfg80211_bss
        cfg80211_inform_bss
        cfg80211_inform_bss_frame_data
        cfg80211_inform_bss_data
        cfg80211_unlink_bss
        cfg80211_find_ie
        ieee80211_bss_get_ie

utility 함수

utility 절은 IEEE 802.11 channel과 frequency 변환, channel 조회, response rate 선택, header 길이 계산과 radiotap iterator의 kernel-doc을 포함합니다.

.. kernel-doc:: include/net/cfg80211.h
   :doc: Utility functions

.. kernel-doc:: include/net/cfg80211.h
   :functions:
        ieee80211_channel_to_frequency
        ieee80211_frequency_to_channel
        ieee80211_get_channel
        ieee80211_get_response_rate
        ieee80211_hdrlen
        ieee80211_get_hdrlen_from_skb
        ieee80211_radiotap_iterator

data path helper

data path helper 절은 802.11 frame을 802.3 frame으로 변환하고 A-MSDU를 여러 802.3 frame으로 분리하며 packet을 802.1D priority로 분류하는 API를 포함합니다.

.. kernel-doc:: include/net/cfg80211.h
   :doc: Data path helpers

.. kernel-doc:: include/net/cfg80211.h
   :functions:
        ieee80211_data_to_8023
        ieee80211_amsdu_to_8023s
        cfg80211_classify8021d

regulatory enforcement 기반 시설

regulatory enforcement 절은 regulatory hint를 전달하고 wiphy별 custom regulatory domain을 적용하며 주파수의 regulatory 정보를 조회하는 API를 포함합니다.

.. kernel-doc:: include/net/cfg80211.h
   :doc: Regulatory enforcement infrastructure

.. kernel-doc:: include/net/cfg80211.h
   :functions:
        regulatory_hint
        wiphy_apply_custom_regulatory
        freq_reg_info

RFkill 통합

RFkill integration 절은 wiphy의 hardware RFkill 상태를 알리고 polling을 시작하거나 중지하는 API를 포함합니다.

.. kernel-doc:: include/net/cfg80211.h
   :doc: RFkill integration

.. kernel-doc:: include/net/cfg80211.h
   :functions:
        wiphy_rfkill_set_hw_state
        wiphy_rfkill_start_polling
        wiphy_rfkill_stop_polling

test mode

test mode 절은 testmode reply와 event에 사용할 skb를 할당하고 reply 또는 event를 userspace로 전달하는 cfg80211 API를 포함합니다.

.. kernel-doc:: include/net/cfg80211.h
   :doc: Test mode

.. kernel-doc:: include/net/cfg80211.h
   :functions:
        cfg80211_testmode_alloc_reply_skb
        cfg80211_testmode_reply
        cfg80211_testmode_alloc_event_skb
        cfg80211_testmode_event