2 * SPDX-License-Identifier: BSD-4-Clause
5 * Bill Paul <wpaul@windriver.com>. All rights reserved.
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
10 * 1. Redistributions of source code must retain the above copyright
11 * notice, this list of conditions and the following disclaimer.
12 * 2. Redistributions in binary form must reproduce the above copyright
13 * notice, this list of conditions and the following disclaimer in the
14 * documentation and/or other materials provided with the distribution.
15 * 3. All advertising materials mentioning features or use of this software
16 * must display the following acknowledgement:
17 * This product includes software developed by Bill Paul.
18 * 4. Neither the name of the author nor the names of any co-contributors
19 * may be used to endorse or promote products derived from this software
20 * without specific prior written permission.
22 * THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND
23 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
24 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
25 * ARE DISCLAIMED. IN NO EVENT SHALL Bill Paul OR THE VOICES IN HIS HEAD
26 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
27 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
28 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
29 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
30 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
31 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
32 * THE POSSIBILITY OF SUCH DAMAGE.
35 #include <sys/cdefs.h>
36 __FBSDID("$FreeBSD$");
38 #include <sys/param.h>
39 #include <sys/systm.h>
40 #include <sys/unistd.h>
41 #include <sys/types.h>
42 #include <sys/errno.h>
43 #include <sys/callout.h>
44 #include <sys/socket.h>
45 #include <sys/queue.h>
46 #include <sys/sysctl.h>
48 #include <sys/malloc.h>
50 #include <sys/mutex.h>
53 #include <sys/kernel.h>
54 #include <sys/module.h>
55 #include <sys/kthread.h>
56 #include <machine/bus.h>
57 #include <machine/resource.h>
62 #include <net/if_var.h>
63 #include <net/if_arp.h>
64 #include <net/ethernet.h>
65 #include <net/if_dl.h>
66 #include <net/if_media.h>
68 #include <net80211/ieee80211_var.h>
69 #include <net80211/ieee80211_ioctl.h>
71 #include <dev/usb/usb.h>
72 #include <dev/usb/usbdi.h>
74 #include <compat/ndis/pe_var.h>
75 #include <compat/ndis/cfg_var.h>
76 #include <compat/ndis/resource_var.h>
77 #include <compat/ndis/ntoskrnl_var.h>
78 #include <compat/ndis/ndis_var.h>
79 #include <compat/ndis/hal_var.h>
80 #include <compat/ndis/usbd_var.h>
81 #include <dev/if_ndis/if_ndisvar.h>
83 #define NDIS_DUMMY_PATH "\\\\some\\bogus\\path"
84 #define NDIS_FLAG_RDONLY 1
86 static void ndis_status_func(ndis_handle, ndis_status, void *, uint32_t);
87 static void ndis_statusdone_func(ndis_handle);
88 static void ndis_setdone_func(ndis_handle, ndis_status);
89 static void ndis_getdone_func(ndis_handle, ndis_status);
90 static void ndis_resetdone_func(ndis_handle, ndis_status, uint8_t);
91 static void ndis_sendrsrcavail_func(ndis_handle);
92 static void ndis_intrsetup(kdpc *, device_object *,
93 irp *, struct ndis_softc *);
94 static void ndis_return(device_object *, void *);
96 static image_patch_table kernndis_functbl[] = {
97 IMPORT_SFUNC(ndis_status_func, 4),
98 IMPORT_SFUNC(ndis_statusdone_func, 1),
99 IMPORT_SFUNC(ndis_setdone_func, 2),
100 IMPORT_SFUNC(ndis_getdone_func, 2),
101 IMPORT_SFUNC(ndis_resetdone_func, 3),
102 IMPORT_SFUNC(ndis_sendrsrcavail_func, 1),
103 IMPORT_SFUNC(ndis_intrsetup, 4),
104 IMPORT_SFUNC(ndis_return, 1),
108 static struct nd_head ndis_devhead;
111 * This allows us to export our symbols to other modules.
112 * Note that we call ourselves 'ndisapi' to avoid a namespace
113 * collision with if_ndis.ko, which internally calls itself
116 * Note: some of the subsystems depend on each other, so the
117 * order in which they're started is important. The order of
120 * HAL - spinlocks and IRQL manipulation
121 * ntoskrnl - DPC and workitem threads, object waiting
122 * windrv - driver/device registration
124 * The HAL should also be the last thing shut down, since
125 * the ntoskrnl subsystem will use spinlocks right up until
126 * the DPC and workitem threads are terminated.
130 ndis_modevent(module_t mod, int cmd, void *arg)
133 image_patch_table *patch;
137 /* Initialize subsystems */
144 patch = kernndis_functbl;
145 while (patch->ipt_func != NULL) {
146 windrv_wrap((funcptr)patch->ipt_func,
147 (funcptr *)&patch->ipt_wrap,
148 patch->ipt_argcnt, patch->ipt_ftype);
152 TAILQ_INIT(&ndis_devhead);
155 if (TAILQ_FIRST(&ndis_devhead) == NULL) {
156 /* Shut down subsystems */
163 patch = kernndis_functbl;
164 while (patch->ipt_func != NULL) {
165 windrv_unwrap(patch->ipt_wrap);
171 /* Shut down subsystems */
178 patch = kernndis_functbl;
179 while (patch->ipt_func != NULL) {
180 windrv_unwrap(patch->ipt_wrap);
192 DEV_MODULE(ndisapi, ndis_modevent, NULL);
193 MODULE_VERSION(ndisapi, 1);
196 ndis_sendrsrcavail_func(adapter)
202 ndis_status_func(adapter, status, sbuf, slen)
208 ndis_miniport_block *block;
209 struct ndis_softc *sc;
213 sc = device_get_softc(block->nmb_physdeviceobj->do_devext);
214 ifp = NDISUSB_GET_IFNET(sc);
215 if ( ifp && ifp->if_flags & IFF_DEBUG)
216 device_printf(sc->ndis_dev, "status: %x\n", status);
220 ndis_statusdone_func(adapter)
223 ndis_miniport_block *block;
224 struct ndis_softc *sc;
228 sc = device_get_softc(block->nmb_physdeviceobj->do_devext);
229 ifp = NDISUSB_GET_IFNET(sc);
230 if (ifp && ifp->if_flags & IFF_DEBUG)
231 device_printf(sc->ndis_dev, "status complete\n");
235 ndis_setdone_func(adapter, status)
239 ndis_miniport_block *block;
242 block->nmb_setstat = status;
243 KeSetEvent(&block->nmb_setevent, IO_NO_INCREMENT, FALSE);
247 ndis_getdone_func(adapter, status)
251 ndis_miniport_block *block;
254 block->nmb_getstat = status;
255 KeSetEvent(&block->nmb_getevent, IO_NO_INCREMENT, FALSE);
259 ndis_resetdone_func(ndis_handle adapter, ndis_status status,
260 uint8_t addressingreset)
262 ndis_miniport_block *block;
263 struct ndis_softc *sc;
267 sc = device_get_softc(block->nmb_physdeviceobj->do_devext);
268 ifp = NDISUSB_GET_IFNET(sc);
270 if (ifp && ifp->if_flags & IFF_DEBUG)
271 device_printf(sc->ndis_dev, "reset done...\n");
272 KeSetEvent(&block->nmb_resetevent, IO_NO_INCREMENT, FALSE);
276 ndis_create_sysctls(arg)
279 struct ndis_softc *sc;
282 struct sysctl_oid *oidp;
283 struct sysctl_ctx_entry *e;
290 device_printf(sc->ndis_dev, "ndis_create_sysctls() sc=%p\n", sc);
292 vals = sc->ndis_regvals;
294 TAILQ_INIT(&sc->ndis_cfglist_head);
296 /* Add the driver-specific registry keys. */
299 if (vals->nc_cfgkey == NULL)
302 if (vals->nc_idx != sc->ndis_devidx) {
307 /* See if we already have a sysctl with this name */
310 TAILQ_FOREACH(e, device_get_sysctl_ctx(sc->ndis_dev), link) {
312 if (strcasecmp(oidp->oid_name, vals->nc_cfgkey) == 0)
322 ndis_add_sysctl(sc, vals->nc_cfgkey, vals->nc_cfgdesc,
323 vals->nc_val, CTLFLAG_RW);
327 /* Now add a couple of builtin keys. */
330 * Environment can be either Windows (0) or WindowsNT (1).
331 * We qualify as the latter.
333 ndis_add_sysctl(sc, "Environment",
334 "Windows environment", "1", NDIS_FLAG_RDONLY);
336 /* NDIS version should be 5.1. */
337 ndis_add_sysctl(sc, "NdisVersion",
338 "NDIS API Version", "0x00050001", NDIS_FLAG_RDONLY);
341 * Some miniport drivers rely on the existence of the SlotNumber,
342 * NetCfgInstanceId and DriverDesc keys.
344 ndis_add_sysctl(sc, "SlotNumber", "Slot Numer", "01", NDIS_FLAG_RDONLY);
345 ndis_add_sysctl(sc, "NetCfgInstanceId", "NetCfgInstanceId",
346 "{12345678-1234-5678-CAFE0-123456789ABC}", NDIS_FLAG_RDONLY);
347 ndis_add_sysctl(sc, "DriverDesc", "Driver Description",
348 "NDIS Network Adapter", NDIS_FLAG_RDONLY);
350 /* Bus type (PCI, PCMCIA, etc...) */
351 sprintf(buf, "%d", (int)sc->ndis_iftype);
352 ndis_add_sysctl(sc, "BusType", "Bus Type", buf, NDIS_FLAG_RDONLY);
354 if (sc->ndis_res_io != NULL) {
355 sprintf(buf, "0x%jx", rman_get_start(sc->ndis_res_io));
356 ndis_add_sysctl(sc, "IOBaseAddress",
357 "Base I/O Address", buf, NDIS_FLAG_RDONLY);
360 if (sc->ndis_irq != NULL) {
361 sprintf(buf, "%ju", rman_get_start(sc->ndis_irq));
362 ndis_add_sysctl(sc, "InterruptNumber",
363 "Interrupt Number", buf, NDIS_FLAG_RDONLY);
370 ndis_add_sysctl(arg, key, desc, val, flag_rdonly)
377 struct ndis_softc *sc;
378 struct ndis_cfglist *cfg;
383 cfg = malloc(sizeof(struct ndis_cfglist), M_DEVBUF, M_NOWAIT|M_ZERO);
386 printf("failed for %s\n", key);
390 cfg->ndis_cfg.nc_cfgkey = strdup(key, M_DEVBUF);
392 snprintf(descstr, sizeof(descstr), "%s (dynamic)", key);
393 cfg->ndis_cfg.nc_cfgdesc = strdup(descstr, M_DEVBUF);
395 cfg->ndis_cfg.nc_cfgdesc = strdup(desc, M_DEVBUF);
396 strcpy(cfg->ndis_cfg.nc_val, val);
398 TAILQ_INSERT_TAIL(&sc->ndis_cfglist_head, cfg, link);
400 if (flag_rdonly != 0) {
402 SYSCTL_ADD_STRING(device_get_sysctl_ctx(sc->ndis_dev),
403 SYSCTL_CHILDREN(device_get_sysctl_tree(sc->ndis_dev)),
404 OID_AUTO, cfg->ndis_cfg.nc_cfgkey, CTLFLAG_RD,
405 cfg->ndis_cfg.nc_val, sizeof(cfg->ndis_cfg.nc_val),
406 cfg->ndis_cfg.nc_cfgdesc);
409 SYSCTL_ADD_STRING(device_get_sysctl_ctx(sc->ndis_dev),
410 SYSCTL_CHILDREN(device_get_sysctl_tree(sc->ndis_dev)),
411 OID_AUTO, cfg->ndis_cfg.nc_cfgkey, CTLFLAG_RW,
412 cfg->ndis_cfg.nc_val, sizeof(cfg->ndis_cfg.nc_val),
413 cfg->ndis_cfg.nc_cfgdesc);
419 * Somewhere, somebody decided "hey, let's automatically create
420 * a sysctl tree for each device instance as it's created -- it'll
421 * make life so much easier!" Lies. Why must they turn the kernel
422 * into a house of lies?
426 ndis_flush_sysctls(arg)
429 struct ndis_softc *sc;
430 struct ndis_cfglist *cfg;
431 struct sysctl_ctx_list *clist;
435 clist = device_get_sysctl_ctx(sc->ndis_dev);
437 while (!TAILQ_EMPTY(&sc->ndis_cfglist_head)) {
438 cfg = TAILQ_FIRST(&sc->ndis_cfglist_head);
439 TAILQ_REMOVE(&sc->ndis_cfglist_head, cfg, link);
440 sysctl_ctx_entry_del(clist, cfg->ndis_oid);
441 sysctl_remove_oid(cfg->ndis_oid, 1, 0);
442 free(cfg->ndis_cfg.nc_cfgkey, M_DEVBUF);
443 free(cfg->ndis_cfg.nc_cfgdesc, M_DEVBUF);
451 ndis_get_routine_address(functbl, name)
452 struct image_patch_table *functbl;
457 for (i = 0; functbl[i].ipt_name != NULL; i++)
458 if (strcmp(name, functbl[i].ipt_name) == 0)
459 return (functbl[i].ipt_wrap);
464 ndis_return(dobj, arg)
468 ndis_miniport_block *block;
469 ndis_miniport_characteristics *ch;
470 ndis_return_handler returnfunc;
477 ch = IoGetDriverObjectExtension(dobj->do_drvobj, (void *)1);
480 adapter = block->nmb_miniportadapterctx;
485 returnfunc = ch->nmc_return_packet_func;
487 KeAcquireSpinLock(&block->nmb_returnlock, &irql);
488 while (!IsListEmpty(&block->nmb_returnlist)) {
489 l = RemoveHeadList((&block->nmb_returnlist));
490 p = CONTAINING_RECORD(l, ndis_packet, np_list);
491 InitializeListHead((&p->np_list));
492 KeReleaseSpinLock(&block->nmb_returnlock, irql);
493 MSCALL2(returnfunc, adapter, p);
494 KeAcquireSpinLock(&block->nmb_returnlock, &irql);
496 KeReleaseSpinLock(&block->nmb_returnlock, irql);
500 ndis_ext_free(struct mbuf *m)
503 return (ndis_return_packet(m->m_ext.ext_arg1));
507 ndis_return_packet(ndis_packet *p)
509 ndis_miniport_block *block;
514 /* Decrement refcount. */
517 /* Release packet when refcount hits zero, otherwise return. */
521 block = ((struct ndis_softc *)p->np_softc)->ndis_block;
523 KeAcquireSpinLockAtDpcLevel(&block->nmb_returnlock);
524 InitializeListHead((&p->np_list));
525 InsertHeadList((&block->nmb_returnlist), (&p->np_list));
526 KeReleaseSpinLockFromDpcLevel(&block->nmb_returnlock);
528 IoQueueWorkItem(block->nmb_returnitem,
529 (io_workitem_func)kernndis_functbl[7].ipt_wrap,
530 WORKQUEUE_CRITICAL, block);
556 ndis_free_bufs(p->np_private.npp_head);
561 ndis_convert_res(arg)
564 struct ndis_softc *sc;
565 ndis_resource_list *rl = NULL;
566 cm_partial_resource_desc *prd = NULL;
567 ndis_miniport_block *block;
569 struct resource_list *brl;
570 struct resource_list_entry *brle;
574 block = sc->ndis_block;
577 rl = malloc(sizeof(ndis_resource_list) +
578 (sizeof(cm_partial_resource_desc) * (sc->ndis_rescnt - 1)),
579 M_DEVBUF, M_NOWAIT|M_ZERO);
584 rl->cprl_version = 5;
585 rl->cprl_revision = 1;
586 rl->cprl_count = sc->ndis_rescnt;
587 prd = rl->cprl_partial_descs;
589 brl = BUS_GET_RESOURCE_LIST(dev, dev);
592 STAILQ_FOREACH(brle, brl, link) {
593 switch (brle->type) {
595 prd->cprd_type = CmResourceTypePort;
596 prd->cprd_flags = CM_RESOURCE_PORT_IO;
597 prd->cprd_sharedisp =
598 CmResourceShareDeviceExclusive;
599 prd->u.cprd_port.cprd_start.np_quad =
601 prd->u.cprd_port.cprd_len = brle->count;
604 prd->cprd_type = CmResourceTypeMemory;
606 CM_RESOURCE_MEMORY_READ_WRITE;
607 prd->cprd_sharedisp =
608 CmResourceShareDeviceExclusive;
609 prd->u.cprd_mem.cprd_start.np_quad =
611 prd->u.cprd_mem.cprd_len = brle->count;
614 prd->cprd_type = CmResourceTypeInterrupt;
617 * Always mark interrupt resources as
618 * shared, since in our implementation,
621 prd->cprd_sharedisp =
622 CmResourceShareShared;
623 prd->u.cprd_intr.cprd_level = brle->start;
624 prd->u.cprd_intr.cprd_vector = brle->start;
625 prd->u.cprd_intr.cprd_affinity = 0;
634 block->nmb_rlist = rl;
640 * Map an NDIS packet to an mbuf list. When an NDIS driver receives a
641 * packet, it will hand it to us in the form of an ndis_packet,
642 * which we need to convert to an mbuf that is then handed off
643 * to the stack. Note: we configure the mbuf list so that it uses
644 * the memory regions specified by the ndis_buffer structures in
645 * the ndis_packet as external storage. In most cases, this will
646 * point to a memory region allocated by the driver (either by
647 * ndis_malloc_withtag() or ndis_alloc_sharedmem()). We expect
648 * the driver to handle free()ing this region for is, so we set up
649 * a dummy no-op free handler for it.
657 struct mbuf *m = NULL, *prev = NULL;
659 ndis_packet_private *priv;
662 struct ether_header *eh;
665 if (p == NULL || m0 == NULL)
668 priv = &p->np_private;
669 buf = priv->npp_head;
672 for (buf = priv->npp_head; buf != NULL; buf = buf->mdl_next) {
673 if (buf == priv->npp_head)
674 m = m_gethdr(M_NOWAIT, MT_DATA);
676 m = m_get(M_NOWAIT, MT_DATA);
682 m->m_len = MmGetMdlByteCount(buf);
683 m_extadd(m, MmGetMdlVirtualAddress(buf), m->m_len,
684 ndis_ext_free, p, NULL, 0, EXT_NDIS);
688 if (m->m_flags & M_PKTHDR)
696 * This is a hack to deal with the Marvell 8335 driver
697 * which, when associated with an AP in WPA-PSK mode,
698 * seems to overpad its frames by 8 bytes. I don't know
699 * that the extra 8 bytes are for, and they're not there
700 * in open mode, so for now clamp the frame size at 1514
701 * until I can figure out how to deal with this properly,
702 * otherwise if_ethersubr() will spank us by discarding
703 * the 'oversize' frames.
706 eh = mtod((*m0), struct ether_header *);
707 ifp = NDISUSB_GET_IFNET((struct ndis_softc *)p->np_softc);
708 if (ifp && totlen > ETHER_MAX_FRAME(ifp, eh->ether_type, FALSE)) {
709 diff = totlen - ETHER_MAX_FRAME(ifp, eh->ether_type, FALSE);
713 (*m0)->m_pkthdr.len = totlen;
719 * Create an NDIS packet from an mbuf chain.
720 * This is used mainly when transmitting packets, where we need
721 * to turn an mbuf off an interface's send queue and transform it
722 * into an NDIS packet which will be fed into the NDIS driver's
725 * NDIS packets consist of two parts: an ndis_packet structure,
726 * which is vaguely analogous to the pkthdr portion of an mbuf,
727 * and one or more ndis_buffer structures, which define the
728 * actual memory segments in which the packet data resides.
729 * We need to allocate one ndis_buffer for each mbuf in a chain,
730 * plus one ndis_packet as the header.
739 ndis_buffer *buf = NULL, *prev = NULL;
740 ndis_packet_private *priv;
742 if (p == NULL || *p == NULL || m0 == NULL)
745 priv = &(*p)->np_private;
746 priv->npp_totlen = m0->m_pkthdr.len;
748 for (m = m0; m != NULL; m = m->m_next) {
751 buf = IoAllocateMdl(m->m_data, m->m_len, FALSE, FALSE, NULL);
753 ndis_free_packet(*p);
757 MmBuildMdlForNonPagedPool(buf);
759 if (priv->npp_head == NULL)
760 priv->npp_head = buf;
762 prev->mdl_next = buf;
766 priv->npp_tail = buf;
772 ndis_get_supported_oids(arg, oids, oidcnt)
780 if (arg == NULL || oids == NULL || oidcnt == NULL)
783 ndis_get_info(arg, OID_GEN_SUPPORTED_LIST, NULL, &len);
785 o = malloc(len, M_DEVBUF, M_NOWAIT);
789 rval = ndis_get_info(arg, OID_GEN_SUPPORTED_LIST, o, &len);
803 ndis_set_info(arg, oid, buf, buflen)
809 struct ndis_softc *sc;
812 ndis_setinfo_handler setfunc;
813 uint32_t byteswritten = 0, bytesneeded = 0;
818 * According to the NDIS spec, MiniportQueryInformation()
819 * and MiniportSetInformation() requests are handled serially:
820 * once one request has been issued, we must wait for it to
821 * finish before allowing another request to proceed.
826 KeResetEvent(&sc->ndis_block->nmb_setevent);
828 KeAcquireSpinLock(&sc->ndis_block->nmb_lock, &irql);
830 if (sc->ndis_block->nmb_pendingreq != NULL) {
831 KeReleaseSpinLock(&sc->ndis_block->nmb_lock, irql);
832 panic("ndis_set_info() called while other request pending");
834 sc->ndis_block->nmb_pendingreq = (ndis_request *)sc;
836 setfunc = sc->ndis_chars->nmc_setinfo_func;
837 adapter = sc->ndis_block->nmb_miniportadapterctx;
839 if (adapter == NULL || setfunc == NULL ||
840 sc->ndis_block->nmb_devicectx == NULL) {
841 sc->ndis_block->nmb_pendingreq = NULL;
842 KeReleaseSpinLock(&sc->ndis_block->nmb_lock, irql);
846 rval = MSCALL6(setfunc, adapter, oid, buf, *buflen,
847 &byteswritten, &bytesneeded);
849 sc->ndis_block->nmb_pendingreq = NULL;
851 KeReleaseSpinLock(&sc->ndis_block->nmb_lock, irql);
853 if (rval == NDIS_STATUS_PENDING) {
854 /* Wait up to 5 seconds. */
855 duetime = (5 * 1000000) * -10;
856 KeWaitForSingleObject(&sc->ndis_block->nmb_setevent,
857 0, 0, FALSE, &duetime);
858 rval = sc->ndis_block->nmb_setstat;
862 *buflen = byteswritten;
864 *buflen = bytesneeded;
866 if (rval == NDIS_STATUS_INVALID_LENGTH)
869 if (rval == NDIS_STATUS_INVALID_OID)
872 if (rval == NDIS_STATUS_NOT_SUPPORTED ||
873 rval == NDIS_STATUS_NOT_ACCEPTED)
876 if (rval != NDIS_STATUS_SUCCESS)
882 typedef void (*ndis_senddone_func)(ndis_handle, ndis_packet *, ndis_status);
885 ndis_send_packets(arg, packets, cnt)
887 ndis_packet **packets;
890 struct ndis_softc *sc;
892 ndis_sendmulti_handler sendfunc;
893 ndis_senddone_func senddonefunc;
899 adapter = sc->ndis_block->nmb_miniportadapterctx;
902 sendfunc = sc->ndis_chars->nmc_sendmulti_func;
903 senddonefunc = sc->ndis_block->nmb_senddone_func;
905 if (NDIS_SERIALIZED(sc->ndis_block))
906 KeAcquireSpinLock(&sc->ndis_block->nmb_lock, &irql);
908 MSCALL3(sendfunc, adapter, packets, cnt);
910 for (i = 0; i < cnt; i++) {
913 * Either the driver already handed the packet to
914 * ndis_txeof() due to a failure, or it wants to keep
915 * it and release it asynchronously later. Skip to the
918 if (p == NULL || p->np_oob.npo_status == NDIS_STATUS_PENDING)
920 MSCALL3(senddonefunc, sc->ndis_block, p, p->np_oob.npo_status);
923 if (NDIS_SERIALIZED(sc->ndis_block))
924 KeReleaseSpinLock(&sc->ndis_block->nmb_lock, irql);
930 ndis_send_packet(arg, packet)
934 struct ndis_softc *sc;
937 ndis_sendsingle_handler sendfunc;
938 ndis_senddone_func senddonefunc;
942 adapter = sc->ndis_block->nmb_miniportadapterctx;
945 sendfunc = sc->ndis_chars->nmc_sendsingle_func;
946 senddonefunc = sc->ndis_block->nmb_senddone_func;
948 if (NDIS_SERIALIZED(sc->ndis_block))
949 KeAcquireSpinLock(&sc->ndis_block->nmb_lock, &irql);
950 status = MSCALL3(sendfunc, adapter, packet,
951 packet->np_private.npp_flags);
953 if (status == NDIS_STATUS_PENDING) {
954 if (NDIS_SERIALIZED(sc->ndis_block))
955 KeReleaseSpinLock(&sc->ndis_block->nmb_lock, irql);
959 MSCALL3(senddonefunc, sc->ndis_block, packet, status);
961 if (NDIS_SERIALIZED(sc->ndis_block))
962 KeReleaseSpinLock(&sc->ndis_block->nmb_lock, irql);
971 struct ndis_softc *sc;
976 sc->ndis_tmaps = malloc(sizeof(bus_dmamap_t) * sc->ndis_maxpkts,
977 M_DEVBUF, M_NOWAIT|M_ZERO);
979 if (sc->ndis_tmaps == NULL)
982 for (i = 0; i < sc->ndis_maxpkts; i++) {
983 error = bus_dmamap_create(sc->ndis_ttag, 0,
986 free(sc->ndis_tmaps, M_DEVBUF);
995 ndis_destroy_dma(arg)
998 struct ndis_softc *sc;
1000 ndis_packet *p = NULL;
1005 for (i = 0; i < sc->ndis_maxpkts; i++) {
1006 if (sc->ndis_txarray[i] != NULL) {
1007 p = sc->ndis_txarray[i];
1008 m = (struct mbuf *)p->np_rsvd[1];
1011 ndis_free_packet(sc->ndis_txarray[i]);
1013 bus_dmamap_destroy(sc->ndis_ttag, sc->ndis_tmaps[i]);
1016 free(sc->ndis_tmaps, M_DEVBUF);
1018 bus_dma_tag_destroy(sc->ndis_ttag);
1027 struct ndis_softc *sc;
1028 ndis_handle adapter;
1029 ndis_reset_handler resetfunc;
1030 uint8_t addressing_reset;
1037 adapter = sc->ndis_block->nmb_miniportadapterctx;
1038 resetfunc = sc->ndis_chars->nmc_reset_func;
1040 if (adapter == NULL || resetfunc == NULL ||
1041 sc->ndis_block->nmb_devicectx == NULL) {
1048 KeResetEvent(&sc->ndis_block->nmb_resetevent);
1050 if (NDIS_SERIALIZED(sc->ndis_block))
1051 KeAcquireSpinLock(&sc->ndis_block->nmb_lock, &irql);
1053 rval = MSCALL2(resetfunc, &addressing_reset, adapter);
1055 if (NDIS_SERIALIZED(sc->ndis_block))
1056 KeReleaseSpinLock(&sc->ndis_block->nmb_lock, irql);
1058 if (rval == NDIS_STATUS_PENDING)
1059 KeWaitForSingleObject(&sc->ndis_block->nmb_resetevent,
1069 struct ndis_softc *sc;
1070 ndis_handle adapter;
1071 ndis_halt_handler haltfunc;
1072 ndis_miniport_block *block;
1077 block = sc->ndis_block;
1080 KeFlushQueuedDpcs();
1083 * Wait for all packets to be returned.
1087 KeAcquireSpinLock(&block->nmb_returnlock, &irql);
1088 empty = IsListEmpty(&block->nmb_returnlist);
1089 KeReleaseSpinLock(&block->nmb_returnlock, irql);
1096 adapter = sc->ndis_block->nmb_miniportadapterctx;
1097 if (adapter == NULL) {
1102 sc->ndis_block->nmb_devicectx = NULL;
1105 * The adapter context is only valid after the init
1106 * handler has been called, and is invalid once the
1107 * halt handler has been called.
1110 haltfunc = sc->ndis_chars->nmc_halt_func;
1113 MSCALL1(haltfunc, adapter);
1116 sc->ndis_block->nmb_miniportadapterctx = NULL;
1123 ndis_shutdown_nic(arg)
1126 struct ndis_softc *sc;
1127 ndis_handle adapter;
1128 ndis_shutdown_handler shutdownfunc;
1132 adapter = sc->ndis_block->nmb_miniportadapterctx;
1133 shutdownfunc = sc->ndis_chars->nmc_shutdown_handler;
1135 if (adapter == NULL || shutdownfunc == NULL)
1138 if (sc->ndis_chars->nmc_rsvd0 == NULL)
1139 MSCALL1(shutdownfunc, adapter);
1141 MSCALL1(shutdownfunc, sc->ndis_chars->nmc_rsvd0);
1143 TAILQ_REMOVE(&ndis_devhead, sc->ndis_block, link);
1149 ndis_pnpevent_nic(arg, type)
1154 struct ndis_softc *sc;
1155 ndis_handle adapter;
1156 ndis_pnpevent_handler pnpeventfunc;
1159 sc = device_get_softc(arg);
1161 adapter = sc->ndis_block->nmb_miniportadapterctx;
1162 pnpeventfunc = sc->ndis_chars->nmc_pnpevent_handler;
1164 if (adapter == NULL || pnpeventfunc == NULL)
1167 if (sc->ndis_chars->nmc_rsvd0 == NULL)
1168 MSCALL4(pnpeventfunc, adapter, type, NULL, 0);
1170 MSCALL4(pnpeventfunc, sc->ndis_chars->nmc_rsvd0, type, NULL, 0);
1179 struct ndis_softc *sc;
1180 ndis_miniport_block *block;
1181 ndis_init_handler initfunc;
1182 ndis_status status, openstatus = 0;
1183 ndis_medium mediumarray[NdisMediumMax];
1184 uint32_t chosenmedium, i;
1191 block = sc->ndis_block;
1192 initfunc = sc->ndis_chars->nmc_init_func;
1195 sc->ndis_block->nmb_timerlist = NULL;
1197 for (i = 0; i < NdisMediumMax; i++)
1200 status = MSCALL6(initfunc, &openstatus, &chosenmedium,
1201 mediumarray, NdisMediumMax, block, block);
1204 * If the init fails, blow away the other exported routines
1205 * we obtained from the driver so we can't call them later.
1206 * If the init failed, none of these will work.
1208 if (status != NDIS_STATUS_SUCCESS) {
1210 sc->ndis_block->nmb_miniportadapterctx = NULL;
1216 * This may look really goofy, but apparently it is possible
1217 * to halt a miniport too soon after it's been initialized.
1218 * After MiniportInitialize() finishes, pause for 1 second
1219 * to give the chip a chance to handle any short-lived timers
1220 * that were set in motion. If we call MiniportHalt() too soon,
1221 * some of the timers may not be cancelled, because the driver
1222 * expects them to fire before the halt is called.
1225 pause("ndwait", hz);
1228 sc->ndis_block->nmb_devicectx = sc;
1235 ndis_intrsetup(dpc, dobj, ip, sc)
1237 device_object *dobj;
1239 struct ndis_softc *sc;
1241 ndis_miniport_interrupt *intr;
1243 intr = sc->ndis_block->nmb_interrupt;
1250 KeAcquireSpinLockAtDpcLevel(&intr->ni_dpccountlock);
1251 KeResetEvent(&intr->ni_dpcevt);
1252 if (KeInsertQueueDpc(&intr->ni_dpc, NULL, NULL) == TRUE)
1254 KeReleaseSpinLockFromDpcLevel(&intr->ni_dpccountlock);
1258 ndis_get_info(arg, oid, buf, buflen)
1264 struct ndis_softc *sc;
1266 ndis_handle adapter;
1267 ndis_queryinfo_handler queryfunc;
1268 uint32_t byteswritten = 0, bytesneeded = 0;
1274 KeResetEvent(&sc->ndis_block->nmb_getevent);
1276 KeAcquireSpinLock(&sc->ndis_block->nmb_lock, &irql);
1278 if (sc->ndis_block->nmb_pendingreq != NULL) {
1279 KeReleaseSpinLock(&sc->ndis_block->nmb_lock, irql);
1280 panic("ndis_get_info() called while other request pending");
1282 sc->ndis_block->nmb_pendingreq = (ndis_request *)sc;
1284 queryfunc = sc->ndis_chars->nmc_queryinfo_func;
1285 adapter = sc->ndis_block->nmb_miniportadapterctx;
1287 if (adapter == NULL || queryfunc == NULL ||
1288 sc->ndis_block->nmb_devicectx == NULL) {
1289 sc->ndis_block->nmb_pendingreq = NULL;
1290 KeReleaseSpinLock(&sc->ndis_block->nmb_lock, irql);
1294 rval = MSCALL6(queryfunc, adapter, oid, buf, *buflen,
1295 &byteswritten, &bytesneeded);
1297 sc->ndis_block->nmb_pendingreq = NULL;
1299 KeReleaseSpinLock(&sc->ndis_block->nmb_lock, irql);
1301 /* Wait for requests that block. */
1303 if (rval == NDIS_STATUS_PENDING) {
1304 /* Wait up to 5 seconds. */
1305 duetime = (5 * 1000000) * -10;
1306 KeWaitForSingleObject(&sc->ndis_block->nmb_getevent,
1307 0, 0, FALSE, &duetime);
1308 rval = sc->ndis_block->nmb_getstat;
1312 *buflen = byteswritten;
1314 *buflen = bytesneeded;
1316 if (rval == NDIS_STATUS_INVALID_LENGTH ||
1317 rval == NDIS_STATUS_BUFFER_TOO_SHORT)
1320 if (rval == NDIS_STATUS_INVALID_OID)
1323 if (rval == NDIS_STATUS_NOT_SUPPORTED ||
1324 rval == NDIS_STATUS_NOT_ACCEPTED)
1327 if (rval != NDIS_STATUS_SUCCESS)
1334 NdisAddDevice(drv, pdo)
1339 ndis_miniport_block *block;
1340 struct ndis_softc *sc;
1344 sc = device_get_softc(pdo->do_devext);
1346 if (sc->ndis_iftype == PCMCIABus || sc->ndis_iftype == PCIBus) {
1347 error = bus_setup_intr(sc->ndis_dev, sc->ndis_irq,
1348 INTR_TYPE_NET | INTR_MPSAFE,
1349 NULL, ntoskrnl_intr, NULL, &sc->ndis_intrhand);
1351 return (NDIS_STATUS_FAILURE);
1354 status = IoCreateDevice(drv, sizeof(ndis_miniport_block), NULL,
1355 FILE_DEVICE_UNKNOWN, 0, FALSE, &fdo);
1357 if (status != STATUS_SUCCESS)
1360 block = fdo->do_devext;
1362 block->nmb_filterdbs.nf_ethdb = block;
1363 block->nmb_deviceobj = fdo;
1364 block->nmb_physdeviceobj = pdo;
1365 block->nmb_nextdeviceobj = IoAttachDeviceToDeviceStack(fdo, pdo);
1366 KeInitializeSpinLock(&block->nmb_lock);
1367 KeInitializeSpinLock(&block->nmb_returnlock);
1368 KeInitializeEvent(&block->nmb_getevent, EVENT_TYPE_NOTIFY, TRUE);
1369 KeInitializeEvent(&block->nmb_setevent, EVENT_TYPE_NOTIFY, TRUE);
1370 KeInitializeEvent(&block->nmb_resetevent, EVENT_TYPE_NOTIFY, TRUE);
1371 InitializeListHead(&block->nmb_parmlist);
1372 InitializeListHead(&block->nmb_returnlist);
1373 block->nmb_returnitem = IoAllocateWorkItem(fdo);
1376 * Stash pointers to the miniport block and miniport
1377 * characteristics info in the if_ndis softc so the
1378 * UNIX wrapper driver can get to them later.
1380 sc->ndis_block = block;
1381 sc->ndis_chars = IoGetDriverObjectExtension(drv, (void *)1);
1384 * If the driver has a MiniportTransferData() function,
1385 * we should allocate a private RX packet pool.
1388 if (sc->ndis_chars->nmc_transferdata_func != NULL) {
1389 NdisAllocatePacketPool(&status, &block->nmb_rxpool,
1390 32, PROTOCOL_RESERVED_SIZE_IN_PACKET);
1391 if (status != NDIS_STATUS_SUCCESS) {
1392 IoDetachDevice(block->nmb_nextdeviceobj);
1393 IoDeleteDevice(fdo);
1396 InitializeListHead((&block->nmb_packetlist));
1399 /* Give interrupt handling priority over timers. */
1400 IoInitializeDpcRequest(fdo, kernndis_functbl[6].ipt_wrap);
1401 KeSetImportanceDpc(&fdo->do_dpc, KDPC_IMPORTANCE_HIGH);
1403 /* Finish up BSD-specific setup. */
1405 block->nmb_signature = (void *)0xcafebabe;
1406 block->nmb_status_func = kernndis_functbl[0].ipt_wrap;
1407 block->nmb_statusdone_func = kernndis_functbl[1].ipt_wrap;
1408 block->nmb_setdone_func = kernndis_functbl[2].ipt_wrap;
1409 block->nmb_querydone_func = kernndis_functbl[3].ipt_wrap;
1410 block->nmb_resetdone_func = kernndis_functbl[4].ipt_wrap;
1411 block->nmb_sendrsrc_func = kernndis_functbl[5].ipt_wrap;
1412 block->nmb_pendingreq = NULL;
1414 TAILQ_INSERT_TAIL(&ndis_devhead, block, link);
1416 return (STATUS_SUCCESS);
1420 ndis_unload_driver(arg)
1423 struct ndis_softc *sc;
1428 if (sc->ndis_intrhand)
1429 bus_teardown_intr(sc->ndis_dev,
1430 sc->ndis_irq, sc->ndis_intrhand);
1432 if (sc->ndis_block->nmb_rlist != NULL)
1433 free(sc->ndis_block->nmb_rlist, M_DEVBUF);
1435 ndis_flush_sysctls(sc);
1437 TAILQ_REMOVE(&ndis_devhead, sc->ndis_block, link);
1439 if (sc->ndis_chars->nmc_transferdata_func != NULL)
1440 NdisFreePacketPool(sc->ndis_block->nmb_rxpool);
1441 fdo = sc->ndis_block->nmb_deviceobj;
1442 IoFreeWorkItem(sc->ndis_block->nmb_returnitem);
1443 IoDetachDevice(sc->ndis_block->nmb_nextdeviceobj);
1444 IoDeleteDevice(fdo);