acpica/utilities/utosi.c

	utosi.c revision 7b1019a6d29ccb7999dc76cba3dde1c627e8e609
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte/******************************************************************************
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte *
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * Module Name: utosi - Support for the _OSI predefined control method
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte *
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte *****************************************************************************/
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte/*
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * Copyright (C) 2000 - 2016, Intel Corp.
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * All rights reserved.
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte *
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * Redistribution and use in source and binary forms, with or without
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * modification, are permitted provided that the following conditions
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * are met:
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * 1. Redistributions of source code must retain the above copyright
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte *    notice, this list of conditions, and the following disclaimer,
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte *    without modification.
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * 2. Redistributions in binary form must reproduce at minimum a disclaimer
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte *    substantially similar to the "NO WARRANTY" disclaimer below
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte *    ("Disclaimer") and any redistribution must be conditioned upon
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte *    including a substantially similar Disclaimer requirement for further
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte *    binary redistribution.
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * 3. Neither the names of the above-listed copyright holders nor the names
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte *    of any contributors may be used to endorse or promote products derived
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte *    from this software without specific prior written permission.
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte *
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * Alternatively, this software may be distributed under the terms of the
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * GNU General Public License ("GPL") version 2 as published by the Free
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * Software Foundation.
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte *
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * NO WARRANTY
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * POSSIBILITY OF SUCH DAMAGES.
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte */
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte#include "acpi.h"
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte#include "accommon.h"
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte#define _COMPONENT          ACPI_UTILITIES
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte        ACPI_MODULE_NAME    ("utosi")
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte/******************************************************************************
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte *
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * ACPICA policy for new _OSI strings:
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte *
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * It is the stated policy of ACPICA that new _OSI strings will be integrated
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * into this module as soon as possible after they are defined. It is strongly
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * recommended that all ACPICA hosts mirror this policy and integrate any
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * changes to this module as soon as possible. There are several historical
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * reasons behind this policy:
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte *
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * 1) New BIOSs tend to test only the case where the host responds TRUE to
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte *    the latest version of Windows, which would respond to the latest/newest
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte *    _OSI string. Not responding TRUE to the latest version of Windows will
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte *    risk executing untested code paths throughout the DSDT and SSDTs.
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte *
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * 2) If a new _OSI string is recognized only after a significant delay, this
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte *    has the potential to cause problems on existing working machines because
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte *    of the possibility that a new and different path through the ASL code
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte *    will be executed.
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte *
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * 3) New _OSI strings are tending to come out about once per year. A delay
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte *    in recognizing a new string for a significant amount of time risks the
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte *    release of another string which only compounds the initial problem.
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte *
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte *****************************************************************************/
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte/*
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * Strings supported by the _OSI predefined control method (which is
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * implemented internally within this module.)
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte *
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * March 2009: Removed "Linux" as this host no longer wants to respond true
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * for this string. Basically, the only safe OS strings are windows-related
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * and in many or most cases represent the only test path within the
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * BIOS-provided ASL code.
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte *
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * The last element of each entry is used to track the newest version of
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * Windows that the BIOS has requested.
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte */
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Fortestatic ACPI_INTERFACE_INFO    AcpiDefaultSupportedInterfaces[] =
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte{
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte    /* Operating System Vendor Strings */
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte    {"Windows 2000",        NULL, 0, ACPI_OSI_WIN_2000},         /* Windows 2000 */
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte    {"Windows 2001",        NULL, 0, ACPI_OSI_WIN_XP},           /* Windows XP */
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte    {"Windows 2001 SP1",    NULL, 0, ACPI_OSI_WIN_XP_SP1},       /* Windows XP SP1 */
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte    {"Windows 2001.1",      NULL, 0, ACPI_OSI_WINSRV_2003},      /* Windows Server 2003 */
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte    {"Windows 2001 SP2",    NULL, 0, ACPI_OSI_WIN_XP_SP2},       /* Windows XP SP2 */
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte    {"Windows 2001.1 SP1",  NULL, 0, ACPI_OSI_WINSRV_2003_SP1},  /* Windows Server 2003 SP1 - Added 03/2006 */
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte    {"Windows 2006",        NULL, 0, ACPI_OSI_WIN_VISTA},        /* Windows Vista - Added 03/2006 */
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte    {"Windows 2006.1",      NULL, 0, ACPI_OSI_WINSRV_2008},      /* Windows Server 2008 - Added 09/2009 */
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte    {"Windows 2006 SP1",    NULL, 0, ACPI_OSI_WIN_VISTA_SP1},    /* Windows Vista SP1 - Added 09/2009 */
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte    {"Windows 2006 SP2",    NULL, 0, ACPI_OSI_WIN_VISTA_SP2},    /* Windows Vista SP2 - Added 09/2010 */
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte    {"Windows 2009",        NULL, 0, ACPI_OSI_WIN_7},            /* Windows 7 and Server 2008 R2 - Added 09/2009 */
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte    /*
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte     * XXX
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte     * The following OSes are temporarily disabled. Windows introduced
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte     * support for xhci (USB 3.0) in Windows 8. When we advertise Windows 8
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte     * and newer support, some vendors use that as a key to automatically
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte     * transition all USB ports to the xhci controller. Until we have
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte     * support for the xhci controller, we should not advertise these
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte     * operating systems. From a brief survey, there isn't too much other
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte     * AML that this impacts at this time.
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte     */
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte/*    {"Windows 2012",        NULL, 0, ACPI_OSI_WIN_8},*/            /* Windows 8 and Server 2012 - Added 08/2012 */
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte/*    {"Windows 2013",        NULL, 0, ACPI_OSI_WIN_8},*/            /* Windows 8.1 and Server 2012 R2 - Added 01/2014 */
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte/*    {"Windows 2015",        NULL, 0, ACPI_OSI_WIN_10},*/           /* Windows 10 - Added 03/2015 */
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte    /* Feature Group Strings */
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte    {"Extended Address Space Descriptor", NULL, ACPI_OSI_FEATURE, 0},
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte    /*
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte     * All "optional" feature group strings (features that are implemented
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte     * by the host) should be dynamically modified to VALID by the host via
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte     * AcpiInstallInterface or AcpiUpdateInterfaces. Such optional feature
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte     * group strings are set as INVALID by default here.
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte     */
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte    {"Module Device",               NULL, ACPI_OSI_OPTIONAL_FEATURE, 0},
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte    {"Processor Device",            NULL, ACPI_OSI_OPTIONAL_FEATURE, 0},
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte    {"3.0 Thermal Model",           NULL, ACPI_OSI_OPTIONAL_FEATURE, 0},
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte    {"3.0 _SCP Extensions",         NULL, ACPI_OSI_OPTIONAL_FEATURE, 0},
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte    {"Processor Aggregator Device", NULL, ACPI_OSI_OPTIONAL_FEATURE, 0}
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte};
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte/*******************************************************************************
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte *
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * FUNCTION:    AcpiUtInitializeInterfaces
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte *
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * PARAMETERS:  None
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte *
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * RETURN:      Status
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte *
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * DESCRIPTION: Initialize the global _OSI supported interfaces list
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte *
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte ******************************************************************************/
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn ForteACPI_STATUS
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn ForteAcpiUtInitializeInterfaces (
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte    void)
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte{
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte    ACPI_STATUS             Status;
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte    UINT32                  i;
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte    Status = AcpiOsAcquireMutex (AcpiGbl_OsiMutex, ACPI_WAIT_FOREVER);
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte    if (ACPI_FAILURE (Status))
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte    {
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte        return (Status);
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte    }
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte    AcpiGbl_SupportedInterfaces = AcpiDefaultSupportedInterfaces;
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte    /* Link the static list of supported interfaces */
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte    for (i = 0;
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte        i < (ACPI_ARRAY_LENGTH (AcpiDefaultSupportedInterfaces) - 1);
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte        i++)
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte    {
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte        AcpiDefaultSupportedInterfaces[i].Next =
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte            &AcpiDefaultSupportedInterfaces[(ACPI_SIZE) i + 1];
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte    }
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte    AcpiOsReleaseMutex (AcpiGbl_OsiMutex);
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte    return (AE_OK);
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte}
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte/*******************************************************************************
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte *
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * FUNCTION:    AcpiUtInterfaceTerminate
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte *
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * PARAMETERS:  None
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte *
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * RETURN:      Status
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte *
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * DESCRIPTION: Delete all interfaces in the global list. Sets
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte *              AcpiGbl_SupportedInterfaces to NULL.
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte *
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte ******************************************************************************/
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn ForteACPI_STATUS
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn ForteAcpiUtInterfaceTerminate (
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte    void)
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte{
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte    ACPI_STATUS             Status;
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte    ACPI_INTERFACE_INFO     *NextInterface;
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte    Status = AcpiOsAcquireMutex (AcpiGbl_OsiMutex, ACPI_WAIT_FOREVER);
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte    if (ACPI_FAILURE (Status))
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte    {
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte        return (Status);
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte    }
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte    NextInterface = AcpiGbl_SupportedInterfaces;
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte    while (NextInterface)
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte    {
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte        AcpiGbl_SupportedInterfaces = NextInterface->Next;
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte        if (NextInterface->Flags & ACPI_OSI_DYNAMIC)
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte        {
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte            /* Only interfaces added at runtime can be freed */
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte            ACPI_FREE (NextInterface->Name);
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte            ACPI_FREE (NextInterface);
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte        }
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte        else
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte        {
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte            /* Interface is in static list. Reset it to invalid or valid. */
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte            if (NextInterface->Flags & ACPI_OSI_DEFAULT_INVALID)
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte            {
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte                NextInterface->Flags |= ACPI_OSI_INVALID;
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte            }
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte            else
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte            {
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte                NextInterface->Flags &= ~ACPI_OSI_INVALID;
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte            }
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte        }
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte        NextInterface = AcpiGbl_SupportedInterfaces;
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte    }
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte    AcpiOsReleaseMutex (AcpiGbl_OsiMutex);
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte    return (AE_OK);
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte}
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte/*******************************************************************************
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte *
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * FUNCTION:    AcpiUtInstallInterface
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte *
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * PARAMETERS:  InterfaceName       - The interface to install
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte *
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * RETURN:      Status
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte *
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte * DESCRIPTION: Install the interface into the global interface list.
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte *              Caller MUST hold AcpiGbl_OsiMutex
fcf3ce441efd61da9bb2884968af01cb7c1452ccJohn Forte *
 ******************************************************************************/

ACPI_STATUS
AcpiUtInstallInterface (
    ACPI_STRING             InterfaceName)
{
    ACPI_INTERFACE_INFO     *InterfaceInfo;


    /* Allocate info block and space for the name string */

    InterfaceInfo = ACPI_ALLOCATE_ZEROED (sizeof (ACPI_INTERFACE_INFO));
    if (!InterfaceInfo)
    {
        return (AE_NO_MEMORY);
    }

    InterfaceInfo->Name = ACPI_ALLOCATE_ZEROED (strlen (InterfaceName) + 1);
    if (!InterfaceInfo->Name)
    {
        ACPI_FREE (InterfaceInfo);
        return (AE_NO_MEMORY);
    }

    /* Initialize new info and insert at the head of the global list */

    strcpy (InterfaceInfo->Name, InterfaceName);
    InterfaceInfo->Flags = ACPI_OSI_DYNAMIC;
    InterfaceInfo->Next = AcpiGbl_SupportedInterfaces;

    AcpiGbl_SupportedInterfaces = InterfaceInfo;
    return (AE_OK);
}


/*******************************************************************************
 *
 * FUNCTION:    AcpiUtRemoveInterface
 *
 * PARAMETERS:  InterfaceName       - The interface to remove
 *
 * RETURN:      Status
 *
 * DESCRIPTION: Remove the interface from the global interface list.
 *              Caller MUST hold AcpiGbl_OsiMutex
 *
 ******************************************************************************/

ACPI_STATUS
AcpiUtRemoveInterface (
    ACPI_STRING             InterfaceName)
{
    ACPI_INTERFACE_INFO     *PreviousInterface;
    ACPI_INTERFACE_INFO     *NextInterface;


    PreviousInterface = NextInterface = AcpiGbl_SupportedInterfaces;
    while (NextInterface)
    {
        if (!strcmp (InterfaceName, NextInterface->Name))
        {
            /*
             * Found: name is in either the static list
             * or was added at runtime
             */
            if (NextInterface->Flags & ACPI_OSI_DYNAMIC)
            {
                /* Interface was added dynamically, remove and free it */

                if (PreviousInterface == NextInterface)
                {
                    AcpiGbl_SupportedInterfaces = NextInterface->Next;
                }
                else
                {
                    PreviousInterface->Next = NextInterface->Next;
                }

                ACPI_FREE (NextInterface->Name);
                ACPI_FREE (NextInterface);
            }
            else
            {
                /*
                 * Interface is in static list. If marked invalid, then
                 * it does not actually exist. Else, mark it invalid.
                 */
                if (NextInterface->Flags & ACPI_OSI_INVALID)
                {
                    return (AE_NOT_EXIST);
                }

                NextInterface->Flags |= ACPI_OSI_INVALID;
            }

            return (AE_OK);
        }

        PreviousInterface = NextInterface;
        NextInterface = NextInterface->Next;
    }

    /* Interface was not found */

    return (AE_NOT_EXIST);
}


/*******************************************************************************
 *
 * FUNCTION:    AcpiUtUpdateInterfaces
 *
 * PARAMETERS:  Action              - Actions to be performed during the
 *                                    update
 *
 * RETURN:      Status
 *
 * DESCRIPTION: Update _OSI interface strings, disabling or enabling OS vendor
 *              strings or/and feature group strings.
 *              Caller MUST hold AcpiGbl_OsiMutex
 *
 ******************************************************************************/

ACPI_STATUS
AcpiUtUpdateInterfaces (
    UINT8                   Action)
{
    ACPI_INTERFACE_INFO     *NextInterface;


    NextInterface = AcpiGbl_SupportedInterfaces;
    while (NextInterface)
    {
        if (((NextInterface->Flags & ACPI_OSI_FEATURE) &&
             (Action & ACPI_FEATURE_STRINGS)) ||
            (!(NextInterface->Flags & ACPI_OSI_FEATURE) &&
             (Action & ACPI_VENDOR_STRINGS)))
        {
            if (Action & ACPI_DISABLE_INTERFACES)
            {
                /* Mark the interfaces as invalid */

                NextInterface->Flags |= ACPI_OSI_INVALID;
            }
            else
            {
                /* Mark the interfaces as valid */

                NextInterface->Flags &= ~ACPI_OSI_INVALID;
            }
        }

        NextInterface = NextInterface->Next;
    }

    return (AE_OK);
}


/*******************************************************************************
 *
 * FUNCTION:    AcpiUtGetInterface
 *
 * PARAMETERS:  InterfaceName       - The interface to find
 *
 * RETURN:      ACPI_INTERFACE_INFO if found. NULL if not found.
 *
 * DESCRIPTION: Search for the specified interface name in the global list.
 *              Caller MUST hold AcpiGbl_OsiMutex
 *
 ******************************************************************************/

ACPI_INTERFACE_INFO *
AcpiUtGetInterface (
    ACPI_STRING             InterfaceName)
{
    ACPI_INTERFACE_INFO     *NextInterface;


    NextInterface = AcpiGbl_SupportedInterfaces;
    while (NextInterface)
    {
        if (!strcmp (InterfaceName, NextInterface->Name))
        {
            return (NextInterface);
        }

        NextInterface = NextInterface->Next;
    }

    return (NULL);
}


/*******************************************************************************
 *
 * FUNCTION:    AcpiUtOsiImplementation
 *
 * PARAMETERS:  WalkState           - Current walk state
 *
 * RETURN:      Status
 *
 * DESCRIPTION: Implementation of the _OSI predefined control method. When
 *              an invocation of _OSI is encountered in the system AML,
 *              control is transferred to this function.
 *
 ******************************************************************************/

ACPI_STATUS
AcpiUtOsiImplementation (
    ACPI_WALK_STATE         *WalkState)
{
    ACPI_OPERAND_OBJECT     *StringDesc;
    ACPI_OPERAND_OBJECT     *ReturnDesc;
    ACPI_INTERFACE_INFO     *InterfaceInfo;
    ACPI_INTERFACE_HANDLER  InterfaceHandler;
    ACPI_STATUS             Status;
    UINT32                  ReturnValue;


    ACPI_FUNCTION_TRACE (UtOsiImplementation);


    /* Validate the string input argument (from the AML caller) */

    StringDesc = WalkState->Arguments[0].Object;
    if (!StringDesc ||
        (StringDesc->Common.Type != ACPI_TYPE_STRING))
    {
        return_ACPI_STATUS (AE_TYPE);
    }

    /* Create a return object */

    ReturnDesc = AcpiUtCreateInternalObject (ACPI_TYPE_INTEGER);
    if (!ReturnDesc)
    {
        return_ACPI_STATUS (AE_NO_MEMORY);
    }

    /* Default return value is 0, NOT SUPPORTED */

    ReturnValue = 0;
    Status = AcpiOsAcquireMutex (AcpiGbl_OsiMutex, ACPI_WAIT_FOREVER);
    if (ACPI_FAILURE (Status))
    {
        AcpiUtRemoveReference (ReturnDesc);
        return_ACPI_STATUS (Status);
    }

    /* Lookup the interface in the global _OSI list */

    InterfaceInfo = AcpiUtGetInterface (StringDesc->String.Pointer);
    if (InterfaceInfo &&
        !(InterfaceInfo->Flags & ACPI_OSI_INVALID))
    {
        /*
         * The interface is supported.
         * Update the OsiData if necessary. We keep track of the latest
         * version of Windows that has been requested by the BIOS.
         */
        if (InterfaceInfo->Value > AcpiGbl_OsiData)
        {
            AcpiGbl_OsiData = InterfaceInfo->Value;
        }

        ReturnValue = ACPI_UINT32_MAX;
    }

    AcpiOsReleaseMutex (AcpiGbl_OsiMutex);

    /*
     * Invoke an optional _OSI interface handler. The host OS may wish
     * to do some interface-specific handling. For example, warn about
     * certain interfaces or override the true/false support value.
     */
    InterfaceHandler = AcpiGbl_InterfaceHandler;
    if (InterfaceHandler)
    {
        ReturnValue = InterfaceHandler (
            StringDesc->String.Pointer, ReturnValue);
    }

    ACPI_DEBUG_PRINT_RAW ((ACPI_DB_INFO,
        "ACPI: BIOS _OSI(\"%s\") is %ssupported\n",
        StringDesc->String.Pointer, ReturnValue == 0 ? "not " : ""));

    /* Complete the return object */

    ReturnDesc->Integer.Value = ReturnValue;
    WalkState->ReturnDesc = ReturnDesc;
    return_ACPI_STATUS (AE_OK);
}