[Midnightbsd-cvs] src: man/man4: Sync man pages with changes to the respective code

laffer1 at midnightbsd.org laffer1 at midnightbsd.org
Wed Dec 10 12:32:05 EST 2008


Log Message:
-----------
Sync man pages with changes to the respective code

Modified Files:
--------------
    src/share/man/man4:
        acpi.4 (r1.1.1.1 -> r1.2)
        acpi_thermal.4 (r1.1.1.1 -> r1.2)
        agp.4 (r1.1.1.2 -> r1.2)
        cardbus.4 (r1.1.1.1 -> r1.2)
        cpufreq.4 (r1.2 -> r1.3)
        em.4 (r1.1.1.2 -> r1.2)
        firewire.4 (r1.1.1.1 -> r1.2)
        fxp.4 (r1.2 -> r1.3)
        ichsmb.4 (r1.1.1.1 -> r1.2)
        pccard.4 (r1.1.1.1 -> r1.2)
        pccbb.4 (r1.1.1.1 -> r1.2)
        sio.4 (r1.1.1.1 -> r1.2)
        uart.4 (r1.2 -> r1.3)
        wlan.4 (r1.1.1.1 -> r1.2)

-------------- next part --------------
Index: wlan.4
===================================================================
RCS file: /home/cvs/src/share/man/man4/wlan.4,v
retrieving revision 1.1.1.1
retrieving revision 1.2
diff -L share/man/man4/wlan.4 -L share/man/man4/wlan.4 -u -r1.1.1.1 -r1.2
--- share/man/man4/wlan.4
+++ share/man/man4/wlan.4
@@ -23,9 +23,9 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\" $FreeBSD: src/share/man/man4/wlan.4,v 1.8.2.1 2005/12/02 16:45:03 brueffer Exp $
+.\" $FreeBSD: src/share/man/man4/wlan.4,v 1.13 2007/09/10 17:20:21 brueffer Exp $
 .\"
-.Dd November 26, 2005
+.Dd September 6, 2007
 .Dt WLAN 4
 .Os
 .Sh NAME
@@ -48,9 +48,11 @@
 .Xr ipw 4 ,
 .Xr iwi 4 ,
 .Xr ral 4 ,
+.Xr rum 4 ,
 .Xr ural 4 ,
+.Xr wi 4 ,
 and
-.Xr wi 4
+.Xr zyd 4
 drivers, with other drivers to follow.
 .Pp
 The
@@ -125,13 +127,15 @@
 .Xr iwi 4 ,
 .Xr netintro 4 ,
 .Xr ral 4 ,
+.Xr rum 4 ,
 .Xr ural 4 ,
 .Xr wi 4 ,
 .Xr wlan_acl 4 ,
 .Xr wlan_ccmp 4 ,
 .Xr wlan_tkip 4 ,
 .Xr wlan_wep 4 ,
-.Xr wlan_xauth 4
+.Xr wlan_xauth 4 ,
+.Xr zyd 4
 .Sh STANDARDS
 More information can be found in the IEEE 802.11 Standard.
 .Sh HISTORY
Index: fxp.4
===================================================================
RCS file: /home/cvs/src/share/man/man4/fxp.4,v
retrieving revision 1.2
retrieving revision 1.3
diff -L share/man/man4/fxp.4 -L share/man/man4/fxp.4 -u -r1.2 -r1.3
--- share/man/man4/fxp.4
+++ share/man/man4/fxp.4
@@ -23,9 +23,9 @@
 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.\" $FreeBSD: src/share/man/man4/fxp.4,v 1.34.2.2 2006/02/02 07:50:00 trhodes Exp $
+.\" $FreeBSD: src/share/man/man4/fxp.4,v 1.40 2007/01/30 08:40:03 brueffer Exp $
 .\"
-.Dd October 28, 2006
+.Dd January 7, 2007
 .Dt FXP 4
 .Os
 .Sh NAME
@@ -122,6 +122,8 @@
 .It
 Intel PRO/100 VE Desktop Adapter
 .It
+Intel PRO/100 VM Network Connection
+.It
 Intel PRO/100 M Desktop Adapter
 .It
 Intel PRO/100 S Desktop, Server and Dual-Port Server Adapters
@@ -132,8 +134,7 @@
 .It
 NEC PC-9821X-B06 (PC-98)
 .It
-Many on-board network interfaces on Intel motherboards including the
-ICH7 chipset.
+Many on-board network interfaces on Intel motherboards
 .El
 .Sh DIAGNOSTICS
 .Bl -diag
@@ -146,18 +147,12 @@
 .It "fxp%d: device timeout"
 The device has stopped responding to the network, or there is a problem with
 the network connection (cable).
-.It "fxp%d: Ethernet address ff:ff:ff:ff:ff:ff"
-In some Alpha's (AXPpci and Multia) you must tell the driver to use (slower)
-I/O rather than memory to access the card.
-Create, if it does not yet exist, and add to the file
-.Pa /boot/device.hints
-the line
-.Dq Li hint.fxp.0.prefer_iomap="0" .
 .It "fxp%d: Microcode loaded, int_delay: %d usec  bundle_max: %d"
 The chip has successfully downloaded the microcode, and changed the
 parameterized values to the given settings.
 .El
 .Sh SEE ALSO
+.Xr altq 4 ,
 .Xr arp 4 ,
 .Xr miibus 4 ,
 .Xr netintro 4 ,
Index: firewire.4
===================================================================
RCS file: /home/cvs/src/share/man/man4/firewire.4,v
retrieving revision 1.1.1.1
retrieving revision 1.2
diff -L share/man/man4/firewire.4 -L share/man/man4/firewire.4 -u -r1.1.1.1 -r1.2
--- share/man/man4/firewire.4
+++ share/man/man4/firewire.4
@@ -29,22 +29,28 @@
 .\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.\" $FreeBSD: src/share/man/man4/firewire.4,v 1.11 2004/12/14 19:53:30 brueffer Exp $
+.\" $FreeBSD: src/share/man/man4/firewire.4,v 1.12 2006/04/01 10:37:35 brueffer Exp $
 .\"
-.Dd December 14, 2004
+.Dd April 1, 2006
 .Dt FIREWIRE 4
 .Os
 .Sh NAME
 .Nm firewire
 .Nd IEEE1394 High-performance Serial Bus
 .Sh SYNOPSIS
-.Cd "kldload firewire"
-.Pp
-or
-.Pp
+To compile this driver into the kernel,
+place the following line in your
+kernel configuration file:
+.Bd -ragged -offset indent
 .Cd "device firewire"
+.Ed
 .Pp
-.In dev/firewire/firewire.h
+Alternatively, to load the driver as a
+module at boot time, place the following line in
+.Xr loader.conf 5 :
+.Bd -literal -offset indent
+firewire_load="YES"
+.Ed
 .Sh DESCRIPTION
 .Fx
 provides machine-independent bus support and raw drivers for
Index: ichsmb.4
===================================================================
RCS file: /home/cvs/src/share/man/man4/ichsmb.4,v
retrieving revision 1.1.1.1
retrieving revision 1.2
diff -L share/man/man4/ichsmb.4 -L share/man/man4/ichsmb.4 -u -r1.1.1.1 -r1.2
--- share/man/man4/ichsmb.4
+++ share/man/man4/ichsmb.4
@@ -32,9 +32,9 @@
 .\"
 .\" Author: Archie Cobbs <archie at FreeBSD.org>
 .\"
-.\" $FreeBSD: src/share/man/man4/ichsmb.4,v 1.7 2005/05/05 12:00:43 wilko Exp $
+.\" $FreeBSD: src/share/man/man4/ichsmb.4,v 1.7.10.1 2007/12/02 08:42:16 remko Exp $
 .\"
-.Dd October 5, 2000
+.Dd November 28, 2007
 .Dt ICHSMB 4
 .Os
 .Sh NAME
@@ -48,8 +48,8 @@
 .Sh DESCRIPTION
 This driver provides access to the SMBus controller logical
 device contained in the Intel 82801AA (ICH), 82801AB (ICH0),
-82801BA (ICH2), 82801CA (ICH3), 82801DC (ICH4) and
-82801EB (ICH5) PCI chips.
+82801BA (ICH2), 82801CA (ICH3), 82801DC (ICH4), 82801EB (ICH5),
+82801FB (ICH6) and 82801GB (ICH7) PCI chips.
 .Sh SEE ALSO
 .Xr smb 4 ,
 .Xr smbus 4
Index: cpufreq.4
===================================================================
RCS file: /home/cvs/src/share/man/man4/cpufreq.4,v
retrieving revision 1.2
retrieving revision 1.3
diff -L share/man/man4/cpufreq.4 -L share/man/man4/cpufreq.4 -u -r1.2 -r1.3
--- share/man/man4/cpufreq.4
+++ share/man/man4/cpufreq.4
@@ -22,9 +22,9 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\" $FreeBSD: src/share/man/man4/cpufreq.4,v 1.10.2.3 2006/03/08 12:56:06 mnag Exp $
+.\" $FreeBSD: src/share/man/man4/cpufreq.4,v 1.15 2006/09/18 15:24:18 ru Exp $
 .\"
-.Dd March 03, 2006
+.Dd March 3, 2006
 .Dt CPUFREQ 4
 .Os
 .Sh NAME
@@ -116,7 +116,7 @@
 .It Pa ichss
 Intel SpeedStep for ICH
 .It Pa powernow
-AMD PowerNow!\& for K7 and K8
+AMD PowerNow!\& and Cool'n'Quiet for K7 and K8
 .It Pa smist
 Intel SMI-based SpeedStep for PIIX4
 .El
Index: pccard.4
===================================================================
RCS file: /home/cvs/src/share/man/man4/pccard.4,v
retrieving revision 1.1.1.1
retrieving revision 1.2
diff -L share/man/man4/pccard.4 -L share/man/man4/pccard.4 -u -r1.1.1.1 -r1.2
--- share/man/man4/pccard.4
+++ share/man/man4/pccard.4
@@ -22,7 +22,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\" $FreeBSD: src/share/man/man4/pccard.4,v 1.5 2003/08/20 06:49:57 imp Exp $
+.\" $FreeBSD: src/share/man/man4/pccard.4,v 1.7 2005/11/18 10:52:22 ru Exp $
 .\"
 .Dd July 9, 2002
 .Dt PCCARD 4
@@ -39,9 +39,40 @@
 The
 .Nm
 driver supports all PC Card bridges in the system.
+.Sh TUNABLES
+The driver supports the following tunable parameters, which may be
+added to
+.Pa /boot/loader.conf
+or set via the
+.Xr sysctl 8
+command:
+.Bl -tag -width ".Cm hw.pccard.cis_debug" -compact
+.It Cm hw.pccard.debug
+Non-zero values cause more verbose information to be printed when a
+16-bit PC Card is inserted or removed.
+.It Cm hw.pccard.cis_debug
+Non-zero value causes the CIS parsing of the 16-bit PC Card to be much
+more verbose and include a complete CIS dump.
+.El
+.Sh FILES
+.Bl -tag -width ".Pa /dev/pccard0.cis" -compact
+.It Pa /dev/pccard0.cis
+This exclusive-use device will report all the CIS chains present in a
+PC Card, if a 16-bit PC Card is inserted in the slot.
+Only one user at a time may access the CIS.
+The CIS is presented as the relevant byte stream from the PC Card.
+For CIS tuples in Attribute Memory (the default), only the even
+locations are presented (the ODD locations are undefined per the
+standard).
+For CIS tuples in Common Memory, every byte is presented to the user.
+Decoding of the CIS tuples is done via a userland program.
+All tuples are presented to the user.
+.El
 .Sh SEE ALSO
 .Xr cardbus 4 ,
 .\" .Xr mecia 4 ,
-.Xr pccbb 4 ,
-.Xr pcic 4
+.Xr pccbb 4
 .\" .Xr tcic 4
+.Rs
+.%T "PC Card Standard, Release 8"
+.Re
Index: em.4
===================================================================
RCS file: /home/cvs/src/share/man/man4/em.4,v
retrieving revision 1.1.1.2
retrieving revision 1.2
diff -L share/man/man4/em.4 -L share/man/man4/em.4 -u -r1.1.1.2 -r1.2
--- share/man/man4/em.4
+++ share/man/man4/em.4
@@ -29,9 +29,9 @@
 .\"
 .\" * Other names and brands may be claimed as the property of others.
 .\"
-.\" $FreeBSD: src/share/man/man4/em.4,v 1.20.2.4 2006/02/02 07:50:00 trhodes Exp $
+.\" $FreeBSD: src/share/man/man4/em.4,v 1.28 2007/01/30 08:40:03 brueffer Exp $
 .\"
-.Dd November 27, 2005
+.Dd September 15, 2006
 .Dt EM 4
 .Os
 .Sh NAME
@@ -58,7 +58,9 @@
 the Intel 82540, 82541ER, 82541PI, 82542, 82543, 82544, 82545, 82546,
 82546EB, 82546GB, 82547, 82571, 81572 and 82573 Ethernet controller chips.
 The driver supports Transmit/Receive checksum offload
-and Jumbo Frames only on 82540, 82543, 82544 and 82546-based adapters.
+and Jumbo Frames on all but 82542-based adapters.
+Furthermore it supports TCP segmentation offload (TSO) on all adapters but
+those based on the 82543, 82544 and 82547 controller chips.
 For further hardware information, see the
 .Pa README
 included with the driver.
@@ -75,8 +77,6 @@
 The maximum MTU size for Jumbo Frames is 16114.
 .Pp
 This driver version supports VLANs.
-For information on enabling VLANs, see the
-.Pa README .
 The
 .Nm
 driver supports the following media types:
@@ -218,10 +218,6 @@
 the network connection (cable).
 .El
 .Sh SUPPORT
-For additional information regarding building and installation,
-see the
-.Pa README
-included with the driver.
 For general information and support,
 go to the Intel support website at:
 .Pa http://support.intel.com .
@@ -231,6 +227,7 @@
 issue to
 .Aq freebsdnic at mailbox.intel.com .
 .Sh SEE ALSO
+.Xr altq 4 ,
 .Xr arp 4 ,
 .Xr netintro 4 ,
 .Xr ng_ether 4 ,
Index: agp.4
===================================================================
RCS file: /home/cvs/src/share/man/man4/agp.4,v
retrieving revision 1.1.1.2
retrieving revision 1.2
diff -L share/man/man4/agp.4 -L share/man/man4/agp.4 -u -r1.1.1.2 -r1.2
--- share/man/man4/agp.4
+++ share/man/man4/agp.4
@@ -22,9 +22,9 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\" $FreeBSD: src/share/man/man4/agp.4,v 1.6.10.2 2005/12/31 13:55:08 brueffer Exp $
+.\" $FreeBSD: src/share/man/man4/agp.4,v 1.10.2.1 2007/12/01 17:24:18 remko Exp $
 .\"
-.Dd December 20, 2005
+.Dd November 28, 2007
 .Dt AGP 4
 .Os
 .Sh NAME
@@ -39,18 +39,18 @@
 the following devices:
 .Pp
 .Bl -tag -width "NVIDIA:" -compact
-.It ALI:
+.It Ali:
 M1541, M1621 and M1671 host to AGP bridges
 .It AMD:
 751, 761 and 762 host to AGP bridges
 .It ATI:
 RS100, RS200, RS250 and RS300 AGP bridges
 .It Intel:
-i820, i840, i845, i850, and i860 host to AGP bridge
+i820, i840, i845, i850, and i860 host to AGP bridges
 .It Intel:
-i810, i810-DC100, i810E, i815, 830M, 845G, 852GM, 852GME, 855GM, 855GME, 865G, 915G and 915GM SVGA controllers
+i810, i810-DC100, i810E, i815, 830M, 845G, 845M, 852GM, 852GME, 855GM, 855GME, 865G, 915G and 915GM SVGA controllers
 .It Intel:
-82443BX, 82443GX, 82443LX, 82815, 82820, 82830, 82840, 82845, 82845G, 82850, 82855, 82855GM, 82860, 82865, 82875P and E7205 host to AGP bridges
+82443BX, 82443GX, 82443LX, 82815, 82820, 82830, 82840, 82845, 82845G, 82850, 82855, 82855GM, 82860, 82865, 82875P, E7205 and E7505 host to AGP bridges
 .It NVIDIA:
 nForce and nForce2 AGP controllers
 .It SiS:
Index: acpi_thermal.4
===================================================================
RCS file: /home/cvs/src/share/man/man4/acpi_thermal.4,v
retrieving revision 1.1.1.1
retrieving revision 1.2
diff -L share/man/man4/acpi_thermal.4 -L share/man/man4/acpi_thermal.4 -u -r1.1.1.1 -r1.2
--- share/man/man4/acpi_thermal.4
+++ share/man/man4/acpi_thermal.4
@@ -22,9 +22,9 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\" $FreeBSD: src/share/man/man4/acpi_thermal.4,v 1.6.8.2 2005/11/05 06:57:32 ume Exp $
+.\" $FreeBSD: src/share/man/man4/acpi_thermal.4,v 1.11 2007/03/18 00:57:07 njl Exp $
 .\"
-.Dd December 27, 2003
+.Dd March 17, 2007
 .Dt ACPI_THERMAL 4
 .Os
 .Sh NAME
@@ -55,6 +55,16 @@
 each thermal zone's setpoints.
 .Sh SYSCTL VARIABLES
 .Bl -tag -width indent
+.It Va hw.acpi.thermal.min_runtime
+Number of seconds to continue active cooling once started.
+A new active cooling level will not be selected until this interval expires.
+.It Va hw.acpi.thermal.polling_rate
+Number of seconds between polling the current temperature.
+.It Va hw.acpi.thermal.user_override
+If set to 1, allow user override of various setpoints (below).
+The original values for these settings are obtained from the BIOS and
+system overheating and possible damage could occur if changed.
+Default is 0 (no override).
 .It Va hw.acpi.thermal.tz%d.active
 Current active cooling system state.
 If this is non-negative, the appropriate _AC%d object is running.
@@ -73,25 +83,26 @@
 Current temperature for this zone.
 .It Va hw.acpi.thermal.tz%d._PSV
 Temperature to start passive cooling by throttling down CPU, etc.
+This value can be overridden by the user.
 .It Va hw.acpi.thermal.tz%d._HOT
 Temperature to start critical suspend to disk (S4).
+This value can be overridden by the user.
 .It Va hw.acpi.thermal.tz%d._CRT
 Temperature to start critical shutdown (S5).
+This value can be overridden by the user.
 .It Va hw.acpi.thermal.tz%d._ACx
 Temperatures at which to switch to the corresponding active cooling
 level.
-For instance, values of
-.Qq Li "3200 3100"
-mean to switch on _AC0 at 320.0K
-and _AC1 at 310.0K.
 The lower the _ACx value, the higher the cooling power.
 .El
 .Pp
-All temperatures are represented in tenths of a Kelvin.
-For example, 300.0K is represented by the integer 3000.
-To convert to units of Centigrade,
-the formula is
-.Li "(x - 2731.5) / 10" .
+All temperatures are printed in Celsius.
+Values can be set in Celsius (by providing a trailing
+.Qq C )
+or Kelvin (by leaving off any trailing letter).
+When setting a value by
+.Xr sysctl 8 ,
+do not specify a trailing decimal (i.e., 90C instead of 90.0C).
 .Sh NOTIFIES
 Notifies are passed to userland via
 .Xr devd 8 .
Index: pccbb.4
===================================================================
RCS file: /home/cvs/src/share/man/man4/pccbb.4,v
retrieving revision 1.1.1.1
retrieving revision 1.2
diff -L share/man/man4/pccbb.4 -L share/man/man4/pccbb.4 -u -r1.1.1.1 -r1.2
--- share/man/man4/pccbb.4
+++ share/man/man4/pccbb.4
@@ -22,7 +22,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\" $FreeBSD: src/share/man/man4/pccbb.4,v 1.6 2004/12/23 05:32:02 imp Exp $
+.\" $FreeBSD: src/share/man/man4/pccbb.4,v 1.8 2005/11/18 10:52:22 ru Exp $
 .\"
 .Dd July 21, 2004
 .Dt PCCBB 4
@@ -164,6 +164,18 @@
 .It
 Toshiba ToPIC100
 .El
+.Sh TUNABLES
+The driver supports the following tunable parameters, which may be
+added to
+.Pa /boot/loader.conf
+or set via the
+.Xr sysctl 8
+command:
+.Bl -tag -width ".Cm hw.cbb.debug" -compact
+.It Cm hw.cbb.debug
+Non-zero values cause more verbose information to be printed to aid in
+debugging problems with the bridge chipset.
+.El
 .Sh SEE ALSO
 .Xr cardbus 4 ,
 .Xr pccard 4
Index: uart.4
===================================================================
RCS file: /home/cvs/src/share/man/man4/uart.4,v
retrieving revision 1.2
retrieving revision 1.3
diff -L share/man/man4/uart.4 -L share/man/man4/uart.4 -u -r1.2 -r1.3
--- share/man/man4/uart.4
+++ share/man/man4/uart.4
@@ -23,9 +23,9 @@
 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.\" $FreeBSD: src/share/man/man4/uart.4,v 1.5.8.1 2006/02/11 06:30:41 marcel Exp $
+.\" $FreeBSD: src/share/man/man4/uart.4,v 1.11 2006/09/18 15:24:19 ru Exp $
 .\"
-.Dd August 25, 2003
+.Dd March 29, 2006
 .Dt UART 4
 .Os
 .\"
@@ -38,6 +38,9 @@
 .Pp
 .Cd "device puc"
 .Cd "device uart"
+.Pp
+.Cd "device scc"
+.Cd "device uart"
 .\"
 .Sh DESCRIPTION
 The
@@ -51,15 +54,21 @@
 The primary support for devices that contain multiple serial interfaces or
 that contain other functionality besides one or more serial interfaces is
 provided by the
-.Xr puc 4
-device driver.
+.Xr puc 4 ,
+or
+.Xr scc 4
+device drivers.
 However, the serial interfaces of those devices that are managed by the
-.Xr puc 4
-driver are controlled by the
+.Xr puc 4 ,
+or
+.Xr scc 4
+driver are each independently controlled by the
 .Nm
 driver.
 As such, the
-.Xr puc 4
+.Xr puc 4 ,
+or
+.Xr scc 4
 driver provides umbrella functionality for the
 .Nm
 driver and hides the complexities that are inherent when elementary components
@@ -112,17 +121,15 @@
 .Bl -bullet -compact
 .It
 NS8250: standard hardware based on the 8250, 16450, 16550, 16650, 16750 or
-the 16950 UARTs
-.It
-SAB82532: Siemens SAB 82532 based serial communications controllers in
-asynchronuous mode.
+the 16950 UARTs.
 .It
-Z8530: Zilog 8530 based serial communications controllers in asynchronuous
-mode.
+SCC: serial communications controllers supported by the
+.Xr scc 4
+device driver.
 .El
 .\"
 .Sh FILES
-.Bl -tag -width /dev/ttyu?.init -compact
+.Bl -tag -width ".Pa /dev/ttyu?.init" -compact
 .It Pa /dev/ttyu?
 for callin ports
 .It Pa /dev/ttyu?.init
@@ -136,7 +143,8 @@
 corresponding callout initial-state and lock-state devices
 .El
 .Sh SEE ALSO
-.Xr puc 4
+.Xr puc 4 ,
+.Xr scc 4
 .\"
 .Sh HISTORY
 The
@@ -144,5 +152,7 @@
 device driver first appeared in
 .Fx 5.2 .
 .Sh AUTHORS
-This manual page was written by
+The
+.Nm
+device driver and this manual page were written by
 .An Marcel Moolenaar Aq marcel at xcllnt.net .
Index: sio.4
===================================================================
RCS file: /home/cvs/src/share/man/man4/sio.4,v
retrieving revision 1.1.1.1
retrieving revision 1.2
diff -L share/man/man4/sio.4 -L share/man/man4/sio.4 -u -r1.1.1.1 -r1.2
--- share/man/man4/sio.4
+++ share/man/man4/sio.4
@@ -34,9 +34,9 @@
 .\"
 .\"     from: @(#)dca.4	5.2 (Berkeley) 3/27/91
 .\"	from: com.4,v 1.1 1993/08/06 11:19:07 cgd Exp
-.\" $FreeBSD: src/share/man/man4/sio.4,v 1.55 2005/02/13 22:25:17 ru Exp $
+.\" $FreeBSD: src/share/man/man4/sio.4,v 1.57 2006/08/30 14:38:42 ru Exp $
 .\"
-.Dd October 17, 2004
+.Dd August 30, 2006
 .Dt SIO 4
 .Os
 .Sh NAME
@@ -179,15 +179,6 @@
 .It 0x20000
 device is assumed to use a 16650A-type (extended FIFO) chip
 .El
-.Pp
-Minor numbering:
-.Bd -literal -offset indent -compact
-0b\fIOLIMMMMM\fR
-  call\fBO\fRut
-   \fBL\fRock
-    \fBI\fRnitial
-     \fBMMMMM\fRinor
-.Ed
 .Sh DESCRIPTION
 The
 .Nm
@@ -301,10 +292,6 @@
 .Nm
 driver also supports an initial-state and a lock-state control
 device for each of the callin and the callout "data" devices.
-The minor number of the initial-state device is 32 higher
-than that of the corresponding data device.
-The minor number of the lock-state device is 64 higher
-than that of the corresponding data device.
 The termios settings of a data device are copied
 from those of the corresponding initial-state device
 on first opens and are not inherited from previous opens.
@@ -321,6 +308,11 @@
 Speeds and special characters
 may be locked by setting the corresponding value in the lock-state
 device to any nonzero value.
+E.g., to lock a speed to 115200, use
+.Dq Li stty 115200
+on the initial-state device and
+.Dq Li stty 1
+on the lock-state device.
 .Pp
 Correct programs talking to correctly wired external devices
 work with almost arbitrary initial states and almost no locking,
Index: acpi.4
===================================================================
RCS file: /home/cvs/src/share/man/man4/acpi.4,v
retrieving revision 1.1.1.1
retrieving revision 1.2
diff -L share/man/man4/acpi.4 -L share/man/man4/acpi.4 -u -r1.1.1.1 -r1.2
--- share/man/man4/acpi.4
+++ share/man/man4/acpi.4
@@ -23,9 +23,9 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\" $FreeBSD: src/share/man/man4/acpi.4,v 1.52.2.1 2005/07/30 09:34:57 hrs Exp $
+.\" $FreeBSD: src/share/man/man4/acpi.4,v 1.61 2006/09/18 15:24:18 ru Exp $
 .\"
-.Dd February 13, 2005
+.Dd July 29, 2006
 .Dt ACPI 4
 .Os
 .Sh NAME
@@ -35,6 +35,7 @@
 .Cd "device acpi"
 .Pp
 .Cd "options ACPI_DEBUG"
+.Cd "options DDB"
 .Sh DESCRIPTION
 The
 .Nm
@@ -56,13 +57,13 @@
 The
 .Nm
 driver is intended to provide power management without user intervention.
-Thus, some of these sysctls are controlled automatically by the
-.Pa power_profile
-.Xr rc 8
-script, which can be configured via
-.Xr rc.conf 5 .
-If values are specified manually, they may be overridden.
+If the default settings are not optimal, the following sysctls can be
+used to modify or monitor
+.Nm
+behavior.
 .Bl -tag -width indent
+.It Va hw.acpi.acline
+AC line state (1 means online, 0 means on battery power).
 .It Va hw.acpi.cpu.cx_usage
 Debugging information listing the percent of total usage for each sleep state.
 The values are reset when
@@ -70,7 +71,9 @@
 is modified.
 .It Va hw.acpi.cpu.cx_lowest
 Lowest Cx state to use for idling the CPU.
-A scheduling algorithm will select states between C1 and this setting
+A scheduling algorithm will select states between
+.Li C1
+and this setting
 as system load dictates.
 To enable ACPI CPU idling control,
 .Va machdep.cpu_idle_hlt
@@ -78,20 +81,115 @@
 .It Va hw.acpi.cpu.cx_supported
 List of supported CPU idle states and their transition latency
 in microseconds.
-Each state has a type (e.g., C2).
-C1 is equivalent to the ia32 HLT instruction, C2 provides a deeper
-sleep with the same semantics, and C3 provides the deepest sleep
+Each state has a type (e.g.,
+.Li C2 ) .
+.Li C1
+is equivalent to the ia32
+.Li HLT
+instruction,
+.Li C2
+provides a deeper
+sleep with the same semantics, and
+.Li C3
+provides the deepest sleep
 but additionally requires bus mastering to be disabled.
-States greater than C3 provide even more power savings with the same
-semantics as the C3 state.
+States greater than
+.Li C3
+provide even more power savings with the same
+semantics as the
+.Li C3
+state.
 Deeper sleeps provide more power savings but increased transition
 latency when an interrupt occurs.
+.It Va hw.acpi.disable_on_reboot
+Disable ACPI during the reboot process.
+Most systems reboot fine with ACPI still enabled, but some require
+exiting to legacy mode first.
+Default is 0, leave ACPI enabled.
+.It Va hw.acpi.handle_reboot
+Use the ACPI Reset Register capability to reboot the system.
+Default is 0, use legacy reboot support.
+Some newer systems require use of this register, while some only work
+with legacy rebooting support.
+.It Va hw.acpi.lid_switch_state
+Suspend state
+.Pq Li S1 Ns \[en] Ns Li S5
+to enter when the lid switch (i.e., a notebook screen) is closed.
+Default is
+.Dq Li NONE
+(do nothing).
+.It Va hw.acpi.power_button_state
+Suspend state
+.Pq Li S1 Ns \[en] Ns Li S5
+to enter when the power button is pressed.
+Default is
+.Li S5
+(power-off nicely).
+.It Va hw.acpi.reset_video
+Reset the video adapter from real mode during the resume path.
+Some systems need this help, others have display problems if it is enabled.
+Default is 0 (disabled).
+.It Va hw.acpi.s4bios
+Indicate whether the system supports
+.Li S4BIOS .
+This means that the BIOS can handle all the functions of suspending the
+system to disk.
+Otherwise, the OS is responsible for suspending to disk
+.Pq Li S4OS .
+Most current systems do not support
+.Li S4BIOS .
+.It Va hw.acpi.sleep_button_state
+Suspend state
+.Pq Li S1 Ns \[en] Ns Li S5
+to enter when the sleep button is pressed.
+This is usually a special function button on the keyboard.
+Default is
+.Li S3
+(suspend-to-RAM).
+.It Va hw.acpi.sleep_delay
+Wait this number of seconds between preparing the system to suspend and
+actually entering the suspend state.
+Default is 1 second.
+.It Va hw.acpi.supported_sleep_state
+Suspend states
+.Pq Li S1 Ns \[en] Ns Li S5
+supported by the BIOS.
+.Bl -tag -width indent
+.It Li S1
+Quick suspend to RAM.
+The CPU enters a lower power state, but most peripherals are left running.
+.It Li S2
+Lower power state than
+.Li S1 ,
+but with the same basic characteristics.
+Not supported by many systems.
+.It Li S3
+Suspend to RAM.
+Most devices are powered off, and the system stops running except for
+memory refresh.
+.It Li S4
+Suspend to disk.
+All devices are powered off, and the system stops running.
+When resuming, the system starts as if from a cold power on.
+Not yet supported by
+.Fx
+unless
+.Li S4BIOS
+is available.
+.It Li S5
+System shuts down cleanly and powers off.
+.El
+.It Va hw.acpi.verbose
+Enable verbose printing from the various ACPI subsystems.
 .El
 .Sh LOADER TUNABLES
 Tunables can be set at the
 .Xr loader 8
 prompt before booting the kernel or stored in
 .Pa /boot/loader.conf .
+Many of these tunables also have a matching
+.Xr sysctl 8
+entry for access after boot.
 .Bl -tag -width indent
 .It Va acpi_dsdt_load
 Enables loading of a custom ACPI DSDT.
@@ -106,6 +204,10 @@
 The default value is 3.
 .It Va debug.acpi.quirks
 Override any automatic quirks completely.
+.It Va debug.acpi.resume_beep
+Beep the PC speaker on resume.
+This can help diagnose suspend/resume problems.
+Default is 0 (disabled).
 .It Va hint.acpi.0.disabled
 Set this to 1 to disable all of ACPI.
 If ACPI has been disabled on your system due to a blacklist entry for your
@@ -116,12 +218,11 @@
 .Qq Li AE_NO_HARDWARE_RESPONSE .
 .It Va hw.acpi.host_mem_start
 Override the assumed memory starting address for PCI host bridges.
-.It Va hw.acpi.pci.link.%d.%d.%d.irq
-Override the interrupt to use.
 .It Va hw.acpi.reset_video
 Enables calling the VESA reset BIOS vector on the resume path.
-Some graphic chips have problems such as LCD white-out after resume.
-Try setting this to 0 if this causes problems for you.
+This can fix some graphics cards that have problems such as LCD white-out
+after resume.
+Default is 0 (disabled).
 .It Va hw.acpi.serialize_methods
 Allow override of whether methods execute in parallel or not.
 Enable this for serial behavior, which fixes
@@ -132,6 +233,25 @@
 such code.
 .It Va hw.acpi.verbose
 Turn on verbose debugging information about what ACPI is doing.
+.It Va hw.pci.link.%s.%d.irq
+Override the interrupt to use for this link and index.
+This capability should be used carefully, and only if a device is not
+working with
+.Nm
+enabled.
+.Qq %s
+is the name of the link (e.g., LNKA).
+.Qq %d
+is the resource index when the link supports multiple IRQs.
+Most PCI links only have one IRQ resource, so the below form should be used.
+.It Va hw.pci.link.%s.irq
+Override the interrupt to use.
+This capability should be used carefully, and only if a device is not
+working with
+.Nm
+enabled.
+.Qq %s
+is the name of the link (e.g., LNKA).
 .El
 .Sh DISABLING ACPI
 Since ACPI support on different platforms varies greatly, there are many
@@ -462,7 +582,21 @@
 This manual page was written by
 .An Michael Smith Aq msmith at FreeBSD.org .
 .Sh BUGS
-If the
+Many BIOS versions have serious bugs that may cause system instability,
+break suspend/resume, or prevent devices from operating properly due to
+IRQ routing problems.
+Upgrade your BIOS to the latest version available from the vendor before
+deciding it is a problem with
+.Nm .
+.Pp
+The
 .Nm
-driver is loaded as a module when it is already linked as part of the
-kernel, odd things may happen.
+CPU idle power management drive conflicts with the local APIC (LAPIC)
+timer.
+Disable APIC mode with
+.Va hint.apic.0.disabled
+or do not use the
+.Li C2
+and
+.Li C3
+states if APIC mode is enabled.
Index: cardbus.4
===================================================================
RCS file: /home/cvs/src/share/man/man4/cardbus.4,v
retrieving revision 1.1.1.1
retrieving revision 1.2
diff -L share/man/man4/cardbus.4 -L share/man/man4/cardbus.4 -u -r1.1.1.1 -r1.2
--- share/man/man4/cardbus.4
+++ share/man/man4/cardbus.4
@@ -22,7 +22,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\" $FreeBSD: src/share/man/man4/cardbus.4,v 1.4 2002/12/13 09:06:44 ru Exp $
+.\" $FreeBSD: src/share/man/man4/cardbus.4,v 1.6 2005/11/18 10:52:22 ru Exp $
 .\"
 .Dd July 9, 2002
 .Dt CARDBUS 4
@@ -39,6 +39,21 @@
 The
 .Nm
 driver supports all cardbus bridges in the system.
+.Sh TUNABLES
+The driver supports the following tunable parameters, which may be
+added to
+.Pa /boot/loader.conf
+or set via the
+.Xr sysctl 8
+command:
+.Bl -tag -width ".Cm hw.cardbus.cis_debug" -compact
+.It Cm hw.cardbus.debug
+Non-zero values cause more verbose information to be printed when a
+32-bit CardBus card is inserted or removed.
+.It Cm hw.cardbus.cis_debug
+Non-zero value causes the CIS parsing of the 32-bit CardBus card to be
+much more verbose and include a complete CIS dump.
+.El
 .Sh SEE ALSO
 .Xr pccard 4 ,
 .Xr pccbb 4


More information about the Midnightbsd-cvs mailing list