docs/51897: Add example for disklable for md devices

Simon L. Nielsen simon at nitro.dk
Wed May 7 08:58:51 UTC 2003


On 2003.05.07 09:34:01 +0200, Marc Fonvieille wrote:
> On Tue, May 06, 2003 at 05:10:06PM -0700, Simon L. Nielsen wrote:
> [...]
> >  
> >  %%%
> >  Index: mdconfig.8
> >  ===================================================================
> >  RCS file: /home/ncvs/src/sbin/mdconfig/mdconfig.8,v
> >  retrieving revision 1.19
> >  diff -u -d -r1.19 mdconfig.8
> >  --- mdconfig.8	27 Apr 2003 01:46:56 -0000	1.19
> >  +++ mdconfig.8	6 May 2003 23:54:40 -0000
> >  @@ -164,6 +164,18 @@
> >   mount /dev/md10 /tmp
> >   chmod 1777 /tmp
> >   .Ed
> >  +.Pp
> >  +To create a 10MB memory disk named
> >  +.Pa /dev/md0
> >  +with the file
> >  +.Pa somebackingfile
> >  +as backing and label it with normal partitions:
> >  +.Bd -literal -offset indent
> >  +dd if=/dev/zero of=somebackingfile bs=1k count=10k
> >  +mdconfig -a -t vnode -f somebackingfile -u 0
> >  +disklabel -w md0
> 
> We shoould be consistent with other docs (Handbook etc..) i.e.
> disklabel -r -w md0 auto

Actually it was on purpose that I changed that.  As I understand it '-r'
and 'auto' are not needed anymore post GEOM.  The examples in
bsdlabel(8) does not use auto and this is the code handling '-r' :

	case 'r':
		/*
		 * We accept and ignode -r for compatibility with
		 * historically disklabel usage.
		 */
		break;

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.

I do agree in general consitency is a very good thing, but in this case
I don't see a reason to keep the old (more complex) format around when
it really is not needed.

-- 
Simon L. Nielsen
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 187 bytes
Desc: not available
URL: <http://lists.freebsd.org/pipermail/freebsd-doc/attachments/20030507/fd2d244d/attachment.sig>


More information about the freebsd-doc mailing list