summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorimp <imp@FreeBSD.org>2004-03-14 22:15:38 +0000
committerimp <imp@FreeBSD.org>2004-03-14 22:15:38 +0000
commit4f9d8b78ae75506f39a713d8bafa71036708aa9d (patch)
tree0661fc3b232a351d1532628ca18fe98257407088
parentf4aa310607b9f4f8ce8f7c240734d3b22c5d88b1 (diff)
downloadFreeBSD-src-4f9d8b78ae75506f39a713d8bafa71036708aa9d.zip
FreeBSD-src-4f9d8b78ae75506f39a713d8bafa71036708aa9d.tar.gz
Really remove asc man page this time
-rw-r--r--share/man/man4/man4.i386/asc.4200
1 files changed, 0 insertions, 200 deletions
diff --git a/share/man/man4/man4.i386/asc.4 b/share/man/man4/man4.i386/asc.4
deleted file mode 100644
index 3ff0e21..0000000
--- a/share/man/man4/man4.i386/asc.4
+++ /dev/null
@@ -1,200 +0,0 @@
-.\" asc(4) - manual page for the scanner device driver `asc'
-.\"
-.\"
-.\" Copyright (c) 1995 Gunther Schadow, Luigi Rizzo. All rights reserved.
-.\"
-.\" Redistribution and use in source and binary forms, with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\" 1. Redistributions of source code must retain the above copyright
-.\" notice, this list of conditions and the following disclaimer.
-.\" 2. Redistributions in binary form must reproduce the above copyright
-.\" notice, this list of conditions and the following disclaimer in the
-.\" documentation and/or other materials provided with the distribution.
-.\" 3. All advertising materials mentioning features or use of this software
-.\" must display the following acknowledgements:
-.\" This product includes software developed by Gunther Schadow.
-.\" This product includes software developed by Luigi Rizzo.
-.\" 4. The name of the author may not be used to endorse or promote products
-.\" derived from this software without specific prior written permission.
-.\"
-.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
-.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
-.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
-.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
-.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
-.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
-.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
-.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
-.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
-.\"
-.\" $FreeBSD$
-.Dd January 19, 1995
-.Dt ASC 4 i386
-.Os
-.Sh NAME
-.Nm asc
-.Nd device driver for a GI1904-based hand scanner
-.Sh SYNOPSIS
-.Cd "device asc 1"
-.Pp
-In
-.Pa /boot/device.hints :
-.Cd hint.asc.0.at="isa"
-.Cd hint.asc.0.port="0x3EB"
-.Cd hint.asc.0.drq="3"
-.Cd hint.asc.0.irq="10"
-.Sh DESCRIPTION
-The
-.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
-.Xr dd 1
-with the driver
-in raw mode.
-.Sh IOCTLS
-The
-.Xr ioctl 2
-commands applicable to
-.Nm
-are listed below.
-The
-.Xr sasc 1
-provides user-level access to these commands.
-.Bl -tag -width "ASC_GHEIGHT"
-.It Dv ASC_GRES
-.Pq Li int
-Get current resolution in dots per inch (dpi).
-.It Dv ASC_GWIDTH
-.Pq Li int
-Get current width of the bitmap in pixels.
-.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.
-.It Dv ASC_GHEIGHT
-.Pq Li int
-Get the current height of the bitmap.
-.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
-.Er ENOMEM
-error is returned if the requested length would exceed this limit.
-.It Dv ASC_GBLEN
-.Pq Li int
-Get the current buffer length in lines.
-.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.
-.It Dv ASC_GBTIME
-.Pq Li int
-Get the current buffer timeout.
-.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
-.Fn ioctl
-requests.
-.Pp
-The
-.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.
-.Pp
-Note that the
-.Xr pbm 5
-versus raw mode selection is done by the
-minor number, not by
-.Fn ioctl
-requests. In raw mode, the selected
-height of the bitmap will have no effect.
-.Sh FILES
-.Bl -tag -width /dev/asc0pd -compact
-.It Pa /dev/asc0
-device node for raw output
-.It Pa /dev/asc0d
-device node for raw output, emitting debug messages if the
-.Dv ASCDEBUG
-option was given in the kernel configuration file
-.It Pa /dev/asc0p
-device node for output in
-.Xr pbm 5
-file format
-.It Pa /dev/asc0pd
-device node for
-.Xr pbm 5
-and debug mode
-.El
-.\"
-.\" .Sh DIAGNOSTICS
-.\"
-.Sh SEE ALSO
-.Xr sasc 1 ,
-.Xr pbm 5
-.Sh BUGS
-Ioctl support is not working yet.
-.Sh AUTHORS
-The
-.Nm
-driver was written by
-.An Luigi Rizzo .
-.Sh HISTORY
-The
-.Nm
-driver first appeared in
-.Fx 2.1 .
OpenPOWER on IntegriCloud