From owner-man-jp-reviewer@jp.freebsd.org  Sat Aug 14 14:49:18 1999
Received: (from daemon@localhost)
	by castle.jp.freebsd.org (8.9.3+3.2W/8.7.3) id OAA45629;
	Sat, 14 Aug 1999 14:49:18 +0900 (JST)
	(envelope-from owner-man-jp-reviewer@jp.FreeBSD.org)
Received: from mail.nk.rim.or.jp (root@mail.nk.rim.or.jp [202.247.130.165])
	by castle.jp.freebsd.org (8.9.3+3.2W/8.7.3) with ESMTP id OAA45624
	for <man-jp-reviewer@jp.freebsd.org>; Sat, 14 Aug 1999 14:49:18 +0900 (JST)
	(envelope-from kuma@nk.rim.or.jp)
Received: from sho.slab.tnr.sharp.co.jp (kobe1-45.pias.ne.jp [210.136.248.247])
	by mail.nk.rim.or.jp (8.8.8/3.6W-RIMNET-98-06-09) with ESMTP id OAA22740
	for <man-jp-reviewer@jp.freebsd.org>; Sat, 14 Aug 1999 14:49:14 +0900 (JST)
Received: from sho.slab.tnr.sharp.co.jp (localhost.slab.tnr.sharp.co.jp [127.0.0.1])
	by sho.slab.tnr.sharp.co.jp (8.9.3/8.8.8laurel981201) with ESMTP id OAA00831
	for <man-jp-reviewer@jp.freebsd.org>; Sat, 14 Aug 1999 14:05:21 +0900 (JST)
	(envelope-from kuma@sho.laurel.nk.rim.or.jp)
Message-Id: <199908140505.OAA00831@sho.slab.tnr.sharp.co.jp>
To: man-jp-reviewer@jp.freebsd.org
Date: Sat, 14 Aug 1999 14:05:21 +0900
From: Norihiro Kumagai <kuma@nk.rim.or.jp>
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 1476
Subject: [man-jp-reviewer 1476] asc.4
Errors-To: owner-man-jp-reviewer@jp.freebsd.org
Sender: owner-man-jp-reviewer@jp.freebsd.org
X-Originator: kuma@nk.rim.or.jp

$B7'C+$G$9!#(B

asc.4 $B$N=iLu$G$9!#(B
$B$7$+$7!"!V(BGI1904 $B%Y!<%9$N%O%s%G%#%9%-%c%J!W$J$s$F8+$?$3$H$"$j$^$9!)(B
$B$=$l$bGr9u%S%C%H%^%C%W$JE[(B:-p
$B$J$s$+:#99!D$H$$$&5$$,$7$D$D$bLu$7=*$($?:#F|$3$N:"$G$7$?!#(B

--
$B7'C+(B $BE5Bg(B

============================================================
--- asc.4-us	Sat Aug 14 12:23:21 1999
+++ asc.4	Sat Aug 14 13:59:37 1999
@@ -30,161 +30,156 @@
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
 .\"	$Id: asc.4,v 1.8 1998/10/22 14:17:44 bde Exp $
+.\" jpman %Id: asc.4,v 0.0 1999/02/22 16:13:12 horikawa Stab %
 .Dd January 19, 1995
 .Dt ASC 4 i386
 .Os FreeBSD
-.Sh NAME
+.Sh $BL>>N(B
 .Nm asc
-.Nd device driver for a GI1904-based hand scanner
-.Sh SYNOPSIS
+.Nd GI1904$B%Y!<%9$N%O%s%I%9%-%c%JMQ%G%P%$%9%I%i%$%P(B
+.Sh $B=q<0(B
 .Cd "device asc0 at isa? port" \&"IO_ASC1\&" tty drq 3 irq 10
-.Sh DESCRIPTION
-The
+.Sh $B2r@b(B
+$B%-%c%i%/%?7?%G%P%$%9%I%i%$%P(B
 .Nm
-character device driver currently handles the
-.Tn GI1904 Ns -based
-hand scanner (e.g. Trust Amiscan Grey).
-It uses DMA and interrupts. 
-Up to 50 lines of scanned input data are buffered in the driver.
-.Pp
-The device can operate at four different resolutions: 100, 200, 300
-and 400 dots per inch. It produces a simple bitmap with the most
-significant bit at the left side.  The driver can optionally output
-the simple portable bitmap file format
-.Xr pbm 5 ;
-thus the scans can easily processed by most graphics packages.
-.Pp
-The width of the output bitmap is fixed as given by the
-resolution value.  However, the height of the bitmap must be
-supplied when in
-.Xr pbm 5
-mode, since the driver must know at what time the
-`end-of-file' shall be reached.  The default is to produce a
-square image; i.e., height equals width.
-With this feature one is able to
-directly copy the scanner output into a
-.Xr pbm 5
-file using
-.Xr cat 1 .
-One can obtain a similar effect by using
+$B$O!"8=:_$N$H$3$m!"(B
+.Tn GI1904 
+$B%Y!<%9$N%O%s%I%9%-%c%J(B ($BNc$($P(B Trust Amiscan Grey $B$J$I(B) $B$r07$$$^$9!#(B
+$B$3$N%G%P%$%9%I%i%$%P$O!"(BDMA $B$H3d$j9~$_$r;HMQ$7$^$9!#(B50 $B%i%$%s$^$G$N(B
+$B%9%-%c%sF~NO%G!<%?$r%I%i%$%PCf$G%P%C%U%!%j%s%0$7$^$9!#(B
+.Pp
+$B$3$N%G%P%$%9$O!"(B4 $B$D$N0[$J$k2rA|EY(B (100, 200, 300, 400 $B%I%C%H(B/$B%$%s%A(B) 
+$B$GF0:n$5$;$k$3$H$,$G$-$^$9!#:G>e0L%S%C%H$,:8B&$KMh$kC1=c$J%S%C%H%^%C%W(B
+$B$r@8@.$7$^$9!#$3$N%I%i%$%P$O!"JLES!"C1=c$J(B
+$B%]!<%?%V%k%S%C%H%^%C%W%U%!%$%k7A<0(B
+.Xr pbm 5
+$B$r@8@.$5$;$k$3$H$b$G$-$^$9!#(B
+$B$3$l$K$h$j!"$[$H$s$I$N%0%i%U%#%C%/%Q%C%1!<%8$G!"$3$N%9%-%c%s7k2L$r(B
+$BMF0W$K=hM}$9$k$3$H$,=PMh$^$9!#(B
+.Pp
+$B=PNO%S%C%H%^%C%W$NI}$O!"2rA|EY$NCM$K$h$j7h$^$k8GDj$NCM$G$9!#$7$+$7!"(B
+.Xr pbm 5
+$B%b!<%I$N>l9g!"%S%C%H%^%C%W$N9b$5$r;XDj$9$kI,MW$,$"$j$^$9!#$3$l$O!"(B
+$B%I%i%$%P$,$$$D!V%U%!%$%k$N=*C<!W$KC#$9$k$+$rCN$C$F$*$/I,MW$,$"$k(B
+$B$+$i$G$9!#%G%U%)%k%H$G$O!"@5J}7A$N%$%a!<%8$r@8@.$7$^$9!#$D$^$j!"I}$H(B
+$B9b$5$,Ey$7$$$H$5$l$^$9!#$3$N5!G=$K$h$j!"(B
+.Xr cat 1
+$B$rMQ$$$F%9%-%c%J$N=PNO$rD>@\(B
+.Xr pbm 5
+$B%U%!%$%k$K%3%T!<$9$k$3$H$,$G$-$^$9!#(B
+$B$3$N%I%i%$%P$r(B raw $B%b!<%I$G;HMQ$9$k>l9g!"(B
 .Xr dd 1
-with the driver
-in raw mode.
-.Sh IOCTLS
-The
-.Xr ioctl 2
-commands applicable to
+$B%3%^%s%I$r;HMQ$9$k$3$H$K$h$j!"$3$N8z2L$H;w$?8z2L$rF@$k$3$H$b$G$-$^$9!#(B
+.Sh IOCTL
 .Nm
-are listed below.
-The
+$B$KE,MQ2DG=$J(B
+.Xr ioctl 2
+$B%3%^%s%I$O<!$N$H$*$j$G$9!#(B
 .Xr sasc 1
-provides user-level access to these commands.
+$B$K$h$j!"%f!<%6%l%Y%k$G$3$l$i$N%3%^%s%I$r;HMQ$9$k$3$H$,$G$-$^$9!#(B
 .Bl -tag -width "ASC_GHEIGHT"
 .It Dv ASC_GRES
 .Pq Li int
-Get current resolution in dots per inch (dpi).
+$B8=:_$N2rA|EY$r!"%I%C%H(B/$B%$%s%A(B (dpi) $BC10L$GJV$7$^$9!#(B
 .It Dv ASC_GWIDTH
 .Pq Li int
-Get current width of the bitmap in pixels.
+$B8=:_$N%S%C%H%^%C%WI}$r%T%/%;%kC10L$GJV$7$^$9!#(B
 .It Dv ASC_SHEIGHT
 .Pq Li int
-Set the height of the bitmap in 
 .Xr pbm 5
-mode.  This is actually
-a limit on the amount of lines scannable after the first read
-operation.  When the limit is reached, read will return 0. However, the
-device is turned off only when the last open file descriptor is closed.
+$B%b!<%I$N%S%C%H%^%C%W$N9b$5$r@_Dj$7$^$9!#(B
+$B<B:]$N$H$3$m!"$3$l$O!":G=i$N(B read $B=hM}0J8e%9%-%c%s2DG=$J%i%$%s$NN_@Q?t(B
+$B$KBP$9$k@)8B$G$9!#$3$N@)8B$KE~C#$9$k$H!"(Bread $B$O%<%m$rJV$7$^$9!#(B
+$B$7$+$7!"%G%P%$%9$,F0:n$rDd;_$9$k$N$O!"%*!<%W%s$5$l$?%U%!%$%k5-=R;R$,$9$Y$F(B
+$B%/%m!<%:$5$l$?$H$-$K8B$j$^$9!#(B
 .It Dv ASC_GHEIGHT
 .Pq Li int
-Get the current height of the bitmap.
+$B8=:_$N%S%C%H%^%C%W$N9b$5$rJV$7$^$9!#(B
 .It Dv ASC_SBLEN
 .Pq Li int
-Set the length of the buffer used internally to do the DMA transfer.
-The buffer length is supplied in lines of the bitmap. Since the buffer
-size limit is (currently) 0x3000 bytes, the maximum number of lines
-allowed will vary with the width of each line.  An
+DMA $BE>Aw$r9T$J$&:]$KFbItE*$K;HMQ$9$k%P%C%U%!$ND9$5$r;XDj$7$^$9!#(B
+$B%P%C%U%!$ND9$5$O%S%C%H%^%C%W$N%i%$%s?t$G;XDj$7$^$9!#%P%C%U%!%5%$%:$N(B
+$B@)8B$,(B ($B8=:_$N$H$3$m(B) 0x3000 $B%P%$%H$G$"$k$?$a!";XDj2DG=$J%i%$%s:GBg?t$O(B
+$B%i%$%s$"$?$j$NI}$K$h$jJQ$o$j$^$9!#(B
+$B;XDj$7$?D9$5$,$3$N@)8B$r1[$($k>l9g!"(B
 .Er ENOMEM
-error is returned if the requested length would exceed this limit.
+$B%(%i!<$,JV$5$l$^$9!#(B
 .It Dv ASC_GBLEN
 .Pq Li int
-Get the current buffer length in lines.
+$B8=:_$N%P%C%U%!$ND9$5$r%i%$%s?tC10L$GJV$7$^$9!#(B
 .It Dv ASC_SBTIME
 .Pq Li int
-Set the timeout for the completion of reading one buffer. Since a
-handy scanner is a human/computer interface timeout values are usually
-higher than those of a flat scanner; the default is 15 seconds.  After
-timeout is reached the read operation will fail with 
-.Er EBUSY .
-Note that
-the timeout timer starts anew for each buffer to be read and thus 
-reducing it does not result in faster scans for longer images.
+$B%P%C%U%!(B 1 $B$D$X$NFI$_9~$_40N;$^$G$N%?%$%`%"%&%H$r;XDj$7$^$9!#(B
+$B%O%s%G%#%9%-%c%J$O?M4V$H%3%s%T%e!<%?4V$N%$%s%?%U%'!<%9$K$h$k$?$a!"(B
+$BIaDL$O!"%?%$%`%"%&%HCM$O%U%i%C%H%9%-%c%J$h$j$bBg$-$/$7$F$*$/I,MW$,(B
+$B$"$j$^$9!#%G%U%)%k%H$O(B 15 $BIC$G$9!#%?%$%`%"%&%H$KE~C#$9$k$H!"FI$_9~$_=hM}$O(B
+.Er EBUSY
+$B%(%i!<$G<:GT$7$^$9!#(B
+$B3F%P%C%U%!$+$iFI$_=P$5$l$k$4$H$K%?%$%`%"%&%H%?%$%^$,?7$?$K3+;O$5$l$^$9!#(B
+$B$h$C$F!"%?%$%^CM$r8:$i$9$3$H$K$h$j!"$h$jD9$$%$%a!<%8$r$h$jB.$/%9%-%c%s(B
+$B$G$-$k$h$&$K$J$k$o$1$G$O$"$j$^$;$s!#(B
 .It Dv ASC_GBTIME
 .Pq Li int
-Get the current buffer timeout.
+$B8=:_$N%P%C%U%!%?%$%`%"%&%HCM$rJV$7$^$9!#(B
 .El
 .Pp
-All
-.Fn ioctl
-requests that modify a parameter except
 .Dv ASC_SBTIME
-do not have an effect on an ongoing scan process.  The user must close
-the device and open it again for the new selections to take effect.
-Consequently, the selections are 
-.Em not
-reset when the device is opened or closed.
-.Pp
-Similarly, requests that read a value do not report the value that is
-used for the ongoing scan process.  The values needed during the scan
-process are saved when it starts and thus are not accessed by 
+$B$r=|$-!"%Q%i%a!<%?$rJQ99$9$k(B
+.Fn ioctl
+$B%j%/%(%9%H$N$9$Y$F$O!"8=:_?J9TCf$N%9%-%c%s=hM}$K1F6A$7$^$;$s!#%f!<%6$O(B
+$B%G%P%$%9$r%/%m!<%:$7!":F$S%*!<%W%s$7$F!"?7$7$$@_Dj$,8zNO$r$"$i$o$9$h$&(B
+$B$K$9$kI,MW$,$"$j$^$9!#7k6I$N$H$3$m!"%G%P%$%9$N%*!<%W%s%/%m!<%:$K$h$j!"(B
+$B%Q%i%a!<%?$N@_Dj$,%j%;%C%H$5$l$k$3$H$O(B
+.Em $B$"$j$^$;$s!#(B
+.Pp
+$BF1MM$K!"CM$rFI$_9~$`%j%/%(%9%H$O!"8=:_?J9TCf$N%9%-%c%s=hM}$GMQ$$$i$l$F(B
+$B$$$kCM$rJV$7$^$;$s!#%9%-%c%s=hM}Cf$KI,MW$JCM$O!"%9%-%c%s3+;O;~$KJ]B8$5$l!"(B
 .Fn ioctl
-requests.
+$B%j%/%(%9%H$G$O%"%/%;%9$G$-$J$$$h$&$K$J$C$F$$$^$9!#(B
 .Pp
-The
+$B$7$+$7!"(B
 .Dv ASC_SBTIME
-value does, however, have an immediate effect on the ongoing scan.
-Thus the timeout can, for example, be set to a large value until the
-user starts scanning, and then set to a small value to react
-(nearly) immediately when the user stops.
+$B$NCM$O!"8=:_?J9TCf$N%9%-%c%s=hM}$KB(:B$K1F6A$r5Z$\$7$^$9!#$3$l$K$h$j!"(B
+$BNc$($P!"%f!<%6$,%9%-%c%s$r3+;O$9$k$^$G$O%?%$%`%"%&%H$KBg$-$JCM$r@_Dj$7!"(B
+$B3+;O8e$O>.$5$JCM$r@_Dj$9$k$3$H$G!"%f!<%6$N%9%-%c%sCf;_$KB(:B$KH?1~$9$k(B
+$B$h$&$K$G$-$^$9!#(B
 .Pp
-Note that the
 .Xr pbm 5
-versus raw mode selection is done by the
-minor number, not by
+$B$H(B raw $B%b!<%I$NA*Br$O!"%^%$%JHV9f$K$h$j9T$J$o$l$^$9!#(B
 .Fn ioctl
-requests.  In raw mode, the selected
-height of the bitmap will have no effect.
-.Sh FILES
+$B%j%/%(%9%H$G$O9T$J$($^$;$s!#(Braw $B%b!<%I$G$O!";XDj$5$l$?%S%C%H%^%C%W$N(B
+$B9b$5$O8z2L$r$"$i$o$7$^$;$s!#(B
+.Sh $B4XO"%U%!%$%k(B
 .Bl -tag -width /dev/asc0pd -compact
 .It Pa /dev/asc0
-device node for raw output
+raw $B=PNOMQ$N%G%P%$%9%N!<%I!#(B
 .It Pa /dev/asc0d
-device node for raw output, emitting debug messages if the
+raw $B=PNOMQ$N%G%P%$%9%N!<%I!#(B
 .Dv ASCDEBUG
-option was given in the kernel configuration file
+$B%*%W%7%g%s$r%+!<%M%k@_Dj%U%!%$%k$G;XDj$7$?>l9g!"%G%P%C%0%a%C%;!<%8$,(B
+$B=PNO$5$l$^$9!#(B
 .It Pa /dev/asc0p
-device node for output in
 .Xr pbm 5
-file format
+$B%U%!%$%k7A<0=PNOMQ$N%G%P%$%9%N!<%I!#(B
 .It Pa /dev/asc0pd
-device node for
 .Xr pbm 5
-and debug mode
+$B%U%!%$%k7A<0=PNOMQ$+$D%G%P%C%0%b!<%I$N%G%P%$%9%N!<%I!#(B
 .PB
 .\"
-.\" .Sh DIAGNOSTICS
+.\" .Sh $B?GCG(B
 .\"
-.Sh SEE ALSO
+.Sh $B4XO"9`L\(B
 .Xr sasc 1 ,
 .Xr pbm 5
-.Sh BUGS
-Ioctl support is not working yet.
-.Sh AUTHOR
-The
+.Sh $B%P%0(B
+ioctl $B$N%5%]!<%H$,$^$@F0:n$7$F$$$^$;$s!#(B
+.Sh $B:n<T(B
 .Nm
-driver was written by
-Luigi Rizzo.
-.Sh HISTORY
-The
+$B%I%i%$%P$O!"(B
+Luigi Rizzo
+$B$,=q$-$^$7$?!#(B
+.Sh $BNr;K(B
 .Nm
-driver first appeared in
-.Fx 2.1 .
+$B%I%i%$%P$,:G=i$K8=$l$?$N$O(B
+.Fx 2.1
+$B$G$9!#(B
