git.oblomov.eu Git - pnputils/blob - setpnp.man

   1 .\" Copyright (C) 1999 David A. Hinds -- dahinds@users.sourceforge.net
   2 .\" (c) Copyright 2006 Hewlett-Packard Development Company, L.P.
   3 .\"     Bjorn Helgaas <bjorn.helgaas@hp.com>
   4 .\"
   5 .TH setpnp 8 "@TODAY@" "@VERSION@" "Linux Plug and Play Utilities"
   6 .SH NAME
   7 setpnp \- modify Plug and Play BIOS device resources
   8 .SH SYNOPSIS
   9 .B setpnp
  10 .RB [ -b ]
  11 .I device resource...
  12 .br
  13 .B setpnp
  14 .RB [ -b ]
  15 .I device {on|off}
  16 .SH DESCRIPTION
  17 This utility updates the system resource information for Plug and Play
  18 BIOS device nodes.  A device is specified by its two-digit hex node
  19 number.  In its first form, a list of resources are given on the
  20 command line.  Alternatively, a device can either be simply switched
  21 ``on'' (reset to its boot configuration) or ``off'' (all resources
  22 disabled).
  23 .PP
  24 There are four types of resources: ``io'', ``mem'', ``irq'', and
  25 ``dma''.  A resource list consists of one or more space-separated
  26 pairs of a resource type with one or more values.  Multiple values for
  27 one resource type can be separated by commas.  Values can also either
  28 be unitary or dash-separated ranges.  For example:
  29 .sp
  30 .RS
  31 .nf
  32 setpnp 0d io 0x2f8-0x2ff irq 3
  33 setpnp 12 io 0x350-0x35f,0x2f8-0x2ff irq 3 irq 10
  34 setpnp 0b irq off
  35 .RE
  36 .fi
  37 .sp
  38 The order of items of different types is not important, but if more
  39 than one item of the same type is present, their relative order is
  40 significant.  The Plug and Play BIOS will reject invalid configuration
  41 attempts; however,
  42 .B setpnp
  43 will not attempt to determine why a configuration was rejected.
  44 .PP
  45 By default, current (dynamic) device configuration information is
  46 modified.  With the
  47 .B -b
  48 option, a device's boot (static) configuration can be updated.  Some
  49 devices may only be reconfigured for the following boot.  Be especially
  50 careful when modifying your system's boot configuration.  Improper use
  51 of this command may disable vital system devices and render your
  52 system unbootable.
  53 .SH OPTIONS
  54 .TP
  55 .B \-b
  56 Boot mode: update the device resource information that will be used at
  57 next boot (as opposed to current resource info).
  58 .SH FILES
  59 .TP
  60 /sys/bus/pnp/devices/...
  61 The kernel interface for Plug and Play BIOS device services.
  62 .TP
  63 /proc/bus/pnp/...
  64 The old kernel interface for Plug and Play BIOS device services.
  65 .SH AUTHORS
  66 David Hinds \- dahinds@users.sourceforge.net
  67 .br
  68 Bjorn Helgaas \- bjorn.helgaas@hp.com
  69 .SH "SEE ALSO"
  70 lspnp(8)