share/man/man4/ppi.4

   1 .\" $NetBSD: ppi.4,v 1.3 2004/01/23 15:49:41 wiz Exp $
   2 .\"
   3 .\" Copyright (c) 1997
   4 .\"      Michael Smith
   5 .\"
   6 .\" Redistribution and use in source and binary forms, with or without
   7 .\" modification, are permitted provided that the following conditions
   8 .\" are met:
   9 .\" 1. Redistributions of source code must retain the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer as
  11 .\"    the first lines of this file unmodified.
  12 .\" 2. Redistributions in binary form must reproduce the above copyright
  13 .\"    notice, this list of conditions and the following disclaimer in the
  14 .\"    documentation and/or other materials provided with the distribution.
  15 .\"
  16 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS''
  17 .\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  18 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  19 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE
  20 .\" LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  21 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  22 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  23 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  24 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  25 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  26 .\" POSSIBILITY OF SUCH DAMAGE.
  27 .\"
  28 .\" $FreeBSD: src/share/man/man4/ppi.4,v 1.4.2.7 2001/12/17 11:30:12 ru Exp $
  29 .\"
  30 .Dd December 29, 2003
  31 .Dt PPI 4
  32 .Os
  33 .Sh NAME
  34 .Nm ppi
  35 .Nd "user-space interface to ppbus parallel port"
  36 .Sh SYNOPSIS
  37 .Cd "ppi* at ppbus?"
  38 .Pp
  39 Minor numbering:  Unit numbers correspond directly to
  40 .Xr ppbus 4
  41 numbers.
  42 .Sh DESCRIPTION
  43 The
  44 .Nm
  45 driver provides a convenient means for user applications to manipulate
  46 the state of the parallel port, enabling easy low-speed I/O operations
  47 without the security problems inherent with the use of the
  48 .Pa /dev/io
  49 interface.
  50 .Pp
  51 The programming interface is described in
  52 .Xr ppi 9 .
  53 .Sh SEE ALSO
  54 .Xr atppc 4 ,
  55 .Xr io 4 ,
  56 .Xr ppbus 4 ,
  57 .Xr ppi 9
  58 .Sh HISTORY
  59 .Nm
  60 originally appeared in
  61 .Fx .
  62 .Sh AUTHORS
  63 This manual page is based on the
  64 .Fx
  65 .Nm ppi
  66 manual page and was updated for the
  67 .Nx
  68 port by
  69 .An Gary Thorpe .
  70 .Sh BUGS
  71 The inverse sense of signals is confusing.
  72 .Pp
  73 The
  74 .Fn ioctl
  75 interface is slow, and there is no way (yet) to chain multiple
  76 operations together.
  77 .Pp
  78 The headers required for user applications are not installed as
  79 part of the standard system.