share/man/man4/lpt.4

   1 .\" $NetBSD: lpt.4,v 1.7 2004/02/03 21:37:00 jdolecek Exp $
   2 .\"
   3 .\"
   4 .\" Copyright (c) 1993 Christopher G. Demetriou
   5 .\" Copyright (c) 1994 Geoffrey M. Rehmet
   6 .\" Copyright (c) 1999 Nicolas Souchu
   7 .\" All rights reserved.
   8 .\"
   9 .\" Redistribution and use in source and binary forms, with or without
  10 .\" modification, are permitted provided that the following conditions
  11 .\" are met:
  12 .\" 1. Redistributions of source code must retain the above copyright
  13 .\"    notice, this list of conditions and the following disclaimer.
  14 .\" 2. Redistributions in binary form must reproduce the above copyright
  15 .\"    notice, this list of conditions and the following disclaimer in the
  16 .\"    documentation and/or other materials provided with the distribution.
  17 .\"
  18 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
  19 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  20 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  21 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  22 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  23 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  24 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  25 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  26 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  27 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  28 .\" SUCH DAMAGE.
  29 .\"
  30 .\" $FreeBSD: src/share/man/man4/lpt.4,v 1.9.2.2 2001/08/17 13:08:38 ru Exp $
  31 .\"
  32 .Dd February 3, 2004
  33 .Dt LPT 4
  34 .Os
  35 .Sh NAME
  36 .Nm lpt
  37 .Nd generic printer device driver
  38 .Sh SYNOPSIS
  39 .Cd "lpt* at ppbus?"
  40 .Cd options LPT_DEBUG
  41 .Cd options LPT_VERBOSE
  42 .Sh DESCRIPTION
  43 The
  44 .Nm
  45 driver is the port of the lpt driver to the
  46 .Xr ppbus 4
  47 system.
  48 .Pp
  49 The purpose of this driver is to allow parallel port sharing with
  50 other parallel devices.
  51 See
  52 .Xr ppbus 4
  53 for more information about the parallel port bus system.
  54 .Pp
  55 The parallel port bus is reserved by
  56 .Nm
  57 when the printer device is opened and released when the device is
  58 closed.
  59 .Pp
  60 Ports can be configured to use interrupts, DMA, IEEE negotiations, and IEEE
  61 compliant transfer modes by using the
  62 .Xr lptctl 8
  63 command, with modes depending on the hardware available.
  64 .Sh FILES
  65 .Bl -tag -width "/dev/lpt0xxxx" -compact
  66 .It Pa /dev/lpt?
  67 parallel port device
  68 .It Pa /dev/lpt?ctl
  69 parallel port control device
  70 .El
  71 .Sh SEE ALSO
  72 .Xr atppc 4 ,
  73 .Xr ppbus 4 ,
  74 .Xr lptctl 8 ,
  75 .Xr mknod 8
  76 .Sh HISTORY
  77 This driver is derived from the
  78 .Fx
  79 ppbus and also from the historic
  80 .Nx
  81 drivers.
  82 .Pp
  83 The
  84 .Nm
  85 driver used to assign special meaning for some bits of device minor.
  86 This was dropped in ppbus-based
  87 .Nm
  88 in favour of configuration via
  89 .Xr lptctl 8 .
  90 .Sh AUTHORS
  91 This manual page was based on the
  92 .Fx
  93 .Nm lpt
  94 manual page.
  95 The information has been updated for the
  96 .Nx
  97 port by Gary Thorpe.