xref: /netbsd-src/share/man/man4/acpiwmi.4 (revision 03a24fd83a055a9d0a76faeab2d3df75156d9a69)
1.\" $NetBSD: acpiwmi.4,v 1.9 2019/05/26 19:34:57 ryoon Exp $
2.\"
3.\" Copyright (c) 2010 Jukka Ruohonen <jruohonen@iki.fi>
4.\" All rights reserved.
5.\"
6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions
8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright
10.\"    notice, this list of conditions and the following disclaimer.
11.\" 2. Neither the name of the author nor the names of any
12.\"    contributors may be used to endorse or promote products derived
13.\"    from this software without specific prior written permission.
14.\"
15.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS
16.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
17.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
18.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
19.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
20.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
21.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
22.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
23.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
24.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
25.\" POSSIBILITY OF SUCH DAMAGE.
26.\"
27.Dd May 27, 2019
28.Dt ACPIWMI 4
29.Os
30.Sh NAME
31.Nm acpiwmi
32.Nd Windows Management Instrumentation support for
33.Tn ACPI
34.Sh SYNOPSIS
35.Cd "acpiwmi* at acpi?"
36.Cd "wmidell* at acpiwmibus?"
37.Cd "wmieeepc* at acpiwmibus?"
38.Cd "wmihp* at acpiwmibus?"
39.Cd "wmimsi* at acpiwmibus?"
40.Sh DESCRIPTION
41The
42.Nm
43device driver provides an
44.Tn ACPI
45interface for Windows Management Instrumentation
46.Pq Tn WMI .
47The
48.Tn ACPI
49.Tn WMI
50interface is typically used to support vendor
51specific features found in various laptops.
52.Pp
53The following
54.Tn WMI
55mappings are supported:
56.Bl -tag -width "wmidell " -offset indent
57.It Sy wmidell
58Dell laptops
59.It Sy wmieeepc
60Some models of Asus Eee PC
61.It Sy wmihp
62Hewlett-Packard laptops
63.It Sy wmimsi
64MSI laptops
65.El
66.Pp
67The functionality varies from vendor to vendor.
68Typically the interface is used for function and hotkey handling,
69but additional features may be present.
70.Sh SEE ALSO
71.Xr acpi 4 ,
72.Xr acpidalb 4
73.Rs
74.%A Microsoft Corporation
75.%D December 4, 2001
76.%T Windows Instrumentation: WMI and ACPI
77.%U http://www.microsoft.com/whdc/system/pnppwr/wmi/wmi-acpi.mspx
78.Re
79.Sh HISTORY
80The
81.Nm
82device driver appeared in
83.Nx 6.0 .
84.Sh AUTHORS
85.An Jukka Ruohonen
86.Aq Mt jruohonen@iki.fi
87wrote
88.Nm
89and most of the mappings.
90.Sh CAVEATS
91While
92.Tn WMI
93should provide a certain degree of portability across laptop
94models from a particular vendor, there is no guarantee that the mappings
95are functional in all models.
96.Pp
97The
98.Sy wmihp
99driver may conflict with
100.Xr hpqlb 4 .
101