From owner-freebsd-doc Sat Nov 30 18:47:28 2002 Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id DA86D37B401 for ; Sat, 30 Nov 2002 18:47:22 -0800 (PST) Received: from mailsrv.otenet.gr (mailsrv.otenet.gr [195.170.0.5]) by mx1.FreeBSD.org (Postfix) with ESMTP id D484343E9C for ; Sat, 30 Nov 2002 18:47:21 -0800 (PST) (envelope-from keramida@freebsd.org) Received: from gothmog.gr (patr530-a155.otenet.gr [212.205.215.155]) by mailsrv.otenet.gr (8.12.6/8.12.6) with ESMTP id gB12koRa020280 for ; Sun, 1 Dec 2002 04:47:02 +0200 (EET) Received: from gothmog.gr (gothmog [127.0.0.1]) by gothmog.gr (8.12.6/8.12.6) with ESMTP id gB12kkfR004525 for ; Sun, 1 Dec 2002 04:46:46 +0200 (EET) (envelope-from keramida@freebsd.org) Received: (from keramida@localhost) by gothmog.gr (8.12.6/8.12.6/Submit) id gB12kY51004524 for freebsd-doc@freebsd.org; Sun, 1 Dec 2002 04:46:34 +0200 (EET) (envelope-from keramida@freebsd.org) Date: Sun, 1 Dec 2002 04:46:33 +0200 From: Giorgos Keramidas To: freebsd-doc@freebsd.org Subject: Notes about devfs in the docs. Message-ID: <20021201024633.GA3728@gothmog.gr> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline 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 Does the following look like a bad idea to anyone? I just want to make sure that users of 5.0-RELEASE will see a note stating that MAKEDEV is not necessary with DEVFS, every time MAKEDEV is mentioned in the docs. This is arguably far from the best way to solve the (now default) DEVFS vs. non-DEVFS systems problem, but it's a start. Make sure you Cc: me too, if you have any comments, ideas or suggestions. Note that this doesn't cover all the docs, since there are still references to MAKEDEV in the following files that haven't reviewed: ./books/handbook/advanced-networking/chapter.sgml ./books/handbook/advanced-networking/chapter.sgml.orig ./books/handbook/advanced-networking/.#chapter.sgml.1.175 ./books/handbook/backups/chapter.sgml ./books/handbook/basics/chapter.sgml ./books/handbook/config/chapter.sgml ./books/handbook/cutting-edge/chapter.sgml ./books/handbook/disks/chapter.sgml ./books/handbook/kernelconfig/chapter.sgml ./books/handbook/x11/chapter.sgml ./books/handbook/multimedia/chapter.sgml ./books/handbook/ppp-and-slip/chapter.sgml ./books/handbook/printing/chapter.sgml ./books/handbook/serialcomms/chapter.sgml %%% Index: articles/console-server/article.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/articles/console-server/article.sgml,v retrieving revision 1.8 diff -u -r1.8 article.sgml --- articles/console-server/article.sgml 11 Jul 2002 19:07:48 -0000 1.8 +++ articles/console-server/article.sgml 23 Nov 2002 19:45:22 -0000 @@ -288,6 +288,10 @@

Making The Devices

+

(NOTE: In FreeBSD 5.x, the MAKEDEV run is not + required if you are running a kernel that uses + DEVFS.)

+

You will need to make the device nodes for the Stallion card (which are not made by default). A new version of /dev/MAKEDEV with Stallion support will have been Index: articles/diskless-x/article.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/articles/diskless-x/article.sgml,v retrieving revision 1.9 diff -u -r1.9 article.sgml --- articles/diskless-x/article.sgml 27 Mar 2002 01:16:43 -0000 1.9 +++ articles/diskless-x/article.sgml 23 Nov 2002 19:46:36 -0000 @@ -304,7 +304,9 @@ -r-xr-xr-x 1 root wheel 1992 Jun 10 1995 ./dev/MAKEDEV.local -r-xr-xr-x 1 root wheel 24419 Jun 10 1995 ./dev/MAKEDEV - Do not forget to run MAKEDEV all in the + If you are not using DEVFS (which is the default + in FreeBSD 5.x), you should make sure that you + do not forget to run MAKEDEV all in the dev directory. My /etc/rc for altair Index: articles/serial-uart/article.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/articles/serial-uart/article.sgml,v retrieving revision 1.6 diff -u -r1.6 article.sgml --- articles/serial-uart/article.sgml 15 Feb 2002 01:05:58 -0000 1.6 +++ articles/serial-uart/article.sgml 30 Nov 2002 11:17:33 -0000 @@ -2137,7 +2137,12 @@ Next, appropriate entries in /dev for the devices must be made using the /dev/MAKEDEV - script. After becoming root: + script. This step can be ommitted if you are running + FreeBSD 5.x with a kernel that has DEVFS + support compiled in. + + If you do need to create the /dev + entries, run the following as root: &prompt.root; cd /dev &prompt.root; ./MAKEDEV tty1 @@ -2310,7 +2315,10 @@ Make the device nodes by typing (the following - example assumes an 8-port board): + example assumes an 8-port board) + You can ommit this part if you are running FreeBSD 5.x + with DEVFS. + : &prompt.root; cd /dev &prompt.root; for i in 0 1 2 3 4 5 6 7;do ./MAKEDEV cuac$i ttyc$i;done @@ -2396,8 +2404,13 @@ After adding the configuration entry, rebuild and install your new kernel. + + The following step, is not necessary if you are using + DEVFS in FreeBSD 5.X. + + After rebooting with the new kernel, you need to make the - device nodes in /dev. The MAKEDEV script + device nodes in /dev. The MAKEDEV script will take care of this for you. Count how many total ports you have and type: Index: books/developers-handbook/driverbasics/chapter.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/developers-handbook/driverbasics/chapter.sgml,v retrieving revision 1.20 diff -u -r1.20 chapter.sgml --- books/developers-handbook/driverbasics/chapter.sgml 27 Aug 2002 16:58:05 -0000 1.20 +++ books/developers-handbook/driverbasics/chapter.sgml 30 Nov 2002 11:20:20 -0000 @@ -28,8 +28,10 @@ Most devices in a Unix-like operating system are accessed through device-nodes, sometimes also called special files. These files are usually located under the directory - /dev in the filesystem hierarchy. Until - devfs is fully integrated into FreeBSD, each device node must be + /dev in the filesystem hierarchy. + In releases of FreeBSD older than 5.0-RELEASE, where + DEVFS support is not integrated into FreeBSD, + each device node must be created statically and independent of the existence of the associated device driver. Most device nodes on the system are created by running MAKEDEV. Index: books/faq/book.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/faq/book.sgml,v retrieving revision 1.497 diff -u -r1.497 book.sgml --- books/faq/book.sgml 30 Nov 2002 12:17:03 -0000 1.497 +++ books/faq/book.sgml 30 Nov 2002 12:23:40 -0000 @@ -23,7 +23,7 @@ The FreeBSD Documentation Project - $FreeBSD: doc/en_US.ISO8859-1/books/faq/book.sgml,v 1.497 2002/11/30 12:17:03 keramida Exp $ + $FreeBSD: doc/en_US.ISO8859-1/books/faq/book.sgml,v 1.496 2002/11/30 06:00:47 jesusr Exp $ 1995 @@ -2458,6 +2458,12 @@ &prompt.root; cd /dev &prompt.root; ./MAKEDEV kbd0 kbd1 + + You can ommit this step if you are running FreeBSD + 5.0-RELEASE or newer with DEVFS enabled, + since the proper device nodes will be created automatically + under /dev. + @@ -2586,7 +2592,14 @@ &prompt.root; cd /dev; sh MAKEDEV psm0 when logged in as root. - + + + You can ommit this step if you are running FreeBSD + 5.0-RELEASE or newer with DEVFS enabled, + since the proper device nodes will be created automatically + under /dev. + + @@ -2714,6 +2727,13 @@ &prompt.root; cd /dev &prompt.root; ./MAKEDEV ums0 + + + You can ommit this step if you are running FreeBSD + 5.0-RELEASE or newer with DEVFS enabled, + since the proper device nodes will be created automatically + under /dev. + @@ -3944,6 +3964,13 @@ &prompt.root; cd /dev &prompt.root; ./MAKEDEV snd1 + + You can ommit this step if you are running FreeBSD + 5.0-RELEASE or newer with DEVFS enabled, + since the proper device nodes will be created automatically + under /dev. + + This situation does not arise in FreeBSD 4.X as a lot of work has been done to make it more PnP-centric and the @@ -5650,11 +5677,17 @@ partitions. For example, if you have an E partition as the second DOS partition on the second SCSI drive, you need to create the special files for slice 5 - in /dev, then mount /dev/da1s5: + in /dev, then mount /dev/da1s5: &prompt.root; cd /dev &prompt.root; sh MAKEDEV da1s5 &prompt.root; mount -t msdos /dev/da1s5 /dos/e + + + You can ommit this step if you are running FreeBSD + 5.0-RELEASE or newer with DEVFS + enabled. + @@ -6894,7 +6927,7 @@ &prompt.root; cd /cdrom/bin &prompt.root; ./install.sh - Alternately, you can remove all MAKE_KERBEROS + Alternately, you can remove all "MAKE_KERBEROS" options from /etc/make.conf and rebuild world. @@ -6966,6 +6999,12 @@ &prompt.root; cd /dev &prompt.root; sh MAKEDEV snd0 + + + You can ommit this step if you are running FreeBSD + 5.0-RELEASE or newer with DEVFS + enabled. + %%% To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message