share/man/man4/man4.i386/pnpbios.4

   1 .\" $NetBSD: pnpbios.4,v 1.11 2002/09/27 22:31:45 wiz Exp $
   2 .\"
   3 .\" Copyright (c) 1999-2002 The NetBSD Foundation, Inc.
   4 .\" All rights reserved.
   5 .\"
   6 .\" This code is derived from software contributed to The NetBSD Foundation
   7 .\" by Lennart Augustsson.
   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 NETBSD FOUNDATION, INC. AND CONTRIBUTORS
  19 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
  20 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  21 .\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
  22 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  23 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  24 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  25 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  26 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  27 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  28 .\" POSSIBILITY OF SUCH DAMAGE.
  29 .\"
  30 .Dd September 27, 2002
  31 .Dt PNPBIOS 4 i386
  32 .Os
  33 .Sh NAME
  34 .Nm pnpbios
  35 .Nd introduction to PnP BIOS support
  36 .Sh SYNOPSIS
  37 .Cd "pnpbios0 at mainbus?"
  38 .Cd "XX*      at pnpbios0 index ?"
  39 .Pp
  40 .Cd options PNPBIOSVERBOSE
  41 .Cd options PNPBIOSDEBUG
  42 .Sh INTRODUCTION
  43 .Nm
  44 provides support for finding and attaching devices by
  45 extracting information from the PnP BIOS of a machine.
  46 .Sh SUPPORTED DEVICES
  47 .Nx
  48 includes the following
  49 .Nm
  50 drivers, sorted by driver name:
  51 .Pp
  52 .Bl -tag -width speaker -offset indent -compact
  53 .It com
  54 serial communications interface
  55 .It ess
  56 ESS Technology AudioDrive family audio device driver
  57 .It fdc
  58 floppy controller
  59 .It joy
  60 game controller
  61 .It lpt
  62 parallel port driver
  63 .It npx
  64 math coprocessor
  65 .It pciide
  66 PCI IDE controllers driver
  67 .It pckbc
  68 PC keyboard/mouse controller
  69 .It sb
  70 SoundBlaster family audio device driver
  71 .It wss
  72 Windows Sound System hardware driver
  73 .It ym
  74 Yamaha OPL3-SA3 sound driver
  75 .El
  76 .Sh SEE ALSO
  77 .Xr com 4 ,
  78 .Xr ess 4 ,
  79 .Xr fdc 4 ,
  80 .Xr intro 4 ,
  81 .Xr isa 4 ,
  82 .Xr joy 4 ,
  83 .Xr lpt 4 ,
  84 .Xr npx 4 ,
  85 .Xr pci 4 ,
  86 .Xr pciide 4 ,
  87 .Xr pckbc 4 ,
  88 .Xr sb 4 ,
  89 .Xr wss 4 ,
  90 .Xr ym 4
  91 .Sh HISTORY
  92 The
  93 .Nm
  94 driver
  95 appeared in
  96 .Nx 1.5 .
  97 .Sh BUGS
  98 The
  99 .Nm
 100 bus provides a different way to attach devices than the real buses
 101 (e.g.,
 102 .Xr isa 4 ) .
 103 The reason to use
 104 .Nm
 105 instead of the real bus is that some machines have weird routings
 106 of, e.g., interrupts.  The exact information about these things can
 107 be found in the BIOS, which is why the
 108 .Nm
 109 bus has a better chance of succeeding with getting it right.
 110 .Pp
 111 Many older BIOS implementations do not support PnP,
 112 and some newer ones do not follow the standards.