From owner-man-jp-reviewer@jp.freebsd.org  Sun Sep 19 23:04:02 1999
Received: (from daemon@localhost)
	by castle.jp.freebsd.org (8.9.3+3.2W/8.7.3) id XAA51223;
	Sun, 19 Sep 1999 23:04:02 +0900 (JST)
	(envelope-from owner-man-jp-reviewer@jp.FreeBSD.org)
Received: from mail.yk.rim.or.jp (root@mail.yk.rim.or.jp [202.247.130.37])
	by castle.jp.freebsd.org (8.9.3+3.2W/8.7.3) with ESMTP id XAA51218
	for <man-jp-reviewer@jp.freebsd.org>; Sun, 19 Sep 1999 23:04:01 +0900 (JST)
	(envelope-from k-horik@yk.rim.or.jp)
Received: from localhost (ppp997.yk.rim.or.jp [202.247.185.248])
	by mail.yk.rim.or.jp (8.8.8/3.6W-RIMNET-98-06-09) with ESMTP id XAA10351
	for <man-jp-reviewer@jp.freebsd.org>; Sun, 19 Sep 1999 23:03:59 +0900 (JST)
To: man-jp-reviewer@jp.freebsd.org
X-Mailer: Mew version 1.93 on Emacs 19.34 / Mule 2.3 (SUETSUMUHANA)
Mime-Version: 1.0
Content-Type: Text/Plain; charset=iso-2022-jp
Content-Transfer-Encoding: 7bit
Message-Id: <19990919230320T.k-horik@yk.rim.or.jp>
Date: Sun, 19 Sep 1999 23:03:20 +0900
From: Kazuo Horikawa <k-horik@yk.rim.or.jp>
X-Dispatcher: imput version 980905(IM100)
Lines: 434
Reply-To: man-jp-reviewer@jp.freebsd.org
Precedence: list
X-Distribute: distribute version 2.1 (Alpha) patchlevel 24e+990727
X-Sequence: man-jp-reviewer 1565
Subject: [man-jp-reviewer 1565] od.4
Errors-To: owner-man-jp-reviewer@jp.freebsd.org
Sender: owner-man-jp-reviewer@jp.freebsd.org
X-Originator: k-horik@yk.rim.or.jp

 $BKY@n$G$9!#(Bod.4 $B$NK]Lu$G$9!#(B

 Yuji <cap1@city.fujisawa.kanagawa.jp> $B$5$s$,Aw$C$F$/$l$?(B od.4 $B$r$b$H(B
$B$K$7$F$$$^$9!#(B

--- od.4.eng	Sun Sep 19 22:12:48 1999
+++ od.4	Sun Sep 19 22:15:43 1999
@@ -30,259 +30,266 @@
 .\"
 .\"	$Id: od.4,v 1.4 1998/03/12 07:30:17 charnier Exp $
 .\"
+.\" jpman %Id: od.4,v 0.0 1999/02/22 16:13:48 horikawa Stab %
+.\" Based on od.4 from Yuji <cap1@city.fujisawa.kanagawa.jp>
 .Dd March 16, 1997
 .Dt OD 4
 .Os FreeBSD
-.Sh NAME
+.Sh $BL>>N(B
 .Nm od
-.Nd SCSI optical disk driver
-.Sh SYNOPSIS
+.Nd SCSI $B8w3X%G%#%9%/%I%i%$%P(B
+.Sh $B=q<0(B
 .Cd device od
 .Cd device od1 at scbus0 target 3 lun 0
 .Pp
-To use a drive which returns bogus ASC/ASCQ values:
+$B%G%P%$%9L>$rYTB$$7$F(B ASC/ASCQ $B$rJV$9%I%i%$%P$r;H$&$K$O(B
 .Cd options OD_BOGUS_NOT_READY
 .Pp
-To enable an automatic spindown:
+$B<+F02sE>Dd;_5!G=$r;H$&$K$O(B
 .Cd options OD_AUTO_TURNOFF
-.Sh DESCRIPTION
-The
+.Sh $B2r@b(B
 .Nm
-driver provides support for a
+$B%I%i%$%P$O(B
 .Em SCSI
-optical disk (AKA. Magneto-Optical or Phase change optical Disk) drive.
-It enables the media change operation and the disk to be divided
-up into a set of pseudo devices called
-.Em partitions .
-A partition has both a 
+$B8w3X%G%#%9%/(B ($B$$$o$f$k!"8w<'5$$dAjJQ2=8w3X%G%#%9%/(B) $B%I%i%$%V$r%5%]!<%H$7$^$9!#(B
+$B%a%G%#%"$N8r49$d!"%G%#%9%/$rJ,3d$7$F(B
+.Em $B%Q!<%F%#%7%g%s(B
+$B$H8F$P$l$k5?;w%G%P%$%9$K3d$jEv$F$k$3$H$,2DG=$K$J$j$^$9!#(B
+$B%Q!<%F%#%7%g%s$K$O(B
 .Em raw
-interface
-and a
-.Em block mode
-interface.
-In general the interfaces are similar to those described by 
+$B%$%s%?%U%'!<%9$H(B
+.Em $B%V%m%C%/%b!<%I(B
+$B%$%s%?%U%'!<%9$,$"$j$^$9!#(B
+$B%$%s%?%U%'!<%9$OA4HLE*$K(B
 .Xr wd 4
-and
-.Xr sd 4 .
+$B$d(B
+.Xr sd 4
+$B$N5-=R$HF1MM$G$9!#(B
 .Pp
-As the SCSI adapter is probed during boot, the 
+$B%V!<%H;~$K(B SCSI $B%"%@%W%?$,%W%m!<%V$5$l$k$H$-!"%G%P%$%9$r8!=P$9$k$?$a$K(B
 .Em SCSI
-bus is scanned for devices. Any devices found which answered as
-.Sq Em Optical
-and
-.Sq Em removable
-type device will be attached to the 
+$B%P%9$,D4$Y$i$l$^$9!#8!=P$5$l$?$b$N$N$&$A(B
+.Sq Em Optical ($B8w3X(B)
+$B$+$D(B
+.Sq Em removable ($B<h$j30$72DG=(B)
+$B7?$HJV$5$l$k$I$N%G%P%$%9$b(B
 .Nm
-driver.
-In
+$B%I%i%$%P$K@\B3$5$l$^$9!#(B
 .Fx 2.1.5
-or later, the first device found will be attached as
+$B0J9_$G$O!":G=i$K8!=P$5$l$?%G%P%$%9$O(B
 .Em od0
-and the next, 
-.Em od1 ,
-and so on.
-It is possible to specify which od unit a device should
-come on line as; refer to
+$B$H$7$F@\B3$5$l!"<!$O(B
+.Em od1
+$B$H0J2<F1MM$KB3$-$^$9!#(B
+$B$I$N%G%P%$%9$r(B od $B%f%K%C%H$H$7$F@\B3$9$Y$-$+;XDj$G$-$^$9!#(B
+$B%+!<%M%k$N9=@.$K$D$$$F$N>\:Y$O(B
 .Xr scsi 4
-for details on kernel configuration.
-Beginning in
+$B$r;2>H$7$F$/$@$5$$!#(B
 .Fx 2.2
-the
+$B$+$i(B
 .Nm
-driver can handle any device which answers as being type
-.Sq Em Direct
-and
-.Sq Em removable
-as well as
-.Sq Em Optical
-and
-.Sq Em removable
-type devices.
-.Sh PARTITIONING
-The 
+$B%I%i%$%P$O(B
+.Sq Em Optical ($B8w3X(B)
+$B$+$D(B
+.Sq Em removable ($B<h$j30$72DG=(B)
+$B7?$@$1$G$J$/!"(B
+.Sq Em Direct ($BD>@\(B)
+$B$+$D(B
+.Sq Em removable ($B<h$j30$72DG=(B)
+$B7?$HJV$5$l$k$I$s$J%G%P%$%9%f%K%C%H$bA`:n$G$-$^$9!#(B
+.Sh $B%Q!<%F%#%7%g%K%s%0(B
 .Nm
-driver allows the disk to have two levels of partitioning.
-One layer, called the
-.Dq slice layer ,
-is used to separate the
+$B%I%i%$%P$O%G%#%9%/$KBP$7!"(B2 $B$D$N3,AX$N%Q!<%F%#%7%g%s$,2DG=$G$9!#(B
+1 $B$DL\$NAX$O(B
+.Dq $B%9%i%$%9AX(B
+$B$H8F$P$l$k$b$N$G!"(B
 .Tn FreeBSD
-areas of the disk from areas used by other operating systems.
-The second layer is the native
+$BNN0h$H$=$NB>$N%*%Z%l!<%F%#%s%0%7%9%F%`$G;HMQ$5$l$F$$$kNN0h$r(B
+$BJ,N%$9$k$?$a$KMQ$$$^$9!#(B
+2 $B$DL\$O!"(B
+.Xr disklabel 5
+$B$K$h$k=cA3$?$k(B
 .Bx 4.4
-partitioning scheme,
-.Xr disklabel 5 ,
-which is used to subdivide the
+$B$N%Q!<%F%#%7%g%K%s%0$N<B9T$G!"(B
 .Tn FreeBSD
-slices into areas for individual filesystems.
-For more information, see
+$B%9%i%$%9$rFH<+$N%U%!%$%k%7%9%F%`$K:YJ,$9$k$?$a$KMQ$$$^$9!#(B
+$B$5$i$K>\$7$$;v$O!"(B
 .Xr fdisk 8
-and
-.Xr disklabel 8 ,
-respectively.
+$B$d(B
+.Xr disklabel 8
+$B$r$=$l$>$l;2>H$7$F$/$@$5$$!#(B
 .Pp
-If an uninitialized disk is opened, the slice table will be
-initialized with a fictitious
+$B=i4|2=$5$l$F$$$J$$%G%#%9%/$,3+$+$l$k$H!"%G%#%9%/A4BN$^$G5Z$V2>A[E*$J(B
 .Tn FreeBSD
-slice spanning the entire disk.  Similarly, if an uninitialized
-(or
-.No non- Ns Tn FreeBSD )
-slice is opened, its disklabel will be initialized with parameters
-returned by the drive and a single
+$B%9%i%$%9$K$h$C$F!"%9%i%$%9%F!<%V%k$,=i4|2=$5$l$^$9!#(B
+$BF1MM$K!"=i4|2=$5$l$F$$$J$$(B ($B$"$k$$$OHs(B
+.Tn FreeBSD )
+$B%9%i%$%9$,3+$+$l$k$H!"%I%i%$%V$*$h$S%9%i%$%9A4BN$r4^$`C10l(B
 .Sq Li c
-partition encompassing the entire slice.
-.Sh KERNEL CONFIGURATION
-Only one
+$B%Q!<%F%#%7%g%s$K$h$C$FJV$5$l$k%Q%i%a!<%?$G!"%G%#%9%/%i%Y%k$,=i4|2=$5$l$^$9!#(B
+.Sh $B%+!<%M%k$N@_Dj(B
+$B@_Dj%U%!%$%k$K(B
 .Nm
-device is necessary in the config file; data structures are dynamically
-allocated as disks are found on the
+$B%G%P%$%9$,(B 1 $B$D$@$1I,MW$G$9!#$9$J$o$A%G!<%?9=B$$O!"%G%#%9%/$,(B
 .Tn SCSI
-bus.
-.Sh IOCTLS
-The following 
+$B%P%9>e$K8!=P$5$l$?$H$-!"F0E*$K3d$jEv$F$i$l$^$9!#(B
+.Sh IOCTL
+$B<!$N(B
 .Xr ioctl 2
-calls apply to optical disks as well as to other disks.
-They are defined in the header file
-.Aq Pa sys/disklabel.h .
+$B%3!<%k$OB>$N%G%#%9%/$@$1$G$J$/!"8w3X%G%#%9%/$K$bBP1~$7$^$9!#(B
+$B$3$l$i$O%X%C%@%U%!%$%k(B
+.Aq Pa sys/disklabel.h
+$B$KDj5A$5$l$F$$$^$9!#(B
 .Pp
 .Bl -tag -width CDIOCPREVENT
 .It Dv DIOCSBAD
-Usually used to set up a bad-block mapping system on the disk. SCSI
-drives incorporate their own bad-block mapping so this is not
-implemented, however it MAY be implemented in the future as a 'kludged'
-interface to the SCSI bad-block mapping.
+$BDL>o!"%G%#%9%/>e$NITNI%V%m%C%/%^%C%T%s%0%7%9%F%`$r@_Dj$9$k$?$a$KMQ$$$i$l$^$9!#(B
+SCSI $B%I%i%$%P$OFH<+$NITNI%V%m%C%/%^%C%T%s%0$rAH$_9~$`$N$G!"(B
+$B$3$l$O<BAu$5$l$F$$$^$;$s!#(B
+$B$7$+$7!">-MhE*$K$O!"(B
+SCSI $BITNI%V%m%C%/%^%C%T%s%0$X$N(B '$BBP=hE*$J(B (kludged)' $B%$%s%?%U%'!<%9$H$7$F(B
+$B<BAu$5$l$k$+$b$7$l$^$;$s!#(B
 .It Dv DIOCGDINFO
-Read the in-core copy of the disklabel for the
-drive from the kernel. This may be a fictitious disklabel if the drive 
-has never been initialized, in which case it will contain information read
-from the SCSI inquiry commands, and should be the same as
-the information printed at boot.
+$B%I%i%$%VMQ$N%G%#%9%/%i%Y%k$NFbIt%3%T!<$r!"%+!<%M%k$r$+$iFI$_9~$_$^$9!#(B
+$B%I%i%$%V$,=i4|2=$5$l$F$$$J$$;~$O!"2>A[E*$J%G%#%9%/%i%Y%k$G$"$k$+$b$7$l$^$;$s!#(B
+$B$3$N>l9g$O!"(BSCSI $BD4::(B (inquiry) $B%3%^%s%I$GFI$_9~$s$@>pJs$r4^$_$^$9!#(B
+$B$=$7$F5/F0;~$KI=<($5$l$k>pJs$HF1$8$K$J$j$^$9!#(B
 .It Dv DIOCSDINFO
-Give the driver a new disklabel to use. The driver will NOT try write
-the new disklabel to the disk.
+$B%I%i%$%P$K?7$7$$%G%#%9%/%i%Y%k$rM?$($^$9!#(B
+$B%I%i%$%P$O!"?7$7$$%G%#%9%/%i%Y%k$r%G%#%9%/$K=q$-9~$_$^$;$s!#(B
 .It Dv DIOCWLABEL
-Enable or Disable the driver's software write protect of the disklabel
-on the disk.
+$B%G%#%9%/>e$N%G%#%9%/%i%Y%k$KBP$9$k%I%i%$%P$N%=%U%H%&%'%"%i%$%H%W%m%F%/%H$r!"(B
+$BM-8z$^$?$OL58z$K$7$^$9!#(B
 .It Dv DIOCWDINFO
-Give the driver a new disklabel to use. The driver WILL try write the
-new disklabel to the disk.
+$B%I%i%$%P$K?7$7$$%G%#%9%/%i%Y%k$rM?$($^$9!#(B
+$B%I%i%$%P$O!"?7$7$$%G%#%9%/%i%Y%k$r%G%#%9%/$K=q$-9~$b$&$H$7$^$9!#(B
 .El
 .Pp
-And the following
+$B<!$N(B
 .Xr ioctl 2
-calls which apply to optical disks are defined in the header file
-.Aq Pa sys/cdio.h .
+$B%3!<%k$OB>$N%G%#%9%/$@$1$G$J$/!"8w3X%G%#%9%/$K$bBP1~$7$^$9!#(B
+$B$3$l$i$O%X%C%@%U%!%$%k(B
+.Aq Pa sys/cdio.h
+$B$KDj5A$5$l$F$$$^$9!#(B
 .Bl -tag -width CDIOCPREVENT
 .It Dv CDIOCEJECT
-Eject the optical disk media.
+$B8w3X%G%#%9%/$rGS=P$7$^$9!#(B
 .It Dv CDIOCALLOW
-Tell the drive to allow manual ejection of the optical disk media.
+$B%I%i%$%V$KBP$7!"8w3X%G%#%9%/$N<jF0GS=P$r5v2D$7$^$9!#(B
 .It Dv CDIOCPREVENT
-Tell the drive to prevent manual ejection of the optical disk media.
+$B%I%i%$%V$KBP$7!"8w3X%G%#%9%/$N<jF0GS=P$r6X;_$7$^$9!#(B
 .El
 .Pp
-In addition, the 
+$B2C$($F!"(B
 .Xr scsi 4
-general ioctls may be used with the 
+$B$N0lHLE*$J(B ioctl $B$O(B
 .Nm
-driver, but only against the fourth (whole disk) partition.
-.Sh NOTES
-Currently the
+$B%I%i%$%P$G;H$C$F$b9=$$$^$;$s!#(B
+$B$7$+$7(B 4 $BHVL\$N%Q!<%F%#%7%g%s(B ($B%G%#%9%/A4BN(B) $B$@$1$OHr$1$F$/$@$5$$!#(B
+.Sh $BCm(B
+$B8=:_$N$H$3$m!"(B
 .Nm
-driver accepts 512, 1024 and 2048 byte/sector media.
-Raw and block mode device access to non-512 byte/sector media
-would be allowed only on each sector size boundary start position and 
-I/O size.
-.Sh FILES
+$B%I%i%$%P$O(B 512, 1024, 2048 $B%P%$%H(B/$B%;%/%?$N%a%G%#%"$KBP1~$7$F$$$^$9!#(B
+raw $B$*$h$S%V%m%C%/%b!<%I$N%G%P%$%9$K$*$1$k!"(B
+$BHs(B 512 $B%P%$%H(B/$B%;%/%?$N%a%G%#%"$X$N%"%/%;%9$O!"(B
+$B3F%;%/%?%5%$%:6-3&@~$N3+;O0LCV$H(B I/O $B%5%$%:$K4X$7$F$N$_2DG=$G$9!#(B
+.Sh $B4XO"%U%!%$%k(B
 .Bl -tag -width /dev/rodXXXXX -compact
 .It Pa /dev/rod Ns Ar u
-raw mode
+raw $B%b!<%I$N(B
 .Tn SCSI
-optical disk unit
-.Ar u ,
-accessed as an unpartitioned device
+$B8w3X%G%#%9%/%f%K%C%H(B
+.Ar u
+$B$O!"%Q!<%F%#%7%g%K%s%0$5$l$F$$$J$$%G%P%$%9$H$7$F%"%/%;%9$5$l$^$9!#(B
 .Sm off
 .It Pa /dev/od Ar u Pa s Ar n
 .Sm on
-block mode
+$B%V%m%C%/%b!<%I$N(B
 .Tn SCSI
-optical disk unit
-.Ar u ,
-slice
-.Ar n ,
-accessed as an unpartitioned device
+$B8w3X%G%#%9%/%f%K%C%H(B
+.Ar u
+$B%9%i%$%9(B
+.Ar n
+$B$O!"%Q!<%F%#%7%g%K%s%0$5$l$F$$$J$$%G%P%$%9$H$7$F%"%/%;%9$5$l$^$9!#(B
 .Sm off
 .It Pa /dev/rod Ar u Pa s Ar n
 .Sm on
-raw mode
+raw $B%b!<%I$N(B
 .Tn SCSI
-optical disk unit
-.Ar u ,
-slice
-.ar n ,
-accessed as an unpartitioned device
+$B8w3X%G%#%9%/%f%K%C%H(B
+.Ar u
+$B%9%i%$%9(B
+.Ar n
+$B$O!"%Q!<%F%#%7%g%K%s%0$5$l$F$$$J$$%G%P%$%9$H$7$F%"%/%;%9$5$l$^$9!#(B
 .It Pa /dev/od Ns Ar u Ns Ar p
-block mode
+$B%V%m%C%/%b!<%I$N(B
 .Tn SCSI
-optical disk unit
-.Ar u ,
-first
+$B8w3X%G%#%9%/%f%K%C%H(B
+.Ar u 
+$B$N:G=i$N(B
 .Tn FreeBSD
-slice, partition
+$B%9%i%$%9$N%Q!<%F%#%7%g%s(B
 .Ar p
+$B!#(B
 .It Pa /dev/rod Ns Ar u Ns Ar p
-raw mode
+raw $B%b!<%I$N(B
 .Tn SCSI
-optical disk unit
-.Ar u ,
-first
+$B8w3X%G%#%9%/%f%K%C%H(B
+.Ar u
+$B$N:G=i$N(B
 .Tn FreeBSD
-slice, partition
+$B%9%i%$%9$N%Q!<%F%#%7%g%s(B
 .Ar p
+$B!#(B
 .Sm off
 .It Xo
 .Pa /dev/od Ar u Pa s Ar n Ar p
 .Xc
 .Sm on
-block mode
+$B%V%m%C%/%b!<%I$N(B
 .Tn SCSI
-optical disk unit
-.Ar u ,
-.No Ar n Ns th
-slice, partition
+$B8w3X%G%#%9%/%f%K%C%H(B
+.Ar u
+$B$N(B
+.No Ar n 
+$BHVL\$N%9%i%$%9$KB8:_$9$k%Q!<%F%#%7%g%s(B
 .Ar p
+$B!#(B
 .Sm off
 .It Xo
 .Pa /dev/rod Ar u Pa s Ar n Ar p
 .Xc
-raw mode
+raw $B%b!<%I$N(B
 .Tn SCSI
-optical disk unit
-.Ar u ,
-.No Ar n Ns th
-slice, partition
+$B8w3X%G%#%9%/%f%K%C%H(B
+.Ar u
+$B$N(B
+.No Ar n
+$BHVL\$N%9%i%$%9$KB8:_$9$k%Q!<%F%#%7%g%s(B
 .Ar p
+$B!#(B
 .Sm off
 .It Xo
 .Pa /dev/rod Ar u Pa .ctl
 .Xc
-the control device unit
-.Ar u ,
-as being used by
 .Xr scsi 8
+$B$G;H$o$l$k@)8f%G%P%$%9%f%K%C%H(B
+.Ar u
+$B!#(B
 .El
-.Sh DIAGNOSTICS
-None.
-.Sh SEE ALSO
+.Sh $B?GCG(B
+$B$"$j$^$;$s!#(B
+.Sh $B4XO"9`L\(B
 .Xr fdisk 1 ,
 .Xr cd 4 ,
 .Xr scsi 4 ,
 .Xr sd 4 ,
 .Xr disklabel 5 ,
 .Xr disklabel 8
-.Sh AUTHORS
-.An Shunsuke Akiyama Aq akiyama@jp.FreeBSD.org
-.Sh HISTORY
-The
+.Sh $B:n<T(B
+Shunsuke Akiyama <akiyama@jp.FreeBSD.org>
+.Sh $BNr;K(B
 .Nm
-driver first appeared in
-.Fx 2.1.5 .
+$B%I%i%$%P$O(B
+.Fx 2.1.5
+$B$KEP>l$7$^$7$?!#(B

