Aren
/
NetBSD
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
NetBSD/share/man/man4/acpivga.4

125 lines
3.6 KiB
Groff
Raw Normal View History

Simplify the sysctl variable for BIOS switch policy, and document it in acpivga(4). The previous hw.acpi.acpivga0.policy variable is renamed into bios_policy for consistency, and is for ACPI_DEBUG only. ok jruoho@
2010-10-29 01:45:02 +04:00
.\" $NetBSD: acpivga.4,v 1.3 2010/10/28 21:45:02 gsutre Exp $
Add acpivga(4).
2010-10-13 03:01:55 +04:00
.\"
.\" 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.
.\"
As the ACPI specification is already mentioned in acpi(4), remove the note about STANDARDS. Instead mention a Microsoft document that is specifically about acpivga(4). Also xref vga(4).
2010-10-28 18:36:04 +04:00
.Dd October 28, 2010
Add acpivga(4).
2010-10-13 03:01:55 +04:00
.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
Simplify the sysctl variable for BIOS switch policy, and document it in acpivga(4). The previous hw.acpi.acpivga0.policy variable is renamed into bios_policy for consistency, and is for ACPI_DEBUG only. ok jruoho@
2010-10-29 01:45:02 +04:00
The driver handles brightness hotkeys and display switch hotkeys.
Add acpivga(4).
2010-10-13 03:01:55 +04:00
In addition, the following
.Xr sysctl 8
read/write variables are provided (when hardware support is available):
.Bl -tag -width Ds
Simplify the sysctl variable for BIOS switch policy, and document it in acpivga(4). The previous hw.acpi.acpivga0.policy variable is renamed into bios_policy for consistency, and is for ACPI_DEBUG only. ok jruoho@
2010-10-29 01:45:02 +04:00
.It Va hw.acpi.acpivga0.bios_switch
BIOS output switching policy.
This boolean variable controls the behavior of the BIOS when a display
switch hotkey is pressed.
.Bl -tag -width xxx -compact
.It Sy 1
the BIOS should automatically switch outputs, with no interaction from
.Nm .
.It Sy 0
the BIOS should only notify
.Nm
of the desired output state changes.
.El
Add acpivga(4).
2010-10-13 03:01:55 +04:00
.It Va hw.acpi.acpiout0.brightness
Brightness level.
Simplify the sysctl variable for BIOS switch policy, and document it in acpivga(4). The previous hw.acpi.acpivga0.policy variable is renamed into bios_policy for consistency, and is for ACPI_DEBUG only. ok jruoho@
2010-10-29 01:45:02 +04:00
This integer variable typically ranges from 0 to 100, but any integer value
is accepted (the driver uses the closest brightness level supported by the
device).
Add acpivga(4).
2010-10-13 03:01:55 +04:00
.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 ,
As the ACPI specification is already mentioned in acpi(4), remove the note about STANDARDS. Instead mention a Microsoft document that is specifically about acpivga(4). Also xref vga(4).
2010-10-28 18:36:04 +04:00
.Xr vga 4 ,
Add acpivga(4).
2010-10-13 03:01:55 +04:00
.Xr sysctl 8
.Rs
.%A Microsoft Corporation
As the ACPI specification is already mentioned in acpi(4), remove the note about STANDARDS. Instead mention a Microsoft document that is specifically about acpivga(4). Also xref vga(4).
2010-10-28 18:36:04 +04:00
.%D December 4, 2001
.%T Mobile System Displays and Windows
.%N Version 1.2c
.%U http://www.microsoft.com/whdc/archive/mobiledisplay.mspx
Add acpivga(4).
2010-10-13 03:01:55 +04:00
.Re
.Sh HISTORY
The
.Nm
driver appeared in
.Nx 6.0 .
.Sh AUTHORS
.An Gr\('egoire Sutre
.Aq gsutre@NetBSD.org
.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.
Simplify the sysctl variable for BIOS switch policy, and document it in acpivga(4). The previous hw.acpi.acpivga0.policy variable is renamed into bios_policy for consistency, and is for ACPI_DEBUG only. ok jruoho@
2010-10-29 01:45:02 +04:00
In particular, display output switching via these extensions often does not
work.
For this reason,
.Nm
enables
.Va hw.acpi.acpivga0.bios_switch
by default.
If the display switch hotkey does not work with this default setting, try
setting
.Va hw.acpi.acpivga0.bios_switch
to 0.
Add acpivga(4).
2010-10-13 03:01:55 +04:00
.Pp
Brightness level should be controlled via
.Xr wsconsctl 8
instead of
.Xr sysctl 8 .