diff options
author | Arend van Spriel <arend@broadcom.com> | 2012-09-19 16:21:17 -0400 |
---|---|---|
committer | John W. Linville <linville@tuxdriver.com> | 2012-09-24 15:02:06 -0400 |
commit | 02030eb61d2737c7e6a2b75506b57608d86199c5 (patch) | |
tree | a062c9eb6e0ad90e31d40e82d5b7ab598341433e /drivers/net/wireless/brcm80211 | |
parent | 6385df2db76c48d04530395a67c16b03afcc4095 (diff) |
brcmfmac: change struct brcmf_cfg80211_priv comments to kernel-doc
Small step to fix structure commenting using kernel-doc syntax.
Reviewed-by: Hante Meuleman <meuleman@broadcom.com>
Signed-off-by: Arend van Spriel <arend@broadcom.com>
Signed-off-by: John W. Linville <linville@tuxdriver.com>
Diffstat (limited to 'drivers/net/wireless/brcm80211')
-rw-r--r-- | drivers/net/wireless/brcm80211/brcmfmac/wl_cfg80211.h | 118 |
1 files changed, 77 insertions, 41 deletions
diff --git a/drivers/net/wireless/brcm80211/brcmfmac/wl_cfg80211.h b/drivers/net/wireless/brcm80211/brcmfmac/wl_cfg80211.h index b5c3fd942f59..a2138c185c65 100644 --- a/drivers/net/wireless/brcm80211/brcmfmac/wl_cfg80211.h +++ b/drivers/net/wireless/brcm80211/brcmfmac/wl_cfg80211.h | |||
@@ -376,51 +376,87 @@ struct brcmf_pno_scanresults_le { | |||
376 | __le32 count; | 376 | __le32 count; |
377 | }; | 377 | }; |
378 | 378 | ||
379 | /* dongle private data of cfg80211 interface */ | 379 | /** |
380 | * struct brcmf_cfg80211_priv - dongle private data of cfg80211 interface | ||
381 | * | ||
382 | * @wdev: representing wl cfg80211 device. | ||
383 | * @conf: dongle configuration. | ||
384 | * @scan_request: cfg80211 scan request object. | ||
385 | * @el: main event loop. | ||
386 | * @evt_q_list: used for event queue. | ||
387 | * @evt_q_lock: for event queue synchronization. | ||
388 | * @usr_sync: mainly for dongle up/down synchronization. | ||
389 | * @bss_list: bss_list holding scanned ap information. | ||
390 | * @scan_results: results of the last scan. | ||
391 | * @scan_req_int: internal scan request object. | ||
392 | * @bss_info: bss information for cfg80211 layer. | ||
393 | * @ie: information element object for internal purpose. | ||
394 | * @profile: holding dongle profile. | ||
395 | * @iscan: iscan controller information. | ||
396 | * @conn_info: association info. | ||
397 | * @pmk_list: wpa2 pmk list. | ||
398 | * @event_work: event handler work struct. | ||
399 | * @status: current dongle status. | ||
400 | * @pub: common driver information. | ||
401 | * @channel: current channel. | ||
402 | * @iscan_on: iscan on/off switch. | ||
403 | * @iscan_kickstart: indicate iscan already started. | ||
404 | * @active_scan: current scan mode. | ||
405 | * @sched_escan: e-scan for scheduled scan support running. | ||
406 | * @ibss_starter: indicates this sta is ibss starter. | ||
407 | * @link_up: link/connection up flag. | ||
408 | * @pwr_save: indicate whether dongle to support power save mode. | ||
409 | * @dongle_up: indicate whether dongle up or not. | ||
410 | * @roam_on: on/off switch for dongle self-roaming. | ||
411 | * @scan_tried: indicates if first scan attempted. | ||
412 | * @dcmd_buf: dcmd buffer. | ||
413 | * @extra_buf: mainly to grab assoc information. | ||
414 | * @debugfsdir: debugfs folder for this device. | ||
415 | * @escan_on: escan on/off switch. | ||
416 | * @escan_info: escan information. | ||
417 | * @escan_timeout: Timer for catch scan timeout. | ||
418 | * @escan_timeout_work: scan timeout worker. | ||
419 | * @escan_ioctl_buf: dongle command buffer for escan commands. | ||
420 | * @ci: used to link this structure to netdev private data. | ||
421 | */ | ||
380 | struct brcmf_cfg80211_priv { | 422 | struct brcmf_cfg80211_priv { |
381 | struct wireless_dev *wdev; /* representing wl cfg80211 device */ | 423 | struct wireless_dev *wdev; |
382 | struct brcmf_cfg80211_conf *conf; /* dongle configuration */ | 424 | struct brcmf_cfg80211_conf *conf; |
383 | struct cfg80211_scan_request *scan_request; /* scan request | 425 | struct cfg80211_scan_request *scan_request; |
384 | object */ | 426 | struct brcmf_cfg80211_event_loop el; |
385 | struct brcmf_cfg80211_event_loop el; /* main event loop */ | 427 | struct list_head evt_q_list; |
386 | struct list_head evt_q_list; /* used for event queue */ | 428 | spinlock_t evt_q_lock; |
387 | spinlock_t evt_q_lock; /* for event queue synchronization */ | 429 | struct mutex usr_sync; |
388 | struct mutex usr_sync; /* maily for dongle up/down synchronization */ | 430 | struct brcmf_scan_results *bss_list; |
389 | struct brcmf_scan_results *bss_list; /* bss_list holding scanned | ||
390 | ap information */ | ||
391 | struct brcmf_scan_results *scan_results; | 431 | struct brcmf_scan_results *scan_results; |
392 | struct brcmf_cfg80211_scan_req *scan_req_int; /* scan request object | 432 | struct brcmf_cfg80211_scan_req *scan_req_int; |
393 | for internal purpose */ | 433 | struct wl_cfg80211_bss_info *bss_info; |
394 | struct wl_cfg80211_bss_info *bss_info; /* bss information for | 434 | struct brcmf_cfg80211_ie ie; |
395 | cfg80211 layer */ | 435 | struct brcmf_cfg80211_profile *profile; |
396 | struct brcmf_cfg80211_ie ie; /* information element object for | 436 | struct brcmf_cfg80211_iscan_ctrl *iscan; |
397 | internal purpose */ | 437 | struct brcmf_cfg80211_connect_info conn_info; |
398 | struct brcmf_cfg80211_profile *profile; /* holding dongle profile */ | 438 | struct brcmf_cfg80211_pmk_list *pmk_list; |
399 | struct brcmf_cfg80211_iscan_ctrl *iscan; /* iscan controller */ | 439 | struct work_struct event_work; |
400 | struct brcmf_cfg80211_connect_info conn_info; /* association info */ | 440 | unsigned long status; |
401 | struct brcmf_cfg80211_pmk_list *pmk_list; /* wpa2 pmk list */ | ||
402 | struct work_struct event_work; /* event handler work struct */ | ||
403 | unsigned long status; /* current dongle status */ | ||
404 | void *pub; | 441 | void *pub; |
405 | u32 channel; /* current channel */ | 442 | u32 channel; |
406 | bool iscan_on; /* iscan on/off switch */ | 443 | bool iscan_on; |
407 | bool iscan_kickstart; /* indicate iscan already started */ | 444 | bool iscan_kickstart; |
408 | bool active_scan; /* current scan mode */ | 445 | bool active_scan; |
409 | bool sched_escan; /* e-scan for scheduled scan support running */ | 446 | bool sched_escan; |
410 | bool ibss_starter; /* indicates this sta is ibss starter */ | 447 | bool ibss_starter; |
411 | bool link_up; /* link/connection up flag */ | 448 | bool link_up; |
412 | bool pwr_save; /* indicate whether dongle to support | 449 | bool pwr_save; |
413 | power save mode */ | 450 | bool dongle_up; |
414 | bool dongle_up; /* indicate whether dongle up or not */ | 451 | bool roam_on; |
415 | bool roam_on; /* on/off switch for dongle self-roaming */ | 452 | bool scan_tried; |
416 | bool scan_tried; /* indicates if first scan attempted */ | 453 | u8 *dcmd_buf; |
417 | u8 *dcmd_buf; /* dcmd buffer */ | 454 | u8 *extra_buf; |
418 | u8 *extra_buf; /* maily to grab assoc information */ | ||
419 | struct dentry *debugfsdir; | 455 | struct dentry *debugfsdir; |
420 | bool escan_on; /* escan on/off switch */ | 456 | bool escan_on; |
421 | struct escan_info escan_info; /* escan information */ | 457 | struct escan_info escan_info; |
422 | struct timer_list escan_timeout; /* Timer for catch scan timeout */ | 458 | struct timer_list escan_timeout; |
423 | struct work_struct escan_timeout_work; /* scan timeout worker */ | 459 | struct work_struct escan_timeout_work; |
424 | u8 *escan_ioctl_buf; | 460 | u8 *escan_ioctl_buf; |
425 | u8 ci[0] __aligned(NETDEV_ALIGN); | 461 | u8 ci[0] __aligned(NETDEV_ALIGN); |
426 | }; | 462 | }; |