17c478bd9Sstevel@tonic-gate /*******************************************************************************
27c478bd9Sstevel@tonic-gate *
37c478bd9Sstevel@tonic-gate * Module Name: nsxfeval - Public interfaces to the ACPI subsystem
47c478bd9Sstevel@tonic-gate * ACPI Object evaluation interfaces
57c478bd9Sstevel@tonic-gate *
67c478bd9Sstevel@tonic-gate ******************************************************************************/
77c478bd9Sstevel@tonic-gate
8*35786f68SRobert Mustacchi /******************************************************************************
9*35786f68SRobert Mustacchi *
10*35786f68SRobert Mustacchi * 1. Copyright Notice
11*35786f68SRobert Mustacchi *
12*35786f68SRobert Mustacchi * Some or all of this work - Copyright (c) 1999 - 2018, Intel Corp.
137c478bd9Sstevel@tonic-gate * All rights reserved.
147c478bd9Sstevel@tonic-gate *
15*35786f68SRobert Mustacchi * 2. License
16*35786f68SRobert Mustacchi *
17*35786f68SRobert Mustacchi * 2.1. This is your license from Intel Corp. under its intellectual property
18*35786f68SRobert Mustacchi * rights. You may have additional license terms from the party that provided
19*35786f68SRobert Mustacchi * you this software, covering your right to use that party's intellectual
20*35786f68SRobert Mustacchi * property rights.
21*35786f68SRobert Mustacchi *
22*35786f68SRobert Mustacchi * 2.2. Intel grants, free of charge, to any person ("Licensee") obtaining a
23*35786f68SRobert Mustacchi * copy of the source code appearing in this file ("Covered Code") an
24*35786f68SRobert Mustacchi * irrevocable, perpetual, worldwide license under Intel's copyrights in the
25*35786f68SRobert Mustacchi * base code distributed originally by Intel ("Original Intel Code") to copy,
26*35786f68SRobert Mustacchi * make derivatives, distribute, use and display any portion of the Covered
27*35786f68SRobert Mustacchi * Code in any form, with the right to sublicense such rights; and
28*35786f68SRobert Mustacchi *
29*35786f68SRobert Mustacchi * 2.3. Intel grants Licensee a non-exclusive and non-transferable patent
30*35786f68SRobert Mustacchi * license (with the right to sublicense), under only those claims of Intel
31*35786f68SRobert Mustacchi * patents that are infringed by the Original Intel Code, to make, use, sell,
32*35786f68SRobert Mustacchi * offer to sell, and import the Covered Code and derivative works thereof
33*35786f68SRobert Mustacchi * solely to the minimum extent necessary to exercise the above copyright
34*35786f68SRobert Mustacchi * license, and in no event shall the patent license extend to any additions
35*35786f68SRobert Mustacchi * to or modifications of the Original Intel Code. No other license or right
36*35786f68SRobert Mustacchi * is granted directly or by implication, estoppel or otherwise;
37*35786f68SRobert Mustacchi *
38*35786f68SRobert Mustacchi * The above copyright and patent license is granted only if the following
39*35786f68SRobert Mustacchi * conditions are met:
40*35786f68SRobert Mustacchi *
41*35786f68SRobert Mustacchi * 3. Conditions
42*35786f68SRobert Mustacchi *
43*35786f68SRobert Mustacchi * 3.1. Redistribution of Source with Rights to Further Distribute Source.
44*35786f68SRobert Mustacchi * Redistribution of source code of any substantial portion of the Covered
45*35786f68SRobert Mustacchi * Code or modification with rights to further distribute source must include
46*35786f68SRobert Mustacchi * the above Copyright Notice, the above License, this list of Conditions,
47*35786f68SRobert Mustacchi * and the following Disclaimer and Export Compliance provision. In addition,
48*35786f68SRobert Mustacchi * Licensee must cause all Covered Code to which Licensee contributes to
49*35786f68SRobert Mustacchi * contain a file documenting the changes Licensee made to create that Covered
50*35786f68SRobert Mustacchi * Code and the date of any change. Licensee must include in that file the
51*35786f68SRobert Mustacchi * documentation of any changes made by any predecessor Licensee. Licensee
52*35786f68SRobert Mustacchi * must include a prominent statement that the modification is derived,
53*35786f68SRobert Mustacchi * directly or indirectly, from Original Intel Code.
54*35786f68SRobert Mustacchi *
55*35786f68SRobert Mustacchi * 3.2. Redistribution of Source with no Rights to Further Distribute Source.
56*35786f68SRobert Mustacchi * Redistribution of source code of any substantial portion of the Covered
57*35786f68SRobert Mustacchi * Code or modification without rights to further distribute source must
58*35786f68SRobert Mustacchi * include the following Disclaimer and Export Compliance provision in the
59*35786f68SRobert Mustacchi * documentation and/or other materials provided with distribution. In
60*35786f68SRobert Mustacchi * addition, Licensee may not authorize further sublicense of source of any
61*35786f68SRobert Mustacchi * portion of the Covered Code, and must include terms to the effect that the
62*35786f68SRobert Mustacchi * license from Licensee to its licensee is limited to the intellectual
63*35786f68SRobert Mustacchi * property embodied in the software Licensee provides to its licensee, and
64*35786f68SRobert Mustacchi * not to intellectual property embodied in modifications its licensee may
65*35786f68SRobert Mustacchi * make.
66*35786f68SRobert Mustacchi *
67*35786f68SRobert Mustacchi * 3.3. Redistribution of Executable. Redistribution in executable form of any
68*35786f68SRobert Mustacchi * substantial portion of the Covered Code or modification must reproduce the
69*35786f68SRobert Mustacchi * above Copyright Notice, and the following Disclaimer and Export Compliance
70*35786f68SRobert Mustacchi * provision in the documentation and/or other materials provided with the
71*35786f68SRobert Mustacchi * distribution.
72*35786f68SRobert Mustacchi *
73*35786f68SRobert Mustacchi * 3.4. Intel retains all right, title, and interest in and to the Original
74*35786f68SRobert Mustacchi * Intel Code.
75*35786f68SRobert Mustacchi *
76*35786f68SRobert Mustacchi * 3.5. Neither the name Intel nor any other trademark owned or controlled by
77*35786f68SRobert Mustacchi * Intel shall be used in advertising or otherwise to promote the sale, use or
78*35786f68SRobert Mustacchi * other dealings in products derived from or relating to the Covered Code
79*35786f68SRobert Mustacchi * without prior written authorization from Intel.
80*35786f68SRobert Mustacchi *
81*35786f68SRobert Mustacchi * 4. Disclaimer and Export Compliance
82*35786f68SRobert Mustacchi *
83*35786f68SRobert Mustacchi * 4.1. INTEL MAKES NO WARRANTY OF ANY KIND REGARDING ANY SOFTWARE PROVIDED
84*35786f68SRobert Mustacchi * HERE. ANY SOFTWARE ORIGINATING FROM INTEL OR DERIVED FROM INTEL SOFTWARE
85*35786f68SRobert Mustacchi * IS PROVIDED "AS IS," AND INTEL WILL NOT PROVIDE ANY SUPPORT, ASSISTANCE,
86*35786f68SRobert Mustacchi * INSTALLATION, TRAINING OR OTHER SERVICES. INTEL WILL NOT PROVIDE ANY
87*35786f68SRobert Mustacchi * UPDATES, ENHANCEMENTS OR EXTENSIONS. INTEL SPECIFICALLY DISCLAIMS ANY
88*35786f68SRobert Mustacchi * IMPLIED WARRANTIES OF MERCHANTABILITY, NONINFRINGEMENT AND FITNESS FOR A
89*35786f68SRobert Mustacchi * PARTICULAR PURPOSE.
90*35786f68SRobert Mustacchi *
91*35786f68SRobert Mustacchi * 4.2. IN NO EVENT SHALL INTEL HAVE ANY LIABILITY TO LICENSEE, ITS LICENSEES
92*35786f68SRobert Mustacchi * OR ANY OTHER THIRD PARTY, FOR ANY LOST PROFITS, LOST DATA, LOSS OF USE OR
93*35786f68SRobert Mustacchi * COSTS OF PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES, OR FOR ANY INDIRECT,
94*35786f68SRobert Mustacchi * SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THIS AGREEMENT, UNDER ANY
95*35786f68SRobert Mustacchi * CAUSE OF ACTION OR THEORY OF LIABILITY, AND IRRESPECTIVE OF WHETHER INTEL
96*35786f68SRobert Mustacchi * HAS ADVANCE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES. THESE LIMITATIONS
97*35786f68SRobert Mustacchi * SHALL APPLY NOTWITHSTANDING THE FAILURE OF THE ESSENTIAL PURPOSE OF ANY
98*35786f68SRobert Mustacchi * LIMITED REMEDY.
99*35786f68SRobert Mustacchi *
100*35786f68SRobert Mustacchi * 4.3. Licensee shall not export, either directly or indirectly, any of this
101*35786f68SRobert Mustacchi * software or system incorporating such software without first obtaining any
102*35786f68SRobert Mustacchi * required license or other approval from the U. S. Department of Commerce or
103*35786f68SRobert Mustacchi * any other agency or department of the United States Government. In the
104*35786f68SRobert Mustacchi * event Licensee exports any such software from the United States or
105*35786f68SRobert Mustacchi * re-exports any such software from a foreign destination, Licensee shall
106*35786f68SRobert Mustacchi * ensure that the distribution and export/re-export of the software is in
107*35786f68SRobert Mustacchi * compliance with all laws, regulations, orders, or other restrictions of the
108*35786f68SRobert Mustacchi * U.S. Export Administration Regulations. Licensee agrees that neither it nor
109*35786f68SRobert Mustacchi * any of its subsidiaries will export/re-export any technical data, process,
110*35786f68SRobert Mustacchi * software, or service, directly or indirectly, to any country for which the
111*35786f68SRobert Mustacchi * United States government or any agency thereof requires an export license,
112*35786f68SRobert Mustacchi * other governmental approval, or letter of assurance, without first obtaining
113*35786f68SRobert Mustacchi * such license, approval or letter.
114*35786f68SRobert Mustacchi *
115*35786f68SRobert Mustacchi *****************************************************************************
116*35786f68SRobert Mustacchi *
117*35786f68SRobert Mustacchi * Alternatively, you may choose to be licensed under the terms of the
118*35786f68SRobert Mustacchi * following license:
119*35786f68SRobert Mustacchi *
12026f3cdf0SGordon Ross * Redistribution and use in source and binary forms, with or without
12126f3cdf0SGordon Ross * modification, are permitted provided that the following conditions
12226f3cdf0SGordon Ross * are met:
12326f3cdf0SGordon Ross * 1. Redistributions of source code must retain the above copyright
12426f3cdf0SGordon Ross * notice, this list of conditions, and the following disclaimer,
12526f3cdf0SGordon Ross * without modification.
12626f3cdf0SGordon Ross * 2. Redistributions in binary form must reproduce at minimum a disclaimer
12726f3cdf0SGordon Ross * substantially similar to the "NO WARRANTY" disclaimer below
12826f3cdf0SGordon Ross * ("Disclaimer") and any redistribution must be conditioned upon
12926f3cdf0SGordon Ross * including a substantially similar Disclaimer requirement for further
13026f3cdf0SGordon Ross * binary redistribution.
13126f3cdf0SGordon Ross * 3. Neither the names of the above-listed copyright holders nor the names
13226f3cdf0SGordon Ross * of any contributors may be used to endorse or promote products derived
13326f3cdf0SGordon Ross * from this software without specific prior written permission.
13426f3cdf0SGordon Ross *
13526f3cdf0SGordon Ross * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
13626f3cdf0SGordon Ross * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
137*35786f68SRobert Mustacchi * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
13826f3cdf0SGordon Ross * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
139*35786f68SRobert Mustacchi * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
140*35786f68SRobert Mustacchi * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
141*35786f68SRobert Mustacchi * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
142*35786f68SRobert Mustacchi * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
143*35786f68SRobert Mustacchi * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
144*35786f68SRobert Mustacchi * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
145*35786f68SRobert Mustacchi * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
146*35786f68SRobert Mustacchi *
147*35786f68SRobert Mustacchi * Alternatively, you may choose to be licensed under the terms of the
148*35786f68SRobert Mustacchi * GNU General Public License ("GPL") version 2 as published by the Free
149*35786f68SRobert Mustacchi * Software Foundation.
150*35786f68SRobert Mustacchi *
151*35786f68SRobert Mustacchi *****************************************************************************/
1527c478bd9Sstevel@tonic-gate
1537b1019a6SJerry Jelinek #define EXPORT_ACPI_INTERFACES
1547c478bd9Sstevel@tonic-gate
1557c478bd9Sstevel@tonic-gate #include "acpi.h"
156aa2aa9a6SDana Myers #include "accommon.h"
1577c478bd9Sstevel@tonic-gate #include "acnamesp.h"
1587c478bd9Sstevel@tonic-gate #include "acinterp.h"
1597c478bd9Sstevel@tonic-gate
1607c478bd9Sstevel@tonic-gate
1617c478bd9Sstevel@tonic-gate #define _COMPONENT ACPI_NAMESPACE
1627c478bd9Sstevel@tonic-gate ACPI_MODULE_NAME ("nsxfeval")
1637c478bd9Sstevel@tonic-gate
164db2bae30SDana Myers /* Local prototypes */
165db2bae30SDana Myers
166db2bae30SDana Myers static void
167db2bae30SDana Myers AcpiNsResolveReferences (
168db2bae30SDana Myers ACPI_EVALUATE_INFO *Info);
169db2bae30SDana Myers
1707c478bd9Sstevel@tonic-gate
1717c478bd9Sstevel@tonic-gate /*******************************************************************************
1727c478bd9Sstevel@tonic-gate *
1737c478bd9Sstevel@tonic-gate * FUNCTION: AcpiEvaluateObjectTyped
1747c478bd9Sstevel@tonic-gate *
1757c478bd9Sstevel@tonic-gate * PARAMETERS: Handle - Object handle (optional)
1767c478bd9Sstevel@tonic-gate * Pathname - Object pathname (optional)
177*35786f68SRobert Mustacchi * ExternalParams - List of parameters to pass to a method,
1787b1019a6SJerry Jelinek * terminated by NULL. May be NULL
1797c478bd9Sstevel@tonic-gate * if no parameters are being passed.
180*35786f68SRobert Mustacchi * ReturnBuffer - Where to put the object return value (if
181*35786f68SRobert Mustacchi * any). Required.
1827c478bd9Sstevel@tonic-gate * ReturnType - Expected type of return object
1837c478bd9Sstevel@tonic-gate *
1847c478bd9Sstevel@tonic-gate * RETURN: Status
1857c478bd9Sstevel@tonic-gate *
1867c478bd9Sstevel@tonic-gate * DESCRIPTION: Find and evaluate the given object, passing the given
1877b1019a6SJerry Jelinek * parameters if necessary. One of "Handle" or "Pathname" must
1887c478bd9Sstevel@tonic-gate * be valid (non-null)
1897c478bd9Sstevel@tonic-gate *
1907c478bd9Sstevel@tonic-gate ******************************************************************************/
1917c478bd9Sstevel@tonic-gate
1927c478bd9Sstevel@tonic-gate ACPI_STATUS
AcpiEvaluateObjectTyped(ACPI_HANDLE Handle,ACPI_STRING Pathname,ACPI_OBJECT_LIST * ExternalParams,ACPI_BUFFER * ReturnBuffer,ACPI_OBJECT_TYPE ReturnType)1937c478bd9Sstevel@tonic-gate AcpiEvaluateObjectTyped (
1947c478bd9Sstevel@tonic-gate ACPI_HANDLE Handle,
1957c478bd9Sstevel@tonic-gate ACPI_STRING Pathname,
1967c478bd9Sstevel@tonic-gate ACPI_OBJECT_LIST *ExternalParams,
1977c478bd9Sstevel@tonic-gate ACPI_BUFFER *ReturnBuffer,
1987c478bd9Sstevel@tonic-gate ACPI_OBJECT_TYPE ReturnType)
1997c478bd9Sstevel@tonic-gate {
2007c478bd9Sstevel@tonic-gate ACPI_STATUS Status;
2017b1019a6SJerry Jelinek BOOLEAN FreeBufferOnError = FALSE;
202*35786f68SRobert Mustacchi ACPI_HANDLE TargetHandle;
203*35786f68SRobert Mustacchi char *FullPathname;
2047c478bd9Sstevel@tonic-gate
2057c478bd9Sstevel@tonic-gate
20627f7c583Smyers ACPI_FUNCTION_TRACE (AcpiEvaluateObjectTyped);
2077c478bd9Sstevel@tonic-gate
2087c478bd9Sstevel@tonic-gate
2097c478bd9Sstevel@tonic-gate /* Return buffer must be valid */
2107c478bd9Sstevel@tonic-gate
2117c478bd9Sstevel@tonic-gate if (!ReturnBuffer)
2127c478bd9Sstevel@tonic-gate {
2137c478bd9Sstevel@tonic-gate return_ACPI_STATUS (AE_BAD_PARAMETER);
2147c478bd9Sstevel@tonic-gate }
2157c478bd9Sstevel@tonic-gate
2167c478bd9Sstevel@tonic-gate if (ReturnBuffer->Length == ACPI_ALLOCATE_BUFFER)
2177c478bd9Sstevel@tonic-gate {
2187b1019a6SJerry Jelinek FreeBufferOnError = TRUE;
2197c478bd9Sstevel@tonic-gate }
2207c478bd9Sstevel@tonic-gate
221*35786f68SRobert Mustacchi /* Get a handle here, in order to build an error message if needed */
222*35786f68SRobert Mustacchi
223*35786f68SRobert Mustacchi TargetHandle = Handle;
224*35786f68SRobert Mustacchi if (Pathname)
225*35786f68SRobert Mustacchi {
226*35786f68SRobert Mustacchi Status = AcpiGetHandle (Handle, Pathname, &TargetHandle);
227*35786f68SRobert Mustacchi if (ACPI_FAILURE (Status))
228*35786f68SRobert Mustacchi {
229*35786f68SRobert Mustacchi return_ACPI_STATUS (Status);
230*35786f68SRobert Mustacchi }
231*35786f68SRobert Mustacchi }
232*35786f68SRobert Mustacchi
233*35786f68SRobert Mustacchi FullPathname = AcpiNsGetExternalPathname (TargetHandle);
234*35786f68SRobert Mustacchi if (!FullPathname)
235*35786f68SRobert Mustacchi {
236*35786f68SRobert Mustacchi return_ACPI_STATUS (AE_NO_MEMORY);
237*35786f68SRobert Mustacchi }
238*35786f68SRobert Mustacchi
2397c478bd9Sstevel@tonic-gate /* Evaluate the object */
2407c478bd9Sstevel@tonic-gate
241*35786f68SRobert Mustacchi Status = AcpiEvaluateObject (TargetHandle, NULL, ExternalParams,
242*35786f68SRobert Mustacchi ReturnBuffer);
2437c478bd9Sstevel@tonic-gate if (ACPI_FAILURE (Status))
2447c478bd9Sstevel@tonic-gate {
245*35786f68SRobert Mustacchi goto Exit;
2467c478bd9Sstevel@tonic-gate }
2477c478bd9Sstevel@tonic-gate
248*35786f68SRobert Mustacchi /* Type ANY means "don't care about return value type" */
2497c478bd9Sstevel@tonic-gate
2507c478bd9Sstevel@tonic-gate if (ReturnType == ACPI_TYPE_ANY)
2517c478bd9Sstevel@tonic-gate {
252*35786f68SRobert Mustacchi goto Exit;
2537c478bd9Sstevel@tonic-gate }
2547c478bd9Sstevel@tonic-gate
2557c478bd9Sstevel@tonic-gate if (ReturnBuffer->Length == 0)
2567c478bd9Sstevel@tonic-gate {
2577c478bd9Sstevel@tonic-gate /* Error because caller specifically asked for a return value */
2587c478bd9Sstevel@tonic-gate
259*35786f68SRobert Mustacchi ACPI_ERROR ((AE_INFO, "%s did not return any object",
260*35786f68SRobert Mustacchi FullPathname));
261*35786f68SRobert Mustacchi Status = AE_NULL_OBJECT;
262*35786f68SRobert Mustacchi goto Exit;
2637c478bd9Sstevel@tonic-gate }
2647c478bd9Sstevel@tonic-gate
2657c478bd9Sstevel@tonic-gate /* Examine the object type returned from EvaluateObject */
2667c478bd9Sstevel@tonic-gate
2677c478bd9Sstevel@tonic-gate if (((ACPI_OBJECT *) ReturnBuffer->Pointer)->Type == ReturnType)
2687c478bd9Sstevel@tonic-gate {
269*35786f68SRobert Mustacchi goto Exit;
2707c478bd9Sstevel@tonic-gate }
2717c478bd9Sstevel@tonic-gate
2727c478bd9Sstevel@tonic-gate /* Return object type does not match requested type */
2737c478bd9Sstevel@tonic-gate
27430082d0cSmyers ACPI_ERROR ((AE_INFO,
275*35786f68SRobert Mustacchi "Incorrect return type from %s - received [%s], requested [%s]",
276*35786f68SRobert Mustacchi FullPathname,
2777c478bd9Sstevel@tonic-gate AcpiUtGetTypeName (((ACPI_OBJECT *) ReturnBuffer->Pointer)->Type),
2787c478bd9Sstevel@tonic-gate AcpiUtGetTypeName (ReturnType)));
2797c478bd9Sstevel@tonic-gate
2807b1019a6SJerry Jelinek if (FreeBufferOnError)
2817c478bd9Sstevel@tonic-gate {
2827b1019a6SJerry Jelinek /*
2837b1019a6SJerry Jelinek * Free a buffer created via ACPI_ALLOCATE_BUFFER.
2847b1019a6SJerry Jelinek * Note: We use AcpiOsFree here because AcpiOsAllocate was used
2857b1019a6SJerry Jelinek * to allocate the buffer. This purposefully bypasses the
2867b1019a6SJerry Jelinek * (optionally enabled) allocation tracking mechanism since we
2877b1019a6SJerry Jelinek * only want to track internal allocations.
2887b1019a6SJerry Jelinek */
2897c478bd9Sstevel@tonic-gate AcpiOsFree (ReturnBuffer->Pointer);
2907c478bd9Sstevel@tonic-gate ReturnBuffer->Pointer = NULL;
2917c478bd9Sstevel@tonic-gate }
2927c478bd9Sstevel@tonic-gate
2937c478bd9Sstevel@tonic-gate ReturnBuffer->Length = 0;
294*35786f68SRobert Mustacchi Status = AE_TYPE;
295*35786f68SRobert Mustacchi
296*35786f68SRobert Mustacchi Exit:
297*35786f68SRobert Mustacchi ACPI_FREE (FullPathname);
298*35786f68SRobert Mustacchi return_ACPI_STATUS (Status);
2997c478bd9Sstevel@tonic-gate }
3007c478bd9Sstevel@tonic-gate
ACPI_EXPORT_SYMBOL(AcpiEvaluateObjectTyped)30127f7c583Smyers ACPI_EXPORT_SYMBOL (AcpiEvaluateObjectTyped)
30227f7c583Smyers
3037c478bd9Sstevel@tonic-gate
3047c478bd9Sstevel@tonic-gate /*******************************************************************************
3057c478bd9Sstevel@tonic-gate *
3067c478bd9Sstevel@tonic-gate * FUNCTION: AcpiEvaluateObject
3077c478bd9Sstevel@tonic-gate *
3087c478bd9Sstevel@tonic-gate * PARAMETERS: Handle - Object handle (optional)
3097c478bd9Sstevel@tonic-gate * Pathname - Object pathname (optional)
3107c478bd9Sstevel@tonic-gate * ExternalParams - List of parameters to pass to method,
3117b1019a6SJerry Jelinek * terminated by NULL. May be NULL
3127c478bd9Sstevel@tonic-gate * if no parameters are being passed.
3137c478bd9Sstevel@tonic-gate * ReturnBuffer - Where to put method's return value (if
3147b1019a6SJerry Jelinek * any). If NULL, no value is returned.
3157c478bd9Sstevel@tonic-gate *
3167c478bd9Sstevel@tonic-gate * RETURN: Status
3177c478bd9Sstevel@tonic-gate *
3187c478bd9Sstevel@tonic-gate * DESCRIPTION: Find and evaluate the given object, passing the given
3197b1019a6SJerry Jelinek * parameters if necessary. One of "Handle" or "Pathname" must
3207c478bd9Sstevel@tonic-gate * be valid (non-null)
3217c478bd9Sstevel@tonic-gate *
3227c478bd9Sstevel@tonic-gate ******************************************************************************/
3237c478bd9Sstevel@tonic-gate
3247c478bd9Sstevel@tonic-gate ACPI_STATUS
3257c478bd9Sstevel@tonic-gate AcpiEvaluateObject (
3267c478bd9Sstevel@tonic-gate ACPI_HANDLE Handle,
3277c478bd9Sstevel@tonic-gate ACPI_STRING Pathname,
3287c478bd9Sstevel@tonic-gate ACPI_OBJECT_LIST *ExternalParams,
3297c478bd9Sstevel@tonic-gate ACPI_BUFFER *ReturnBuffer)
3307c478bd9Sstevel@tonic-gate {
3317c478bd9Sstevel@tonic-gate ACPI_STATUS Status;
33227f7c583Smyers ACPI_EVALUATE_INFO *Info;
3337c478bd9Sstevel@tonic-gate ACPI_SIZE BufferSpaceNeeded;
3347c478bd9Sstevel@tonic-gate UINT32 i;
3357c478bd9Sstevel@tonic-gate
3367c478bd9Sstevel@tonic-gate
33727f7c583Smyers ACPI_FUNCTION_TRACE (AcpiEvaluateObject);
33827f7c583Smyers
33927f7c583Smyers
34027f7c583Smyers /* Allocate and initialize the evaluation information block */
3417c478bd9Sstevel@tonic-gate
34227f7c583Smyers Info = ACPI_ALLOCATE_ZEROED (sizeof (ACPI_EVALUATE_INFO));
34327f7c583Smyers if (!Info)
34427f7c583Smyers {
34527f7c583Smyers return_ACPI_STATUS (AE_NO_MEMORY);
34627f7c583Smyers }
3477c478bd9Sstevel@tonic-gate
34827f7c583Smyers /* Convert and validate the device handle */
34927f7c583Smyers
35026f3cdf0SGordon Ross Info->PrefixNode = AcpiNsValidateHandle (Handle);
35127f7c583Smyers if (!Info->PrefixNode)
35227f7c583Smyers {
35327f7c583Smyers Status = AE_BAD_PARAMETER;
35427f7c583Smyers goto Cleanup;
35527f7c583Smyers }
3567c478bd9Sstevel@tonic-gate
3577c478bd9Sstevel@tonic-gate /*
3587b1019a6SJerry Jelinek * Get the actual namespace node for the target object.
3597b1019a6SJerry Jelinek * Handles these cases:
3607b1019a6SJerry Jelinek *
3617b1019a6SJerry Jelinek * 1) Null node, valid pathname from root (absolute path)
3627b1019a6SJerry Jelinek * 2) Node and valid pathname (path relative to Node)
3637b1019a6SJerry Jelinek * 3) Node, Null pathname
3647b1019a6SJerry Jelinek */
3657b1019a6SJerry Jelinek if ((Pathname) &&
3667b1019a6SJerry Jelinek (ACPI_IS_ROOT_PREFIX (Pathname[0])))
3677b1019a6SJerry Jelinek {
3687b1019a6SJerry Jelinek /* The path is fully qualified, just evaluate by name */
3697b1019a6SJerry Jelinek
3707b1019a6SJerry Jelinek Info->PrefixNode = NULL;
3717b1019a6SJerry Jelinek }
3727b1019a6SJerry Jelinek else if (!Handle)
3737b1019a6SJerry Jelinek {
3747b1019a6SJerry Jelinek /*
3757b1019a6SJerry Jelinek * A handle is optional iff a fully qualified pathname is specified.
3767b1019a6SJerry Jelinek * Since we've already handled fully qualified names above, this is
3777b1019a6SJerry Jelinek * an error.
3787b1019a6SJerry Jelinek */
3797b1019a6SJerry Jelinek if (!Pathname)
3807b1019a6SJerry Jelinek {
3817b1019a6SJerry Jelinek ACPI_DEBUG_PRINT ((ACPI_DB_INFO,
3827b1019a6SJerry Jelinek "Both Handle and Pathname are NULL"));
3837b1019a6SJerry Jelinek }
3847b1019a6SJerry Jelinek else
3857b1019a6SJerry Jelinek {
3867b1019a6SJerry Jelinek ACPI_DEBUG_PRINT ((ACPI_DB_INFO,
3877b1019a6SJerry Jelinek "Null Handle with relative pathname [%s]", Pathname));
3887b1019a6SJerry Jelinek }
3897b1019a6SJerry Jelinek
3907b1019a6SJerry Jelinek Status = AE_BAD_PARAMETER;
3917b1019a6SJerry Jelinek goto Cleanup;
3927b1019a6SJerry Jelinek }
3937b1019a6SJerry Jelinek
3947b1019a6SJerry Jelinek Info->RelativePathname = Pathname;
3957b1019a6SJerry Jelinek
3967b1019a6SJerry Jelinek /*
3977b1019a6SJerry Jelinek * Convert all external objects passed as arguments to the
3987b1019a6SJerry Jelinek * internal version(s).
3997c478bd9Sstevel@tonic-gate */
4007c478bd9Sstevel@tonic-gate if (ExternalParams && ExternalParams->Count)
4017c478bd9Sstevel@tonic-gate {
4027b1019a6SJerry Jelinek Info->ParamCount = (UINT16) ExternalParams->Count;
4037b1019a6SJerry Jelinek
4047b1019a6SJerry Jelinek /* Warn on impossible argument count */
4057b1019a6SJerry Jelinek
4067b1019a6SJerry Jelinek if (Info->ParamCount > ACPI_METHOD_NUM_ARGS)
4077b1019a6SJerry Jelinek {
4087b1019a6SJerry Jelinek ACPI_WARN_PREDEFINED ((AE_INFO, Pathname, ACPI_WARN_ALWAYS,
4097b1019a6SJerry Jelinek "Excess arguments (%u) - using only %u",
4107b1019a6SJerry Jelinek Info->ParamCount, ACPI_METHOD_NUM_ARGS));
4117b1019a6SJerry Jelinek
4127b1019a6SJerry Jelinek Info->ParamCount = ACPI_METHOD_NUM_ARGS;
4137b1019a6SJerry Jelinek }
4147b1019a6SJerry Jelinek
4157c478bd9Sstevel@tonic-gate /*
4167c478bd9Sstevel@tonic-gate * Allocate a new parameter block for the internal objects
4177c478bd9Sstevel@tonic-gate * Add 1 to count to allow for null terminated internal list
4187c478bd9Sstevel@tonic-gate */
41927f7c583Smyers Info->Parameters = ACPI_ALLOCATE_ZEROED (
4207b1019a6SJerry Jelinek ((ACPI_SIZE) Info->ParamCount + 1) * sizeof (void *));
42127f7c583Smyers if (!Info->Parameters)
4227c478bd9Sstevel@tonic-gate {
42327f7c583Smyers Status = AE_NO_MEMORY;
42427f7c583Smyers goto Cleanup;
4257c478bd9Sstevel@tonic-gate }
4267c478bd9Sstevel@tonic-gate
42727f7c583Smyers /* Convert each external object in the list to an internal object */
42827f7c583Smyers
4297b1019a6SJerry Jelinek for (i = 0; i < Info->ParamCount; i++)
4307c478bd9Sstevel@tonic-gate {
43127f7c583Smyers Status = AcpiUtCopyEobjectToIobject (
4327b1019a6SJerry Jelinek &ExternalParams->Pointer[i], &Info->Parameters[i]);
4337c478bd9Sstevel@tonic-gate if (ACPI_FAILURE (Status))
4347c478bd9Sstevel@tonic-gate {
43527f7c583Smyers goto Cleanup;
4367c478bd9Sstevel@tonic-gate }
4377c478bd9Sstevel@tonic-gate }
4387b1019a6SJerry Jelinek
4397b1019a6SJerry Jelinek Info->Parameters[Info->ParamCount] = NULL;
4407c478bd9Sstevel@tonic-gate }
4417c478bd9Sstevel@tonic-gate
4427b1019a6SJerry Jelinek
4437b1019a6SJerry Jelinek #ifdef _FUTURE_FEATURE
4447b1019a6SJerry Jelinek
4457c478bd9Sstevel@tonic-gate /*
4467b1019a6SJerry Jelinek * Begin incoming argument count analysis. Check for too few args
4477b1019a6SJerry Jelinek * and too many args.
4487c478bd9Sstevel@tonic-gate */
4497b1019a6SJerry Jelinek switch (AcpiNsGetType (Info->Node))
4507c478bd9Sstevel@tonic-gate {
4517b1019a6SJerry Jelinek case ACPI_TYPE_METHOD:
4527b1019a6SJerry Jelinek
4537b1019a6SJerry Jelinek /* Check incoming argument count against the method definition */
4547b1019a6SJerry Jelinek
4557b1019a6SJerry Jelinek if (Info->ObjDesc->Method.ParamCount > Info->ParamCount)
4567b1019a6SJerry Jelinek {
4577b1019a6SJerry Jelinek ACPI_ERROR ((AE_INFO,
4587b1019a6SJerry Jelinek "Insufficient arguments (%u) - %u are required",
4597b1019a6SJerry Jelinek Info->ParamCount,
4607b1019a6SJerry Jelinek Info->ObjDesc->Method.ParamCount));
4617b1019a6SJerry Jelinek
4627b1019a6SJerry Jelinek Status = AE_MISSING_ARGUMENTS;
4637b1019a6SJerry Jelinek goto Cleanup;
4647b1019a6SJerry Jelinek }
4657b1019a6SJerry Jelinek
4667b1019a6SJerry Jelinek else if (Info->ObjDesc->Method.ParamCount < Info->ParamCount)
4677b1019a6SJerry Jelinek {
4687b1019a6SJerry Jelinek ACPI_WARNING ((AE_INFO,
4697b1019a6SJerry Jelinek "Excess arguments (%u) - only %u are required",
4707b1019a6SJerry Jelinek Info->ParamCount,
4717b1019a6SJerry Jelinek Info->ObjDesc->Method.ParamCount));
4727b1019a6SJerry Jelinek
4737b1019a6SJerry Jelinek /* Just pass the required number of arguments */
4747b1019a6SJerry Jelinek
4757b1019a6SJerry Jelinek Info->ParamCount = Info->ObjDesc->Method.ParamCount;
4767b1019a6SJerry Jelinek }
47730082d0cSmyers
4787c478bd9Sstevel@tonic-gate /*
4797b1019a6SJerry Jelinek * Any incoming external objects to be passed as arguments to the
4807b1019a6SJerry Jelinek * method must be converted to internal objects
4817c478bd9Sstevel@tonic-gate */
4827b1019a6SJerry Jelinek if (Info->ParamCount)
4837c478bd9Sstevel@tonic-gate {
4847b1019a6SJerry Jelinek /*
4857b1019a6SJerry Jelinek * Allocate a new parameter block for the internal objects
4867b1019a6SJerry Jelinek * Add 1 to count to allow for null terminated internal list
4877b1019a6SJerry Jelinek */
4887b1019a6SJerry Jelinek Info->Parameters = ACPI_ALLOCATE_ZEROED (
4897b1019a6SJerry Jelinek ((ACPI_SIZE) Info->ParamCount + 1) * sizeof (void *));
4907b1019a6SJerry Jelinek if (!Info->Parameters)
4917b1019a6SJerry Jelinek {
4927b1019a6SJerry Jelinek Status = AE_NO_MEMORY;
4937b1019a6SJerry Jelinek goto Cleanup;
4947b1019a6SJerry Jelinek }
4957b1019a6SJerry Jelinek
4967b1019a6SJerry Jelinek /* Convert each external object in the list to an internal object */
4977b1019a6SJerry Jelinek
4987b1019a6SJerry Jelinek for (i = 0; i < Info->ParamCount; i++)
4997b1019a6SJerry Jelinek {
5007b1019a6SJerry Jelinek Status = AcpiUtCopyEobjectToIobject (
5017b1019a6SJerry Jelinek &ExternalParams->Pointer[i], &Info->Parameters[i]);
5027b1019a6SJerry Jelinek if (ACPI_FAILURE (Status))
5037b1019a6SJerry Jelinek {
5047b1019a6SJerry Jelinek goto Cleanup;
5057b1019a6SJerry Jelinek }
5067b1019a6SJerry Jelinek }
5077b1019a6SJerry Jelinek
5087b1019a6SJerry Jelinek Info->Parameters[Info->ParamCount] = NULL;
5097c478bd9Sstevel@tonic-gate }
5107b1019a6SJerry Jelinek break;
5117b1019a6SJerry Jelinek
5127b1019a6SJerry Jelinek default:
5137b1019a6SJerry Jelinek
5147b1019a6SJerry Jelinek /* Warn if arguments passed to an object that is not a method */
5157b1019a6SJerry Jelinek
5167b1019a6SJerry Jelinek if (Info->ParamCount)
5177c478bd9Sstevel@tonic-gate {
5187b1019a6SJerry Jelinek ACPI_WARNING ((AE_INFO,
5197b1019a6SJerry Jelinek "%u arguments were passed to a non-method ACPI object",
5207b1019a6SJerry Jelinek Info->ParamCount));
5217c478bd9Sstevel@tonic-gate }
5227b1019a6SJerry Jelinek break;
5237c478bd9Sstevel@tonic-gate }
52430082d0cSmyers
5257b1019a6SJerry Jelinek #endif
5267b1019a6SJerry Jelinek
5277b1019a6SJerry Jelinek
5287b1019a6SJerry Jelinek /* Now we can evaluate the object */
5297b1019a6SJerry Jelinek
5307b1019a6SJerry Jelinek Status = AcpiNsEvaluate (Info);
5317c478bd9Sstevel@tonic-gate
5327c478bd9Sstevel@tonic-gate /*
5337c478bd9Sstevel@tonic-gate * If we are expecting a return value, and all went well above,
5347c478bd9Sstevel@tonic-gate * copy the return value to an external object.
5357c478bd9Sstevel@tonic-gate */
5367b1019a6SJerry Jelinek if (!ReturnBuffer)
5377c478bd9Sstevel@tonic-gate {
5387b1019a6SJerry Jelinek goto CleanupReturnObject;
5397b1019a6SJerry Jelinek }
5407b1019a6SJerry Jelinek
5417b1019a6SJerry Jelinek if (!Info->ReturnObject)
5427b1019a6SJerry Jelinek {
5437b1019a6SJerry Jelinek ReturnBuffer->Length = 0;
5447b1019a6SJerry Jelinek goto Cleanup;
5457b1019a6SJerry Jelinek }
5467b1019a6SJerry Jelinek
5477b1019a6SJerry Jelinek if (ACPI_GET_DESCRIPTOR_TYPE (Info->ReturnObject) ==
5487b1019a6SJerry Jelinek ACPI_DESC_TYPE_NAMED)
5497b1019a6SJerry Jelinek {
5507b1019a6SJerry Jelinek /*
5517b1019a6SJerry Jelinek * If we received a NS Node as a return object, this means that
5527b1019a6SJerry Jelinek * the object we are evaluating has nothing interesting to
5537b1019a6SJerry Jelinek * return (such as a mutex, etc.) We return an error because
5547b1019a6SJerry Jelinek * these types are essentially unsupported by this interface.
5557b1019a6SJerry Jelinek * We don't check up front because this makes it easier to add
5567b1019a6SJerry Jelinek * support for various types at a later date if necessary.
5577b1019a6SJerry Jelinek */
5587b1019a6SJerry Jelinek Status = AE_TYPE;
5597b1019a6SJerry Jelinek Info->ReturnObject = NULL; /* No need to delete a NS Node */
5607b1019a6SJerry Jelinek ReturnBuffer->Length = 0;
5617b1019a6SJerry Jelinek }
5627b1019a6SJerry Jelinek
5637b1019a6SJerry Jelinek if (ACPI_FAILURE (Status))
5647b1019a6SJerry Jelinek {
5657b1019a6SJerry Jelinek goto CleanupReturnObject;
5667b1019a6SJerry Jelinek }
5677b1019a6SJerry Jelinek
5687b1019a6SJerry Jelinek /* Dereference Index and RefOf references */
5697b1019a6SJerry Jelinek
5707b1019a6SJerry Jelinek AcpiNsResolveReferences (Info);
5717b1019a6SJerry Jelinek
5727b1019a6SJerry Jelinek /* Get the size of the returned object */
5737b1019a6SJerry Jelinek
5747b1019a6SJerry Jelinek Status = AcpiUtGetObjectSize (Info->ReturnObject,
5757b1019a6SJerry Jelinek &BufferSpaceNeeded);
5767b1019a6SJerry Jelinek if (ACPI_SUCCESS (Status))
5777b1019a6SJerry Jelinek {
5787b1019a6SJerry Jelinek /* Validate/Allocate/Clear caller buffer */
5797b1019a6SJerry Jelinek
5807b1019a6SJerry Jelinek Status = AcpiUtInitializeBuffer (ReturnBuffer,
5817b1019a6SJerry Jelinek BufferSpaceNeeded);
5827b1019a6SJerry Jelinek if (ACPI_FAILURE (Status))
5837c478bd9Sstevel@tonic-gate {
5847b1019a6SJerry Jelinek /*
5857b1019a6SJerry Jelinek * Caller's buffer is too small or a new one can't
5867b1019a6SJerry Jelinek * be allocated
5877b1019a6SJerry Jelinek */
5887b1019a6SJerry Jelinek ACPI_DEBUG_PRINT ((ACPI_DB_INFO,
5897b1019a6SJerry Jelinek "Needed buffer size %X, %s\n",
5907b1019a6SJerry Jelinek (UINT32) BufferSpaceNeeded,
5917b1019a6SJerry Jelinek AcpiFormatException (Status)));
5927c478bd9Sstevel@tonic-gate }
5937c478bd9Sstevel@tonic-gate else
5947c478bd9Sstevel@tonic-gate {
5957b1019a6SJerry Jelinek /* We have enough space for the object, build it */
59627f7c583Smyers
5977b1019a6SJerry Jelinek Status = AcpiUtCopyIobjectToEobject (
5987b1019a6SJerry Jelinek Info->ReturnObject, ReturnBuffer);
5997c478bd9Sstevel@tonic-gate }
6007c478bd9Sstevel@tonic-gate }
6017c478bd9Sstevel@tonic-gate
6027b1019a6SJerry Jelinek CleanupReturnObject:
6037b1019a6SJerry Jelinek
60427f7c583Smyers if (Info->ReturnObject)
6057c478bd9Sstevel@tonic-gate {
6067c478bd9Sstevel@tonic-gate /*
60727f7c583Smyers * Delete the internal return object. NOTE: Interpreter must be
60827f7c583Smyers * locked to avoid race condition.
6097c478bd9Sstevel@tonic-gate */
610db2bae30SDana Myers AcpiExEnterInterpreter ();
61127f7c583Smyers
612db2bae30SDana Myers /* Remove one reference on the return object (should delete it) */
613db2bae30SDana Myers
614db2bae30SDana Myers AcpiUtRemoveReference (Info->ReturnObject);
615db2bae30SDana Myers AcpiExExitInterpreter ();
6167c478bd9Sstevel@tonic-gate }
6177c478bd9Sstevel@tonic-gate
61827f7c583Smyers
61927f7c583Smyers Cleanup:
62027f7c583Smyers
62130082d0cSmyers /* Free the input parameter list (if we created one) */
62230082d0cSmyers
62327f7c583Smyers if (Info->Parameters)
6247c478bd9Sstevel@tonic-gate {
6257c478bd9Sstevel@tonic-gate /* Free the allocated parameter block */
6267c478bd9Sstevel@tonic-gate
62727f7c583Smyers AcpiUtDeleteInternalObjectList (Info->Parameters);
6287c478bd9Sstevel@tonic-gate }
6297c478bd9Sstevel@tonic-gate
63027f7c583Smyers ACPI_FREE (Info);
6317c478bd9Sstevel@tonic-gate return_ACPI_STATUS (Status);
6327c478bd9Sstevel@tonic-gate }
6337c478bd9Sstevel@tonic-gate
ACPI_EXPORT_SYMBOL(AcpiEvaluateObject)63427f7c583Smyers ACPI_EXPORT_SYMBOL (AcpiEvaluateObject)
63527f7c583Smyers
6367c478bd9Sstevel@tonic-gate
637db2bae30SDana Myers /*******************************************************************************
638db2bae30SDana Myers *
639db2bae30SDana Myers * FUNCTION: AcpiNsResolveReferences
640db2bae30SDana Myers *
641db2bae30SDana Myers * PARAMETERS: Info - Evaluation info block
642db2bae30SDana Myers *
643db2bae30SDana Myers * RETURN: Info->ReturnObject is replaced with the dereferenced object
644db2bae30SDana Myers *
645db2bae30SDana Myers * DESCRIPTION: Dereference certain reference objects. Called before an
646db2bae30SDana Myers * internal return object is converted to an external ACPI_OBJECT.
647db2bae30SDana Myers *
648db2bae30SDana Myers * Performs an automatic dereference of Index and RefOf reference objects.
649db2bae30SDana Myers * These reference objects are not supported by the ACPI_OBJECT, so this is a
650db2bae30SDana Myers * last resort effort to return something useful. Also, provides compatibility
651db2bae30SDana Myers * with other ACPI implementations.
652db2bae30SDana Myers *
653db2bae30SDana Myers * NOTE: does not handle references within returned package objects or nested
654db2bae30SDana Myers * references, but this support could be added later if found to be necessary.
655db2bae30SDana Myers *
656db2bae30SDana Myers ******************************************************************************/
657db2bae30SDana Myers
658db2bae30SDana Myers static void
659db2bae30SDana Myers AcpiNsResolveReferences (
660db2bae30SDana Myers ACPI_EVALUATE_INFO *Info)
661db2bae30SDana Myers {
662db2bae30SDana Myers ACPI_OPERAND_OBJECT *ObjDesc = NULL;
663db2bae30SDana Myers ACPI_NAMESPACE_NODE *Node;
664db2bae30SDana Myers
665db2bae30SDana Myers
666db2bae30SDana Myers /* We are interested in reference objects only */
667db2bae30SDana Myers
668aa2aa9a6SDana Myers if ((Info->ReturnObject)->Common.Type != ACPI_TYPE_LOCAL_REFERENCE)
669db2bae30SDana Myers {
670db2bae30SDana Myers return;
671db2bae30SDana Myers }
672db2bae30SDana Myers
673db2bae30SDana Myers /*
674db2bae30SDana Myers * Two types of references are supported - those created by Index and
675db2bae30SDana Myers * RefOf operators. A name reference (AML_NAMEPATH_OP) can be converted
676db2bae30SDana Myers * to an ACPI_OBJECT, so it is not dereferenced here. A DdbHandle
677db2bae30SDana Myers * (AML_LOAD_OP) cannot be dereferenced, nor can it be converted to
678db2bae30SDana Myers * an ACPI_OBJECT.
679db2bae30SDana Myers */
680db2bae30SDana Myers switch (Info->ReturnObject->Reference.Class)
681db2bae30SDana Myers {
682db2bae30SDana Myers case ACPI_REFCLASS_INDEX:
683db2bae30SDana Myers
684db2bae30SDana Myers ObjDesc = *(Info->ReturnObject->Reference.Where);
685db2bae30SDana Myers break;
686db2bae30SDana Myers
687db2bae30SDana Myers case ACPI_REFCLASS_REFOF:
688db2bae30SDana Myers
689db2bae30SDana Myers Node = Info->ReturnObject->Reference.Object;
690db2bae30SDana Myers if (Node)
691db2bae30SDana Myers {
692db2bae30SDana Myers ObjDesc = Node->Object;
693db2bae30SDana Myers }
694db2bae30SDana Myers break;
695db2bae30SDana Myers
696db2bae30SDana Myers default:
6977b1019a6SJerry Jelinek
698db2bae30SDana Myers return;
699db2bae30SDana Myers }
700db2bae30SDana Myers
701db2bae30SDana Myers /* Replace the existing reference object */
702db2bae30SDana Myers
703db2bae30SDana Myers if (ObjDesc)
704db2bae30SDana Myers {
705db2bae30SDana Myers AcpiUtAddReference (ObjDesc);
706db2bae30SDana Myers AcpiUtRemoveReference (Info->ReturnObject);
707db2bae30SDana Myers Info->ReturnObject = ObjDesc;
708db2bae30SDana Myers }
709db2bae30SDana Myers
710db2bae30SDana Myers return;
711db2bae30SDana Myers }
712db2bae30SDana Myers
713db2bae30SDana Myers
7147c478bd9Sstevel@tonic-gate /*******************************************************************************
7157c478bd9Sstevel@tonic-gate *
7167c478bd9Sstevel@tonic-gate * FUNCTION: AcpiWalkNamespace
7177c478bd9Sstevel@tonic-gate *
7187c478bd9Sstevel@tonic-gate * PARAMETERS: Type - ACPI_OBJECT_TYPE to search for
7197c478bd9Sstevel@tonic-gate * StartObject - Handle in namespace where search begins
7207c478bd9Sstevel@tonic-gate * MaxDepth - Depth to which search is to reach
7217b1019a6SJerry Jelinek * DescendingCallback - Called during tree descent
72257190917SDana Myers * when an object of "Type" is found
7237b1019a6SJerry Jelinek * AscendingCallback - Called during tree ascent
72457190917SDana Myers * when an object of "Type" is found
72557190917SDana Myers * Context - Passed to user function(s) above
7267c478bd9Sstevel@tonic-gate * ReturnValue - Location where return value of
7277c478bd9Sstevel@tonic-gate * UserFunction is put if terminated early
7287c478bd9Sstevel@tonic-gate *
7297c478bd9Sstevel@tonic-gate * RETURNS Return value from the UserFunction if terminated early.
7307c478bd9Sstevel@tonic-gate * Otherwise, returns NULL.
7317c478bd9Sstevel@tonic-gate *
7327c478bd9Sstevel@tonic-gate * DESCRIPTION: Performs a modified depth-first walk of the namespace tree,
7337c478bd9Sstevel@tonic-gate * starting (and ending) at the object specified by StartHandle.
73457190917SDana Myers * The callback function is called whenever an object that matches
73557190917SDana Myers * the type parameter is found. If the callback function returns
7367c478bd9Sstevel@tonic-gate * a non-zero value, the search is terminated immediately and this
7377c478bd9Sstevel@tonic-gate * value is returned to the caller.
7387c478bd9Sstevel@tonic-gate *
7397c478bd9Sstevel@tonic-gate * The point of this procedure is to provide a generic namespace
7407c478bd9Sstevel@tonic-gate * walk routine that can be called from multiple places to
74157190917SDana Myers * provide multiple services; the callback function(s) can be
74257190917SDana Myers * tailored to each task, whether it is a print function,
74357190917SDana Myers * a compare function, etc.
7447c478bd9Sstevel@tonic-gate *
7457c478bd9Sstevel@tonic-gate ******************************************************************************/
7467c478bd9Sstevel@tonic-gate
7477c478bd9Sstevel@tonic-gate ACPI_STATUS
AcpiWalkNamespace(ACPI_OBJECT_TYPE Type,ACPI_HANDLE StartObject,UINT32 MaxDepth,ACPI_WALK_CALLBACK DescendingCallback,ACPI_WALK_CALLBACK AscendingCallback,void * Context,void ** ReturnValue)7487c478bd9Sstevel@tonic-gate AcpiWalkNamespace (
7497c478bd9Sstevel@tonic-gate ACPI_OBJECT_TYPE Type,
7507c478bd9Sstevel@tonic-gate ACPI_HANDLE StartObject,
7517c478bd9Sstevel@tonic-gate UINT32 MaxDepth,
7527b1019a6SJerry Jelinek ACPI_WALK_CALLBACK DescendingCallback,
7537b1019a6SJerry Jelinek ACPI_WALK_CALLBACK AscendingCallback,
7547c478bd9Sstevel@tonic-gate void *Context,
7557c478bd9Sstevel@tonic-gate void **ReturnValue)
7567c478bd9Sstevel@tonic-gate {
7577c478bd9Sstevel@tonic-gate ACPI_STATUS Status;
7587c478bd9Sstevel@tonic-gate
7597c478bd9Sstevel@tonic-gate
76027f7c583Smyers ACPI_FUNCTION_TRACE (AcpiWalkNamespace);
7617c478bd9Sstevel@tonic-gate
7627c478bd9Sstevel@tonic-gate
7637c478bd9Sstevel@tonic-gate /* Parameter validation */
7647c478bd9Sstevel@tonic-gate
76530082d0cSmyers if ((Type > ACPI_TYPE_LOCAL_MAX) ||
76627f7c583Smyers (!MaxDepth) ||
7677b1019a6SJerry Jelinek (!DescendingCallback && !AscendingCallback))
7687c478bd9Sstevel@tonic-gate {
7697c478bd9Sstevel@tonic-gate return_ACPI_STATUS (AE_BAD_PARAMETER);
7707c478bd9Sstevel@tonic-gate }
7717c478bd9Sstevel@tonic-gate
7727c478bd9Sstevel@tonic-gate /*
773aa2aa9a6SDana Myers * Need to acquire the namespace reader lock to prevent interference
774aa2aa9a6SDana Myers * with any concurrent table unloads (which causes the deletion of
775aa2aa9a6SDana Myers * namespace objects). We cannot allow the deletion of a namespace node
776aa2aa9a6SDana Myers * while the user function is using it. The exception to this are the
777aa2aa9a6SDana Myers * nodes created and deleted during control method execution -- these
778aa2aa9a6SDana Myers * nodes are marked as temporary nodes and are ignored by the namespace
779aa2aa9a6SDana Myers * walk. Thus, control methods can be executed while holding the
780aa2aa9a6SDana Myers * namespace deletion lock (and the user function can execute control
781aa2aa9a6SDana Myers * methods.)
782aa2aa9a6SDana Myers */
783aa2aa9a6SDana Myers Status = AcpiUtAcquireReadLock (&AcpiGbl_NamespaceRwLock);
784aa2aa9a6SDana Myers if (ACPI_FAILURE (Status))
785aa2aa9a6SDana Myers {
7867b1019a6SJerry Jelinek return_ACPI_STATUS (Status);
787aa2aa9a6SDana Myers }
788aa2aa9a6SDana Myers
789aa2aa9a6SDana Myers /*
790aa2aa9a6SDana Myers * Lock the namespace around the walk. The namespace will be
791aa2aa9a6SDana Myers * unlocked/locked around each call to the user function - since the user
792aa2aa9a6SDana Myers * function must be allowed to make ACPICA calls itself (for example, it
793aa2aa9a6SDana Myers * will typically execute control methods during device enumeration.)
7947c478bd9Sstevel@tonic-gate */
7957c478bd9Sstevel@tonic-gate Status = AcpiUtAcquireMutex (ACPI_MTX_NAMESPACE);
7967c478bd9Sstevel@tonic-gate if (ACPI_FAILURE (Status))
7977c478bd9Sstevel@tonic-gate {
798aa2aa9a6SDana Myers goto UnlockAndExit;
7997c478bd9Sstevel@tonic-gate }
8007c478bd9Sstevel@tonic-gate
8017b1019a6SJerry Jelinek /* Now we can validate the starting node */
8027b1019a6SJerry Jelinek
8037b1019a6SJerry Jelinek if (!AcpiNsValidateHandle (StartObject))
8047b1019a6SJerry Jelinek {
8057b1019a6SJerry Jelinek Status = AE_BAD_PARAMETER;
8067b1019a6SJerry Jelinek goto UnlockAndExit2;
8077b1019a6SJerry Jelinek }
8087b1019a6SJerry Jelinek
8097c478bd9Sstevel@tonic-gate Status = AcpiNsWalkNamespace (Type, StartObject, MaxDepth,
8107b1019a6SJerry Jelinek ACPI_NS_WALK_UNLOCK, DescendingCallback,
8117b1019a6SJerry Jelinek AscendingCallback, Context, ReturnValue);
8127c478bd9Sstevel@tonic-gate
8137b1019a6SJerry Jelinek UnlockAndExit2:
8147c478bd9Sstevel@tonic-gate (void) AcpiUtReleaseMutex (ACPI_MTX_NAMESPACE);
815aa2aa9a6SDana Myers
816aa2aa9a6SDana Myers UnlockAndExit:
817aa2aa9a6SDana Myers (void) AcpiUtReleaseReadLock (&AcpiGbl_NamespaceRwLock);
8187c478bd9Sstevel@tonic-gate return_ACPI_STATUS (Status);
8197c478bd9Sstevel@tonic-gate }
8207c478bd9Sstevel@tonic-gate
ACPI_EXPORT_SYMBOL(AcpiWalkNamespace)82127f7c583Smyers ACPI_EXPORT_SYMBOL (AcpiWalkNamespace)
82227f7c583Smyers
8237c478bd9Sstevel@tonic-gate
8247c478bd9Sstevel@tonic-gate /*******************************************************************************
8257c478bd9Sstevel@tonic-gate *
8267c478bd9Sstevel@tonic-gate * FUNCTION: AcpiNsGetDeviceCallback
8277c478bd9Sstevel@tonic-gate *
8287c478bd9Sstevel@tonic-gate * PARAMETERS: Callback from AcpiGetDevice
8297c478bd9Sstevel@tonic-gate *
8307c478bd9Sstevel@tonic-gate * RETURN: Status
8317c478bd9Sstevel@tonic-gate *
8327c478bd9Sstevel@tonic-gate * DESCRIPTION: Takes callbacks from WalkNamespace and filters out all non-
8337c478bd9Sstevel@tonic-gate * present devices, or if they specified a HID, it filters based
8347c478bd9Sstevel@tonic-gate * on that.
8357c478bd9Sstevel@tonic-gate *
8367c478bd9Sstevel@tonic-gate ******************************************************************************/
8377c478bd9Sstevel@tonic-gate
8387c478bd9Sstevel@tonic-gate static ACPI_STATUS
8397c478bd9Sstevel@tonic-gate AcpiNsGetDeviceCallback (
8407c478bd9Sstevel@tonic-gate ACPI_HANDLE ObjHandle,
8417c478bd9Sstevel@tonic-gate UINT32 NestingLevel,
8427c478bd9Sstevel@tonic-gate void *Context,
8437c478bd9Sstevel@tonic-gate void **ReturnValue)
8447c478bd9Sstevel@tonic-gate {
8457c478bd9Sstevel@tonic-gate ACPI_GET_DEVICES_INFO *Info = Context;
8467c478bd9Sstevel@tonic-gate ACPI_STATUS Status;
8477c478bd9Sstevel@tonic-gate ACPI_NAMESPACE_NODE *Node;
8487c478bd9Sstevel@tonic-gate UINT32 Flags;
8497b1019a6SJerry Jelinek ACPI_PNP_DEVICE_ID *Hid;
8507b1019a6SJerry Jelinek ACPI_PNP_DEVICE_ID_LIST *Cid;
851db2bae30SDana Myers UINT32 i;
852db2bae30SDana Myers BOOLEAN Found;
85357190917SDana Myers int NoMatch;
8547c478bd9Sstevel@tonic-gate
8557c478bd9Sstevel@tonic-gate
8567c478bd9Sstevel@tonic-gate Status = AcpiUtAcquireMutex (ACPI_MTX_NAMESPACE);
8577c478bd9Sstevel@tonic-gate if (ACPI_FAILURE (Status))
8587c478bd9Sstevel@tonic-gate {
8597c478bd9Sstevel@tonic-gate return (Status);
8607c478bd9Sstevel@tonic-gate }
8617c478bd9Sstevel@tonic-gate
86226f3cdf0SGordon Ross Node = AcpiNsValidateHandle (ObjHandle);
8637c478bd9Sstevel@tonic-gate Status = AcpiUtReleaseMutex (ACPI_MTX_NAMESPACE);
8647c478bd9Sstevel@tonic-gate if (ACPI_FAILURE (Status))
8657c478bd9Sstevel@tonic-gate {
8667c478bd9Sstevel@tonic-gate return (Status);
8677c478bd9Sstevel@tonic-gate }
8687c478bd9Sstevel@tonic-gate
8697c478bd9Sstevel@tonic-gate if (!Node)
8707c478bd9Sstevel@tonic-gate {
8717c478bd9Sstevel@tonic-gate return (AE_BAD_PARAMETER);
8727c478bd9Sstevel@tonic-gate }
8737c478bd9Sstevel@tonic-gate
87426f3cdf0SGordon Ross /*
87526f3cdf0SGordon Ross * First, filter based on the device HID and CID.
87626f3cdf0SGordon Ross *
87726f3cdf0SGordon Ross * 01/2010: For this case where a specific HID is requested, we don't
87826f3cdf0SGordon Ross * want to run _STA until we have an actual HID match. Thus, we will
87926f3cdf0SGordon Ross * not unnecessarily execute _STA on devices for which the caller
88026f3cdf0SGordon Ross * doesn't care about. Previously, _STA was executed unconditionally
88126f3cdf0SGordon Ross * on all devices found here.
88226f3cdf0SGordon Ross *
88326f3cdf0SGordon Ross * A side-effect of this change is that now we will continue to search
88426f3cdf0SGordon Ross * for a matching HID even under device trees where the parent device
88526f3cdf0SGordon Ross * would have returned a _STA that indicates it is not present or
88626f3cdf0SGordon Ross * not functioning (thus aborting the search on that branch).
88726f3cdf0SGordon Ross */
8887c478bd9Sstevel@tonic-gate if (Info->Hid != NULL)
8897c478bd9Sstevel@tonic-gate {
8907c478bd9Sstevel@tonic-gate Status = AcpiUtExecute_HID (Node, &Hid);
8917c478bd9Sstevel@tonic-gate if (Status == AE_NOT_FOUND)
8927c478bd9Sstevel@tonic-gate {
8937c478bd9Sstevel@tonic-gate return (AE_OK);
8947c478bd9Sstevel@tonic-gate }
8957c478bd9Sstevel@tonic-gate else if (ACPI_FAILURE (Status))
8967c478bd9Sstevel@tonic-gate {
8977c478bd9Sstevel@tonic-gate return (AE_CTRL_DEPTH);
8987c478bd9Sstevel@tonic-gate }
8997c478bd9Sstevel@tonic-gate
9007b1019a6SJerry Jelinek NoMatch = strcmp (Hid->String, Info->Hid);
90157190917SDana Myers ACPI_FREE (Hid);
90257190917SDana Myers
90357190917SDana Myers if (NoMatch)
9047c478bd9Sstevel@tonic-gate {
905db2bae30SDana Myers /*
906db2bae30SDana Myers * HID does not match, attempt match within the
907db2bae30SDana Myers * list of Compatible IDs (CIDs)
908db2bae30SDana Myers */
9097c478bd9Sstevel@tonic-gate Status = AcpiUtExecute_CID (Node, &Cid);
9107c478bd9Sstevel@tonic-gate if (Status == AE_NOT_FOUND)
9117c478bd9Sstevel@tonic-gate {
9127c478bd9Sstevel@tonic-gate return (AE_OK);
9137c478bd9Sstevel@tonic-gate }
9147c478bd9Sstevel@tonic-gate else if (ACPI_FAILURE (Status))
9157c478bd9Sstevel@tonic-gate {
9167c478bd9Sstevel@tonic-gate return (AE_CTRL_DEPTH);
9177c478bd9Sstevel@tonic-gate }
9187c478bd9Sstevel@tonic-gate
9197c478bd9Sstevel@tonic-gate /* Walk the CID list */
9207c478bd9Sstevel@tonic-gate
921db2bae30SDana Myers Found = FALSE;
9227c478bd9Sstevel@tonic-gate for (i = 0; i < Cid->Count; i++)
9237c478bd9Sstevel@tonic-gate {
9247b1019a6SJerry Jelinek if (strcmp (Cid->Ids[i].String, Info->Hid) == 0)
9257c478bd9Sstevel@tonic-gate {
926db2bae30SDana Myers /* Found a matching CID */
927db2bae30SDana Myers
928db2bae30SDana Myers Found = TRUE;
929db2bae30SDana Myers break;
9307c478bd9Sstevel@tonic-gate }
9317c478bd9Sstevel@tonic-gate }
932db2bae30SDana Myers
93327f7c583Smyers ACPI_FREE (Cid);
934db2bae30SDana Myers if (!Found)
935db2bae30SDana Myers {
936db2bae30SDana Myers return (AE_OK);
937db2bae30SDana Myers }
9387c478bd9Sstevel@tonic-gate }
9397c478bd9Sstevel@tonic-gate }
9407c478bd9Sstevel@tonic-gate
94126f3cdf0SGordon Ross /* Run _STA to determine if device is present */
94226f3cdf0SGordon Ross
94326f3cdf0SGordon Ross Status = AcpiUtExecute_STA (Node, &Flags);
94426f3cdf0SGordon Ross if (ACPI_FAILURE (Status))
94526f3cdf0SGordon Ross {
94626f3cdf0SGordon Ross return (AE_CTRL_DEPTH);
94726f3cdf0SGordon Ross }
94826f3cdf0SGordon Ross
94926f3cdf0SGordon Ross if (!(Flags & ACPI_STA_DEVICE_PRESENT) &&
95026f3cdf0SGordon Ross !(Flags & ACPI_STA_DEVICE_FUNCTIONING))
95126f3cdf0SGordon Ross {
95226f3cdf0SGordon Ross /*
95326f3cdf0SGordon Ross * Don't examine the children of the device only when the
95426f3cdf0SGordon Ross * device is neither present nor functional. See ACPI spec,
95526f3cdf0SGordon Ross * description of _STA for more information.
95626f3cdf0SGordon Ross */
95726f3cdf0SGordon Ross return (AE_CTRL_DEPTH);
95826f3cdf0SGordon Ross }
95926f3cdf0SGordon Ross
960db2bae30SDana Myers /* We have a valid device, invoke the user function */
961db2bae30SDana Myers
9627b1019a6SJerry Jelinek Status = Info->UserFunction (ObjHandle, NestingLevel,
9637b1019a6SJerry Jelinek Info->Context, ReturnValue);
9647c478bd9Sstevel@tonic-gate return (Status);
9657c478bd9Sstevel@tonic-gate }
9667c478bd9Sstevel@tonic-gate
9677c478bd9Sstevel@tonic-gate
9687c478bd9Sstevel@tonic-gate /*******************************************************************************
9697c478bd9Sstevel@tonic-gate *
9707c478bd9Sstevel@tonic-gate * FUNCTION: AcpiGetDevices
9717c478bd9Sstevel@tonic-gate *
9727c478bd9Sstevel@tonic-gate * PARAMETERS: HID - HID to search for. Can be NULL.
9737c478bd9Sstevel@tonic-gate * UserFunction - Called when a matching object is found
9747c478bd9Sstevel@tonic-gate * Context - Passed to user function
9757c478bd9Sstevel@tonic-gate * ReturnValue - Location where return value of
9767c478bd9Sstevel@tonic-gate * UserFunction is put if terminated early
9777c478bd9Sstevel@tonic-gate *
9787c478bd9Sstevel@tonic-gate * RETURNS Return value from the UserFunction if terminated early.
9797c478bd9Sstevel@tonic-gate * Otherwise, returns NULL.
9807c478bd9Sstevel@tonic-gate *
9817c478bd9Sstevel@tonic-gate * DESCRIPTION: Performs a modified depth-first walk of the namespace tree,
9827c478bd9Sstevel@tonic-gate * starting (and ending) at the object specified by StartHandle.
9837c478bd9Sstevel@tonic-gate * The UserFunction is called whenever an object of type
9847b1019a6SJerry Jelinek * Device is found. If the user function returns
9857c478bd9Sstevel@tonic-gate * a non-zero value, the search is terminated immediately and this
9867c478bd9Sstevel@tonic-gate * value is returned to the caller.
9877c478bd9Sstevel@tonic-gate *
9887c478bd9Sstevel@tonic-gate * This is a wrapper for WalkNamespace, but the callback performs
989db2bae30SDana Myers * additional filtering. Please see AcpiNsGetDeviceCallback.
9907c478bd9Sstevel@tonic-gate *
9917c478bd9Sstevel@tonic-gate ******************************************************************************/
9927c478bd9Sstevel@tonic-gate
9937c478bd9Sstevel@tonic-gate ACPI_STATUS
AcpiGetDevices(char * HID,ACPI_WALK_CALLBACK UserFunction,void * Context,void ** ReturnValue)9947c478bd9Sstevel@tonic-gate AcpiGetDevices (
9957c478bd9Sstevel@tonic-gate char *HID,
9967c478bd9Sstevel@tonic-gate ACPI_WALK_CALLBACK UserFunction,
9977c478bd9Sstevel@tonic-gate void *Context,
9987c478bd9Sstevel@tonic-gate void **ReturnValue)
9997c478bd9Sstevel@tonic-gate {
10007c478bd9Sstevel@tonic-gate ACPI_STATUS Status;
10017c478bd9Sstevel@tonic-gate ACPI_GET_DEVICES_INFO Info;
10027c478bd9Sstevel@tonic-gate
10037c478bd9Sstevel@tonic-gate
100427f7c583Smyers ACPI_FUNCTION_TRACE (AcpiGetDevices);
10057c478bd9Sstevel@tonic-gate
10067c478bd9Sstevel@tonic-gate
10077c478bd9Sstevel@tonic-gate /* Parameter validation */
10087c478bd9Sstevel@tonic-gate
10097c478bd9Sstevel@tonic-gate if (!UserFunction)
10107c478bd9Sstevel@tonic-gate {
10117c478bd9Sstevel@tonic-gate return_ACPI_STATUS (AE_BAD_PARAMETER);
10127c478bd9Sstevel@tonic-gate }
10137c478bd9Sstevel@tonic-gate
10147c478bd9Sstevel@tonic-gate /*
10157c478bd9Sstevel@tonic-gate * We're going to call their callback from OUR callback, so we need
10167c478bd9Sstevel@tonic-gate * to know what it is, and their context parameter.
10177c478bd9Sstevel@tonic-gate */
10187b1019a6SJerry Jelinek Info.Hid = HID;
10197b1019a6SJerry Jelinek Info.Context = Context;
10207c478bd9Sstevel@tonic-gate Info.UserFunction = UserFunction;
10217c478bd9Sstevel@tonic-gate
10227c478bd9Sstevel@tonic-gate /*
10237c478bd9Sstevel@tonic-gate * Lock the namespace around the walk.
10247c478bd9Sstevel@tonic-gate * The namespace will be unlocked/locked around each call
10257c478bd9Sstevel@tonic-gate * to the user function - since this function
10267c478bd9Sstevel@tonic-gate * must be allowed to make Acpi calls itself.
10277c478bd9Sstevel@tonic-gate */
10287c478bd9Sstevel@tonic-gate Status = AcpiUtAcquireMutex (ACPI_MTX_NAMESPACE);
10297c478bd9Sstevel@tonic-gate if (ACPI_FAILURE (Status))
10307c478bd9Sstevel@tonic-gate {
10317c478bd9Sstevel@tonic-gate return_ACPI_STATUS (Status);
10327c478bd9Sstevel@tonic-gate }
10337c478bd9Sstevel@tonic-gate
103430082d0cSmyers Status = AcpiNsWalkNamespace (ACPI_TYPE_DEVICE, ACPI_ROOT_OBJECT,
10357b1019a6SJerry Jelinek ACPI_UINT32_MAX, ACPI_NS_WALK_UNLOCK,
10367b1019a6SJerry Jelinek AcpiNsGetDeviceCallback, NULL, &Info, ReturnValue);
10377c478bd9Sstevel@tonic-gate
10387c478bd9Sstevel@tonic-gate (void) AcpiUtReleaseMutex (ACPI_MTX_NAMESPACE);
10397c478bd9Sstevel@tonic-gate return_ACPI_STATUS (Status);
10407c478bd9Sstevel@tonic-gate }
10417c478bd9Sstevel@tonic-gate
ACPI_EXPORT_SYMBOL(AcpiGetDevices)104227f7c583Smyers ACPI_EXPORT_SYMBOL (AcpiGetDevices)
104327f7c583Smyers
10447c478bd9Sstevel@tonic-gate
10457c478bd9Sstevel@tonic-gate /*******************************************************************************
10467c478bd9Sstevel@tonic-gate *
10477c478bd9Sstevel@tonic-gate * FUNCTION: AcpiAttachData
10487c478bd9Sstevel@tonic-gate *
10497c478bd9Sstevel@tonic-gate * PARAMETERS: ObjHandle - Namespace node
10507c478bd9Sstevel@tonic-gate * Handler - Handler for this attachment
10517c478bd9Sstevel@tonic-gate * Data - Pointer to data to be attached
10527c478bd9Sstevel@tonic-gate *
10537c478bd9Sstevel@tonic-gate * RETURN: Status
10547c478bd9Sstevel@tonic-gate *
10557c478bd9Sstevel@tonic-gate * DESCRIPTION: Attach arbitrary data and handler to a namespace node.
10567c478bd9Sstevel@tonic-gate *
10577c478bd9Sstevel@tonic-gate ******************************************************************************/
10587c478bd9Sstevel@tonic-gate
10597c478bd9Sstevel@tonic-gate ACPI_STATUS
10607c478bd9Sstevel@tonic-gate AcpiAttachData (
10617c478bd9Sstevel@tonic-gate ACPI_HANDLE ObjHandle,
10627c478bd9Sstevel@tonic-gate ACPI_OBJECT_HANDLER Handler,
10637c478bd9Sstevel@tonic-gate void *Data)
10647c478bd9Sstevel@tonic-gate {
10657c478bd9Sstevel@tonic-gate ACPI_NAMESPACE_NODE *Node;
10667c478bd9Sstevel@tonic-gate ACPI_STATUS Status;
10677c478bd9Sstevel@tonic-gate
10687c478bd9Sstevel@tonic-gate
10697c478bd9Sstevel@tonic-gate /* Parameter validation */
10707c478bd9Sstevel@tonic-gate
10717c478bd9Sstevel@tonic-gate if (!ObjHandle ||
10727c478bd9Sstevel@tonic-gate !Handler ||
10737c478bd9Sstevel@tonic-gate !Data)
10747c478bd9Sstevel@tonic-gate {
10757c478bd9Sstevel@tonic-gate return (AE_BAD_PARAMETER);
10767c478bd9Sstevel@tonic-gate }
10777c478bd9Sstevel@tonic-gate
10787c478bd9Sstevel@tonic-gate Status = AcpiUtAcquireMutex (ACPI_MTX_NAMESPACE);
10797c478bd9Sstevel@tonic-gate if (ACPI_FAILURE (Status))
10807c478bd9Sstevel@tonic-gate {
10817c478bd9Sstevel@tonic-gate return (Status);
10827c478bd9Sstevel@tonic-gate }
10837c478bd9Sstevel@tonic-gate
10847c478bd9Sstevel@tonic-gate /* Convert and validate the handle */
10857c478bd9Sstevel@tonic-gate
108626f3cdf0SGordon Ross Node = AcpiNsValidateHandle (ObjHandle);
10877c478bd9Sstevel@tonic-gate if (!Node)
10887c478bd9Sstevel@tonic-gate {
10897c478bd9Sstevel@tonic-gate Status = AE_BAD_PARAMETER;
10907c478bd9Sstevel@tonic-gate goto UnlockAndExit;
10917c478bd9Sstevel@tonic-gate }
10927c478bd9Sstevel@tonic-gate
10937c478bd9Sstevel@tonic-gate Status = AcpiNsAttachData (Node, Handler, Data);
10947c478bd9Sstevel@tonic-gate
10957c478bd9Sstevel@tonic-gate UnlockAndExit:
10967c478bd9Sstevel@tonic-gate (void) AcpiUtReleaseMutex (ACPI_MTX_NAMESPACE);
10977c478bd9Sstevel@tonic-gate return (Status);
10987c478bd9Sstevel@tonic-gate }
10997c478bd9Sstevel@tonic-gate
ACPI_EXPORT_SYMBOL(AcpiAttachData)110027f7c583Smyers ACPI_EXPORT_SYMBOL (AcpiAttachData)
110127f7c583Smyers
11027c478bd9Sstevel@tonic-gate
11037c478bd9Sstevel@tonic-gate /*******************************************************************************
11047c478bd9Sstevel@tonic-gate *
11057c478bd9Sstevel@tonic-gate * FUNCTION: AcpiDetachData
11067c478bd9Sstevel@tonic-gate *
11077c478bd9Sstevel@tonic-gate * PARAMETERS: ObjHandle - Namespace node handle
11087c478bd9Sstevel@tonic-gate * Handler - Handler used in call to AcpiAttachData
11097c478bd9Sstevel@tonic-gate *
11107c478bd9Sstevel@tonic-gate * RETURN: Status
11117c478bd9Sstevel@tonic-gate *
11127c478bd9Sstevel@tonic-gate * DESCRIPTION: Remove data that was previously attached to a node.
11137c478bd9Sstevel@tonic-gate *
11147c478bd9Sstevel@tonic-gate ******************************************************************************/
11157c478bd9Sstevel@tonic-gate
11167c478bd9Sstevel@tonic-gate ACPI_STATUS
11177c478bd9Sstevel@tonic-gate AcpiDetachData (
11187c478bd9Sstevel@tonic-gate ACPI_HANDLE ObjHandle,
11197c478bd9Sstevel@tonic-gate ACPI_OBJECT_HANDLER Handler)
11207c478bd9Sstevel@tonic-gate {
11217c478bd9Sstevel@tonic-gate ACPI_NAMESPACE_NODE *Node;
11227c478bd9Sstevel@tonic-gate ACPI_STATUS Status;
11237c478bd9Sstevel@tonic-gate
11247c478bd9Sstevel@tonic-gate
11257c478bd9Sstevel@tonic-gate /* Parameter validation */
11267c478bd9Sstevel@tonic-gate
11277c478bd9Sstevel@tonic-gate if (!ObjHandle ||
11287c478bd9Sstevel@tonic-gate !Handler)
11297c478bd9Sstevel@tonic-gate {
11307c478bd9Sstevel@tonic-gate return (AE_BAD_PARAMETER);
11317c478bd9Sstevel@tonic-gate }
11327c478bd9Sstevel@tonic-gate
11337c478bd9Sstevel@tonic-gate Status = AcpiUtAcquireMutex (ACPI_MTX_NAMESPACE);
11347c478bd9Sstevel@tonic-gate if (ACPI_FAILURE (Status))
11357c478bd9Sstevel@tonic-gate {
11367c478bd9Sstevel@tonic-gate return (Status);
11377c478bd9Sstevel@tonic-gate }
11387c478bd9Sstevel@tonic-gate
11397c478bd9Sstevel@tonic-gate /* Convert and validate the handle */
11407c478bd9Sstevel@tonic-gate
114126f3cdf0SGordon Ross Node = AcpiNsValidateHandle (ObjHandle);
11427c478bd9Sstevel@tonic-gate if (!Node)
11437c478bd9Sstevel@tonic-gate {
11447c478bd9Sstevel@tonic-gate Status = AE_BAD_PARAMETER;
11457c478bd9Sstevel@tonic-gate goto UnlockAndExit;
11467c478bd9Sstevel@tonic-gate }
11477c478bd9Sstevel@tonic-gate
11487c478bd9Sstevel@tonic-gate Status = AcpiNsDetachData (Node, Handler);
11497c478bd9Sstevel@tonic-gate
11507c478bd9Sstevel@tonic-gate UnlockAndExit:
11517c478bd9Sstevel@tonic-gate (void) AcpiUtReleaseMutex (ACPI_MTX_NAMESPACE);
11527c478bd9Sstevel@tonic-gate return (Status);
11537c478bd9Sstevel@tonic-gate }
11547c478bd9Sstevel@tonic-gate
ACPI_EXPORT_SYMBOL(AcpiDetachData)115527f7c583Smyers ACPI_EXPORT_SYMBOL (AcpiDetachData)
115627f7c583Smyers
11577c478bd9Sstevel@tonic-gate
11587c478bd9Sstevel@tonic-gate /*******************************************************************************
11597c478bd9Sstevel@tonic-gate *
11607c478bd9Sstevel@tonic-gate * FUNCTION: AcpiGetData
11617c478bd9Sstevel@tonic-gate *
11627c478bd9Sstevel@tonic-gate * PARAMETERS: ObjHandle - Namespace node
11637c478bd9Sstevel@tonic-gate * Handler - Handler used in call to AttachData
11647c478bd9Sstevel@tonic-gate * Data - Where the data is returned
11657c478bd9Sstevel@tonic-gate *
11667c478bd9Sstevel@tonic-gate * RETURN: Status
11677c478bd9Sstevel@tonic-gate *
11687c478bd9Sstevel@tonic-gate * DESCRIPTION: Retrieve data that was previously attached to a namespace node.
11697c478bd9Sstevel@tonic-gate *
11707c478bd9Sstevel@tonic-gate ******************************************************************************/
11717c478bd9Sstevel@tonic-gate
11727c478bd9Sstevel@tonic-gate ACPI_STATUS
11737c478bd9Sstevel@tonic-gate AcpiGetData (
11747c478bd9Sstevel@tonic-gate ACPI_HANDLE ObjHandle,
11757c478bd9Sstevel@tonic-gate ACPI_OBJECT_HANDLER Handler,
11767c478bd9Sstevel@tonic-gate void **Data)
11777c478bd9Sstevel@tonic-gate {
11787c478bd9Sstevel@tonic-gate ACPI_NAMESPACE_NODE *Node;
11797c478bd9Sstevel@tonic-gate ACPI_STATUS Status;
11807c478bd9Sstevel@tonic-gate
11817c478bd9Sstevel@tonic-gate
11827c478bd9Sstevel@tonic-gate /* Parameter validation */
11837c478bd9Sstevel@tonic-gate
11847c478bd9Sstevel@tonic-gate if (!ObjHandle ||
11857c478bd9Sstevel@tonic-gate !Handler ||
11867c478bd9Sstevel@tonic-gate !Data)
11877c478bd9Sstevel@tonic-gate {
11887c478bd9Sstevel@tonic-gate return (AE_BAD_PARAMETER);
11897c478bd9Sstevel@tonic-gate }
11907c478bd9Sstevel@tonic-gate
11917c478bd9Sstevel@tonic-gate Status = AcpiUtAcquireMutex (ACPI_MTX_NAMESPACE);
11927c478bd9Sstevel@tonic-gate if (ACPI_FAILURE (Status))
11937c478bd9Sstevel@tonic-gate {
11947c478bd9Sstevel@tonic-gate return (Status);
11957c478bd9Sstevel@tonic-gate }
11967c478bd9Sstevel@tonic-gate
11977c478bd9Sstevel@tonic-gate /* Convert and validate the handle */
11987c478bd9Sstevel@tonic-gate
119926f3cdf0SGordon Ross Node = AcpiNsValidateHandle (ObjHandle);
12007c478bd9Sstevel@tonic-gate if (!Node)
12017c478bd9Sstevel@tonic-gate {
12027c478bd9Sstevel@tonic-gate Status = AE_BAD_PARAMETER;
12037c478bd9Sstevel@tonic-gate goto UnlockAndExit;
12047c478bd9Sstevel@tonic-gate }
12057c478bd9Sstevel@tonic-gate
12067c478bd9Sstevel@tonic-gate Status = AcpiNsGetAttachedData (Node, Handler, Data);
12077c478bd9Sstevel@tonic-gate
12087c478bd9Sstevel@tonic-gate UnlockAndExit:
12097c478bd9Sstevel@tonic-gate (void) AcpiUtReleaseMutex (ACPI_MTX_NAMESPACE);
12107c478bd9Sstevel@tonic-gate return (Status);
12117c478bd9Sstevel@tonic-gate }
12127c478bd9Sstevel@tonic-gate
121327f7c583Smyers ACPI_EXPORT_SYMBOL (AcpiGetData)
1214