[src/trunk]: src Add acpivga(4).

[gsutre <gsutre%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/96d0cba315f9
branches:  trunk
changeset: 758004:96d0cba315f9
user:      gsutre <gsutre%NetBSD.org@localhost>
date:      Tue Oct 12 23:01:55 2010 +0000

description:
Add acpivga(4).

diffstat:

 distrib/sets/lists/man/mi |    8 ++-
 share/man/man4/Makefile   |    5 +-
 share/man/man4/acpivga.4  |  119 ++++++++++++++++++++++++++++++++++++++++++++++
 3 files changed, 129 insertions(+), 3 deletions(-)

diffs (191 lines):

diff -r b27b62ba515f -r 96d0cba315f9 distrib/sets/lists/man/mi
--- a/distrib/sets/lists/man/mi Tue Oct 12 21:49:08 2010 +0000
+++ b/distrib/sets/lists/man/mi Tue Oct 12 23:01:55 2010 +0000
@@ -1,4 +1,4 @@
-# $NetBSD: mi,v 1.1239 2010/10/02 06:26:28 kiyohara Exp $
+# $NetBSD: mi,v 1.1240 2010/10/12 23:01:55 gsutre Exp $
 #
 # Note: don't delete entries from here - mark them as "obsolete" instead.
 #
@@ -628,8 +628,10 @@
 ./usr/share/man/cat4/acpiec.0                  man-sys-catman          .cat
 ./usr/share/man/cat4/acpiecdt.0                        man-sys-catman          .cat
 ./usr/share/man/cat4/acpilid.0                 man-sys-catman          .cat
+./usr/share/man/cat4/acpiout.0                 man-sys-catman          .cat
 ./usr/share/man/cat4/acpismbus.0               man-sys-catman          .cat
 ./usr/share/man/cat4/acpitz.0                  man-sys-catman          .cat
+./usr/share/man/cat4/acpivga.0                 man-sys-catman          .cat
 ./usr/share/man/cat4/acpiwmi.0                 man-sys-catman          .cat
 ./usr/share/man/cat4/adb.0                     man-sys-catman          .cat
 ./usr/share/man/cat4/adbbt.0                   man-sys-catman          .cat
@@ -3351,8 +3353,10 @@
 ./usr/share/man/html4/acpiec.html              man-sys-htmlman         html
 ./usr/share/man/html4/acpiecdt.html            man-sys-htmlman         html
 ./usr/share/man/html4/acpilid.html             man-sys-htmlman         html
+./usr/share/man/html4/acpiout.html             man-sys-htmlman         html
 ./usr/share/man/html4/acpismbus.html           man-sys-htmlman         html
 ./usr/share/man/html4/acpitz.html              man-sys-htmlman         html
+./usr/share/man/html4/acpivga.html             man-sys-htmlman         html
 ./usr/share/man/html4/acpiwmi.html             man-sys-htmlman         html
 ./usr/share/man/html4/adb.html                 man-sys-htmlman         html
 ./usr/share/man/html4/adbbt.html               man-sys-htmlman         html
@@ -5774,8 +5778,10 @@
 ./usr/share/man/man4/acpiec.4                  man-sys-man             .man
 ./usr/share/man/man4/acpiecdt.4                        man-sys-man             .man
 ./usr/share/man/man4/acpilid.4                 man-sys-man             .man
+./usr/share/man/man4/acpiout.4                 man-sys-man             .man
 ./usr/share/man/man4/acpismbus.4               man-sys-man             .man
 ./usr/share/man/man4/acpitz.4                  man-sys-man             .man
+./usr/share/man/man4/acpivga.4                 man-sys-man             .man
 ./usr/share/man/man4/acpiwmi.4                 man-sys-man             .man
 ./usr/share/man/man4/adb.4                     man-sys-man             .man
 ./usr/share/man/man4/adbbt.4                   man-sys-man             .man
diff -r b27b62ba515f -r 96d0cba315f9 share/man/man4/Makefile
--- a/share/man/man4/Makefile   Tue Oct 12 21:49:08 2010 +0000
+++ b/share/man/man4/Makefile   Tue Oct 12 23:01:55 2010 +0000
@@ -1,4 +1,4 @@
-#      $NetBSD: Makefile,v 1.526 2010/10/02 06:22:00 kiyohara Exp $
+#      $NetBSD: Makefile,v 1.527 2010/10/12 23:01:55 gsutre Exp $
 #      @(#)Makefile    8.1 (Berkeley) 6/18/93
 
 MAN=   aac.4 ac97.4 acardide.4 aceride.4 acphy.4 \
@@ -83,7 +83,7 @@
 # ACPI devices
 MAN+=  acpi.4 acpiacad.4 acpibat.4 acpibut.4 acpicpu.4 \
        acpidalb.4 acpiec.4 acpilid.4 \
-       acpismbus.4 acpitz.4 acpiwmi.4
+       acpismbus.4 acpitz.4 acpivga.4 acpiwmi.4
 
 # Radio devices
 MAN+=  radio.4 az.4 mr.4 rt.4 rtii.4 sf2r.4
@@ -147,6 +147,7 @@
 MLINKS+=drm.4 viadrm.4
 
 MLINKS+=acpiec.4 acpiecdt.4
+MLINKS+=acpivga.4 acpiout.4
 MLINKS+=acpiwmi.4 wmidell.4 acpiwmi.4 wmihp.4
 MLINKS+=aibs.4 aiboost.4
 MLINKS+=ata.4 atabus.4
diff -r b27b62ba515f -r 96d0cba315f9 share/man/man4/acpivga.4
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/share/man/man4/acpivga.4  Tue Oct 12 23:01:55 2010 +0000
@@ -0,0 +1,119 @@
+.\" $NetBSD: acpivga.4,v 1.1 2010/10/12 23:01:55 gsutre Exp $
+.\"
+.\" Copyright (c) 2010 The NetBSD Foundation, Inc.
+.\" All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
+.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
+.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+.\" POSSIBILITY OF SUCH DAMAGE.
+.\"
+.Dd October 12, 2010
+.Dt ACPIVGA 4
+.Os
+.Sh NAME
+.Nm acpivga
+.Nd ACPI Display Adapter and Output Devices
+.Sh SYNOPSIS
+.Cd "acpivga* at acpi?"
+.Cd "acpiout* at acpivga?"
+.Sh DESCRIPTION
+The
+.Nm
+driver provides generic support for brightness control and output switching,
+through
+.Tn ACPI
+video extensions.
+The
+.Tn ACPI
+specification requires that systems containing a built-in display adapter
+implement these extensions in their
+.Tn ACPI
+BIOS.
+.Pp
+The driver handles brightness hotkeys and output switch hotkeys.
+In addition, the following
+.Xr sysctl 8
+read/write variables are provided (when hardware support is available):
+.Bl -tag -width Ds
+.It Va hw.acpi.acpivga0.policy
+BIOS switch policy.
+Accepted values range from 0 to 7.
+For more information, refer to the documentation of the _DOS method,
+in Section B.4.1 of the
+.Tn ACPI
+specification (revision 4.0a).
+.It Va hw.acpi.acpiout0.brightness
+Brightness level.
+Typical values range from 0 to 100, but any integer value is accepted (the
+driver uses the closest brightness level supported by the device).
+.El
+.Pp
+Please note, however, that future versions of
+.Nm
+may remove these
+.Xr sysctl 8
+variables without prior notice.
+.Sh SEE ALSO
+.Xr acpi 4 ,
+.Xr sysctl 8
+.Sh STANDARDS
+The
+.Nm
+driver supports the
+.Em ACPI Extensions for Display Adapters
+given in Appendix B of the
+.Tn ACPI
+specification.
+.Pp
+.Rs
+.%A Hewlett-Packard Corporation
+.%A Intel Corporation
+.%A Microsoft Corporation
+.%A Phoenix Technologies Ltd.
+.%A Toshiba Corporation
+.%B Advanced Configuration and Power Interface Specification
+.%V Revision 4.0a
+.%D April 5, 2010
+.%U http://www.acpi.info/spec.htm
+.Re
+.Sh HISTORY
+The
+.Nm
+driver appeared in
+.Nx 6.0 .
+.Sh AUTHORS
+.An Gr\('egoire Sutre
+.Aq gsutre%NetBSD.org@localhost
+.Sh CAVEATS
+The
+.Nm
+driver only supports PCI/PCI-X/PCI-E display adapters.
+.Pp
+Many
+.Tn ACPI
+BIOSes implement only part of the
+.Tn ACPI
+video extensions.
+In particular, display output switching often does not work.
+.Pp
+Brightness level should be controlled via
+.Xr wsconsctl 8
+instead of
+.Xr sysctl 8 .