From owner-freebsd-doc@FreeBSD.ORG Wed May 7 13:32:12 2003 Return-Path: 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 8FB7037B401; Wed, 7 May 2003 13:32:12 -0700 (PDT) Received: from arthur.nitro.dk (port324.ds1-khk.adsl.cybercity.dk [212.242.113.79]) by mx1.FreeBSD.org (Postfix) with ESMTP id 7376A43F3F; Wed, 7 May 2003 13:32:11 -0700 (PDT) (envelope-from simon@arthur.nitro.dk) Received: by arthur.nitro.dk (Postfix, from userid 1000) id 8ACE910BF81; Wed, 7 May 2003 22:32:10 +0200 (CEST) Date: Wed, 7 May 2003 22:32:10 +0200 From: "Simon L. Nielsen" To: Marc Fonvieille Message-ID: <20030507203210.GA4230@nitro.dk> References: <200305070010.h470A6gY099125@freefall.freebsd.org> <20030507093401.A97412@abigail.blackend.org> <20030507085847.GA394@nitro.dk> <20030507183649.GA532@nosferatu.blackend.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="VrqPEDrXMn8OVzN4" Content-Disposition: inline In-Reply-To: <20030507183649.GA532@nosferatu.blackend.org> User-Agent: Mutt/1.5.4i cc: freebsd-doc@FreeBSD.org Subject: Re: docs/51897: Add example for disklable for md devices X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 07 May 2003 20:32:12 -0000 --VrqPEDrXMn8OVzN4 Content-Type: multipart/mixed; boundary="AqsLC8rIMeq19msA" Content-Disposition: inline --AqsLC8rIMeq19msA Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2003.05.07 20:36:49 +0200, Marc Fonvieille wrote: > On Wed, May 07, 2003 at 10:58:48AM +0200, Simon L. Nielsen wrote: > > case 'r': > > /* > > * We accept and ignode -r for compatibility with > > * historically disklabel usage. > > */ > > break; > >=20 > > I would rather say that the rest of the docs should be change not to use > > '-r' and 'auto' and perhaps add a compatibility note for FreeBSD < 5.0. > >=20 >=20 > You meant 5.1 I think. > In the Handbook I would write that -r and auto options can be safely > omitted on FreeBSD 5.1 and later. I actually meant 5.0 but after searching the archives and it looks like phk has said -r should it be used to write the first label (before disklabel(8) -> bsdlabel(8)). So I think your suggestion about a note for >=3D 5.1 is right but I think the mdconfig man page should only note the new form, right ? Anyway just did a quick grep for disklabel in the handbook and added a note about the options to the main places I found disklabel to be referenced. Patch should be attached. What do you think of this approch? Btw. I don't know the policy about repeating a note like this so I just added it all the places I found since it is simpler for you to remove it if it shouldn't be there than the over way around. Btww. I noticed that in another example the arguments were given in a different way so the patch also brings them in line to be more consistent. --=20 Simon L. Nielsen --AqsLC8rIMeq19msA Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename="doc-handbook-disklabel51.patch" Content-Transfer-Encoding: quoted-printable Index: disks/chapter.sgml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/disks/chapter.sgml,v retrieving revision 1.157 diff -u -d -r1.157 chapter.sgml --- disks/chapter.sgml 5 May 2003 19:36:10 -0000 1.157 +++ disks/chapter.sgml 7 May 2003 20:28:01 -0000 @@ -297,6 +297,15 @@ &prompt.root; mount /dev/da1s1e /1 # Mount the part= ition(s) &prompt.root; vi /etc/fstab # Add the appropriate e= ntry/entries to your /etc/fstab. =20 + + If you are using &os; 5.1 or newer the + &man.disklabel.8; arguments and + can be ommited so the command can + simply be : + + &prompt.root; disklabel -B -w da1s1 + + If you have an IDE disk, substitute ad for da. On pre-4.X systems use wd. @@ -314,7 +323,7 @@ understand. =09 &prompt.root; dd if=3D/dev/zero of=3D/dev/da1 bs=3D1k = count=3D1 -&prompt.root; disklabel -Brw da1 auto +&prompt.root; disklabel -B -r -w da1 auto &prompt.root; disklabel -e da1 # create the `e' = partition &prompt.root; newfs -d0 /dev/da1e &prompt.root; mkdir -p /1 @@ -324,7 +333,7 @@ An alternate method is: =20 &prompt.root; dd if=3D/dev/zero of=3D/dev/da1 count=3D= 2 -&prompt.root; disklabel /dev/da1 | disklabel -BrR da1 /dev/stdi= n +&prompt.root; disklabel /dev/da1 | disklabel -B -r -R da1 /dev/= stdin &prompt.root; newfs /dev/da1e &prompt.root; mkdir -p /1 &prompt.root; vi /etc/fstab # add an entry for = /dev/da1e @@ -446,6 +455,13 @@ disklabel -r -w ad2 auto disklabel -r -w ad3 auto =20 + + If you are using &os; 5.1 or newer the + disklabel arguments + and can be + ommited. + + This creates a disklabel for ad1c, ad2c and ad3c that spans the entire disk. =20 @@ -2284,6 +2300,14 @@ Filesystem 1K-blocks Used Avail Capacity Mounted on /dev/md0c 4846 2 4458 0% /mnt + + + If you are using &os; 5.1 or newer the &man.disklabel.8; + arguments and can + be ommited so the command can simply be : + + &prompt.root; disklabel -w md0 + =20 If you do not specify the unit number with the option, &man.mdconfig.8; will use the --AqsLC8rIMeq19msA-- --VrqPEDrXMn8OVzN4 Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.1 (FreeBSD) iD8DBQE+uW1K8kocFXgPTRwRAiFyAJ46Y2C9mMDqONvSRsJmtdX6MQlIhwCeNVNE clnrB9h+eafrTIDCI496gbw= =WZFZ -----END PGP SIGNATURE----- --VrqPEDrXMn8OVzN4--