sys/netproto/802_11/README.DRAGONFLY

   1
   2                             README.DRAGONFLY
   3
   4     All ABI entry points into the wlan infrastructure must acquire the
   5     wlan_global_serializer.  Normally all wireless base drivers also
   6     use this serializer to avoid deadlocks.
   7
   8 modevent        ieee80211_dragonfly.h
   9                 search for DECLARE_MODULE
  10
  11 sysctl          search for SYSCTL_HANDLER_ARGS
  12
  13 eventhandler    search for EVENTHANDLER_REGISTER
  14
  15 taskq           search for TASK_INIT
  16
  17 callout         search for callout_reset
  18
  19                 search for callout_stop to deal with
  20                 potential deadlock issues
  21
  22 ifnet           wlan/ieee80211.c
  23
  24                 Set if_serializer to &wlan_global_serializer.  There are
  25                 a few places where if_ioctl is set to NULL and then later
  26                 restored.  It is unclear why this is being done.
  27
  28 ifnet, interrupt, devmethod, copyin/copyout
  29
  30 ieee80211_ioctl()
  31
  32                 This is called directly from the wlan's ifp->if_ioctl and
  33                 also from various wireless drivers.  This function expects
  34                 the serializer to already be acquired.
  35
  36                 The kernel will acquire if_serializer when making
  37                 ifp->if_ioctl() calls.