docs/149106: [man] xfs.5: non-working mount example

[Dmitry Marakasov]

>Number:         149106
>Category:       docs
>Synopsis:       [man] xfs.5: non-working mount example
>Confidential:   no
>Severity:       serious
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Jul 30 13:30:05 UTC 2010
>Closed-Date:
>Last-Modified:
>Originator:     Dmitry Marakasov
>Release:        FreeBSD 8.1-RELEASE i386
>Organization:
>Environment:
System: FreeBSD hades.panopticon 8.1-RELEASE FreeBSD 8.1-RELEASE #0: Fri Jul 30 02:50:28 MSD 2010 root at hades.panopticon:/async/obj/usr/src/sys/HADES i386


>Description:
xfs.5 says:

EXAMPLES
     To mount a xfs volume located on /dev/ad1s1:
           
           mount -t xfs /dev/ad1s1 /mnt

However, this doesn't work:

# mdconfig -a -s 256m
md0
# mkfs.xfs /dev/md0
meta-data=/dev/md0               isize=256    agcount=8, agsize=8192 blks
         =                       sectsz=512   attr=0
data     =                       bsize=4096   blocks=65536, imaxpct=25
         =                       sunit=0      swidth=0 blks, unwritten=1
naming   =version 2              bsize=4096  
log      =internal log           bsize=4096   blocks=1200, version=1
         =                       sectsz=512   sunit=0 blks, lazy-count=0
realtime =none                   extsz=4096   blocks=0, rtextents=0
# mount -t xfs /dev/md0 /mnt
mount: /dev/md0 : Operation not permitted

However, it works if I explicitely request read-only mount:
# mount -t xfs -oro /dev/md0 /mnt
# mount | tail -1
/dev/md0 on /mnt (xfs, local, read-only)

>How-To-Repeat:
See above
>Fix:
Trivial: -o ro should be added into the example

>Release-Note:
>Audit-Trail:
>Unformatted: