Aren
/
NetBSD
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Sort sections, use more markup, sort options, spelling fixes, improve 

formatting.
This commit is contained in:
wiz 2008-11-04 19:43:04 +00:00
parent 00f6effc9c
commit 1f13db8251
1 changed files with 62 additions and 62 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

124
usr.sbin/mmcformat/mmcformat.8
View File

@ -1,4 +1,4 @@
.\" $NetBSD: mmcformat.8,v 1.2 2008/11/04 13:54:10 reinoud Exp $
.\" $NetBSD: mmcformat.8,v 1.3 2008/11/04 19:43:04 wiz Exp $
.\"
.\" Copyright (c) 2008 Reinoud Zandijk
.\" All rights reserved.
@ -26,7 +26,7 @@
.\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
.\"
.Dd May, 9, 2008
.Dd May 9, 2008
.Dt MMCFORMAT 8
.Os
.Sh NAME
@ -34,103 +34,103 @@
.Nd format optical media
.Sh SYNOPSIS
.Nm
.Op Fl B
.Op Fl F
.Op Fl O
.Op Fl M
.Op Fl R
.Op Fl G
.Op Fl S
.Op Fl s
.Op Fl w
.Op Fl p
.Op Fl BDFGHhIMOpRrSsw
.Op Fl b Ar blockingnr
.Op Fl c Ar cert-num
.Op Fl r
.Op Fl h
.Op Fl H
.Op Fl I
.\" .Op X format is not implemented yet
.Op Fl b blockingnr
.Op D
.Ar special
.Sh DESCRIPTION
The
.Nm
utility formats optical media conforming to the MMC standard. These include
CD , DVD, and Blu-Ray (BD) media.
utility formats optical media conforming to the MMC standard.
These include CD, DVD, and Blu-Ray (BD) media.
.Pp
The options are as follows:
.Bl -tag -width indent
.Bl -tag -width XbXblockingnrXX
.It Fl B
Blank media when possible before formatting it.
.It Fl b Ar blockingnr
Explicit select packet size in sectors for CD-RW only; not recommended to
change from its default 32.
.It Fl c Ar cert-num
Certify media for DVD-RAM / DV-RE.
The argument cert-num specifies:
.Bl -tag -offset indent
.It 0
no certification
.It 1
full certification
.It 2
quick certification
.El
.It Fl D
Verbose report all SCSI/ATAPI command errors.
.It Fl F
Format media.
.It Fl O
Old style CD-RW formatting ; recommended for CD-RW.
.It Fl M
Select MRW (Mount Raineer) error correcting background format.
.It Fl R
Restart previously stopped MCD-MRW or DVD+RW backfround format.
.It Fl G
Grow last CD-RW/DVD-RW session.
.It Fl H
Show help or inquiry format possibilities for inserted media.
.It Fl h
Show help or inquiry format possibilities for inserted media.
.It Fl I
Show help or inquiry format possibilities for inserted media.
.It Fl M
Select MRW (Mount Rainier) error correcting background format.
.It Fl O
Old style CD-RW formatting; recommended for CD-RW.
.It Fl p
Explicitly set packet format.
.It Fl R
Restart previously stopped MCD-MRW or DVD+RW background format.
.It Fl r
Recompile defect list for DVD-RAM.
.It Fl S
Grow spare space DVD-RAM / BD-RE.
.It Fl s
Format DVD+MRW / BD-RE with extra spare space.
.It Fl w
Wait until completion of background format.
.It Fl p
Explicitly set packet format.
.It Fl c Ar cert-num
Certify media for DVD-RAM / DV-RE. The argument cert-num specifies: 0) no
certification , 1) full certification , 2) quick certification.
.It Fl r
Recompile defect list for DVD-RAM.
.It Fl h
Show help or inquiry format possibilities for inserted media.
.It Fl H
Show help or inquiry format possibilities for inserted media.
.It Fl I
Show help or inquiry format possibilities for inserted media.
.It Fl b blockingnr
Explicit select packet size in sectors for CD-RW only; not recommended to
change from its default 32.
.It Fl D
Verbose all SCSI/ATAPI command errors.
.El
.Sh NOTES
Due to the enormous varieties in optical media, the tool is made as generic as
possible. This can result in confusion.
Due to the enormous varieties in optical media, the tool is made
as generic as possible.
This can result in confusion.
.Sh EXAMPLES
.Bd -literal -offset indent
mmcformat -B -O /dev/rcd0d
.Ed
.Pp
Blanks and then formats a CD-RW disc using the `old-style' format command. Its
recommended to use this `old-style' command unless your drive reports its not
supported; if so, resort to the default
.Fl F
.
Note that a CD-RW disc can be reformatted without being blanked. Blanking
swiches between sequential and fixed packet writing by erasing the disc. This
can also help to revive old discs.
Blanks and then formats a CD-RW disc using the
.Dq old-style
format command.
Its recommended to use this
.Dq old-style
command unless your drive reports its not supported; if so, resort
to the default
.Fl F .
Note that a CD-RW disc can be reformatted without being blanked.
Blanking switches between sequential and fixed packet writing by
erasing the disc.
This can also help to revive old discs.
.Pp
.Bd -literal -offset indent
mmcformat -F -M /dev/rcd0d
.Ed
.Pp
Format a CD-RW or a DVD+RW to use MRW (Mount Raineer). This format tries to
hide media flaws as much as possible by relocation.
Format a CD-RW or a DVD+RW to use MRW (Mount Rainier).
This format tries to hide media flaws as much as possible by
relocation.
.Sh SEE ALSO
.Xr scsictl 8
.Sh BUGS
It could be merged with
.Xr scsictl 8
but that tool is very harddisc oriented.
.Sh HISTORY
The
.Nm
command first appeared in
.Nx 5.0 .
.Sh AUTHORS
.An Reinoud Zandijk Aq reinoud@NetBSD.org .
.An Reinoud Zandijk Aq reinoud@NetBSD.org
.Sh BUGS
It could be merged with
.Xr scsictl 8
but that tool is very hard disc oriented.