From owner-freebsd-doc Sun Dec 1 3:19:42 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 1155637B401; Sun, 1 Dec 2002 03:19:35 -0800 (PST) Received: from abigail.blackend.org (blackend.org [212.11.50.35]) by mx1.FreeBSD.org (Postfix) with ESMTP id 4923543EA9; Sun, 1 Dec 2002 03:19:33 -0800 (PST) (envelope-from marc@blackend.org) Received: from nosferatu.blackend.org (nosferatu.blackend.org [192.168.1.205]) by abigail.blackend.org (8.12.3/8.12.3) with ESMTP id gB1BJVNe027710; Sun, 1 Dec 2002 12:19:31 +0100 (CET) (envelope-from marc@abigail.blackend.org) Received: from nosferatu.blackend.org (localhost [127.0.0.1]) by nosferatu.blackend.org (8.12.6/8.12.6) with ESMTP id gB1BIoxo000248; Sun, 1 Dec 2002 12:18:50 +0100 (CET) (envelope-from marc@nosferatu.blackend.org) Received: (from marc@localhost) by nosferatu.blackend.org (8.12.6/8.12.6/Submit) id gB1BIonW000247; Sun, 1 Dec 2002 12:18:50 +0100 (CET) Date: Sun, 1 Dec 2002 12:18:50 +0100 From: Marc Fonvieille To: Giorgos Keramidas Cc: freebsd-doc@freebsd.org Subject: Re: Notes about devfs in the docs. Message-ID: <20021201111850.GA205@nosferatu.blackend.org> References: <20021201024633.GA3728@gothmog.gr> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20021201024633.GA3728@gothmog.gr> User-Agent: Mutt/1.4i X-Useless-Header: blackend.org X-Operating-System: FreeBSD 4.7-STABLE 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 On Sun, Dec 01, 2002 at 04:46:33AM +0200, Giorgos Keramidas wrote: > 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 I will take this one. > ./books/handbook/backups/chapter.sgml This one is not used anymore. > ./books/handbook/basics/chapter.sgml Done. > ./books/handbook/config/chapter.sgml I will take this one. > ./books/handbook/cutting-edge/chapter.sgml > ./books/handbook/disks/chapter.sgml I will take these ones. > ./books/handbook/kernelconfig/chapter.sgml Done. > ./books/handbook/x11/chapter.sgml I will take this one. > ./books/handbook/multimedia/chapter.sgml Done. > ./books/handbook/ppp-and-slip/chapter.sgml Done. > ./books/handbook/printing/chapter.sgml Done. > ./books/handbook/serialcomms/chapter.sgml > Done. I will do all updates this night, it's Ok? > %%% > 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 5.X ? > + required if you are running a kernel that uses > + DEVFS.)

> + I'm more for &man.devfs.5; that gives more info. >

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 5.X :) > + 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 idem > + 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 idem :) > + 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. > + > > > > %%% Marc To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message