1bc36eafdSMike Gerdts /******************************************************************************
2bc36eafdSMike Gerdts *
3bc36eafdSMike Gerdts * Module Name: aslxrefout.c - support for optional cross-reference file
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 "acnamesp.h"
155bc36eafdSMike Gerdts #include "acparser.h"
156bc36eafdSMike Gerdts #include "amlcode.h"
157bc36eafdSMike Gerdts
158bc36eafdSMike Gerdts #define _COMPONENT ACPI_COMPILER
159bc36eafdSMike Gerdts ACPI_MODULE_NAME ("aslxrefout")
160bc36eafdSMike Gerdts
161bc36eafdSMike Gerdts
162bc36eafdSMike Gerdts /* Local prototypes */
163bc36eafdSMike Gerdts
164bc36eafdSMike Gerdts static ACPI_STATUS
165bc36eafdSMike Gerdts OtXrefWalkPart2 (
166bc36eafdSMike Gerdts ACPI_PARSE_OBJECT *Op,
167bc36eafdSMike Gerdts UINT32 Level,
168bc36eafdSMike Gerdts void *Context);
169bc36eafdSMike Gerdts
170bc36eafdSMike Gerdts static ACPI_STATUS
171bc36eafdSMike Gerdts OtXrefWalkPart3 (
172bc36eafdSMike Gerdts ACPI_PARSE_OBJECT *Op,
173bc36eafdSMike Gerdts UINT32 Level,
174bc36eafdSMike Gerdts void *Context);
175bc36eafdSMike Gerdts
176bc36eafdSMike Gerdts static ACPI_STATUS
177bc36eafdSMike Gerdts OtXrefAnalysisWalkPart1 (
178bc36eafdSMike Gerdts ACPI_PARSE_OBJECT *Op,
179bc36eafdSMike Gerdts UINT32 Level,
180bc36eafdSMike Gerdts void *Context);
181bc36eafdSMike Gerdts
182bc36eafdSMike Gerdts
183bc36eafdSMike Gerdts static ACPI_STATUS
184bc36eafdSMike Gerdts OtXrefAnalysisWalkPart2 (
185bc36eafdSMike Gerdts ACPI_PARSE_OBJECT *Op,
186bc36eafdSMike Gerdts UINT32 Level,
187bc36eafdSMike Gerdts void *Context);
188bc36eafdSMike Gerdts
189bc36eafdSMike Gerdts static ACPI_STATUS
190bc36eafdSMike Gerdts OtXrefAnalysisWalkPart3 (
191bc36eafdSMike Gerdts ACPI_PARSE_OBJECT *Op,
192bc36eafdSMike Gerdts UINT32 Level,
193bc36eafdSMike Gerdts void *Context);
194bc36eafdSMike Gerdts
195bc36eafdSMike Gerdts
196bc36eafdSMike Gerdts /*******************************************************************************
197bc36eafdSMike Gerdts *
198bc36eafdSMike Gerdts * FUNCTION: OtPrintHeaders
199bc36eafdSMike Gerdts *
200bc36eafdSMike Gerdts * PARAMETERS: Message - Main header message
201bc36eafdSMike Gerdts *
202bc36eafdSMike Gerdts * RETURN: None
203bc36eafdSMike Gerdts *
204bc36eafdSMike Gerdts * DESCRIPTION: Emits the main header message along with field descriptions
205bc36eafdSMike Gerdts *
206bc36eafdSMike Gerdts ******************************************************************************/
207bc36eafdSMike Gerdts
208bc36eafdSMike Gerdts void
OtPrintHeaders(char * Message)209bc36eafdSMike Gerdts OtPrintHeaders (
210bc36eafdSMike Gerdts char *Message)
211bc36eafdSMike Gerdts {
212bc36eafdSMike Gerdts UINT32 Length;
213bc36eafdSMike Gerdts
214bc36eafdSMike Gerdts
215bc36eafdSMike Gerdts Length = strlen (Message);
216bc36eafdSMike Gerdts
217bc36eafdSMike Gerdts FlPrintFile (ASL_FILE_XREF_OUTPUT, "\n\n%s\n", Message);
218bc36eafdSMike Gerdts while (Length)
219bc36eafdSMike Gerdts {
220bc36eafdSMike Gerdts FlPrintFile (ASL_FILE_XREF_OUTPUT, "-");
221bc36eafdSMike Gerdts Length--;
222bc36eafdSMike Gerdts }
223bc36eafdSMike Gerdts
224bc36eafdSMike Gerdts FlPrintFile (ASL_FILE_XREF_OUTPUT, "\n\nLineno %-40s Description\n",
225bc36eafdSMike Gerdts "Full Pathname");
226bc36eafdSMike Gerdts }
227bc36eafdSMike Gerdts
228bc36eafdSMike Gerdts
229bc36eafdSMike Gerdts /*******************************************************************************
230bc36eafdSMike Gerdts *
231bc36eafdSMike Gerdts * FUNCTION: OtCreateXrefFile
232bc36eafdSMike Gerdts *
233bc36eafdSMike Gerdts * PARAMETERS: None
234bc36eafdSMike Gerdts *
235bc36eafdSMike Gerdts * RETURN: None
236bc36eafdSMike Gerdts *
237bc36eafdSMike Gerdts * DESCRIPTION Main entry point for parts 2 and 3 of the cross-reference
238bc36eafdSMike Gerdts * file.
239bc36eafdSMike Gerdts *
240bc36eafdSMike Gerdts ******************************************************************************/
241bc36eafdSMike Gerdts
242bc36eafdSMike Gerdts void
OtCreateXrefFile(void)243bc36eafdSMike Gerdts OtCreateXrefFile (
244bc36eafdSMike Gerdts void)
245bc36eafdSMike Gerdts {
246bc36eafdSMike Gerdts ASL_XREF_INFO XrefInfo;
247bc36eafdSMike Gerdts
248bc36eafdSMike Gerdts
249bc36eafdSMike Gerdts /* Build cross-reference output file if requested */
250bc36eafdSMike Gerdts
251bc36eafdSMike Gerdts if (!Gbl_CrossReferenceOutput)
252bc36eafdSMike Gerdts {
253bc36eafdSMike Gerdts return;
254bc36eafdSMike Gerdts }
255bc36eafdSMike Gerdts
256bc36eafdSMike Gerdts memset (&XrefInfo, 0, sizeof (ASL_XREF_INFO));
257bc36eafdSMike Gerdts
258bc36eafdSMike Gerdts /* Cross-reference output file, part 2 (Method invocations) */
259bc36eafdSMike Gerdts
260bc36eafdSMike Gerdts OtPrintHeaders ("Part 2: Method Reference Map "
261bc36eafdSMike Gerdts "(Invocations of each user-defined control method)");
262bc36eafdSMike Gerdts
263bc36eafdSMike Gerdts TrWalkParseTree (Gbl_ParseTreeRoot, ASL_WALK_VISIT_DOWNWARD,
264bc36eafdSMike Gerdts OtXrefWalkPart2, NULL, &XrefInfo);
265bc36eafdSMike Gerdts
266bc36eafdSMike Gerdts /* Cross-reference output file, part 3 (All other object refs) */
267bc36eafdSMike Gerdts
268bc36eafdSMike Gerdts OtPrintHeaders ("Part 3: Full Object Reference Map "
269bc36eafdSMike Gerdts "(Methods that reference each object in namespace");
270bc36eafdSMike Gerdts
271bc36eafdSMike Gerdts TrWalkParseTree (Gbl_ParseTreeRoot, ASL_WALK_VISIT_DOWNWARD,
272bc36eafdSMike Gerdts OtXrefWalkPart3, NULL, &XrefInfo);
273bc36eafdSMike Gerdts
274bc36eafdSMike Gerdts /* Cross-reference summary */
275bc36eafdSMike Gerdts
276bc36eafdSMike Gerdts FlPrintFile (ASL_FILE_XREF_OUTPUT, "\n\nObject Summary\n");
277bc36eafdSMike Gerdts
278bc36eafdSMike Gerdts FlPrintFile (ASL_FILE_XREF_OUTPUT,
279bc36eafdSMike Gerdts "\nTotal methods: %u\n",
280bc36eafdSMike Gerdts XrefInfo.TotalPredefinedMethods + XrefInfo.TotalUserMethods);
281bc36eafdSMike Gerdts FlPrintFile (ASL_FILE_XREF_OUTPUT,
282bc36eafdSMike Gerdts "Total predefined methods: %u\n",
283bc36eafdSMike Gerdts XrefInfo.TotalPredefinedMethods);
284bc36eafdSMike Gerdts
285bc36eafdSMike Gerdts FlPrintFile (ASL_FILE_XREF_OUTPUT,
286bc36eafdSMike Gerdts "\nTotal user methods: %u\n",
287bc36eafdSMike Gerdts XrefInfo.TotalUserMethods);
288bc36eafdSMike Gerdts FlPrintFile (ASL_FILE_XREF_OUTPUT,
289bc36eafdSMike Gerdts "Total unreferenced user methods %u\n",
290bc36eafdSMike Gerdts XrefInfo.TotalUnreferenceUserMethods);
291bc36eafdSMike Gerdts
292bc36eafdSMike Gerdts FlPrintFile (ASL_FILE_XREF_OUTPUT,
293bc36eafdSMike Gerdts "\nTotal defined objects: %u\n",
294bc36eafdSMike Gerdts XrefInfo.TotalObjects);
295bc36eafdSMike Gerdts FlPrintFile (ASL_FILE_XREF_OUTPUT,
296bc36eafdSMike Gerdts "Total unreferenced objects: %u\n",
297bc36eafdSMike Gerdts XrefInfo.TotalUnreferencedObjects);
298bc36eafdSMike Gerdts }
299bc36eafdSMike Gerdts
300bc36eafdSMike Gerdts
301bc36eafdSMike Gerdts /*
302bc36eafdSMike Gerdts * Part 1 of the cross reference file. This part emits the namespace objects
303bc36eafdSMike Gerdts * that are referenced by each control method in the namespace.
304bc36eafdSMike Gerdts *
305bc36eafdSMike Gerdts * Part 2 and 3 are below part 1.
306bc36eafdSMike Gerdts */
307bc36eafdSMike Gerdts
308bc36eafdSMike Gerdts /*******************************************************************************
309bc36eafdSMike Gerdts *
310bc36eafdSMike Gerdts * FUNCTION: OtXrefWalkPart1
311bc36eafdSMike Gerdts *
312bc36eafdSMike Gerdts * PARAMETERS: Op - Current parse Op
313bc36eafdSMike Gerdts * Level - Current tree nesting level
314bc36eafdSMike Gerdts * MethodInfo - Info block for the current method
315bc36eafdSMike Gerdts *
316bc36eafdSMike Gerdts *
317bc36eafdSMike Gerdts * RETURN: None
318bc36eafdSMike Gerdts *
319bc36eafdSMike Gerdts * DESCRIPTION: Entry point for the creation of the method call reference map.
320bc36eafdSMike Gerdts * For each control method in the namespace, all other methods
321bc36eafdSMike Gerdts * that invoke the method are listed. Predefined names/methods
322bc36eafdSMike Gerdts * that start with an underscore are ignored, because these are
323bc36eafdSMike Gerdts * essentially external/public interfaces.
324bc36eafdSMike Gerdts
325bc36eafdSMike Gerdts * DESCRIPTION: Entry point for the creation of the object reference map.
326bc36eafdSMike Gerdts * For each control method in the namespace, all objects that
327bc36eafdSMike Gerdts * are referenced by the method are listed.
328bc36eafdSMike Gerdts *
329bc36eafdSMike Gerdts * Called during a normal namespace walk, once per namespace
330bc36eafdSMike Gerdts * object. (MtMethodAnalysisWalkBegin)
331bc36eafdSMike Gerdts *
332bc36eafdSMike Gerdts ******************************************************************************/
333bc36eafdSMike Gerdts
334bc36eafdSMike Gerdts void
OtXrefWalkPart1(ACPI_PARSE_OBJECT * Op,UINT32 Level,ASL_METHOD_INFO * MethodInfo)335bc36eafdSMike Gerdts OtXrefWalkPart1 (
336bc36eafdSMike Gerdts ACPI_PARSE_OBJECT *Op,
337bc36eafdSMike Gerdts UINT32 Level,
338bc36eafdSMike Gerdts ASL_METHOD_INFO *MethodInfo)
339bc36eafdSMike Gerdts {
340bc36eafdSMike Gerdts ACPI_NAMESPACE_NODE *Node;
341bc36eafdSMike Gerdts ACPI_PARSE_OBJECT *NextOp;
342bc36eafdSMike Gerdts ACPI_PARSE_OBJECT *FieldOp;
343bc36eafdSMike Gerdts char *ParentPath;
344bc36eafdSMike Gerdts UINT32 Length;
345bc36eafdSMike Gerdts ACPI_STATUS Status;
346bc36eafdSMike Gerdts
347bc36eafdSMike Gerdts
348bc36eafdSMike Gerdts switch (Op->Asl.ParseOpcode)
349bc36eafdSMike Gerdts {
350bc36eafdSMike Gerdts case PARSEOP_NAMESEG:
351bc36eafdSMike Gerdts case PARSEOP_NAMESTRING:
352bc36eafdSMike Gerdts case PARSEOP_METHODCALL:
353bc36eafdSMike Gerdts
354bc36eafdSMike Gerdts if (!MethodInfo ||
355bc36eafdSMike Gerdts (MethodInfo->Op->Asl.Child == Op) ||
356bc36eafdSMike Gerdts !Op->Asl.Node)
357bc36eafdSMike Gerdts {
358bc36eafdSMike Gerdts break;
359bc36eafdSMike Gerdts }
360bc36eafdSMike Gerdts
361bc36eafdSMike Gerdts MethodInfo->CurrentOp = Op;
362bc36eafdSMike Gerdts Node = Op->Asl.Node;
363bc36eafdSMike Gerdts
364bc36eafdSMike Gerdts /* Find all objects referenced by this method */
365bc36eafdSMike Gerdts
366bc36eafdSMike Gerdts Status = TrWalkParseTree (MethodInfo->Op, ASL_WALK_VISIT_DOWNWARD,
367bc36eafdSMike Gerdts OtXrefAnalysisWalkPart1, NULL, MethodInfo);
368bc36eafdSMike Gerdts
369bc36eafdSMike Gerdts if (Status == AE_CTRL_TERMINATE)
370bc36eafdSMike Gerdts {
371bc36eafdSMike Gerdts ParentPath = AcpiNsGetNormalizedPathname (Node, TRUE);
372bc36eafdSMike Gerdts
373bc36eafdSMike Gerdts FlPrintFile (ASL_FILE_XREF_OUTPUT, " %-40s %s",
374bc36eafdSMike Gerdts ParentPath, AcpiUtGetTypeName (Node->Type));
375bc36eafdSMike Gerdts ACPI_FREE (ParentPath);
376bc36eafdSMike Gerdts
377bc36eafdSMike Gerdts switch (Node->Type)
378bc36eafdSMike Gerdts {
379bc36eafdSMike Gerdts /* Handle externals */
380bc36eafdSMike Gerdts
381bc36eafdSMike Gerdts case ACPI_TYPE_ANY:
382bc36eafdSMike Gerdts case ACPI_TYPE_FIELD_UNIT:
383bc36eafdSMike Gerdts
384bc36eafdSMike Gerdts FlPrintFile (ASL_FILE_XREF_OUTPUT, " <External Object>");
385bc36eafdSMike Gerdts break;
386bc36eafdSMike Gerdts
387bc36eafdSMike Gerdts case ACPI_TYPE_INTEGER:
388bc36eafdSMike Gerdts
389bc36eafdSMike Gerdts FlPrintFile (ASL_FILE_XREF_OUTPUT, " %8.8X%8.8X",
390bc36eafdSMike Gerdts ACPI_FORMAT_UINT64 (Op->Asl.Value.Integer));
391bc36eafdSMike Gerdts break;
392bc36eafdSMike Gerdts
393bc36eafdSMike Gerdts case ACPI_TYPE_METHOD:
394bc36eafdSMike Gerdts
395bc36eafdSMike Gerdts FlPrintFile (ASL_FILE_XREF_OUTPUT, " Invocation (%u args)",
396bc36eafdSMike Gerdts Node->ArgCount);
397bc36eafdSMike Gerdts break;
398bc36eafdSMike Gerdts
399bc36eafdSMike Gerdts case ACPI_TYPE_BUFFER_FIELD:
400bc36eafdSMike Gerdts
401bc36eafdSMike Gerdts NextOp = Node->Op; /* Create Buffer Field Op */
402bc36eafdSMike Gerdts switch (NextOp->Asl.ParseOpcode)
403bc36eafdSMike Gerdts {
404bc36eafdSMike Gerdts case PARSEOP_CREATEBITFIELD:
405bc36eafdSMike Gerdts Length = 1;
406bc36eafdSMike Gerdts break;
407bc36eafdSMike Gerdts
408bc36eafdSMike Gerdts case PARSEOP_CREATEBYTEFIELD:
409bc36eafdSMike Gerdts Length = 8;
410bc36eafdSMike Gerdts break;
411bc36eafdSMike Gerdts
412bc36eafdSMike Gerdts case PARSEOP_CREATEWORDFIELD:
413bc36eafdSMike Gerdts Length = 16;
414bc36eafdSMike Gerdts break;
415bc36eafdSMike Gerdts
416bc36eafdSMike Gerdts case PARSEOP_CREATEDWORDFIELD:
417bc36eafdSMike Gerdts Length = 32;
418bc36eafdSMike Gerdts break;
419bc36eafdSMike Gerdts
420bc36eafdSMike Gerdts case PARSEOP_CREATEQWORDFIELD:
421bc36eafdSMike Gerdts Length = 64;
422bc36eafdSMike Gerdts break;
423bc36eafdSMike Gerdts
424bc36eafdSMike Gerdts default:
425bc36eafdSMike Gerdts Length = 0;
426bc36eafdSMike Gerdts break;
427bc36eafdSMike Gerdts }
428bc36eafdSMike Gerdts
429bc36eafdSMike Gerdts NextOp = NextOp->Asl.Child; /* Buffer name */
430bc36eafdSMike Gerdts
431bc36eafdSMike Gerdts if (!NextOp->Asl.ExternalName)
432bc36eafdSMike Gerdts {
433bc36eafdSMike Gerdts FlPrintFile (ASL_FILE_XREF_OUTPUT, " in Arg/Local");
434bc36eafdSMike Gerdts }
435bc36eafdSMike Gerdts else
436bc36eafdSMike Gerdts {
437bc36eafdSMike Gerdts ParentPath = AcpiNsGetNormalizedPathname (
438bc36eafdSMike Gerdts NextOp->Asl.Node, TRUE);
439bc36eafdSMike Gerdts
440bc36eafdSMike Gerdts FlPrintFile (ASL_FILE_XREF_OUTPUT, " (%.2u bit) in Buffer %s",
441bc36eafdSMike Gerdts Length, ParentPath);
442bc36eafdSMike Gerdts ACPI_FREE (ParentPath);
443bc36eafdSMike Gerdts }
444bc36eafdSMike Gerdts break;
445bc36eafdSMike Gerdts
446bc36eafdSMike Gerdts case ACPI_TYPE_LOCAL_REGION_FIELD:
447bc36eafdSMike Gerdts
448bc36eafdSMike Gerdts NextOp = Node->Op;
449bc36eafdSMike Gerdts FieldOp = NextOp->Asl.Parent;
450bc36eafdSMike Gerdts NextOp = FieldOp->Asl.Child;
451bc36eafdSMike Gerdts
452bc36eafdSMike Gerdts ParentPath = AcpiNsGetNormalizedPathname (
453bc36eafdSMike Gerdts NextOp->Asl.Node, TRUE);
454bc36eafdSMike Gerdts
455bc36eafdSMike Gerdts FlPrintFile (ASL_FILE_XREF_OUTPUT, " (%.2u bit) in Region %s",
456bc36eafdSMike Gerdts (UINT32) Node->Op->Asl.Child->Asl.Value.Integer,
457bc36eafdSMike Gerdts ParentPath);
458bc36eafdSMike Gerdts ACPI_FREE (ParentPath);
459bc36eafdSMike Gerdts
460bc36eafdSMike Gerdts if (FieldOp->Asl.ParseOpcode == PARSEOP_FIELD)
461bc36eafdSMike Gerdts {
462bc36eafdSMike Gerdts Node = NextOp->Asl.Node; /* Region node */
463bc36eafdSMike Gerdts NextOp = Node->Op; /* PARSEOP_REGION */
464bc36eafdSMike Gerdts NextOp = NextOp->Asl.Child; /* Region name */
465bc36eafdSMike Gerdts NextOp = NextOp->Asl.Next;
466bc36eafdSMike Gerdts
467bc36eafdSMike Gerdts /* Get region space/addr/len? */
468bc36eafdSMike Gerdts
469bc36eafdSMike Gerdts FlPrintFile (ASL_FILE_XREF_OUTPUT, " (%s)",
470bc36eafdSMike Gerdts AcpiUtGetRegionName ((UINT8)
471bc36eafdSMike Gerdts NextOp->Asl.Value.Integer));
472bc36eafdSMike Gerdts }
473bc36eafdSMike Gerdts break;
474bc36eafdSMike Gerdts
475bc36eafdSMike Gerdts default:
476bc36eafdSMike Gerdts break;
477bc36eafdSMike Gerdts }
478bc36eafdSMike Gerdts
479bc36eafdSMike Gerdts FlPrintFile (ASL_FILE_XREF_OUTPUT, "\n");
480bc36eafdSMike Gerdts }
481bc36eafdSMike Gerdts break;
482bc36eafdSMike Gerdts
483bc36eafdSMike Gerdts case PARSEOP_METHOD:
484bc36eafdSMike Gerdts
485bc36eafdSMike Gerdts ParentPath = AcpiNsGetNormalizedPathname (Op->Asl.Node, TRUE);
486bc36eafdSMike Gerdts
487bc36eafdSMike Gerdts FlPrintFile (ASL_FILE_XREF_OUTPUT,
488bc36eafdSMike Gerdts "\n[%5u] %-40s %s Declaration (%u args)\n",
489bc36eafdSMike Gerdts Op->Asl.LogicalLineNumber, ParentPath,
490bc36eafdSMike Gerdts AcpiUtGetTypeName (Op->Asl.Node->Type), Op->Asl.Node->ArgCount);
491bc36eafdSMike Gerdts
492bc36eafdSMike Gerdts ACPI_FREE (ParentPath);
493bc36eafdSMike Gerdts break;
494bc36eafdSMike Gerdts
495bc36eafdSMike Gerdts default:
496bc36eafdSMike Gerdts break;
497bc36eafdSMike Gerdts }
498bc36eafdSMike Gerdts }
499bc36eafdSMike Gerdts
500bc36eafdSMike Gerdts
501bc36eafdSMike Gerdts /*******************************************************************************
502bc36eafdSMike Gerdts *
503bc36eafdSMike Gerdts * FUNCTION: OtXrefAnalysisWalkPart1
504bc36eafdSMike Gerdts *
505bc36eafdSMike Gerdts * PARAMETERS: ASL_WALK_CALLBACK
506bc36eafdSMike Gerdts *
507bc36eafdSMike Gerdts * RETURN: Status
508bc36eafdSMike Gerdts *
509bc36eafdSMike Gerdts * DESCRIPTION: Secondary walk for cross-reference part 1.
510bc36eafdSMike Gerdts *
511bc36eafdSMike Gerdts ******************************************************************************/
512bc36eafdSMike Gerdts
513bc36eafdSMike Gerdts static ACPI_STATUS
OtXrefAnalysisWalkPart1(ACPI_PARSE_OBJECT * Op,UINT32 Level,void * Context)514bc36eafdSMike Gerdts OtXrefAnalysisWalkPart1 (
515bc36eafdSMike Gerdts ACPI_PARSE_OBJECT *Op,
516bc36eafdSMike Gerdts UINT32 Level,
517bc36eafdSMike Gerdts void *Context)
518bc36eafdSMike Gerdts {
519bc36eafdSMike Gerdts ASL_METHOD_INFO *MethodInfo = (ASL_METHOD_INFO *) Context;
520bc36eafdSMike Gerdts ACPI_PARSE_OBJECT *Next;
521bc36eafdSMike Gerdts
522bc36eafdSMike Gerdts
523bc36eafdSMike Gerdts /* Only interested in name string Ops -- ignore all others */
524bc36eafdSMike Gerdts
525bc36eafdSMike Gerdts if ((Op->Asl.ParseOpcode != PARSEOP_NAMESEG) &&
526bc36eafdSMike Gerdts (Op->Asl.ParseOpcode != PARSEOP_NAMESTRING) &&
527bc36eafdSMike Gerdts (Op->Asl.ParseOpcode != PARSEOP_METHODCALL))
528bc36eafdSMike Gerdts {
529bc36eafdSMike Gerdts return (AE_OK);
530bc36eafdSMike Gerdts }
531bc36eafdSMike Gerdts
532bc36eafdSMike Gerdts /* No node means a locally declared object -- ignore */
533bc36eafdSMike Gerdts
534bc36eafdSMike Gerdts if (!Op->Asl.Node)
535bc36eafdSMike Gerdts {
536bc36eafdSMike Gerdts return (AE_OK);
537bc36eafdSMike Gerdts }
538bc36eafdSMike Gerdts
539bc36eafdSMike Gerdts /* When we encounter the source Op, we are done */
540bc36eafdSMike Gerdts
541bc36eafdSMike Gerdts Next = MethodInfo->CurrentOp;
542bc36eafdSMike Gerdts if (Next == Op)
543bc36eafdSMike Gerdts {
544bc36eafdSMike Gerdts return (AE_CTRL_TERMINATE);
545bc36eafdSMike Gerdts }
546bc36eafdSMike Gerdts
547bc36eafdSMike Gerdts /* If we have a name match, this Op is a duplicate */
548bc36eafdSMike Gerdts
549bc36eafdSMike Gerdts if ((Next->Asl.ParseOpcode == PARSEOP_NAMESEG) ||
550bc36eafdSMike Gerdts (Next->Asl.ParseOpcode == PARSEOP_NAMESTRING) ||
551bc36eafdSMike Gerdts (Next->Asl.ParseOpcode == PARSEOP_METHODCALL))
552bc36eafdSMike Gerdts {
553bc36eafdSMike Gerdts if (!strcmp (Op->Asl.ExternalName, Next->Asl.ExternalName))
554bc36eafdSMike Gerdts {
555bc36eafdSMike Gerdts return (AE_ALREADY_EXISTS);
556bc36eafdSMike Gerdts }
557bc36eafdSMike Gerdts }
558bc36eafdSMike Gerdts
559bc36eafdSMike Gerdts return (AE_OK);
560bc36eafdSMike Gerdts }
561bc36eafdSMike Gerdts
562bc36eafdSMike Gerdts
563bc36eafdSMike Gerdts /*
564bc36eafdSMike Gerdts * Part 2 of the cross reference file. This part emits the names of each
565bc36eafdSMike Gerdts * non-predefined method in the namespace (user methods), along with the
566bc36eafdSMike Gerdts * names of each control method that references that method.
567bc36eafdSMike Gerdts */
568bc36eafdSMike Gerdts
569bc36eafdSMike Gerdts /*******************************************************************************
570bc36eafdSMike Gerdts *
571bc36eafdSMike Gerdts * FUNCTION: OtXrefWalkPart2
572bc36eafdSMike Gerdts *
573bc36eafdSMike Gerdts * PARAMETERS: ASL_WALK_CALLBACK
574bc36eafdSMike Gerdts *
575bc36eafdSMike Gerdts * RETURN: Status
576bc36eafdSMike Gerdts *
577bc36eafdSMike Gerdts * DESCRIPTION: For each control method in the namespace, we will re-walk the
578bc36eafdSMike Gerdts * namespace to find each and every invocation of that control
579bc36eafdSMike Gerdts * method. Brute force, but does not matter, even for large
580bc36eafdSMike Gerdts * namespaces. Ignore predefined names (start with underscore).
581bc36eafdSMike Gerdts *
582bc36eafdSMike Gerdts ******************************************************************************/
583bc36eafdSMike Gerdts
584bc36eafdSMike Gerdts static ACPI_STATUS
OtXrefWalkPart2(ACPI_PARSE_OBJECT * Op,UINT32 Level,void * Context)585bc36eafdSMike Gerdts OtXrefWalkPart2 (
586bc36eafdSMike Gerdts ACPI_PARSE_OBJECT *Op,
587bc36eafdSMike Gerdts UINT32 Level,
588bc36eafdSMike Gerdts void *Context)
589bc36eafdSMike Gerdts {
590bc36eafdSMike Gerdts ASL_XREF_INFO *XrefInfo = (ASL_XREF_INFO *) Context;
591bc36eafdSMike Gerdts ACPI_NAMESPACE_NODE *Node;
592bc36eafdSMike Gerdts char *ParentPath;
593bc36eafdSMike Gerdts
594bc36eafdSMike Gerdts
595bc36eafdSMike Gerdts /* Looking for Method Declaration Ops only */
596bc36eafdSMike Gerdts
597bc36eafdSMike Gerdts if (!Op->Asl.Node ||
598bc36eafdSMike Gerdts (Op->Asl.ParseOpcode != PARSEOP_METHOD))
599bc36eafdSMike Gerdts {
600bc36eafdSMike Gerdts return (AE_OK);
601bc36eafdSMike Gerdts }
602bc36eafdSMike Gerdts
603bc36eafdSMike Gerdts /* Ignore predefined names */
604bc36eafdSMike Gerdts
605bc36eafdSMike Gerdts if (Op->Asl.Node->Name.Ascii[0] == '_')
606bc36eafdSMike Gerdts {
607bc36eafdSMike Gerdts XrefInfo->TotalPredefinedMethods++;
608bc36eafdSMike Gerdts return (AE_OK);
609bc36eafdSMike Gerdts }
610bc36eafdSMike Gerdts
611bc36eafdSMike Gerdts Node = Op->Asl.Node;
612bc36eafdSMike Gerdts ParentPath = AcpiNsGetNormalizedPathname (Node, TRUE);
613bc36eafdSMike Gerdts
614bc36eafdSMike Gerdts FlPrintFile (ASL_FILE_XREF_OUTPUT,
615bc36eafdSMike Gerdts "\n[%5u] %-40s %s Declaration (%u args)\n",
616bc36eafdSMike Gerdts Op->Asl.LogicalLineNumber, ParentPath,
617bc36eafdSMike Gerdts AcpiUtGetTypeName (Node->Type), Node->ArgCount);
618bc36eafdSMike Gerdts
619bc36eafdSMike Gerdts XrefInfo->TotalUserMethods++;
620bc36eafdSMike Gerdts XrefInfo->ThisMethodInvocations = 0;
621bc36eafdSMike Gerdts XrefInfo->MethodOp = Op;
622bc36eafdSMike Gerdts
623bc36eafdSMike Gerdts (void) TrWalkParseTree (Gbl_ParseTreeRoot, ASL_WALK_VISIT_DOWNWARD,
624bc36eafdSMike Gerdts OtXrefAnalysisWalkPart2, NULL, XrefInfo);
625bc36eafdSMike Gerdts
626bc36eafdSMike Gerdts if (!XrefInfo->ThisMethodInvocations)
627bc36eafdSMike Gerdts {
628bc36eafdSMike Gerdts FlPrintFile (ASL_FILE_XREF_OUTPUT,
629bc36eafdSMike Gerdts " Zero invocations of this method in this module\n");
630bc36eafdSMike Gerdts XrefInfo->TotalUnreferenceUserMethods++;
631bc36eafdSMike Gerdts }
632bc36eafdSMike Gerdts else
633bc36eafdSMike Gerdts {
634bc36eafdSMike Gerdts FlPrintFile (ASL_FILE_XREF_OUTPUT,
635bc36eafdSMike Gerdts " %u invocations of method %s in this module\n",
636bc36eafdSMike Gerdts XrefInfo->ThisMethodInvocations, ParentPath);
637bc36eafdSMike Gerdts }
638bc36eafdSMike Gerdts
639bc36eafdSMike Gerdts ACPI_FREE (ParentPath);
640bc36eafdSMike Gerdts return (AE_OK);
641bc36eafdSMike Gerdts }
642bc36eafdSMike Gerdts
643bc36eafdSMike Gerdts
644bc36eafdSMike Gerdts /*******************************************************************************
645bc36eafdSMike Gerdts *
646bc36eafdSMike Gerdts * FUNCTION: OtXrefAnalysisWalkPart2
647bc36eafdSMike Gerdts *
648bc36eafdSMike Gerdts * PARAMETERS: ASL_WALK_CALLBACK
649bc36eafdSMike Gerdts *
650bc36eafdSMike Gerdts * RETURN: Status
651bc36eafdSMike Gerdts *
652bc36eafdSMike Gerdts * DESCRIPTION: For every Op that is a method invocation, emit a reference
653bc36eafdSMike Gerdts * line if the Op is invoking the target method.
654bc36eafdSMike Gerdts *
655bc36eafdSMike Gerdts ******************************************************************************/
656bc36eafdSMike Gerdts
657bc36eafdSMike Gerdts static ACPI_STATUS
OtXrefAnalysisWalkPart2(ACPI_PARSE_OBJECT * Op,UINT32 Level,void * Context)658bc36eafdSMike Gerdts OtXrefAnalysisWalkPart2 (
659bc36eafdSMike Gerdts ACPI_PARSE_OBJECT *Op,
660bc36eafdSMike Gerdts UINT32 Level,
661bc36eafdSMike Gerdts void *Context)
662bc36eafdSMike Gerdts {
663bc36eafdSMike Gerdts ASL_XREF_INFO *XrefInfo = (ASL_XREF_INFO *) Context;
664bc36eafdSMike Gerdts ACPI_PARSE_OBJECT *CallerOp;
665bc36eafdSMike Gerdts char *CallerFullPathname;
666bc36eafdSMike Gerdts
667bc36eafdSMike Gerdts
668bc36eafdSMike Gerdts /* Looking for MethodCall Ops only */
669bc36eafdSMike Gerdts
670bc36eafdSMike Gerdts if (!Op->Asl.Node ||
671bc36eafdSMike Gerdts (Op->Asl.ParseOpcode != PARSEOP_METHODCALL))
672bc36eafdSMike Gerdts {
673bc36eafdSMike Gerdts return (AE_OK);
674bc36eafdSMike Gerdts }
675bc36eafdSMike Gerdts
676bc36eafdSMike Gerdts /* If not a match to the target method, we are done */
677bc36eafdSMike Gerdts
678bc36eafdSMike Gerdts if (Op->Asl.Node != XrefInfo->MethodOp->Asl.Node)
679bc36eafdSMike Gerdts {
680bc36eafdSMike Gerdts return (AE_CTRL_DEPTH);
681bc36eafdSMike Gerdts }
682bc36eafdSMike Gerdts
683bc36eafdSMike Gerdts /* Find parent method to get method caller namepath */
684bc36eafdSMike Gerdts
685bc36eafdSMike Gerdts CallerOp = Op->Asl.Parent;
686bc36eafdSMike Gerdts while (CallerOp &&
687bc36eafdSMike Gerdts (CallerOp->Asl.ParseOpcode != PARSEOP_METHOD))
688bc36eafdSMike Gerdts {
689bc36eafdSMike Gerdts CallerOp = CallerOp->Asl.Parent;
690bc36eafdSMike Gerdts }
691bc36eafdSMike Gerdts
692bc36eafdSMike Gerdts /* There is no parent method for External() statements */
693bc36eafdSMike Gerdts
694bc36eafdSMike Gerdts if (!CallerOp)
695bc36eafdSMike Gerdts {
696bc36eafdSMike Gerdts return (AE_OK);
697bc36eafdSMike Gerdts }
698bc36eafdSMike Gerdts
699bc36eafdSMike Gerdts CallerFullPathname = AcpiNsGetNormalizedPathname (
700bc36eafdSMike Gerdts CallerOp->Asl.Node, TRUE);
701bc36eafdSMike Gerdts
702bc36eafdSMike Gerdts FlPrintFile (ASL_FILE_XREF_OUTPUT,
703bc36eafdSMike Gerdts "[%5u] %-40s Invocation path: %s\n",
704bc36eafdSMike Gerdts Op->Asl.LogicalLineNumber, CallerFullPathname,
705bc36eafdSMike Gerdts Op->Asl.ExternalName);
706bc36eafdSMike Gerdts
707bc36eafdSMike Gerdts ACPI_FREE (CallerFullPathname);
708bc36eafdSMike Gerdts XrefInfo->ThisMethodInvocations++;
709bc36eafdSMike Gerdts return (AE_OK);
710bc36eafdSMike Gerdts }
711bc36eafdSMike Gerdts
712bc36eafdSMike Gerdts
713bc36eafdSMike Gerdts /*
714bc36eafdSMike Gerdts * Part 3 of the cross reference file. This part emits the names of each
715bc36eafdSMike Gerdts * non-predefined method in the namespace (user methods), along with the
716bc36eafdSMike Gerdts * names of each control method that references that method.
717bc36eafdSMike Gerdts */
718bc36eafdSMike Gerdts
719bc36eafdSMike Gerdts /*******************************************************************************
720bc36eafdSMike Gerdts *
721bc36eafdSMike Gerdts * FUNCTION: OtXrefWalkPart3
722bc36eafdSMike Gerdts *
723bc36eafdSMike Gerdts * PARAMETERS: ASL_WALK_CALLBACK
724bc36eafdSMike Gerdts *
725bc36eafdSMike Gerdts * RETURN: Status
726bc36eafdSMike Gerdts *
727bc36eafdSMike Gerdts * DESCRIPTION: Cross-reference part 3. references to objects other than
728bc36eafdSMike Gerdts * control methods.
729bc36eafdSMike Gerdts *
730bc36eafdSMike Gerdts ******************************************************************************/
731bc36eafdSMike Gerdts
732bc36eafdSMike Gerdts static ACPI_STATUS
OtXrefWalkPart3(ACPI_PARSE_OBJECT * Op,UINT32 Level,void * Context)733bc36eafdSMike Gerdts OtXrefWalkPart3 (
734bc36eafdSMike Gerdts ACPI_PARSE_OBJECT *Op,
735bc36eafdSMike Gerdts UINT32 Level,
736bc36eafdSMike Gerdts void *Context)
737bc36eafdSMike Gerdts {
738bc36eafdSMike Gerdts ASL_XREF_INFO *XrefInfo = (ASL_XREF_INFO *) Context;
739bc36eafdSMike Gerdts ACPI_NAMESPACE_NODE *Node;
740bc36eafdSMike Gerdts char *ParentPath;
741bc36eafdSMike Gerdts const ACPI_OPCODE_INFO *OpInfo;
742bc36eafdSMike Gerdts
743bc36eafdSMike Gerdts
744bc36eafdSMike Gerdts /* Ignore method declarations */
745bc36eafdSMike Gerdts
746bc36eafdSMike Gerdts if (!Op->Asl.Node ||
747bc36eafdSMike Gerdts (Op->Asl.ParseOpcode == PARSEOP_METHOD))
748bc36eafdSMike Gerdts {
749bc36eafdSMike Gerdts return (AE_OK);
750bc36eafdSMike Gerdts }
751bc36eafdSMike Gerdts
752bc36eafdSMike Gerdts OpInfo = AcpiPsGetOpcodeInfo (Op->Asl.AmlOpcode);
753bc36eafdSMike Gerdts if (!(OpInfo->Class & AML_CLASS_NAMED_OBJECT))
754bc36eafdSMike Gerdts {
755bc36eafdSMike Gerdts return (AE_OK);
756bc36eafdSMike Gerdts }
757bc36eafdSMike Gerdts
758bc36eafdSMike Gerdts /* Only care about named object creation opcodes */
759bc36eafdSMike Gerdts
760bc36eafdSMike Gerdts if ((Op->Asl.ParseOpcode != PARSEOP_NAME) &&
761bc36eafdSMike Gerdts (Op->Asl.ParseOpcode != PARSEOP_DEVICE) &&
762bc36eafdSMike Gerdts (Op->Asl.ParseOpcode != PARSEOP_MUTEX) &&
763bc36eafdSMike Gerdts (Op->Asl.ParseOpcode != PARSEOP_OPERATIONREGION) &&
764bc36eafdSMike Gerdts (Op->Asl.ParseOpcode != PARSEOP_FIELD) &&
765bc36eafdSMike Gerdts (Op->Asl.ParseOpcode != PARSEOP_EVENT))
766bc36eafdSMike Gerdts {
767bc36eafdSMike Gerdts return (AE_OK);
768bc36eafdSMike Gerdts }
769bc36eafdSMike Gerdts
770bc36eafdSMike Gerdts /* Ignore predefined names */
771bc36eafdSMike Gerdts
772bc36eafdSMike Gerdts if (Op->Asl.Node->Name.Ascii[0] == '_')
773bc36eafdSMike Gerdts {
774bc36eafdSMike Gerdts return (AE_OK);
775bc36eafdSMike Gerdts }
776bc36eafdSMike Gerdts
777bc36eafdSMike Gerdts Node = Op->Asl.Node;
778bc36eafdSMike Gerdts ParentPath = AcpiNsGetNormalizedPathname (Node, TRUE);
779bc36eafdSMike Gerdts
780bc36eafdSMike Gerdts FlPrintFile (ASL_FILE_XREF_OUTPUT,
781bc36eafdSMike Gerdts "\n[%5u] %-40s %s Declaration\n",
782bc36eafdSMike Gerdts Op->Asl.LogicalLineNumber, ParentPath,
783bc36eafdSMike Gerdts AcpiUtGetTypeName (Node->Type));
784bc36eafdSMike Gerdts ACPI_FREE (ParentPath);
785bc36eafdSMike Gerdts
786bc36eafdSMike Gerdts XrefInfo->MethodOp = Op;
787bc36eafdSMike Gerdts XrefInfo->ThisObjectReferences = 0;
788bc36eafdSMike Gerdts XrefInfo->TotalObjects = 0;
789bc36eafdSMike Gerdts
790bc36eafdSMike Gerdts (void) TrWalkParseTree (Gbl_ParseTreeRoot, ASL_WALK_VISIT_DOWNWARD,
791bc36eafdSMike Gerdts OtXrefAnalysisWalkPart3, NULL, XrefInfo);
792bc36eafdSMike Gerdts
793bc36eafdSMike Gerdts if (!XrefInfo->ThisObjectReferences)
794bc36eafdSMike Gerdts {
795bc36eafdSMike Gerdts FlPrintFile (ASL_FILE_XREF_OUTPUT,
796bc36eafdSMike Gerdts " Zero references to this object in this module\n");
797bc36eafdSMike Gerdts XrefInfo->TotalUnreferencedObjects++;
798bc36eafdSMike Gerdts }
799bc36eafdSMike Gerdts else
800bc36eafdSMike Gerdts {
801bc36eafdSMike Gerdts FlPrintFile (ASL_FILE_XREF_OUTPUT,
802bc36eafdSMike Gerdts " %u references to this object in this module\n",
803bc36eafdSMike Gerdts XrefInfo->ThisObjectReferences, ParentPath);
804bc36eafdSMike Gerdts }
805bc36eafdSMike Gerdts
806bc36eafdSMike Gerdts return (AE_OK);
807bc36eafdSMike Gerdts }
808bc36eafdSMike Gerdts
809bc36eafdSMike Gerdts
810bc36eafdSMike Gerdts /*******************************************************************************
811bc36eafdSMike Gerdts *
812bc36eafdSMike Gerdts * FUNCTION: OtXrefAnalysisWalkPart3
813bc36eafdSMike Gerdts *
814bc36eafdSMike Gerdts * PARAMETERS: ASL_WALK_CALLBACK
815bc36eafdSMike Gerdts *
816bc36eafdSMike Gerdts * RETURN: Status
817bc36eafdSMike Gerdts *
818bc36eafdSMike Gerdts * DESCRIPTION: Secondary walk for cross-reference part 3.
819bc36eafdSMike Gerdts *
820bc36eafdSMike Gerdts ******************************************************************************/
821bc36eafdSMike Gerdts
822bc36eafdSMike Gerdts static ACPI_STATUS
OtXrefAnalysisWalkPart3(ACPI_PARSE_OBJECT * Op,UINT32 Level,void * Context)823bc36eafdSMike Gerdts OtXrefAnalysisWalkPart3 (
824bc36eafdSMike Gerdts ACPI_PARSE_OBJECT *Op,
825bc36eafdSMike Gerdts UINT32 Level,
826bc36eafdSMike Gerdts void *Context)
827bc36eafdSMike Gerdts {
828bc36eafdSMike Gerdts ASL_XREF_INFO *XrefInfo = (ASL_XREF_INFO *) Context;
829bc36eafdSMike Gerdts char *CallerFullPathname = NULL;
830bc36eafdSMike Gerdts ACPI_PARSE_OBJECT *CallerOp;
831bc36eafdSMike Gerdts const char *Operator;
832bc36eafdSMike Gerdts
833bc36eafdSMike Gerdts
834bc36eafdSMike Gerdts if (!Op->Asl.Node)
835bc36eafdSMike Gerdts {
836bc36eafdSMike Gerdts return (AE_OK);
837bc36eafdSMike Gerdts }
838bc36eafdSMike Gerdts
839bc36eafdSMike Gerdts XrefInfo->TotalObjects++;
840bc36eafdSMike Gerdts
841bc36eafdSMike Gerdts /* Ignore Op that actually defined the object */
842bc36eafdSMike Gerdts
843bc36eafdSMike Gerdts if (Op == XrefInfo->MethodOp)
844bc36eafdSMike Gerdts {
845bc36eafdSMike Gerdts return (AE_OK);
846bc36eafdSMike Gerdts }
847bc36eafdSMike Gerdts
848bc36eafdSMike Gerdts /* Only interested in Ops that reference the target node */
849bc36eafdSMike Gerdts
850bc36eafdSMike Gerdts if (Op->Asl.Node != XrefInfo->MethodOp->Asl.Node)
851bc36eafdSMike Gerdts {
852bc36eafdSMike Gerdts return (AE_OK);
853bc36eafdSMike Gerdts }
854bc36eafdSMike Gerdts
855bc36eafdSMike Gerdts /* Find parent "open scope" object to get method caller namepath */
856bc36eafdSMike Gerdts
857bc36eafdSMike Gerdts CallerOp = Op->Asl.Parent;
858bc36eafdSMike Gerdts while (CallerOp &&
859bc36eafdSMike Gerdts (CallerOp->Asl.ParseOpcode != PARSEOP_NAME) &&
860bc36eafdSMike Gerdts (CallerOp->Asl.ParseOpcode != PARSEOP_METHOD) &&
861bc36eafdSMike Gerdts (CallerOp->Asl.ParseOpcode != PARSEOP_DEVICE) &&
862bc36eafdSMike Gerdts (CallerOp->Asl.ParseOpcode != PARSEOP_POWERRESOURCE) &&
863bc36eafdSMike Gerdts (CallerOp->Asl.ParseOpcode != PARSEOP_PROCESSOR) &&
864bc36eafdSMike Gerdts (CallerOp->Asl.ParseOpcode != PARSEOP_THERMALZONE))
865bc36eafdSMike Gerdts {
866bc36eafdSMike Gerdts CallerOp = CallerOp->Asl.Parent;
867bc36eafdSMike Gerdts }
868bc36eafdSMike Gerdts
869bc36eafdSMike Gerdts if (CallerOp == XrefInfo->CurrentMethodOp)
870bc36eafdSMike Gerdts {
871bc36eafdSMike Gerdts return (AE_OK);
872bc36eafdSMike Gerdts }
873bc36eafdSMike Gerdts
874bc36eafdSMike Gerdts /* Null CallerOp means the caller is at the namespace root */
875bc36eafdSMike Gerdts
876bc36eafdSMike Gerdts if (CallerOp)
877bc36eafdSMike Gerdts {
878bc36eafdSMike Gerdts CallerFullPathname = AcpiNsGetNormalizedPathname (
879bc36eafdSMike Gerdts CallerOp->Asl.Node, TRUE);
880bc36eafdSMike Gerdts }
881bc36eafdSMike Gerdts
882bc36eafdSMike Gerdts /* There are some special cases for the oddball operators */
883bc36eafdSMike Gerdts
884bc36eafdSMike Gerdts if (Op->Asl.ParseOpcode == PARSEOP_SCOPE)
885bc36eafdSMike Gerdts {
886bc36eafdSMike Gerdts Operator = "Scope";
887bc36eafdSMike Gerdts }
888bc36eafdSMike Gerdts else if (Op->Asl.Parent->Asl.ParseOpcode == PARSEOP_ALIAS)
889bc36eafdSMike Gerdts {
890bc36eafdSMike Gerdts Operator = "Alias";
891bc36eafdSMike Gerdts }
892bc36eafdSMike Gerdts else if (!CallerOp)
893bc36eafdSMike Gerdts {
894bc36eafdSMike Gerdts Operator = "ModLevel";
895bc36eafdSMike Gerdts }
896bc36eafdSMike Gerdts else
897bc36eafdSMike Gerdts {
898bc36eafdSMike Gerdts Operator = AcpiUtGetTypeName (CallerOp->Asl.Node->Type);
899bc36eafdSMike Gerdts }
900bc36eafdSMike Gerdts
901bc36eafdSMike Gerdts FlPrintFile (ASL_FILE_XREF_OUTPUT,
902bc36eafdSMike Gerdts "[%5u] %-40s %-8s via path: %s, Operator: %s\n",
903bc36eafdSMike Gerdts Op->Asl.LogicalLineNumber,
904bc36eafdSMike Gerdts CallerFullPathname ? CallerFullPathname : "<root>",
905bc36eafdSMike Gerdts Operator,
906bc36eafdSMike Gerdts Op->Asl.ExternalName,
907bc36eafdSMike Gerdts Op->Asl.Parent->Asl.ParseOpName);
908bc36eafdSMike Gerdts
909bc36eafdSMike Gerdts if (!CallerOp)
910bc36eafdSMike Gerdts {
911bc36eafdSMike Gerdts CallerOp = ACPI_TO_POINTER (0xFFFFFFFF);
912bc36eafdSMike Gerdts }
913bc36eafdSMike Gerdts
914bc36eafdSMike Gerdts if (CallerFullPathname)
915bc36eafdSMike Gerdts {
916bc36eafdSMike Gerdts ACPI_FREE (CallerFullPathname);
917bc36eafdSMike Gerdts }
918bc36eafdSMike Gerdts
919bc36eafdSMike Gerdts XrefInfo->CurrentMethodOp = CallerOp;
920bc36eafdSMike Gerdts XrefInfo->ThisObjectReferences++;
921bc36eafdSMike Gerdts return (AE_OK);
922bc36eafdSMike Gerdts }
923