freebsd with flexible iflib nic queues
Go to file
Bill Paul 58a6edd121 When you call MiniportInitialize() for an 802.11 driver, it will
at some point result in a status event being triggered (it should
be a link down event: the Microsoft driver design guide says you
should generate one when the NIC is initialized). Some drivers
generate the event during MiniportInitialize(), such that by the
time MiniportInitialize() completes, the NIC is ready to go. But
some drivers, in particular the ones for Atheros wireless NICs,
don't generate the event until after a device interrupt occurs
at some point after MiniportInitialize() has completed.

The gotcha is that you have to wait until the link status event
occurs one way or the other before you try to fiddle with any
settings (ssid, channel, etc...). For the drivers that set the
event sycnhronously this isn't a problem, but for the others
we have to pause after calling ndis_init_nic() and wait for the event
to arrive before continuing. Failing to wait can cause big trouble:
on my SMP system, calling ndis_setstate_80211() after ndis_init_nic()
completes, but _before_ the link event arrives, will lock up or
reset the system.

What we do now is check to see if a link event arrived while
ndis_init_nic() was running, and if it didn't we msleep() until
it does.

Along the way, I discovered a few other problems:

- Defered procedure calls run at PASSIVE_LEVEL, not DISPATCH_LEVEL.
  ntoskrnl_run_dpc() has been fixed accordingly. (I read the documentation
  wrong.)

- Similarly, the NDIS interrupt handler, which is essentially a
  DPC, also doesn't need to run at DISPATCH_LEVEL. ndis_intrtask()
  has been fixed accordingly.

- MiniportQueryInformation() and MiniportSetInformation() run at
  DISPATCH_LEVEL, and each request must complete before another
  can be submitted. ndis_get_info() and ndis_set_info() have been
  fixed accordingly.

- Turned the sleep lock that guards the NDIS thread job list into
  a spin lock. We never do anything with this lock held except manage
  the job list (no other locks are held), so it's safe to do this,
  and it's possible that ndis_sched() and ndis_unsched() can be
  called from DISPATCH_LEVEL, so using a sleep lock here is
  semantically incorrect. Also updated subr_witness.c to add the
  lock to the order list.
2005-03-07 03:05:31 +00:00
bin Use `.Pq Ql'' to quote single characters, instead of `.Pq Li''. 2005-03-04 13:16:50 +00:00
contrib Don't extract the .gdbinit file from the distribution. 2005-02-28 17:29:10 +00:00
crypto File removed in update from OpenSSL 0.9.7d -> 0.9.7e. 2005-02-25 06:22:30 +00:00
etc New Ukrainian locale: uk_UA.CP1251. 2005-03-04 14:24:30 +00:00
games Another good Dijkstra quote. 2005-03-04 09:47:22 +00:00
gnu Implement and document the -q and -f options with their corresponding 2005-03-02 18:40:04 +00:00
include Only install acpiio.h in /usr/include. That's all we want to export to users. 2005-03-02 10:45:09 +00:00
kerberos5 Update Heimdal 0.6.1 -> 0.6.3. 2005-02-24 22:24:24 +00:00
lib Fix a mistake in the exponent range. 2005-03-06 19:08:18 +00:00
libexec Install rlogind(8). Pointy hat is available on request. 2005-03-03 15:59:32 +00:00
release New release notes: 2005-03-06 19:08:51 +00:00
rescue Wrap BSD r* commands in NO_RCMDS. 2005-03-02 11:53:22 +00:00
sbin Use a signal-safe type for two variables that are used to synchronise 2005-03-02 02:30:08 +00:00
secure Update OpenSSL 0.9.7d -> 0.9.7e. 2005-02-25 06:04:12 +00:00
share Remove superflous .Pp calls. 2005-03-04 22:34:57 +00:00
sys When you call MiniportInitialize() for an 802.11 driver, it will 2005-03-07 03:05:31 +00:00
tools Markup nits. 2005-03-03 07:20:57 +00:00
usr.bin Change fix a bug where the length of data written by snprintf was 2005-03-03 17:20:36 +00:00
usr.sbin Add the -N option to not rotate any files. This is to be used in 2005-03-03 15:47:32 +00:00
COPYRIGHT Complete 2005 transition. 2005-01-01 07:29:20 +00:00
MAINTAINERS Drop hold on patch. ENOTIME for long-stalled ideas here. Too busy elsewhere. 2004-12-29 03:49:58 +00:00
Makefile Repo-copy tools/regression/usr.bin/make to tools/build/make_check 2005-03-02 12:33:23 +00:00
Makefile.inc1 Add hacks that I use to test cross-builds (by building on 2005-03-02 16:40:51 +00:00
README KerberosIV de-orbit burn continues. Disconnect from "make world". 2003-03-08 10:01:26 +00:00
UPDATING Remove important entry being X that's 9 months old 2005-03-03 08:44:33 +00:00

This is the top level of the FreeBSD source directory.  This file
was last revised on:
$FreeBSD$

For copyright information, please see the file COPYRIGHT in this
directory (additional copyright information also exists for some
sources in this tree - please see the specific source directories for
more information).

The Makefile in this directory supports a number of targets for
building components (or all) of the FreeBSD source tree, the most
commonly used one being ``world'', which rebuilds and installs
everything in the FreeBSD system from the source tree except the
kernel, the kernel-modules and the contents of /etc.  The
``buildkernel'' and ``installkernel'' targets build and install
the kernel and the modules (see below).  Please see the top of
the Makefile in this directory for more information on the
standard build targets and compile-time flags.

Building a kernel is a somewhat more involved process, documentation
for which can be found at:
   http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/kernelconfig.html
And in the config(8) man page.
Note: If you want to build and install the kernel with the
``buildkernel'' and ``installkernel'' targets, you might need to build
world before.  More information is available in the handbook.

The sample kernel configuration files reside in the sys/<arch>/conf
sub-directory (assuming that you've installed the kernel sources), the
file named GENERIC being the one used to build your initial installation
kernel.  The file NOTES contains entries and documentation for all possible
devices, not just those commonly used.  It is the successor of the ancient
LINT file, but in contrast to LINT, it is not buildable as a kernel but a
pure reference and documentation file.


Source Roadmap:
---------------
bin		System/user commands.

contrib		Packages contributed by 3rd parties.

crypto		Cryptography stuff (see crypto/README).

etc		Template files for /etc.

games		Amusements.

gnu		Various commands and libraries under the GNU Public License.
		Please see gnu/COPYING* for more information.

include		System include files.

kerberos5	Kerberos5 (Heimdal) package.

lib		System libraries.

libexec		System daemons.

release		Release building Makefile & associated tools.

sbin		System commands.

secure		Cryptographic libraries and commands.

share		Shared resources.

sys		Kernel sources.

tools		Utilities for regression testing and miscellaneous tasks.

usr.bin		User commands.

usr.sbin	System administration commands.


For information on synchronizing your source tree with one or more of
the FreeBSD Project's development branches, please see:

  http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/synching.html