xref: /illumos-gate/usr/src/cmd/acpi/iasl/aslanalyze.c (revision 35786f68)
1bc36eafdSMike Gerdts /******************************************************************************
2bc36eafdSMike Gerdts  *
3bc36eafdSMike Gerdts  * Module Name: aslanalyze.c - Support functions for parse tree walks
4bc36eafdSMike Gerdts  *
5bc36eafdSMike Gerdts  *****************************************************************************/
6bc36eafdSMike Gerdts 
7*35786f68SRobert Mustacchi /******************************************************************************
8*35786f68SRobert Mustacchi  *
9*35786f68SRobert Mustacchi  * 1. Copyright Notice
10*35786f68SRobert Mustacchi  *
11*35786f68SRobert Mustacchi  * Some or all of this work - Copyright (c) 1999 - 2018, Intel Corp.
12bc36eafdSMike Gerdts  * All rights reserved.
13bc36eafdSMike Gerdts  *
14*35786f68SRobert Mustacchi  * 2. License
15*35786f68SRobert Mustacchi  *
16*35786f68SRobert Mustacchi  * 2.1. This is your license from Intel Corp. under its intellectual property
17*35786f68SRobert Mustacchi  * rights. You may have additional license terms from the party that provided
18*35786f68SRobert Mustacchi  * you this software, covering your right to use that party's intellectual
19*35786f68SRobert Mustacchi  * property rights.
20*35786f68SRobert Mustacchi  *
21*35786f68SRobert Mustacchi  * 2.2. Intel grants, free of charge, to any person ("Licensee") obtaining a
22*35786f68SRobert Mustacchi  * copy of the source code appearing in this file ("Covered Code") an
23*35786f68SRobert Mustacchi  * irrevocable, perpetual, worldwide license under Intel's copyrights in the
24*35786f68SRobert Mustacchi  * base code distributed originally by Intel ("Original Intel Code") to copy,
25*35786f68SRobert Mustacchi  * make derivatives, distribute, use and display any portion of the Covered
26*35786f68SRobert Mustacchi  * Code in any form, with the right to sublicense such rights; and
27*35786f68SRobert Mustacchi  *
28*35786f68SRobert Mustacchi  * 2.3. Intel grants Licensee a non-exclusive and non-transferable patent
29*35786f68SRobert Mustacchi  * license (with the right to sublicense), under only those claims of Intel
30*35786f68SRobert Mustacchi  * patents that are infringed by the Original Intel Code, to make, use, sell,
31*35786f68SRobert Mustacchi  * offer to sell, and import the Covered Code and derivative works thereof
32*35786f68SRobert Mustacchi  * solely to the minimum extent necessary to exercise the above copyright
33*35786f68SRobert Mustacchi  * license, and in no event shall the patent license extend to any additions
34*35786f68SRobert Mustacchi  * to or modifications of the Original Intel Code. No other license or right
35*35786f68SRobert Mustacchi  * is granted directly or by implication, estoppel or otherwise;
36*35786f68SRobert Mustacchi  *
37*35786f68SRobert Mustacchi  * The above copyright and patent license is granted only if the following
38*35786f68SRobert Mustacchi  * conditions are met:
39*35786f68SRobert Mustacchi  *
40*35786f68SRobert Mustacchi  * 3. Conditions
41*35786f68SRobert Mustacchi  *
42*35786f68SRobert Mustacchi  * 3.1. Redistribution of Source with Rights to Further Distribute Source.
43*35786f68SRobert Mustacchi  * Redistribution of source code of any substantial portion of the Covered
44*35786f68SRobert Mustacchi  * Code or modification with rights to further distribute source must include
45*35786f68SRobert Mustacchi  * the above Copyright Notice, the above License, this list of Conditions,
46*35786f68SRobert Mustacchi  * and the following Disclaimer and Export Compliance provision. In addition,
47*35786f68SRobert Mustacchi  * Licensee must cause all Covered Code to which Licensee contributes to
48*35786f68SRobert Mustacchi  * contain a file documenting the changes Licensee made to create that Covered
49*35786f68SRobert Mustacchi  * Code and the date of any change. Licensee must include in that file the
50*35786f68SRobert Mustacchi  * documentation of any changes made by any predecessor Licensee. Licensee
51*35786f68SRobert Mustacchi  * must include a prominent statement that the modification is derived,
52*35786f68SRobert Mustacchi  * directly or indirectly, from Original Intel Code.
53*35786f68SRobert Mustacchi  *
54*35786f68SRobert Mustacchi  * 3.2. Redistribution of Source with no Rights to Further Distribute Source.
55*35786f68SRobert Mustacchi  * Redistribution of source code of any substantial portion of the Covered
56*35786f68SRobert Mustacchi  * Code or modification without rights to further distribute source must
57*35786f68SRobert Mustacchi  * include the following Disclaimer and Export Compliance provision in the
58*35786f68SRobert Mustacchi  * documentation and/or other materials provided with distribution. In
59*35786f68SRobert Mustacchi  * addition, Licensee may not authorize further sublicense of source of any
60*35786f68SRobert Mustacchi  * portion of the Covered Code, and must include terms to the effect that the
61*35786f68SRobert Mustacchi  * license from Licensee to its licensee is limited to the intellectual
62*35786f68SRobert Mustacchi  * property embodied in the software Licensee provides to its licensee, and
63*35786f68SRobert Mustacchi  * not to intellectual property embodied in modifications its licensee may
64*35786f68SRobert Mustacchi  * make.
65*35786f68SRobert Mustacchi  *
66*35786f68SRobert Mustacchi  * 3.3. Redistribution of Executable. Redistribution in executable form of any
67*35786f68SRobert Mustacchi  * substantial portion of the Covered Code or modification must reproduce the
68*35786f68SRobert Mustacchi  * above Copyright Notice, and the following Disclaimer and Export Compliance
69*35786f68SRobert Mustacchi  * provision in the documentation and/or other materials provided with the
70*35786f68SRobert Mustacchi  * distribution.
71*35786f68SRobert Mustacchi  *
72*35786f68SRobert Mustacchi  * 3.4. Intel retains all right, title, and interest in and to the Original
73*35786f68SRobert Mustacchi  * Intel Code.
74*35786f68SRobert Mustacchi  *
75*35786f68SRobert Mustacchi  * 3.5. Neither the name Intel nor any other trademark owned or controlled by
76*35786f68SRobert Mustacchi  * Intel shall be used in advertising or otherwise to promote the sale, use or
77*35786f68SRobert Mustacchi  * other dealings in products derived from or relating to the Covered Code
78*35786f68SRobert Mustacchi  * without prior written authorization from Intel.
79*35786f68SRobert Mustacchi  *
80*35786f68SRobert Mustacchi  * 4. Disclaimer and Export Compliance
81*35786f68SRobert Mustacchi  *
82*35786f68SRobert Mustacchi  * 4.1. INTEL MAKES NO WARRANTY OF ANY KIND REGARDING ANY SOFTWARE PROVIDED
83*35786f68SRobert Mustacchi  * HERE. ANY SOFTWARE ORIGINATING FROM INTEL OR DERIVED FROM INTEL SOFTWARE
84*35786f68SRobert Mustacchi  * IS PROVIDED "AS IS," AND INTEL WILL NOT PROVIDE ANY SUPPORT, ASSISTANCE,
85*35786f68SRobert Mustacchi  * INSTALLATION, TRAINING OR OTHER SERVICES. INTEL WILL NOT PROVIDE ANY
86*35786f68SRobert Mustacchi  * UPDATES, ENHANCEMENTS OR EXTENSIONS. INTEL SPECIFICALLY DISCLAIMS ANY
87*35786f68SRobert Mustacchi  * IMPLIED WARRANTIES OF MERCHANTABILITY, NONINFRINGEMENT AND FITNESS FOR A
88*35786f68SRobert Mustacchi  * PARTICULAR PURPOSE.
89*35786f68SRobert Mustacchi  *
90*35786f68SRobert Mustacchi  * 4.2. IN NO EVENT SHALL INTEL HAVE ANY LIABILITY TO LICENSEE, ITS LICENSEES
91*35786f68SRobert Mustacchi  * OR ANY OTHER THIRD PARTY, FOR ANY LOST PROFITS, LOST DATA, LOSS OF USE OR
92*35786f68SRobert Mustacchi  * COSTS OF PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES, OR FOR ANY INDIRECT,
93*35786f68SRobert Mustacchi  * SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THIS AGREEMENT, UNDER ANY
94*35786f68SRobert Mustacchi  * CAUSE OF ACTION OR THEORY OF LIABILITY, AND IRRESPECTIVE OF WHETHER INTEL
95*35786f68SRobert Mustacchi  * HAS ADVANCE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES. THESE LIMITATIONS
96*35786f68SRobert Mustacchi  * SHALL APPLY NOTWITHSTANDING THE FAILURE OF THE ESSENTIAL PURPOSE OF ANY
97*35786f68SRobert Mustacchi  * LIMITED REMEDY.
98*35786f68SRobert Mustacchi  *
99*35786f68SRobert Mustacchi  * 4.3. Licensee shall not export, either directly or indirectly, any of this
100*35786f68SRobert Mustacchi  * software or system incorporating such software without first obtaining any
101*35786f68SRobert Mustacchi  * required license or other approval from the U. S. Department of Commerce or
102*35786f68SRobert Mustacchi  * any other agency or department of the United States Government. In the
103*35786f68SRobert Mustacchi  * event Licensee exports any such software from the United States or
104*35786f68SRobert Mustacchi  * re-exports any such software from a foreign destination, Licensee shall
105*35786f68SRobert Mustacchi  * ensure that the distribution and export/re-export of the software is in
106*35786f68SRobert Mustacchi  * compliance with all laws, regulations, orders, or other restrictions of the
107*35786f68SRobert Mustacchi  * U.S. Export Administration Regulations. Licensee agrees that neither it nor
108*35786f68SRobert Mustacchi  * any of its subsidiaries will export/re-export any technical data, process,
109*35786f68SRobert Mustacchi  * software, or service, directly or indirectly, to any country for which the
110*35786f68SRobert Mustacchi  * United States government or any agency thereof requires an export license,
111*35786f68SRobert Mustacchi  * other governmental approval, or letter of assurance, without first obtaining
112*35786f68SRobert Mustacchi  * such license, approval or letter.
113*35786f68SRobert Mustacchi  *
114*35786f68SRobert Mustacchi  *****************************************************************************
115*35786f68SRobert Mustacchi  *
116*35786f68SRobert Mustacchi  * Alternatively, you may choose to be licensed under the terms of the
117*35786f68SRobert Mustacchi  * following license:
118*35786f68SRobert Mustacchi  *
119bc36eafdSMike Gerdts  * Redistribution and use in source and binary forms, with or without
120bc36eafdSMike Gerdts  * modification, are permitted provided that the following conditions
121bc36eafdSMike Gerdts  * are met:
122bc36eafdSMike Gerdts  * 1. Redistributions of source code must retain the above copyright
123bc36eafdSMike Gerdts  *    notice, this list of conditions, and the following disclaimer,
124bc36eafdSMike Gerdts  *    without modification.
125bc36eafdSMike Gerdts  * 2. Redistributions in binary form must reproduce at minimum a disclaimer
126bc36eafdSMike Gerdts  *    substantially similar to the "NO WARRANTY" disclaimer below
127bc36eafdSMike Gerdts  *    ("Disclaimer") and any redistribution must be conditioned upon
128bc36eafdSMike Gerdts  *    including a substantially similar Disclaimer requirement for further
129bc36eafdSMike Gerdts  *    binary redistribution.
130bc36eafdSMike Gerdts  * 3. Neither the names of the above-listed copyright holders nor the names
131bc36eafdSMike Gerdts  *    of any contributors may be used to endorse or promote products derived
132bc36eafdSMike Gerdts  *    from this software without specific prior written permission.
133bc36eafdSMike Gerdts  *
134bc36eafdSMike Gerdts  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
135bc36eafdSMike Gerdts  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
136*35786f68SRobert Mustacchi  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
137bc36eafdSMike Gerdts  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
138*35786f68SRobert Mustacchi  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
139*35786f68SRobert Mustacchi  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
140*35786f68SRobert Mustacchi  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
141*35786f68SRobert Mustacchi  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
142*35786f68SRobert Mustacchi  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
143*35786f68SRobert Mustacchi  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
144*35786f68SRobert Mustacchi  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
145*35786f68SRobert Mustacchi  *
146*35786f68SRobert Mustacchi  * Alternatively, you may choose to be licensed under the terms of the
147*35786f68SRobert Mustacchi  * GNU General Public License ("GPL") version 2 as published by the Free
148*35786f68SRobert Mustacchi  * Software Foundation.
149*35786f68SRobert Mustacchi  *
150*35786f68SRobert Mustacchi  *****************************************************************************/
151bc36eafdSMike Gerdts 
152bc36eafdSMike Gerdts #include "aslcompiler.h"
153bc36eafdSMike Gerdts #include "aslcompiler.y.h"
154bc36eafdSMike Gerdts #include <string.h>
155bc36eafdSMike Gerdts 
156bc36eafdSMike Gerdts 
157bc36eafdSMike Gerdts #define _COMPONENT          ACPI_COMPILER
158bc36eafdSMike Gerdts         ACPI_MODULE_NAME    ("aslanalyze")
159bc36eafdSMike Gerdts 
160bc36eafdSMike Gerdts 
161bc36eafdSMike Gerdts /* Local Prototypes */
162bc36eafdSMike Gerdts 
163bc36eafdSMike Gerdts static ACPI_STATUS
164bc36eafdSMike Gerdts ApDeviceSubtreeWalk (
165bc36eafdSMike Gerdts     ACPI_PARSE_OBJECT       *Op,
166bc36eafdSMike Gerdts     UINT32                  Level,
167bc36eafdSMike Gerdts     void                    *Context);
168bc36eafdSMike Gerdts 
169bc36eafdSMike Gerdts 
170bc36eafdSMike Gerdts /*******************************************************************************
171bc36eafdSMike Gerdts  *
172bc36eafdSMike Gerdts  * FUNCTION:    AnIsInternalMethod
173bc36eafdSMike Gerdts  *
174bc36eafdSMike Gerdts  * PARAMETERS:  Op                  - Current op
175bc36eafdSMike Gerdts  *
176bc36eafdSMike Gerdts  * RETURN:      Boolean
177bc36eafdSMike Gerdts  *
178bc36eafdSMike Gerdts  * DESCRIPTION: Check for an internal control method.
179bc36eafdSMike Gerdts  *
180bc36eafdSMike Gerdts  ******************************************************************************/
181bc36eafdSMike Gerdts 
182bc36eafdSMike Gerdts BOOLEAN
AnIsInternalMethod(ACPI_PARSE_OBJECT * Op)183bc36eafdSMike Gerdts AnIsInternalMethod (
184bc36eafdSMike Gerdts     ACPI_PARSE_OBJECT       *Op)
185bc36eafdSMike Gerdts {
186bc36eafdSMike Gerdts 
187bc36eafdSMike Gerdts     if ((!strcmp (Op->Asl.ExternalName, "\\_OSI")) ||
188bc36eafdSMike Gerdts         (!strcmp (Op->Asl.ExternalName, "_OSI")))
189bc36eafdSMike Gerdts     {
190bc36eafdSMike Gerdts         return (TRUE);
191bc36eafdSMike Gerdts     }
192bc36eafdSMike Gerdts 
193bc36eafdSMike Gerdts     return (FALSE);
194bc36eafdSMike Gerdts }
195bc36eafdSMike Gerdts 
196bc36eafdSMike Gerdts 
197bc36eafdSMike Gerdts /*******************************************************************************
198bc36eafdSMike Gerdts  *
199bc36eafdSMike Gerdts  * FUNCTION:    AnGetInternalMethodReturnType
200bc36eafdSMike Gerdts  *
201bc36eafdSMike Gerdts  * PARAMETERS:  Op                  - Current op
202bc36eafdSMike Gerdts  *
203bc36eafdSMike Gerdts  * RETURN:      Btype
204bc36eafdSMike Gerdts  *
205bc36eafdSMike Gerdts  * DESCRIPTION: Get the return type of an internal method
206bc36eafdSMike Gerdts  *
207bc36eafdSMike Gerdts  ******************************************************************************/
208bc36eafdSMike Gerdts 
209bc36eafdSMike Gerdts UINT32
AnGetInternalMethodReturnType(ACPI_PARSE_OBJECT * Op)210bc36eafdSMike Gerdts AnGetInternalMethodReturnType (
211bc36eafdSMike Gerdts     ACPI_PARSE_OBJECT       *Op)
212bc36eafdSMike Gerdts {
213bc36eafdSMike Gerdts 
214bc36eafdSMike Gerdts     if ((!strcmp (Op->Asl.ExternalName, "\\_OSI")) ||
215bc36eafdSMike Gerdts         (!strcmp (Op->Asl.ExternalName, "_OSI")))
216bc36eafdSMike Gerdts     {
217bc36eafdSMike Gerdts         return (ACPI_BTYPE_STRING);
218bc36eafdSMike Gerdts     }
219bc36eafdSMike Gerdts 
220bc36eafdSMike Gerdts     return (0);
221bc36eafdSMike Gerdts }
222bc36eafdSMike Gerdts 
223bc36eafdSMike Gerdts 
224bc36eafdSMike Gerdts /*******************************************************************************
225bc36eafdSMike Gerdts  *
226bc36eafdSMike Gerdts  * FUNCTION:    AnCheckId
227bc36eafdSMike Gerdts  *
228bc36eafdSMike Gerdts  * PARAMETERS:  Op                  - Current parse op
229bc36eafdSMike Gerdts  *              Type                - HID or CID
230bc36eafdSMike Gerdts  *
231bc36eafdSMike Gerdts  * RETURN:      None
232bc36eafdSMike Gerdts  *
233bc36eafdSMike Gerdts  * DESCRIPTION: Perform various checks on _HID and _CID strings. Only limited
234bc36eafdSMike Gerdts  *              checks can be performed on _CID strings.
235bc36eafdSMike Gerdts  *
236bc36eafdSMike Gerdts  ******************************************************************************/
237bc36eafdSMike Gerdts 
238bc36eafdSMike Gerdts void
AnCheckId(ACPI_PARSE_OBJECT * Op,ACPI_NAME Type)239bc36eafdSMike Gerdts AnCheckId (
240bc36eafdSMike Gerdts     ACPI_PARSE_OBJECT       *Op,
241bc36eafdSMike Gerdts     ACPI_NAME               Type)
242bc36eafdSMike Gerdts {
243bc36eafdSMike Gerdts     UINT32                  i;
244bc36eafdSMike Gerdts     ACPI_SIZE               Length;
245bc36eafdSMike Gerdts 
246bc36eafdSMike Gerdts 
247bc36eafdSMike Gerdts     /* Only care about string versions of _HID/_CID (integers are legal) */
248bc36eafdSMike Gerdts 
249bc36eafdSMike Gerdts     if (Op->Asl.ParseOpcode != PARSEOP_STRING_LITERAL)
250bc36eafdSMike Gerdts     {
251bc36eafdSMike Gerdts         return;
252bc36eafdSMike Gerdts     }
253bc36eafdSMike Gerdts 
254bc36eafdSMike Gerdts     /* For both _HID and _CID, the string must be non-null */
255bc36eafdSMike Gerdts 
256bc36eafdSMike Gerdts     Length = strlen (Op->Asl.Value.String);
257bc36eafdSMike Gerdts     if (!Length)
258bc36eafdSMike Gerdts     {
259bc36eafdSMike Gerdts         AslError (ASL_ERROR, ASL_MSG_NULL_STRING, Op, NULL);
260bc36eafdSMike Gerdts         return;
261bc36eafdSMike Gerdts     }
262bc36eafdSMike Gerdts 
263bc36eafdSMike Gerdts     /*
264bc36eafdSMike Gerdts      * One of the things we want to catch here is the use of a leading
265bc36eafdSMike Gerdts      * asterisk in the string -- an odd construct that certain platform
266bc36eafdSMike Gerdts      * manufacturers are fond of. Technically, a leading asterisk is OK
267bc36eafdSMike Gerdts      * for _CID, but a valid use of this has not been seen.
268bc36eafdSMike Gerdts      */
269bc36eafdSMike Gerdts     if (*Op->Asl.Value.String == '*')
270bc36eafdSMike Gerdts     {
271bc36eafdSMike Gerdts         AslError (ASL_ERROR, ASL_MSG_LEADING_ASTERISK,
272bc36eafdSMike Gerdts             Op, Op->Asl.Value.String);
273bc36eafdSMike Gerdts         return;
274bc36eafdSMike Gerdts     }
275bc36eafdSMike Gerdts 
276bc36eafdSMike Gerdts     /* _CID strings are bus-specific, no more checks can be performed */
277bc36eafdSMike Gerdts 
278bc36eafdSMike Gerdts     if (Type == ASL_TYPE_CID)
279bc36eafdSMike Gerdts     {
280bc36eafdSMike Gerdts         return;
281bc36eafdSMike Gerdts     }
282bc36eafdSMike Gerdts 
283bc36eafdSMike Gerdts     /* For _HID, all characters must be alphanumeric */
284bc36eafdSMike Gerdts 
285bc36eafdSMike Gerdts     for (i = 0; Op->Asl.Value.String[i]; i++)
286bc36eafdSMike Gerdts     {
287bc36eafdSMike Gerdts         if (!isalnum ((int) Op->Asl.Value.String[i]))
288bc36eafdSMike Gerdts         {
289bc36eafdSMike Gerdts             AslError (ASL_ERROR, ASL_MSG_ALPHANUMERIC_STRING,
290bc36eafdSMike Gerdts                 Op, Op->Asl.Value.String);
291bc36eafdSMike Gerdts             return;
292bc36eafdSMike Gerdts         }
293bc36eafdSMike Gerdts     }
294bc36eafdSMike Gerdts 
295bc36eafdSMike Gerdts     /*
296bc36eafdSMike Gerdts      * _HID String must be one of these forms:
297bc36eafdSMike Gerdts      *
298bc36eafdSMike Gerdts      * "AAA####"    A is an uppercase letter and # is a hex digit
299bc36eafdSMike Gerdts      * "ACPI####"   # is a hex digit
300bc36eafdSMike Gerdts      * "NNNN####"   N is an uppercase letter or decimal digit (0-9)
301bc36eafdSMike Gerdts      *              # is a hex digit (ACPI 5.0)
302bc36eafdSMike Gerdts      */
303bc36eafdSMike Gerdts     if ((Length < 7) || (Length > 8))
304bc36eafdSMike Gerdts     {
305bc36eafdSMike Gerdts         AslError (ASL_ERROR, ASL_MSG_HID_LENGTH,
306bc36eafdSMike Gerdts             Op, Op->Asl.Value.String);
307bc36eafdSMike Gerdts         return;
308bc36eafdSMike Gerdts     }
309bc36eafdSMike Gerdts 
310bc36eafdSMike Gerdts     /* _HID Length is valid (7 or 8), now check prefix (first 3 or 4 chars) */
311bc36eafdSMike Gerdts 
312bc36eafdSMike Gerdts     if (Length == 7)
313bc36eafdSMike Gerdts     {
314bc36eafdSMike Gerdts         /* AAA####: Ensure the alphabetic prefix is all uppercase */
315bc36eafdSMike Gerdts 
316bc36eafdSMike Gerdts         for (i = 0; i < 3; i++)
317bc36eafdSMike Gerdts         {
318bc36eafdSMike Gerdts             if (!isupper ((int) Op->Asl.Value.String[i]))
319bc36eafdSMike Gerdts             {
320bc36eafdSMike Gerdts                 AslError (ASL_ERROR, ASL_MSG_UPPER_CASE,
321bc36eafdSMike Gerdts                     Op, &Op->Asl.Value.String[i]);
322bc36eafdSMike Gerdts                 return;
323bc36eafdSMike Gerdts             }
324bc36eafdSMike Gerdts         }
325bc36eafdSMike Gerdts     }
326bc36eafdSMike Gerdts     else /* Length == 8 */
327bc36eafdSMike Gerdts     {
328bc36eafdSMike Gerdts         /*
329bc36eafdSMike Gerdts          * ACPI#### or NNNN####:
330bc36eafdSMike Gerdts          * Ensure the prefix contains only uppercase alpha or decimal digits
331bc36eafdSMike Gerdts          */
332bc36eafdSMike Gerdts         for (i = 0; i < 4; i++)
333bc36eafdSMike Gerdts         {
334bc36eafdSMike Gerdts             if (!isupper ((int) Op->Asl.Value.String[i]) &&
335bc36eafdSMike Gerdts                 !isdigit ((int) Op->Asl.Value.String[i]))
336bc36eafdSMike Gerdts             {
337bc36eafdSMike Gerdts                 AslError (ASL_ERROR, ASL_MSG_HID_PREFIX,
338bc36eafdSMike Gerdts                     Op, &Op->Asl.Value.String[i]);
339bc36eafdSMike Gerdts                 return;
340bc36eafdSMike Gerdts             }
341bc36eafdSMike Gerdts         }
342bc36eafdSMike Gerdts     }
343bc36eafdSMike Gerdts 
344bc36eafdSMike Gerdts     /* Remaining characters (suffix) must be hex digits */
345bc36eafdSMike Gerdts 
346bc36eafdSMike Gerdts     for (; i < Length; i++)
347bc36eafdSMike Gerdts     {
348bc36eafdSMike Gerdts         if (!isxdigit ((int) Op->Asl.Value.String[i]))
349bc36eafdSMike Gerdts         {
350bc36eafdSMike Gerdts             AslError (ASL_ERROR, ASL_MSG_HID_SUFFIX,
351bc36eafdSMike Gerdts                 Op, &Op->Asl.Value.String[i]);
352bc36eafdSMike Gerdts             break;
353bc36eafdSMike Gerdts         }
354bc36eafdSMike Gerdts     }
355bc36eafdSMike Gerdts }
356bc36eafdSMike Gerdts 
357bc36eafdSMike Gerdts 
358bc36eafdSMike Gerdts /*******************************************************************************
359bc36eafdSMike Gerdts  *
360bc36eafdSMike Gerdts  * FUNCTION:    AnLastStatementIsReturn
361bc36eafdSMike Gerdts  *
362bc36eafdSMike Gerdts  * PARAMETERS:  Op                  - A method parse node
363bc36eafdSMike Gerdts  *
364bc36eafdSMike Gerdts  * RETURN:      TRUE if last statement is an ASL RETURN. False otherwise
365bc36eafdSMike Gerdts  *
366bc36eafdSMike Gerdts  * DESCRIPTION: Walk down the list of top level statements within a method
367bc36eafdSMike Gerdts  *              to find the last one. Check if that last statement is in
368bc36eafdSMike Gerdts  *              fact a RETURN statement.
369bc36eafdSMike Gerdts  *
370bc36eafdSMike Gerdts  ******************************************************************************/
371bc36eafdSMike Gerdts 
372bc36eafdSMike Gerdts BOOLEAN
AnLastStatementIsReturn(ACPI_PARSE_OBJECT * Op)373bc36eafdSMike Gerdts AnLastStatementIsReturn (
374bc36eafdSMike Gerdts     ACPI_PARSE_OBJECT       *Op)
375bc36eafdSMike Gerdts {
376bc36eafdSMike Gerdts     ACPI_PARSE_OBJECT       *Next;
377bc36eafdSMike Gerdts 
378bc36eafdSMike Gerdts 
379bc36eafdSMike Gerdts     /* Check if last statement is a return */
380bc36eafdSMike Gerdts 
381bc36eafdSMike Gerdts     Next = ASL_GET_CHILD_NODE (Op);
382bc36eafdSMike Gerdts     while (Next)
383bc36eafdSMike Gerdts     {
384bc36eafdSMike Gerdts         if ((!Next->Asl.Next) &&
385bc36eafdSMike Gerdts             (Next->Asl.ParseOpcode == PARSEOP_RETURN))
386bc36eafdSMike Gerdts         {
387bc36eafdSMike Gerdts             return (TRUE);
388bc36eafdSMike Gerdts         }
389bc36eafdSMike Gerdts 
390bc36eafdSMike Gerdts         Next = ASL_GET_PEER_NODE (Next);
391bc36eafdSMike Gerdts     }
392bc36eafdSMike Gerdts 
393bc36eafdSMike Gerdts     return (FALSE);
394bc36eafdSMike Gerdts }
395bc36eafdSMike Gerdts 
396bc36eafdSMike Gerdts 
397bc36eafdSMike Gerdts /*******************************************************************************
398bc36eafdSMike Gerdts  *
399bc36eafdSMike Gerdts  * FUNCTION:    AnCheckMethodReturnValue
400bc36eafdSMike Gerdts  *
401bc36eafdSMike Gerdts  * PARAMETERS:  Op                  - Parent
402bc36eafdSMike Gerdts  *              OpInfo              - Parent info
403bc36eafdSMike Gerdts  *              ArgOp               - Method invocation op
404bc36eafdSMike Gerdts  *              RequiredBtypes      - What caller requires
405bc36eafdSMike Gerdts  *              ThisNodeBtype       - What this node returns (if anything)
406bc36eafdSMike Gerdts  *
407bc36eafdSMike Gerdts  * RETURN:      None
408bc36eafdSMike Gerdts  *
409bc36eafdSMike Gerdts  * DESCRIPTION: Check a method invocation for 1) A return value and if it does
410bc36eafdSMike Gerdts  *              in fact return a value, 2) check the type of the return value.
411bc36eafdSMike Gerdts  *
412bc36eafdSMike Gerdts  ******************************************************************************/
413bc36eafdSMike Gerdts 
414bc36eafdSMike Gerdts void
AnCheckMethodReturnValue(ACPI_PARSE_OBJECT * Op,const ACPI_OPCODE_INFO * OpInfo,ACPI_PARSE_OBJECT * ArgOp,UINT32 RequiredBtypes,UINT32 ThisNodeBtype)415bc36eafdSMike Gerdts AnCheckMethodReturnValue (
416bc36eafdSMike Gerdts     ACPI_PARSE_OBJECT       *Op,
417bc36eafdSMike Gerdts     const ACPI_OPCODE_INFO  *OpInfo,
418bc36eafdSMike Gerdts     ACPI_PARSE_OBJECT       *ArgOp,
419bc36eafdSMike Gerdts     UINT32                  RequiredBtypes,
420bc36eafdSMike Gerdts     UINT32                  ThisNodeBtype)
421bc36eafdSMike Gerdts {
422bc36eafdSMike Gerdts     ACPI_PARSE_OBJECT       *OwningOp;
423bc36eafdSMike Gerdts     ACPI_NAMESPACE_NODE     *Node;
424bc36eafdSMike Gerdts 
425bc36eafdSMike Gerdts 
426bc36eafdSMike Gerdts     Node = ArgOp->Asl.Node;
427bc36eafdSMike Gerdts 
428bc36eafdSMike Gerdts     if (!Node)
429bc36eafdSMike Gerdts     {
430bc36eafdSMike Gerdts         /* No error message, this can happen and is OK */
431bc36eafdSMike Gerdts 
432bc36eafdSMike Gerdts         return;
433bc36eafdSMike Gerdts     }
434bc36eafdSMike Gerdts 
435bc36eafdSMike Gerdts     /* Examine the parent op of this method */
436bc36eafdSMike Gerdts 
437bc36eafdSMike Gerdts     OwningOp = Node->Op;
438*35786f68SRobert Mustacchi     if (OwningOp->Asl.CompileFlags & OP_METHOD_NO_RETVAL)
439bc36eafdSMike Gerdts     {
440bc36eafdSMike Gerdts         /* Method NEVER returns a value */
441bc36eafdSMike Gerdts 
442bc36eafdSMike Gerdts         AslError (ASL_ERROR, ASL_MSG_NO_RETVAL, Op, Op->Asl.ExternalName);
443bc36eafdSMike Gerdts     }
444*35786f68SRobert Mustacchi     else if (OwningOp->Asl.CompileFlags & OP_METHOD_SOME_NO_RETVAL)
445bc36eafdSMike Gerdts     {
446bc36eafdSMike Gerdts         /* Method SOMETIMES returns a value, SOMETIMES not */
447bc36eafdSMike Gerdts 
448bc36eafdSMike Gerdts         AslError (ASL_WARNING, ASL_MSG_SOME_NO_RETVAL,
449bc36eafdSMike Gerdts             Op, Op->Asl.ExternalName);
450bc36eafdSMike Gerdts     }
451bc36eafdSMike Gerdts     else if (!(ThisNodeBtype & RequiredBtypes))
452bc36eafdSMike Gerdts     {
453bc36eafdSMike Gerdts         /* Method returns a value, but the type is wrong */
454bc36eafdSMike Gerdts 
455bc36eafdSMike Gerdts         AnFormatBtype (StringBuffer, ThisNodeBtype);
456bc36eafdSMike Gerdts         AnFormatBtype (StringBuffer2, RequiredBtypes);
457bc36eafdSMike Gerdts 
458bc36eafdSMike Gerdts         /*
459bc36eafdSMike Gerdts          * The case where the method does not return any value at all
460bc36eafdSMike Gerdts          * was already handled in the namespace cross reference
461bc36eafdSMike Gerdts          * -- Only issue an error if the method in fact returns a value,
462bc36eafdSMike Gerdts          * but it is of the wrong type
463bc36eafdSMike Gerdts          */
464bc36eafdSMike Gerdts         if (ThisNodeBtype != 0)
465bc36eafdSMike Gerdts         {
466bc36eafdSMike Gerdts             sprintf (MsgBuffer,
467bc36eafdSMike Gerdts                 "Method returns [%s], %s operator requires [%s]",
468bc36eafdSMike Gerdts                 StringBuffer, OpInfo->Name, StringBuffer2);
469bc36eafdSMike Gerdts 
470bc36eafdSMike Gerdts             AslError (ASL_ERROR, ASL_MSG_INVALID_TYPE, ArgOp, MsgBuffer);
471bc36eafdSMike Gerdts         }
472bc36eafdSMike Gerdts     }
473bc36eafdSMike Gerdts }
474bc36eafdSMike Gerdts 
475bc36eafdSMike Gerdts 
476bc36eafdSMike Gerdts /*******************************************************************************
477bc36eafdSMike Gerdts  *
478bc36eafdSMike Gerdts  * FUNCTION:    AnIsResultUsed
479bc36eafdSMike Gerdts  *
480bc36eafdSMike Gerdts  * PARAMETERS:  Op                  - Parent op for the operator
481bc36eafdSMike Gerdts  *
482bc36eafdSMike Gerdts  * RETURN:      TRUE if result from this operation is actually consumed
483bc36eafdSMike Gerdts  *
484bc36eafdSMike Gerdts  * DESCRIPTION: Determine if the function result value from an operator is
485bc36eafdSMike Gerdts  *              used.
486bc36eafdSMike Gerdts  *
487bc36eafdSMike Gerdts  ******************************************************************************/
488bc36eafdSMike Gerdts 
489bc36eafdSMike Gerdts BOOLEAN
AnIsResultUsed(ACPI_PARSE_OBJECT * Op)490bc36eafdSMike Gerdts AnIsResultUsed (
491bc36eafdSMike Gerdts     ACPI_PARSE_OBJECT       *Op)
492bc36eafdSMike Gerdts {
493bc36eafdSMike Gerdts     ACPI_PARSE_OBJECT       *Parent;
494bc36eafdSMike Gerdts 
495bc36eafdSMike Gerdts 
496bc36eafdSMike Gerdts     switch (Op->Asl.ParseOpcode)
497bc36eafdSMike Gerdts     {
498bc36eafdSMike Gerdts     case PARSEOP_INCREMENT:
499bc36eafdSMike Gerdts     case PARSEOP_DECREMENT:
500bc36eafdSMike Gerdts 
501bc36eafdSMike Gerdts         /* These are standalone operators, no return value */
502bc36eafdSMike Gerdts 
503bc36eafdSMike Gerdts         return (TRUE);
504bc36eafdSMike Gerdts 
505bc36eafdSMike Gerdts     default:
506bc36eafdSMike Gerdts 
507bc36eafdSMike Gerdts         break;
508bc36eafdSMike Gerdts     }
509bc36eafdSMike Gerdts 
510bc36eafdSMike Gerdts     /* Examine parent to determine if the return value is used */
511bc36eafdSMike Gerdts 
512bc36eafdSMike Gerdts     Parent = Op->Asl.Parent;
513bc36eafdSMike Gerdts     switch (Parent->Asl.ParseOpcode)
514bc36eafdSMike Gerdts     {
515bc36eafdSMike Gerdts     /* If/While - check if the operator is the predicate */
516bc36eafdSMike Gerdts 
517bc36eafdSMike Gerdts     case PARSEOP_IF:
518bc36eafdSMike Gerdts     case PARSEOP_WHILE:
519bc36eafdSMike Gerdts 
520bc36eafdSMike Gerdts         /* First child is the predicate */
521bc36eafdSMike Gerdts 
522bc36eafdSMike Gerdts         if (Parent->Asl.Child == Op)
523bc36eafdSMike Gerdts         {
524bc36eafdSMike Gerdts             return (TRUE);
525bc36eafdSMike Gerdts         }
526bc36eafdSMike Gerdts 
527bc36eafdSMike Gerdts         return (FALSE);
528bc36eafdSMike Gerdts 
529bc36eafdSMike Gerdts     /* Not used if one of these is the parent */
530bc36eafdSMike Gerdts 
531bc36eafdSMike Gerdts     case PARSEOP_METHOD:
532bc36eafdSMike Gerdts     case PARSEOP_DEFINITION_BLOCK:
533bc36eafdSMike Gerdts     case PARSEOP_ELSE:
534bc36eafdSMike Gerdts 
535bc36eafdSMike Gerdts         return (FALSE);
536bc36eafdSMike Gerdts 
537bc36eafdSMike Gerdts     default:
538bc36eafdSMike Gerdts 
539bc36eafdSMike Gerdts         /* Any other type of parent means that the result is used */
540bc36eafdSMike Gerdts 
541bc36eafdSMike Gerdts         return (TRUE);
542bc36eafdSMike Gerdts     }
543bc36eafdSMike Gerdts }
544bc36eafdSMike Gerdts 
545bc36eafdSMike Gerdts 
546bc36eafdSMike Gerdts /*******************************************************************************
547bc36eafdSMike Gerdts  *
548bc36eafdSMike Gerdts  * FUNCTION:    ApCheckForGpeNameConflict
549bc36eafdSMike Gerdts  *
550bc36eafdSMike Gerdts  * PARAMETERS:  Op                  - Current parse op
551bc36eafdSMike Gerdts  *
552bc36eafdSMike Gerdts  * RETURN:      None
553bc36eafdSMike Gerdts  *
554bc36eafdSMike Gerdts  * DESCRIPTION: Check for a conflict between GPE names within this scope.
555bc36eafdSMike Gerdts  *              Conflict means two GPE names with the same GPE number, but
556bc36eafdSMike Gerdts  *              different types -- such as _L1C and _E1C.
557bc36eafdSMike Gerdts  *
558bc36eafdSMike Gerdts  ******************************************************************************/
559bc36eafdSMike Gerdts 
560bc36eafdSMike Gerdts void
ApCheckForGpeNameConflict(ACPI_PARSE_OBJECT * Op)561bc36eafdSMike Gerdts ApCheckForGpeNameConflict (
562bc36eafdSMike Gerdts     ACPI_PARSE_OBJECT       *Op)
563bc36eafdSMike Gerdts {
564bc36eafdSMike Gerdts     ACPI_PARSE_OBJECT       *NextOp;
565bc36eafdSMike Gerdts     UINT32                  GpeNumber;
566bc36eafdSMike Gerdts     char                    Name[ACPI_NAME_SIZE + 1];
567bc36eafdSMike Gerdts     char                    Target[ACPI_NAME_SIZE];
568bc36eafdSMike Gerdts 
569bc36eafdSMike Gerdts 
570bc36eafdSMike Gerdts     /* Need a null-terminated string version of NameSeg */
571bc36eafdSMike Gerdts 
572bc36eafdSMike Gerdts     ACPI_MOVE_32_TO_32 (Name, &Op->Asl.NameSeg);
573bc36eafdSMike Gerdts     Name[ACPI_NAME_SIZE] = 0;
574bc36eafdSMike Gerdts 
575bc36eafdSMike Gerdts     /*
576bc36eafdSMike Gerdts      * For a GPE method:
577bc36eafdSMike Gerdts      * 1st char must be underscore
578bc36eafdSMike Gerdts      * 2nd char must be L or E
579bc36eafdSMike Gerdts      * 3rd/4th chars must be a hex number
580bc36eafdSMike Gerdts      */
581bc36eafdSMike Gerdts     if ((Name[0] != '_') ||
582bc36eafdSMike Gerdts        ((Name[1] != 'L') && (Name[1] != 'E')))
583bc36eafdSMike Gerdts     {
584bc36eafdSMike Gerdts         return;
585bc36eafdSMike Gerdts     }
586bc36eafdSMike Gerdts 
587bc36eafdSMike Gerdts     /* Verify 3rd/4th chars are a valid hex value */
588bc36eafdSMike Gerdts 
589bc36eafdSMike Gerdts     GpeNumber = strtoul (&Name[2], NULL, 16);
590bc36eafdSMike Gerdts     if (GpeNumber == ACPI_UINT32_MAX)
591bc36eafdSMike Gerdts     {
592bc36eafdSMike Gerdts         return;
593bc36eafdSMike Gerdts     }
594bc36eafdSMike Gerdts 
595bc36eafdSMike Gerdts     /*
596bc36eafdSMike Gerdts      * We are now sure we have an _Lxx or _Exx.
597bc36eafdSMike Gerdts      * Create the target name that would cause collision (Flip E/L)
598bc36eafdSMike Gerdts      */
599bc36eafdSMike Gerdts     ACPI_MOVE_32_TO_32 (Target, Name);
600bc36eafdSMike Gerdts 
601bc36eafdSMike Gerdts     /* Inject opposite letter ("L" versus "E") */
602bc36eafdSMike Gerdts 
603bc36eafdSMike Gerdts     if (Name[1] == 'L')
604bc36eafdSMike Gerdts     {
605bc36eafdSMike Gerdts         Target[1] = 'E';
606bc36eafdSMike Gerdts     }
607bc36eafdSMike Gerdts     else /* Name[1] == 'E' */
608bc36eafdSMike Gerdts     {
609bc36eafdSMike Gerdts         Target[1] = 'L';
610bc36eafdSMike Gerdts     }
611bc36eafdSMike Gerdts 
612bc36eafdSMike Gerdts     /* Search all peers (objects within this scope) for target match */
613bc36eafdSMike Gerdts 
614bc36eafdSMike Gerdts     NextOp = Op->Asl.Next;
615bc36eafdSMike Gerdts     while (NextOp)
616bc36eafdSMike Gerdts     {
617bc36eafdSMike Gerdts         /*
618bc36eafdSMike Gerdts          * We mostly care about methods, but check Name() constructs also,
619bc36eafdSMike Gerdts          * even though they will get another error for not being a method.
620bc36eafdSMike Gerdts          * All GPE names must be defined as control methods.
621bc36eafdSMike Gerdts          */
622bc36eafdSMike Gerdts         if ((NextOp->Asl.ParseOpcode == PARSEOP_METHOD) ||
623bc36eafdSMike Gerdts             (NextOp->Asl.ParseOpcode == PARSEOP_NAME))
624bc36eafdSMike Gerdts         {
625bc36eafdSMike Gerdts             if (ACPI_COMPARE_NAME (Target, NextOp->Asl.NameSeg))
626bc36eafdSMike Gerdts             {
627bc36eafdSMike Gerdts                 /* Found both _Exy and _Lxy in the same scope, error */
628bc36eafdSMike Gerdts 
629bc36eafdSMike Gerdts                 AslError (ASL_ERROR, ASL_MSG_GPE_NAME_CONFLICT, NextOp,
630bc36eafdSMike Gerdts                     Name);
631bc36eafdSMike Gerdts                 return;
632bc36eafdSMike Gerdts             }
633bc36eafdSMike Gerdts         }
634bc36eafdSMike Gerdts 
635bc36eafdSMike Gerdts         NextOp = NextOp->Asl.Next;
636bc36eafdSMike Gerdts     }
637bc36eafdSMike Gerdts 
638bc36eafdSMike Gerdts     /* OK, no conflict found */
639bc36eafdSMike Gerdts 
640bc36eafdSMike Gerdts     return;
641bc36eafdSMike Gerdts }
642bc36eafdSMike Gerdts 
643bc36eafdSMike Gerdts 
644bc36eafdSMike Gerdts /*******************************************************************************
645bc36eafdSMike Gerdts  *
646bc36eafdSMike Gerdts  * FUNCTION:    ApCheckRegMethod
647bc36eafdSMike Gerdts  *
648bc36eafdSMike Gerdts  * PARAMETERS:  Op                  - Current parse op
649bc36eafdSMike Gerdts  *
650bc36eafdSMike Gerdts  * RETURN:      None
651bc36eafdSMike Gerdts  *
652bc36eafdSMike Gerdts  * DESCRIPTION: Ensure that a _REG method has a corresponding Operation
653bc36eafdSMike Gerdts  *              Region declaration within the same scope. Note: _REG is defined
654bc36eafdSMike Gerdts  *              to have two arguments and must therefore be defined as a
655bc36eafdSMike Gerdts  *              control method.
656bc36eafdSMike Gerdts  *
657bc36eafdSMike Gerdts  ******************************************************************************/
658bc36eafdSMike Gerdts 
659bc36eafdSMike Gerdts void
ApCheckRegMethod(ACPI_PARSE_OBJECT * Op)660bc36eafdSMike Gerdts ApCheckRegMethod (
661bc36eafdSMike Gerdts     ACPI_PARSE_OBJECT       *Op)
662bc36eafdSMike Gerdts {
663bc36eafdSMike Gerdts     ACPI_PARSE_OBJECT       *Next;
664bc36eafdSMike Gerdts     ACPI_PARSE_OBJECT       *Parent;
665bc36eafdSMike Gerdts 
666bc36eafdSMike Gerdts 
667bc36eafdSMike Gerdts     /* We are only interested in _REG methods */
668bc36eafdSMike Gerdts 
669bc36eafdSMike Gerdts     if (!ACPI_COMPARE_NAME (METHOD_NAME__REG, &Op->Asl.NameSeg))
670bc36eafdSMike Gerdts     {
671bc36eafdSMike Gerdts         return;
672bc36eafdSMike Gerdts     }
673bc36eafdSMike Gerdts 
674bc36eafdSMike Gerdts     /* Get the start of the current scope */
675bc36eafdSMike Gerdts 
676bc36eafdSMike Gerdts     Parent = Op->Asl.Parent;
677bc36eafdSMike Gerdts     Next = Parent->Asl.Child;
678bc36eafdSMike Gerdts 
679bc36eafdSMike Gerdts     /* Search entire scope for an operation region declaration */
680bc36eafdSMike Gerdts 
681bc36eafdSMike Gerdts     while (Next)
682bc36eafdSMike Gerdts     {
683bc36eafdSMike Gerdts         if (Next->Asl.ParseOpcode == PARSEOP_OPERATIONREGION)
684bc36eafdSMike Gerdts         {
685bc36eafdSMike Gerdts             return; /* Found region, OK */
686bc36eafdSMike Gerdts         }
687bc36eafdSMike Gerdts 
688bc36eafdSMike Gerdts         Next = Next->Asl.Next;
689bc36eafdSMike Gerdts     }
690bc36eafdSMike Gerdts 
691bc36eafdSMike Gerdts     /* No region found, issue warning */
692bc36eafdSMike Gerdts 
693bc36eafdSMike Gerdts     AslError (ASL_WARNING, ASL_MSG_NO_REGION, Op, NULL);
694bc36eafdSMike Gerdts }
695bc36eafdSMike Gerdts 
696bc36eafdSMike Gerdts 
697bc36eafdSMike Gerdts /*******************************************************************************
698bc36eafdSMike Gerdts  *
699bc36eafdSMike Gerdts  * FUNCTION:    ApFindNameInDeviceTree
700bc36eafdSMike Gerdts  *
701bc36eafdSMike Gerdts  * PARAMETERS:  Name                - Name to search for
702bc36eafdSMike Gerdts  *              Op                  - Current parse op
703bc36eafdSMike Gerdts  *
704bc36eafdSMike Gerdts  * RETURN:      TRUE if name found in the same scope as Op.
705bc36eafdSMike Gerdts  *
706bc36eafdSMike Gerdts  * DESCRIPTION: Determine if a name appears in the same scope as Op, as either
707bc36eafdSMike Gerdts  *              a Method() or a Name(). "Same scope" can mean under an If or
708bc36eafdSMike Gerdts  *              Else statement.
709bc36eafdSMike Gerdts  *
710bc36eafdSMike Gerdts  * NOTE: Detects _HID/_ADR in this type of construct (legal in ACPI 6.1+)
711bc36eafdSMike Gerdts  *
712bc36eafdSMike Gerdts  * Scope (\_SB.PCI0)
713bc36eafdSMike Gerdts  * {
714bc36eafdSMike Gerdts  *     Device (I2C0)
715bc36eafdSMike Gerdts  *     {
716bc36eafdSMike Gerdts  *         If (SMD0 != 4) {
717bc36eafdSMike Gerdts  *             Name (_HID, "INT3442")
718bc36eafdSMike Gerdts  *         } Else {
719bc36eafdSMike Gerdts  *             Name (_ADR, 0x400)
720bc36eafdSMike Gerdts  *         }
721bc36eafdSMike Gerdts  *     }
722bc36eafdSMike Gerdts  * }
723bc36eafdSMike Gerdts  ******************************************************************************/
724bc36eafdSMike Gerdts 
725bc36eafdSMike Gerdts BOOLEAN
ApFindNameInDeviceTree(char * Name,ACPI_PARSE_OBJECT * Op)726bc36eafdSMike Gerdts ApFindNameInDeviceTree (
727bc36eafdSMike Gerdts     char                    *Name,
728bc36eafdSMike Gerdts     ACPI_PARSE_OBJECT       *Op)
729bc36eafdSMike Gerdts {
730bc36eafdSMike Gerdts     ACPI_STATUS             Status;
731bc36eafdSMike Gerdts 
732bc36eafdSMike Gerdts 
733bc36eafdSMike Gerdts     Status = TrWalkParseTree (Op, ASL_WALK_VISIT_DOWNWARD,
734bc36eafdSMike Gerdts         ApDeviceSubtreeWalk, NULL, Name);
735bc36eafdSMike Gerdts 
736bc36eafdSMike Gerdts     if (Status == AE_CTRL_TRUE)
737bc36eafdSMike Gerdts     {
738bc36eafdSMike Gerdts         return (TRUE);  /* Found a match */
739bc36eafdSMike Gerdts     }
740bc36eafdSMike Gerdts 
741bc36eafdSMike Gerdts     return (FALSE);
742bc36eafdSMike Gerdts }
743bc36eafdSMike Gerdts 
744bc36eafdSMike Gerdts 
745bc36eafdSMike Gerdts /* Callback function for interface above */
746bc36eafdSMike Gerdts 
747bc36eafdSMike Gerdts static ACPI_STATUS
ApDeviceSubtreeWalk(ACPI_PARSE_OBJECT * Op,UINT32 Level,void * Context)748bc36eafdSMike Gerdts ApDeviceSubtreeWalk (
749bc36eafdSMike Gerdts     ACPI_PARSE_OBJECT       *Op,
750bc36eafdSMike Gerdts     UINT32                  Level,
751bc36eafdSMike Gerdts     void                    *Context)
752bc36eafdSMike Gerdts {
753bc36eafdSMike Gerdts     char                    *Name = ACPI_CAST_PTR (char, Context);
754bc36eafdSMike Gerdts 
755bc36eafdSMike Gerdts 
756bc36eafdSMike Gerdts     switch (Op->Asl.ParseOpcode)
757bc36eafdSMike Gerdts     {
758bc36eafdSMike Gerdts     case PARSEOP_DEVICE:
759bc36eafdSMike Gerdts 
760bc36eafdSMike Gerdts         /* Level 0 is the starting device, ignore it */
761bc36eafdSMike Gerdts 
762bc36eafdSMike Gerdts         if (Level > 0)
763bc36eafdSMike Gerdts         {
764bc36eafdSMike Gerdts             /* Ignore sub-devices */
765bc36eafdSMike Gerdts 
766bc36eafdSMike Gerdts             return (AE_CTRL_DEPTH);
767bc36eafdSMike Gerdts         }
768bc36eafdSMike Gerdts         break;
769bc36eafdSMike Gerdts 
770bc36eafdSMike Gerdts     case PARSEOP_NAME:
771bc36eafdSMike Gerdts     case PARSEOP_METHOD:
772bc36eafdSMike Gerdts 
773bc36eafdSMike Gerdts         /* These are what we are looking for */
774bc36eafdSMike Gerdts 
775bc36eafdSMike Gerdts         if (ACPI_COMPARE_NAME (Name, Op->Asl.NameSeg))
776bc36eafdSMike Gerdts         {
777bc36eafdSMike Gerdts             return (AE_CTRL_TRUE);
778bc36eafdSMike Gerdts         }
779bc36eafdSMike Gerdts         return (AE_CTRL_DEPTH);
780bc36eafdSMike Gerdts 
781bc36eafdSMike Gerdts     case PARSEOP_SCOPE:
782bc36eafdSMike Gerdts     case PARSEOP_FIELD:
783bc36eafdSMike Gerdts     case PARSEOP_OPERATIONREGION:
784bc36eafdSMike Gerdts 
785bc36eafdSMike Gerdts         /*
786bc36eafdSMike Gerdts          * We want to ignore these, because either they can be large
787bc36eafdSMike Gerdts          * subtrees or open a scope to somewhere else.
788bc36eafdSMike Gerdts          */
789bc36eafdSMike Gerdts         return (AE_CTRL_DEPTH);
790bc36eafdSMike Gerdts 
791bc36eafdSMike Gerdts     default:
792bc36eafdSMike Gerdts         break;
793bc36eafdSMike Gerdts     }
794bc36eafdSMike Gerdts 
795bc36eafdSMike Gerdts     return (AE_OK);
796bc36eafdSMike Gerdts }
797bc36eafdSMike Gerdts 
798bc36eafdSMike Gerdts 
799bc36eafdSMike Gerdts /*******************************************************************************
800bc36eafdSMike Gerdts  *
801bc36eafdSMike Gerdts  * FUNCTION:    ApFindNameInScope
802bc36eafdSMike Gerdts  *
803bc36eafdSMike Gerdts  * PARAMETERS:  Name                - Name to search for
804bc36eafdSMike Gerdts  *              Op                  - Current parse op
805bc36eafdSMike Gerdts  *
806bc36eafdSMike Gerdts  * RETURN:      TRUE if name found in the same scope as Op.
807bc36eafdSMike Gerdts  *
808bc36eafdSMike Gerdts  * DESCRIPTION: Determine if a name appears in the same scope as Op, as either
809bc36eafdSMike Gerdts  *              a Method() or a Name().
810bc36eafdSMike Gerdts  *
811bc36eafdSMike Gerdts  ******************************************************************************/
812bc36eafdSMike Gerdts 
813bc36eafdSMike Gerdts BOOLEAN
ApFindNameInScope(char * Name,ACPI_PARSE_OBJECT * Op)814bc36eafdSMike Gerdts ApFindNameInScope (
815bc36eafdSMike Gerdts     char                    *Name,
816bc36eafdSMike Gerdts     ACPI_PARSE_OBJECT       *Op)
817bc36eafdSMike Gerdts {
818bc36eafdSMike Gerdts     ACPI_PARSE_OBJECT       *Next;
819bc36eafdSMike Gerdts     ACPI_PARSE_OBJECT       *Parent;
820bc36eafdSMike Gerdts 
821bc36eafdSMike Gerdts 
822bc36eafdSMike Gerdts     /* Get the start of the current scope */
823bc36eafdSMike Gerdts 
824bc36eafdSMike Gerdts     Parent = Op->Asl.Parent;
825bc36eafdSMike Gerdts     Next = Parent->Asl.Child;
826bc36eafdSMike Gerdts 
827bc36eafdSMike Gerdts     /* Search entire scope for a match to the name */
828bc36eafdSMike Gerdts 
829bc36eafdSMike Gerdts     while (Next)
830bc36eafdSMike Gerdts     {
831bc36eafdSMike Gerdts         if ((Next->Asl.ParseOpcode == PARSEOP_METHOD) ||
832bc36eafdSMike Gerdts             (Next->Asl.ParseOpcode == PARSEOP_NAME))
833bc36eafdSMike Gerdts         {
834bc36eafdSMike Gerdts             if (ACPI_COMPARE_NAME (Name, Next->Asl.NameSeg))
835bc36eafdSMike Gerdts             {
836bc36eafdSMike Gerdts                 return (TRUE);
837bc36eafdSMike Gerdts             }
838bc36eafdSMike Gerdts         }
839bc36eafdSMike Gerdts 
840bc36eafdSMike Gerdts         Next = Next->Asl.Next;
841bc36eafdSMike Gerdts     }
842bc36eafdSMike Gerdts 
843bc36eafdSMike Gerdts     return (FALSE);
844bc36eafdSMike Gerdts }
845