From owner-freebsd-doc@FreeBSD.ORG Sat May 13 21:40:25 2006 Return-Path: X-Original-To: freebsd-doc@hub.freebsd.org Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 9271E16A40B for ; Sat, 13 May 2006 21:40:25 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id AD9F743D4C for ; Sat, 13 May 2006 21:40:23 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.13.4/8.13.4) with ESMTP id k4DLeNsu017727 for ; Sat, 13 May 2006 21:40:23 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.4/8.13.4/Submit) id k4DLeNGc017726; Sat, 13 May 2006 21:40:23 GMT (envelope-from gnats) Resent-Date: Sat, 13 May 2006 21:40:23 GMT Resent-Message-Id: <200605132140.k4DLeNGc017726@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Gavin Atkinson Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 56CBC16A423 for ; Sat, 13 May 2006 21:31:40 +0000 (UTC) (envelope-from ga9@buffy.york.ac.uk) Received: from mail-gw4.york.ac.uk (mail-gw4.york.ac.uk [144.32.128.249]) by mx1.FreeBSD.org (Postfix) with ESMTP id 20AB543D48 for ; Sat, 13 May 2006 21:31:38 +0000 (GMT) (envelope-from ga9@buffy.york.ac.uk) Received: from buffy.york.ac.uk (buffy-128.york.ac.uk [144.32.128.160]) by mail-gw4.york.ac.uk (8.13.6/8.13.6) with ESMTP id k4DLVS5p003997 for ; Sat, 13 May 2006 22:31:29 +0100 (BST) Received: from buffy.york.ac.uk (localhost [127.0.0.1]) by buffy.york.ac.uk (8.13.6/8.13.6) with ESMTP id k4DLVS4I017677 for ; Sat, 13 May 2006 22:31:28 +0100 (BST) (envelope-from ga9@buffy.york.ac.uk) Received: (from ga9@localhost) by buffy.york.ac.uk (8.13.6/8.13.6/Submit) id k4DLVSik017676; Sat, 13 May 2006 22:31:28 +0100 (BST) (envelope-from ga9) Message-Id: <200605132131.k4DLVSik017676@buffy.york.ac.uk> Date: Sat, 13 May 2006 22:31:28 +0100 (BST) From: Gavin Atkinson To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/97229: [patch] Handbook contains obsolete instructions on NDIS X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Gavin Atkinson List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 13 May 2006 21:40:25 -0000 >Number: 97229 >Category: docs >Synopsis: [patch] Handbook contains obsolete instructions on NDIS >Confidential: no >Severity: serious >Priority: medium >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sat May 13 21:40:23 GMT 2006 >Closed-Date: >Last-Modified: >Originator: Gavin Atkinson >Release: FreeBSD 6.1-RC i386 >Organization: http://www.mod3.co.uk/ >Environment: System: FreeBSD buffy.york.ac.uk 6.1-RC FreeBSD 6.1-RC #8: Fri May 5 16:37:33 BST 2006 root@buffy.york.ac.uk:/usr/obj/usr/src/sys/BUFFY i386 >Description: The instructions at http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/network-wireless.html are wrong with regards to creating an NDIS kernel module under FreeBSD 5.5, 6.0 and later. The "old" way detailed in the handbook is deprecated and is not guaranteed to work (and indeed, doesn't, for me...) >How-To-Repeat: Try following the example with the standard Intel 3945ABG driver >Fix: Note that as this is a new laptop, I don't currently have the infrastructure to compile-test this patch: please check it doesn't break the build before committing it. --- ndis.diff begins here --- Index: doc/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.sgml =================================================================== RCS file: /usr/cvs/doc/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.sgml,v retrieving revision 1.365 diff -u -r1.365 chapter.sgml --- doc/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.sgml 18 Mar 2005 01:56:06 -0000 1.365 +++ doc/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.sgml 13 May 2006 21:19:08 -0000 @@ -1135,18 +1135,31 @@ - You may need to compile the &man.ndis.4; mini port driver - wrapper module. As root: - - &prompt.root; cd /usr/src/sys/modules/ndis -&prompt.root; make && make install - Locate the files for your specific card. Generally, they can be found on the included CDs or at the vendors' websites. In the following examples, we will use W32DRIVER.SYS and W32DRIVER.INF. + In &os; 5.5, &os; 6.0 and later, a kernel module is created + with &man.ndisgen.8; as root: + + &prompt.root; ndisgen /path/to/W32DRIVER.INF /path/to/W32DRIVER.SYS + + The &man.ndisgen.8; utility is interactive and will prompt + for any extra information it requires; it will produce a kernel + module in the current directory which can be loaded as follows: + &prompt.root; kldload ./W32DRIVER.ko + + Under &os; 5.4 and before, the process of creating the kernel + module is more involved, and is detailed next. + + You may need to compile the &man.ndis.4; mini port driver + wrapper module. As root: + + &prompt.root; cd /usr/src/sys/modules/ndis +&prompt.root; make && make install + The next step is to compile the driver binary into a loadable kernel module. To accomplish this, as root, go into the --- ndis.diff ends here --- >Release-Note: >Audit-Trail: >Unformatted: