From owner-freebsd-doc Wed Feb 13 13: 0:15 2002 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21]) by hub.freebsd.org (Postfix) with ESMTP id 7C7BD37B41C for ; Wed, 13 Feb 2002 13:00:01 -0800 (PST) Received: (from gnats@localhost) by freefall.freebsd.org (8.11.6/8.11.6) id g1DL01279749; Wed, 13 Feb 2002 13:00:01 -0800 (PST) (envelope-from gnats) Received: from relay3-gui.server.ntli.net (relay3-gui.server.ntli.net [194.168.4.200]) by hub.freebsd.org (Postfix) with ESMTP id 6333437B416 for ; Wed, 13 Feb 2002 12:50:02 -0800 (PST) Received: from pc4-card4-0-cust162.cdf.cable.ntl.com ([80.4.14.162] helo=rhadamanth.private.submonkey.net ident=mailnull) by relay3-gui.server.ntli.net with esmtp (Exim 3.03 #2) id 16b6Lp-00008H-00 for FreeBSD-gnats-submit@freebsd.org; Wed, 13 Feb 2002 20:50:01 +0000 Received: from setantae by rhadamanth.private.submonkey.net with local (Exim 3.34 #1) id 16b6Lo-000AnG-00 for FreeBSD-gnats-submit@freebsd.org; Wed, 13 Feb 2002 20:50:00 +0000 Message-Id: Date: Wed, 13 Feb 2002 20:50:00 +0000 From: Ceri Reply-To: Ceri To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.113 Subject: docs/34914: More fixup for Developers' Handbook : Driver Basics chapter Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org >Number: 34914 >Category: docs >Synopsis: More fixup for Developers' Handbook : Driver Basics chapter >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Wed Feb 13 13:00:01 PST 2002 >Closed-Date: >Last-Modified: >Originator: Ceri >Release: FreeBSD 4.5-STABLE i386 >Organization: >Environment: System: FreeBSD rhadamanth.private.submonkey.net 4.5-STABLE FreeBSD 4.5-STABLE #0: Tue Feb 12 17:56:57 GMT 2002 setantae@rhadamanth.private.submonkey.net:/usr/obj/usr/src/sys/RHADAMANTH i386 >Description: - Formalise markup. - Fix some broken &prompt.root entities that somehow were making it past "make lint".. - Amend strange "administrator commands" phrase. Your call on this one. - Some grammatical changes. Ceri >How-To-Repeat: >Fix: --- doc/en_US.ISO8859-1/books/developers-handbook/driverbasics/chapter.sgml.old Wed Feb 13 20:29:18 2002 +++ doc/en_US.ISO8859-1/books/developers-handbook/driverbasics/chapter.sgml Wed Feb 13 20:45:07 2002 @@ -49,7 +49,7 @@ changes. The kld interface is used through the following - administrator commands : + privileged commands : kldload - loads a new kernel @@ -123,8 +123,7 @@ Simply running make with this makefile will create a file skeleton.ko that can be loaded into your system by typing : - &prompt.root - kldload -v ./skeleton.ko +&prompt.root; kldload -v ./skeleton.ko @@ -138,7 +137,7 @@ accesses a device node. The /dev/MAKEDEV script makes most of the device nodes for your system but if you are doing your own driver development it may be necessary to - create your own device nodes with mknod + create your own device nodes with mknod. @@ -146,7 +145,7 @@ The mknod command requires four arguments to create a device node. You must specify the name - of this device node, the type of device, the major number of + of the device node, the type of device, the major number of the device, and the minor number of the device. @@ -158,7 +157,7 @@ This eliminates the problems of potentially having a device driver without a static device node, or a device node without an installed device driver. Devfs is still a work in - progress, but it is already working quite nice. + progress, but it is already working quite nicely. @@ -337,13 +336,13 @@ To install this driver you will first need to make a node on your filesystem with a command such as : - &prompt.root mknod /dev/echo c 33 0 + &prompt.root; mknod /dev/echo c 33 0 With this driver loaded you should now be able to type something like : - &prompt.root echo -n "Test Data" > /dev/echo -&prompt.root cat /dev/echo + &prompt.root; echo -n "Test Data" > /dev/echo +&prompt.root; cat /dev/echo Test Data Real hardware devices in the next chapter.. >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message