usr.sbin/pcictl/pcictl.8

   1 .\"     $NetBSD: pcictl.8,v 1.6 2007/01/29 00:48:34 hubertf Exp $
   2 .\"
   3 .\" Copyright 2001 Wasabi Systems, Inc.
   4 .\" All rights reserved.
   5 .\"
   6 .\" Written by Jason R. Thorpe for Wasabi Systems, Inc.
   7 .\"
   8 .\" Redistribution and use in source and binary forms, with or without
   9 .\" modification, are permitted provided that the following conditions
  10 .\" are met:
  11 .\" 1. Redistributions of source code must retain the above copyright
  12 .\"    notice, this list of conditions and the following disclaimer.
  13 .\" 2. Redistributions in binary form must reproduce the above copyright
  14 .\"    notice, this list of conditions and the following disclaimer in the
  15 .\"    documentation and/or other materials provided with the distribution.
  16 .\" 3. All advertising materials mentioning features or use of this software
  17 .\"    must display the following acknowledgement:
  18 .\"     This product includes software developed for the NetBSD Project by
  19 .\"     Wasabi Systems, Inc.
  20 .\" 4. The name of Wasabi Systems, Inc. may not be used to endorse
  21 .\"    or promote products derived from this software without specific prior
  22 .\"    written permission.
  23 .\"
  24 .\" THIS SOFTWARE IS PROVIDED BY WASABI SYSTEMS, INC. ``AS IS'' AND
  25 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
  26 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  27 .\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL WASABI SYSTEMS, INC
  28 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  29 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  30 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  31 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  32 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  33 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  34 .\" POSSIBILITY OF SUCH DAMAGE.
  35 .\"
  36 .Dd January 29, 2007
  37 .Dt PCICTL 8
  38 .Os
  39 .Sh NAME
  40 .Nm pcictl
  41 .Nd a program to manipulate the PCI bus
  42 .Sh SYNOPSIS
  43 .Nm
  44 .Ar pcibus
  45 .Ar command
  46 .Oo
  47 .Ar arg Oo ...
  48 .Oc
  49 .Oc
  50 .Sh DESCRIPTION
  51 .Nm
  52 allows a user or system administrator to access various resources
  53 on a PCI bus.
  54 .Pp
  55 The following commands are available:
  56 .Pp
  57 .Nm list
  58 .Op Fl n
  59 .Op Fl b Ar bus
  60 .Op Fl d Ar device
  61 .Op Fl f Ar function
  62 .Pp
  63 List the devices in the PCI domain, either as names or, if
  64 .Fl n
  65 is given, as numbers.
  66 The bus, device, and function
  67 numbers may be specified by flags.
  68 If the bus is not specified, it defaults to the bus number of the
  69 PCI bus specified on the command line.
  70 Any other locator not specified defaults
  71 to a wildcard, or may be explicitly wildcarded by specifying
  72 .Dq any .
  73 .Pp
  74 .Nm dump
  75 .Op Fl b Ar bus
  76 .Fl d Ar device
  77 .Op Fl f Ar function
  78 .Pp
  79 Dump the PCI configuration space for the specified device located
  80 at the specified bus, device, and function.
  81 If the bus is not specified, it defaults to the bus number of the
  82 PCI bus specified on the command line.
  83 If the function is not specified, it defaults to 0.
  84 .Sh FILES
  85 .Pa /dev/pci*
  86 - PCI bus device nodes
  87 .Sh SEE ALSO
  88 .Xr pci 3 ,
  89 .Xr pci 4 ,
  90 .Xr drvctl 8
  91 .Sh HISTORY
  92 The
  93 .Nm
  94 command first appeared in
  95 .Nx 1.6 .