1.\" 2.\" Copyright (c) 2015 The DragonFly Project. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 8.\" 1. Redistributions of source code must retain the above copyright 9.\" notice, this list of conditions and the following disclaimer. 10.\" 2. Redistributions in binary form must reproduce the above copyright 11.\" notice, this list of conditions and the following disclaimer in 12.\" the documentation and/or other materials provided with the 13.\" distribution. 14.\" 3. Neither the name of The DragonFly Project nor the names of its 15.\" contributors may be used to endorse or promote products derived 16.\" from this software without specific, prior written permission. 17.\" 18.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 19.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 20.\" LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS 21.\" FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE 22.\" COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, 23.\" INCIDENTAL, SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING, 24.\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 25.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED 26.\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 27.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT 28.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 29.\" SUCH DAMAGE. 30.\" 31.Dd August 31, 2015 32.Dt ACPICALL 8 33.Os 34.Sh NAME 35.Nm acpicall 36.Nd call ACPI methods 37.Sh SYNOPSIS 38.Nm 39.Op Fl hv 40.Op Fl b Ar hexstring 41.Op Fl d Ar file 42.Op Fl i Ar number 43.Op Fl o Ar i | s | b | o 44.Op Fl s Ar string 45.Ar path 46.Sh DESCRIPTION 47The 48.Nm 49utility calls the ACPI method 50.Ar path 51with the arguments specified by any 52.Fl b , 53.Fl i , 54.Fl o , 55and 56.Fl s 57options. 58The 59.Ar path 60argument must be a full ACPI namespace path such as 61.Pa \e_SB.PCI0.PEGR.GFX0._DSM . 62.Pp 63Note that in order to be able to use the 64.Nm 65utility, the 66.Va debug.acpi.allow_method_calls 67loader tunable must be specified in 68.Pa /boot/loader.conf . 69.Pp 70The following options are supported: 71.Bl -tag -width indent 72.It Fl b Ar hexstring 73Pass 74.Ar hexstring 75as a buffer argument. 76.It Fl d Ar file 77Specify the path of the ACPI control device. 78The default is 79.Pa /dev/acpi . 80.It Fl i Ar number 81Pass 82.Ar number 83as an integer argument. 84.It Fl o Ar i | s | b | o 85Choose the format to print the result in: 86.Ar ( i ) Ns nteger , 87.Ar ( s ) Ns tring , 88.Ar ( b ) Ns uffer , 89or 90.Ar ( o ) Ns bject . 91.It Fl s Ar string 92Pass 93.Ar string 94as a string argument. 95.It Fl v 96Increase verbosity. 97.El 98.Sh EXAMPLES 99Note that many ACPI methods are specific to the BIOS and machine in 100question, so it is impossible to present any generic examples that will 101work everywhere. 102Some familiarity with ASL and the DSDT code of the specific machine to 103be tweaked is highly recommended. 104.Pp 105The following calls were successfully used to turn off the discrete 106.Tn NVIDIA 107GPU on the 108.Tn Optimus 109based 110.Tn Asus K53SV 111laptop: 112.Bd -literal 113acpicall -b "f8d886a4da0b1b47a72b6042a6b5bee0" \e 114 -i 256 -i 26 -b "01000003" "\e_SB.PCI0.PEGR.GFX0._DSM" 115 116acpicall "\e_SB.PCI0.PEGR.GFX0._PS3" 117.Ed 118.Sh SEE ALSO 119.Xr acpi 4 , 120.Xr acpibin 8 , 121.Xr acpiconf 8 , 122.Xr acpidump 8 , 123.Xr acpiexec 8 , 124.Xr acpihelp 8 , 125.Xr acpinames 8 , 126.Xr acpixtract 8 , 127.Xr iasl 8 128.Sh AUTHORS 129.Nm 130is based on the 131.Nm acpi_call 132utility by 133.An Maxim Ignatenko Aq Mt gelraen.ua@gmail.com . 134This manual page was written by 135.An Sascha Wildner . 136