aboutsummaryrefslogtreecommitdiffstats
path: root/drivers/net/wireless/brcm80211
diff options
context:
space:
mode:
authorArend van Spriel <arend@broadcom.com>2012-09-19 16:21:17 -0400
committerJohn W. Linville <linville@tuxdriver.com>2012-09-24 15:02:06 -0400
commit02030eb61d2737c7e6a2b75506b57608d86199c5 (patch)
treea062c9eb6e0ad90e31d40e82d5b7ab598341433e /drivers/net/wireless/brcm80211
parent6385df2db76c48d04530395a67c16b03afcc4095 (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.h118
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 */
380struct brcmf_cfg80211_priv { 422struct 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};