mac80211: extend sta kdoc - explain when they are added

Signed-off-by: Luis R. Rodriguez <lrodriguez@atheros.com>
Signed-off-by: John W. Linville <linville@tuxdriver.com>
This commit is contained in:
Luis R. Rodriguez 2009-06-02 18:38:14 -04:00 committed by John W. Linville
parent 60fd2b6701
commit 7e189a12c2
1 changed files with 9 additions and 0 deletions

View File

@ -44,6 +44,15 @@
* When the insertion fails (sta_info_insert()) returns non-zero), the
* structure will have been freed by sta_info_insert()!
*
* sta entries are added by mac80211 when you establish a link with a
* peer. This means different things for the different type of interfaces
* we support. For a regular station this mean we add the AP sta when we
* receive an assocation response from the AP. For IBSS this occurs when
* we receive a probe response or a beacon from target IBSS network. For
* WDS we add the sta for the peer imediately upon device open. When using
* AP mode we add stations for each respective station upon request from
* userspace through nl80211.
*
* Because there are debugfs entries for each station, and adding those
* must be able to sleep, it is also possible to "pin" a station entry,
* that means it can be removed from the hash table but not be freed.