1d638c6eeSSascha Wildner /******************************************************************************
2d638c6eeSSascha Wildner *
3d638c6eeSSascha Wildner * Module Name: cvparser - Converter functions that are called from the AML
4d638c6eeSSascha Wildner * parser.
5d638c6eeSSascha Wildner *
6d638c6eeSSascha Wildner *****************************************************************************/
7d638c6eeSSascha Wildner
8b4315fc7SSascha Wildner /******************************************************************************
9b4315fc7SSascha Wildner *
10b4315fc7SSascha Wildner * 1. Copyright Notice
11b4315fc7SSascha Wildner *
12*383048acSSascha Wildner * Some or all of this work - Copyright (c) 1999 - 2021, Intel Corp.
13d638c6eeSSascha Wildner * All rights reserved.
14d638c6eeSSascha Wildner *
15b4315fc7SSascha Wildner * 2. License
16b4315fc7SSascha Wildner *
17b4315fc7SSascha Wildner * 2.1. This is your license from Intel Corp. under its intellectual property
18b4315fc7SSascha Wildner * rights. You may have additional license terms from the party that provided
19b4315fc7SSascha Wildner * you this software, covering your right to use that party's intellectual
20b4315fc7SSascha Wildner * property rights.
21b4315fc7SSascha Wildner *
22b4315fc7SSascha Wildner * 2.2. Intel grants, free of charge, to any person ("Licensee") obtaining a
23b4315fc7SSascha Wildner * copy of the source code appearing in this file ("Covered Code") an
24b4315fc7SSascha Wildner * irrevocable, perpetual, worldwide license under Intel's copyrights in the
25b4315fc7SSascha Wildner * base code distributed originally by Intel ("Original Intel Code") to copy,
26b4315fc7SSascha Wildner * make derivatives, distribute, use and display any portion of the Covered
27b4315fc7SSascha Wildner * Code in any form, with the right to sublicense such rights; and
28b4315fc7SSascha Wildner *
29b4315fc7SSascha Wildner * 2.3. Intel grants Licensee a non-exclusive and non-transferable patent
30b4315fc7SSascha Wildner * license (with the right to sublicense), under only those claims of Intel
31b4315fc7SSascha Wildner * patents that are infringed by the Original Intel Code, to make, use, sell,
32b4315fc7SSascha Wildner * offer to sell, and import the Covered Code and derivative works thereof
33b4315fc7SSascha Wildner * solely to the minimum extent necessary to exercise the above copyright
34b4315fc7SSascha Wildner * license, and in no event shall the patent license extend to any additions
35b4315fc7SSascha Wildner * to or modifications of the Original Intel Code. No other license or right
36b4315fc7SSascha Wildner * is granted directly or by implication, estoppel or otherwise;
37b4315fc7SSascha Wildner *
38b4315fc7SSascha Wildner * The above copyright and patent license is granted only if the following
39b4315fc7SSascha Wildner * conditions are met:
40b4315fc7SSascha Wildner *
41b4315fc7SSascha Wildner * 3. Conditions
42b4315fc7SSascha Wildner *
43b4315fc7SSascha Wildner * 3.1. Redistribution of Source with Rights to Further Distribute Source.
44b4315fc7SSascha Wildner * Redistribution of source code of any substantial portion of the Covered
45b4315fc7SSascha Wildner * Code or modification with rights to further distribute source must include
46b4315fc7SSascha Wildner * the above Copyright Notice, the above License, this list of Conditions,
47b4315fc7SSascha Wildner * and the following Disclaimer and Export Compliance provision. In addition,
48b4315fc7SSascha Wildner * Licensee must cause all Covered Code to which Licensee contributes to
49b4315fc7SSascha Wildner * contain a file documenting the changes Licensee made to create that Covered
50b4315fc7SSascha Wildner * Code and the date of any change. Licensee must include in that file the
51b4315fc7SSascha Wildner * documentation of any changes made by any predecessor Licensee. Licensee
52b4315fc7SSascha Wildner * must include a prominent statement that the modification is derived,
53b4315fc7SSascha Wildner * directly or indirectly, from Original Intel Code.
54b4315fc7SSascha Wildner *
55b4315fc7SSascha Wildner * 3.2. Redistribution of Source with no Rights to Further Distribute Source.
56b4315fc7SSascha Wildner * Redistribution of source code of any substantial portion of the Covered
57b4315fc7SSascha Wildner * Code or modification without rights to further distribute source must
58b4315fc7SSascha Wildner * include the following Disclaimer and Export Compliance provision in the
59b4315fc7SSascha Wildner * documentation and/or other materials provided with distribution. In
60b4315fc7SSascha Wildner * addition, Licensee may not authorize further sublicense of source of any
61b4315fc7SSascha Wildner * portion of the Covered Code, and must include terms to the effect that the
62b4315fc7SSascha Wildner * license from Licensee to its licensee is limited to the intellectual
63b4315fc7SSascha Wildner * property embodied in the software Licensee provides to its licensee, and
64b4315fc7SSascha Wildner * not to intellectual property embodied in modifications its licensee may
65b4315fc7SSascha Wildner * make.
66b4315fc7SSascha Wildner *
67b4315fc7SSascha Wildner * 3.3. Redistribution of Executable. Redistribution in executable form of any
68b4315fc7SSascha Wildner * substantial portion of the Covered Code or modification must reproduce the
69b4315fc7SSascha Wildner * above Copyright Notice, and the following Disclaimer and Export Compliance
70b4315fc7SSascha Wildner * provision in the documentation and/or other materials provided with the
71b4315fc7SSascha Wildner * distribution.
72b4315fc7SSascha Wildner *
73b4315fc7SSascha Wildner * 3.4. Intel retains all right, title, and interest in and to the Original
74b4315fc7SSascha Wildner * Intel Code.
75b4315fc7SSascha Wildner *
76b4315fc7SSascha Wildner * 3.5. Neither the name Intel nor any other trademark owned or controlled by
77b4315fc7SSascha Wildner * Intel shall be used in advertising or otherwise to promote the sale, use or
78b4315fc7SSascha Wildner * other dealings in products derived from or relating to the Covered Code
79b4315fc7SSascha Wildner * without prior written authorization from Intel.
80b4315fc7SSascha Wildner *
81b4315fc7SSascha Wildner * 4. Disclaimer and Export Compliance
82b4315fc7SSascha Wildner *
83b4315fc7SSascha Wildner * 4.1. INTEL MAKES NO WARRANTY OF ANY KIND REGARDING ANY SOFTWARE PROVIDED
84b4315fc7SSascha Wildner * HERE. ANY SOFTWARE ORIGINATING FROM INTEL OR DERIVED FROM INTEL SOFTWARE
85b4315fc7SSascha Wildner * IS PROVIDED "AS IS," AND INTEL WILL NOT PROVIDE ANY SUPPORT, ASSISTANCE,
86b4315fc7SSascha Wildner * INSTALLATION, TRAINING OR OTHER SERVICES. INTEL WILL NOT PROVIDE ANY
87b4315fc7SSascha Wildner * UPDATES, ENHANCEMENTS OR EXTENSIONS. INTEL SPECIFICALLY DISCLAIMS ANY
88b4315fc7SSascha Wildner * IMPLIED WARRANTIES OF MERCHANTABILITY, NONINFRINGEMENT AND FITNESS FOR A
89b4315fc7SSascha Wildner * PARTICULAR PURPOSE.
90b4315fc7SSascha Wildner *
91b4315fc7SSascha Wildner * 4.2. IN NO EVENT SHALL INTEL HAVE ANY LIABILITY TO LICENSEE, ITS LICENSEES
92b4315fc7SSascha Wildner * OR ANY OTHER THIRD PARTY, FOR ANY LOST PROFITS, LOST DATA, LOSS OF USE OR
93b4315fc7SSascha Wildner * COSTS OF PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES, OR FOR ANY INDIRECT,
94b4315fc7SSascha Wildner * SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THIS AGREEMENT, UNDER ANY
95b4315fc7SSascha Wildner * CAUSE OF ACTION OR THEORY OF LIABILITY, AND IRRESPECTIVE OF WHETHER INTEL
96b4315fc7SSascha Wildner * HAS ADVANCE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES. THESE LIMITATIONS
97b4315fc7SSascha Wildner * SHALL APPLY NOTWITHSTANDING THE FAILURE OF THE ESSENTIAL PURPOSE OF ANY
98b4315fc7SSascha Wildner * LIMITED REMEDY.
99b4315fc7SSascha Wildner *
100b4315fc7SSascha Wildner * 4.3. Licensee shall not export, either directly or indirectly, any of this
101b4315fc7SSascha Wildner * software or system incorporating such software without first obtaining any
102b4315fc7SSascha Wildner * required license or other approval from the U. S. Department of Commerce or
103b4315fc7SSascha Wildner * any other agency or department of the United States Government. In the
104b4315fc7SSascha Wildner * event Licensee exports any such software from the United States or
105b4315fc7SSascha Wildner * re-exports any such software from a foreign destination, Licensee shall
106b4315fc7SSascha Wildner * ensure that the distribution and export/re-export of the software is in
107b4315fc7SSascha Wildner * compliance with all laws, regulations, orders, or other restrictions of the
108b4315fc7SSascha Wildner * U.S. Export Administration Regulations. Licensee agrees that neither it nor
109b4315fc7SSascha Wildner * any of its subsidiaries will export/re-export any technical data, process,
110b4315fc7SSascha Wildner * software, or service, directly or indirectly, to any country for which the
111b4315fc7SSascha Wildner * United States government or any agency thereof requires an export license,
112b4315fc7SSascha Wildner * other governmental approval, or letter of assurance, without first obtaining
113b4315fc7SSascha Wildner * such license, approval or letter.
114b4315fc7SSascha Wildner *
115b4315fc7SSascha Wildner *****************************************************************************
116b4315fc7SSascha Wildner *
117b4315fc7SSascha Wildner * Alternatively, you may choose to be licensed under the terms of the
118b4315fc7SSascha Wildner * following license:
119b4315fc7SSascha Wildner *
120d638c6eeSSascha Wildner * Redistribution and use in source and binary forms, with or without
121d638c6eeSSascha Wildner * modification, are permitted provided that the following conditions
122d638c6eeSSascha Wildner * are met:
123d638c6eeSSascha Wildner * 1. Redistributions of source code must retain the above copyright
124d638c6eeSSascha Wildner * notice, this list of conditions, and the following disclaimer,
125d638c6eeSSascha Wildner * without modification.
126d638c6eeSSascha Wildner * 2. Redistributions in binary form must reproduce at minimum a disclaimer
127d638c6eeSSascha Wildner * substantially similar to the "NO WARRANTY" disclaimer below
128d638c6eeSSascha Wildner * ("Disclaimer") and any redistribution must be conditioned upon
129d638c6eeSSascha Wildner * including a substantially similar Disclaimer requirement for further
130d638c6eeSSascha Wildner * binary redistribution.
131d638c6eeSSascha Wildner * 3. Neither the names of the above-listed copyright holders nor the names
132d638c6eeSSascha Wildner * of any contributors may be used to endorse or promote products derived
133d638c6eeSSascha Wildner * from this software without specific prior written permission.
134d638c6eeSSascha Wildner *
135b4315fc7SSascha Wildner * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
136b4315fc7SSascha Wildner * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
137b4315fc7SSascha Wildner * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
138b4315fc7SSascha Wildner * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
139b4315fc7SSascha Wildner * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
140b4315fc7SSascha Wildner * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
141b4315fc7SSascha Wildner * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
142b4315fc7SSascha Wildner * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
143b4315fc7SSascha Wildner * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
144b4315fc7SSascha Wildner * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
145b4315fc7SSascha Wildner * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
146b4315fc7SSascha Wildner *
147b4315fc7SSascha Wildner * Alternatively, you may choose to be licensed under the terms of the
148d638c6eeSSascha Wildner * GNU General Public License ("GPL") version 2 as published by the Free
149d638c6eeSSascha Wildner * Software Foundation.
150d638c6eeSSascha Wildner *
151b4315fc7SSascha Wildner *****************************************************************************/
152d638c6eeSSascha Wildner
153d638c6eeSSascha Wildner #include "aslcompiler.h"
154d638c6eeSSascha Wildner #include "acparser.h"
155d638c6eeSSascha Wildner #include "acdispat.h"
156d638c6eeSSascha Wildner #include "amlcode.h"
157d638c6eeSSascha Wildner #include "acinterp.h"
158d638c6eeSSascha Wildner #include "acdisasm.h"
159d638c6eeSSascha Wildner #include "acconvert.h"
160d638c6eeSSascha Wildner
161d638c6eeSSascha Wildner
162d638c6eeSSascha Wildner /* local prototypes */
163d638c6eeSSascha Wildner
164d638c6eeSSascha Wildner static BOOLEAN
165d638c6eeSSascha Wildner CvCommentExists (
166d638c6eeSSascha Wildner UINT8 *Address);
167d638c6eeSSascha Wildner
168d638c6eeSSascha Wildner static BOOLEAN
169d638c6eeSSascha Wildner CvIsFilename (
170d638c6eeSSascha Wildner char *Filename);
171d638c6eeSSascha Wildner
172d638c6eeSSascha Wildner static ACPI_FILE_NODE*
173d638c6eeSSascha Wildner CvFileAddressLookup(
174d638c6eeSSascha Wildner char *Address,
175d638c6eeSSascha Wildner ACPI_FILE_NODE *Head);
176d638c6eeSSascha Wildner
177d638c6eeSSascha Wildner static void
178d638c6eeSSascha Wildner CvAddToFileTree (
179d638c6eeSSascha Wildner char *Filename,
180d638c6eeSSascha Wildner char *PreviousFilename);
181d638c6eeSSascha Wildner
182d638c6eeSSascha Wildner static void
183d638c6eeSSascha Wildner CvSetFileParent (
184d638c6eeSSascha Wildner char *ChildFile,
185d638c6eeSSascha Wildner char *ParentFile);
186d638c6eeSSascha Wildner
187d638c6eeSSascha Wildner
188d638c6eeSSascha Wildner /*******************************************************************************
189d638c6eeSSascha Wildner *
190d638c6eeSSascha Wildner * FUNCTION: CvIsFilename
191d638c6eeSSascha Wildner *
192d638c6eeSSascha Wildner * PARAMETERS: filename - input filename
193d638c6eeSSascha Wildner *
194d638c6eeSSascha Wildner * RETURN: BOOLEAN - TRUE if all characters are between 0x20 and 0x7f
195d638c6eeSSascha Wildner *
196d638c6eeSSascha Wildner * DESCRIPTION: Take a given char * and see if it contains all printable
197d638c6eeSSascha Wildner * characters. If all characters have hexvalues 20-7f and ends with
198d638c6eeSSascha Wildner * .dsl, we will assume that it is a proper filename.
199d638c6eeSSascha Wildner *
200d638c6eeSSascha Wildner ******************************************************************************/
201d638c6eeSSascha Wildner
202d638c6eeSSascha Wildner static BOOLEAN
CvIsFilename(char * Filename)203d638c6eeSSascha Wildner CvIsFilename (
204d638c6eeSSascha Wildner char *Filename)
205d638c6eeSSascha Wildner {
206d638c6eeSSascha Wildner UINT64 Length = strlen(Filename);
207d638c6eeSSascha Wildner char *FileExt = Filename + Length - 4;
2081093ca81SSascha Wildner UINT64 i;
209d638c6eeSSascha Wildner
210d638c6eeSSascha Wildner
211d638c6eeSSascha Wildner if ((Length > 4) && AcpiUtStricmp (FileExt, ".dsl"))
212d638c6eeSSascha Wildner {
2131093ca81SSascha Wildner return (FALSE);
214d638c6eeSSascha Wildner }
215d638c6eeSSascha Wildner
216d638c6eeSSascha Wildner for(i = 0; i<Length; ++i)
217d638c6eeSSascha Wildner {
2181093ca81SSascha Wildner if (!isprint ((int) Filename[i]))
219d638c6eeSSascha Wildner {
2201093ca81SSascha Wildner return (FALSE);
221d638c6eeSSascha Wildner }
222d638c6eeSSascha Wildner }
2231093ca81SSascha Wildner
2241093ca81SSascha Wildner return (TRUE);
225d638c6eeSSascha Wildner }
226d638c6eeSSascha Wildner
227d638c6eeSSascha Wildner
228d638c6eeSSascha Wildner /*******************************************************************************
229d638c6eeSSascha Wildner *
230d638c6eeSSascha Wildner * FUNCTION: CvInitFileTree
231d638c6eeSSascha Wildner *
232d638c6eeSSascha Wildner * PARAMETERS: Table - input table
233ff3cb46dSSascha Wildner * RootFile - Output file that defines the DefinitionBlock
234d638c6eeSSascha Wildner *
2351093ca81SSascha Wildner * RETURN: None
236d638c6eeSSascha Wildner *
237d638c6eeSSascha Wildner * DESCRIPTION: Initialize the file dependency tree by scanning the AML.
238d638c6eeSSascha Wildner * This is referred as ASL_CV_INIT_FILETREE.
239d638c6eeSSascha Wildner *
240d638c6eeSSascha Wildner ******************************************************************************/
241d638c6eeSSascha Wildner
242d638c6eeSSascha Wildner void
CvInitFileTree(ACPI_TABLE_HEADER * Table,FILE * RootFile)243d638c6eeSSascha Wildner CvInitFileTree (
244d638c6eeSSascha Wildner ACPI_TABLE_HEADER *Table,
245ff3cb46dSSascha Wildner FILE *RootFile)
246d638c6eeSSascha Wildner {
247d638c6eeSSascha Wildner UINT8 *TreeAml;
248d638c6eeSSascha Wildner UINT8 *FileEnd;
249d638c6eeSSascha Wildner char *Filename = NULL;
250d638c6eeSSascha Wildner char *PreviousFilename = NULL;
251d638c6eeSSascha Wildner char *ParentFilename = NULL;
252d638c6eeSSascha Wildner char *ChildFilename = NULL;
253ff3cb46dSSascha Wildner UINT8 *AmlStart;
254ff3cb46dSSascha Wildner UINT32 AmlLength;
255d638c6eeSSascha Wildner
256d638c6eeSSascha Wildner
2577bcb6cafSSascha Wildner if (!AcpiGbl_CaptureComments)
258d638c6eeSSascha Wildner {
259d638c6eeSSascha Wildner return;
260d638c6eeSSascha Wildner }
261d638c6eeSSascha Wildner
262ff3cb46dSSascha Wildner
263ff3cb46dSSascha Wildner AmlLength = Table->Length - sizeof (ACPI_TABLE_HEADER);
264ff3cb46dSSascha Wildner AmlStart = ((UINT8 *) Table + sizeof (ACPI_TABLE_HEADER));
265ff3cb46dSSascha Wildner
266d638c6eeSSascha Wildner CvDbgPrint ("AmlLength: %x\n", AmlLength);
267d638c6eeSSascha Wildner CvDbgPrint ("AmlStart: %p\n", AmlStart);
268ff3cb46dSSascha Wildner CvDbgPrint ("AmlEnd: %p\n", AmlStart+AmlLength);
269d638c6eeSSascha Wildner
270d638c6eeSSascha Wildner AcpiGbl_FileTreeRoot = AcpiOsAcquireObject (AcpiGbl_FileCache);
2711093ca81SSascha Wildner
272d638c6eeSSascha Wildner AcpiGbl_FileTreeRoot->FileStart = (char *)(AmlStart);
273d638c6eeSSascha Wildner AcpiGbl_FileTreeRoot->FileEnd = (char *)(AmlStart + Table->Length);
274d638c6eeSSascha Wildner AcpiGbl_FileTreeRoot->Next = NULL;
275d638c6eeSSascha Wildner AcpiGbl_FileTreeRoot->Parent = NULL;
276d638c6eeSSascha Wildner AcpiGbl_FileTreeRoot->Filename = (char *)(AmlStart+2);
277d638c6eeSSascha Wildner
278d638c6eeSSascha Wildner /* Set the root file to the current open file */
279d638c6eeSSascha Wildner
280ff3cb46dSSascha Wildner AcpiGbl_FileTreeRoot->File = RootFile;
281d638c6eeSSascha Wildner
282d638c6eeSSascha Wildner /*
28300ffa116SSascha Wildner * Set this to true because we don't need to output
284d638c6eeSSascha Wildner * an include statement for the topmost file
285d638c6eeSSascha Wildner */
286d638c6eeSSascha Wildner AcpiGbl_FileTreeRoot->IncludeWritten = TRUE;
287d638c6eeSSascha Wildner Filename = NULL;
288d638c6eeSSascha Wildner AcpiGbl_CurrentFilename = (char *)(AmlStart+2);
289d638c6eeSSascha Wildner AcpiGbl_RootFilename = (char *)(AmlStart+2);
290d638c6eeSSascha Wildner
291d638c6eeSSascha Wildner TreeAml = AmlStart;
292d638c6eeSSascha Wildner FileEnd = AmlStart + AmlLength;
293d638c6eeSSascha Wildner
294d638c6eeSSascha Wildner while (TreeAml <= FileEnd)
295d638c6eeSSascha Wildner {
296d638c6eeSSascha Wildner /*
297d638c6eeSSascha Wildner * Make sure that this filename contains all printable characters
298d638c6eeSSascha Wildner * and a .dsl extension at the end. If not, then it must be some
299d638c6eeSSascha Wildner * raw data that doesn't outline a filename.
300d638c6eeSSascha Wildner */
301d638c6eeSSascha Wildner if ((*TreeAml == AML_COMMENT_OP) &&
302d638c6eeSSascha Wildner (*(TreeAml +1) == FILENAME_COMMENT) &&
303d638c6eeSSascha Wildner (CvIsFilename ((char *)(TreeAml +2))))
304d638c6eeSSascha Wildner {
305d638c6eeSSascha Wildner CvDbgPrint ("A9 and a 08 file\n");
306d638c6eeSSascha Wildner PreviousFilename = Filename;
307d638c6eeSSascha Wildner Filename = (char *) (TreeAml +2);
3081093ca81SSascha Wildner
309d638c6eeSSascha Wildner CvAddToFileTree (Filename, PreviousFilename);
310d638c6eeSSascha Wildner ChildFilename = Filename;
311d638c6eeSSascha Wildner CvDbgPrint ("%s\n", Filename);
312d638c6eeSSascha Wildner }
313d638c6eeSSascha Wildner else if ((*TreeAml == AML_COMMENT_OP) &&
314d638c6eeSSascha Wildner (*(TreeAml +1) == PARENTFILENAME_COMMENT) &&
315d638c6eeSSascha Wildner (CvIsFilename ((char *)(TreeAml +2))))
316d638c6eeSSascha Wildner {
317d638c6eeSSascha Wildner CvDbgPrint ("A9 and a 09 file\n");
318d638c6eeSSascha Wildner ParentFilename = (char *)(TreeAml +2);
319d638c6eeSSascha Wildner CvSetFileParent (ChildFilename, ParentFilename);
320d638c6eeSSascha Wildner CvDbgPrint ("%s\n", ParentFilename);
321d638c6eeSSascha Wildner }
3221093ca81SSascha Wildner
323d638c6eeSSascha Wildner ++TreeAml;
324d638c6eeSSascha Wildner }
325d638c6eeSSascha Wildner }
326d638c6eeSSascha Wildner
327d638c6eeSSascha Wildner
328d638c6eeSSascha Wildner /*******************************************************************************
329d638c6eeSSascha Wildner *
330d638c6eeSSascha Wildner * FUNCTION: CvClearOpComments
331d638c6eeSSascha Wildner *
332d638c6eeSSascha Wildner * PARAMETERS: Op -- clear all comments within this Op
333d638c6eeSSascha Wildner *
3341093ca81SSascha Wildner * RETURN: None
335d638c6eeSSascha Wildner *
336d638c6eeSSascha Wildner * DESCRIPTION: Clear all converter-related fields of the given Op.
337d638c6eeSSascha Wildner * This is referred as ASL_CV_CLEAR_OP_COMMENTS.
338d638c6eeSSascha Wildner *
339d638c6eeSSascha Wildner ******************************************************************************/
340d638c6eeSSascha Wildner
341d638c6eeSSascha Wildner void
CvClearOpComments(ACPI_PARSE_OBJECT * Op)342d638c6eeSSascha Wildner CvClearOpComments (
343d638c6eeSSascha Wildner ACPI_PARSE_OBJECT *Op)
344d638c6eeSSascha Wildner {
3451093ca81SSascha Wildner
346d638c6eeSSascha Wildner Op->Common.InlineComment = NULL;
347d638c6eeSSascha Wildner Op->Common.EndNodeComment = NULL;
348d638c6eeSSascha Wildner Op->Common.NameComment = NULL;
349d638c6eeSSascha Wildner Op->Common.CommentList = NULL;
350d638c6eeSSascha Wildner Op->Common.EndBlkComment = NULL;
351d638c6eeSSascha Wildner Op->Common.CloseBraceComment = NULL;
352d638c6eeSSascha Wildner Op->Common.CvFilename = NULL;
353d638c6eeSSascha Wildner Op->Common.CvParentFilename = NULL;
354d638c6eeSSascha Wildner }
355d638c6eeSSascha Wildner
356d638c6eeSSascha Wildner
357d638c6eeSSascha Wildner /*******************************************************************************
358d638c6eeSSascha Wildner *
359d638c6eeSSascha Wildner * FUNCTION: CvCommentExists
360d638c6eeSSascha Wildner *
3611093ca81SSascha Wildner * PARAMETERS: Address - check if this address appears in the list
362d638c6eeSSascha Wildner *
363d638c6eeSSascha Wildner * RETURN: BOOLEAN - TRUE if the address exists.
364d638c6eeSSascha Wildner *
3651093ca81SSascha Wildner * DESCRIPTION: Look at the pointer address and check if this appears in the
3661093ca81SSascha Wildner * list of all addresses. If it exists in the list, return TRUE
367d638c6eeSSascha Wildner * if it exists. Otherwise add to the list and return FALSE.
368d638c6eeSSascha Wildner *
369d638c6eeSSascha Wildner ******************************************************************************/
370d638c6eeSSascha Wildner
371d638c6eeSSascha Wildner static BOOLEAN
CvCommentExists(UINT8 * Address)372d638c6eeSSascha Wildner CvCommentExists (
373d638c6eeSSascha Wildner UINT8 *Address)
374d638c6eeSSascha Wildner {
375d638c6eeSSascha Wildner ACPI_COMMENT_ADDR_NODE *Current = AcpiGbl_CommentAddrListHead;
376d638c6eeSSascha Wildner UINT8 Option;
377d638c6eeSSascha Wildner
378d638c6eeSSascha Wildner
379d638c6eeSSascha Wildner if (!Address)
380d638c6eeSSascha Wildner {
381d638c6eeSSascha Wildner return (FALSE);
382d638c6eeSSascha Wildner }
3831093ca81SSascha Wildner
384d638c6eeSSascha Wildner Option = *(Address + 1);
385d638c6eeSSascha Wildner
386d638c6eeSSascha Wildner /*
3871093ca81SSascha Wildner * FILENAME_COMMENT and PARENTFILENAME_COMMENT are not treated as
3881093ca81SSascha Wildner * comments. They serve as markers for where the file starts and ends.
389d638c6eeSSascha Wildner */
3901093ca81SSascha Wildner if ((Option == FILENAME_COMMENT) ||
3911093ca81SSascha Wildner (Option == PARENTFILENAME_COMMENT))
392d638c6eeSSascha Wildner {
393d638c6eeSSascha Wildner return (FALSE);
394d638c6eeSSascha Wildner }
395d638c6eeSSascha Wildner
396d638c6eeSSascha Wildner if (!Current)
397d638c6eeSSascha Wildner {
398d638c6eeSSascha Wildner AcpiGbl_CommentAddrListHead =
399d638c6eeSSascha Wildner AcpiOsAcquireObject (AcpiGbl_RegCommentCache);
400d638c6eeSSascha Wildner AcpiGbl_CommentAddrListHead->Addr = Address;
401d638c6eeSSascha Wildner AcpiGbl_CommentAddrListHead->Next = NULL;
402d638c6eeSSascha Wildner return (FALSE);
403d638c6eeSSascha Wildner }
404d638c6eeSSascha Wildner else
405d638c6eeSSascha Wildner {
406d638c6eeSSascha Wildner while (Current)
407d638c6eeSSascha Wildner {
408d638c6eeSSascha Wildner if (Current->Addr != Address)
409d638c6eeSSascha Wildner {
410d638c6eeSSascha Wildner Current = Current->Next;
411d638c6eeSSascha Wildner }
412d638c6eeSSascha Wildner else
413d638c6eeSSascha Wildner {
414d638c6eeSSascha Wildner return (TRUE);
415d638c6eeSSascha Wildner }
416d638c6eeSSascha Wildner }
417d638c6eeSSascha Wildner
418d638c6eeSSascha Wildner /*
4191093ca81SSascha Wildner * If the execution gets to this point, it means that this
4201093ca81SSascha Wildner * address does not exists in the list. Add this address to the
421d638c6eeSSascha Wildner * beginning of the list.
422d638c6eeSSascha Wildner */
423d638c6eeSSascha Wildner Current = AcpiGbl_CommentAddrListHead;
424d638c6eeSSascha Wildner AcpiGbl_CommentAddrListHead =
425d638c6eeSSascha Wildner AcpiOsAcquireObject (AcpiGbl_RegCommentCache);
4261093ca81SSascha Wildner
427d638c6eeSSascha Wildner AcpiGbl_CommentAddrListHead->Addr = Address;
428d638c6eeSSascha Wildner AcpiGbl_CommentAddrListHead->Next = Current;
429d638c6eeSSascha Wildner return (FALSE);
430d638c6eeSSascha Wildner }
431d638c6eeSSascha Wildner }
432d638c6eeSSascha Wildner
433d638c6eeSSascha Wildner
434d638c6eeSSascha Wildner /*******************************************************************************
435d638c6eeSSascha Wildner *
436d638c6eeSSascha Wildner * FUNCTION: CvFilenameExists
437d638c6eeSSascha Wildner *
438d638c6eeSSascha Wildner * PARAMETERS: Filename - filename to search
439d638c6eeSSascha Wildner *
440d638c6eeSSascha Wildner * RETURN: ACPI_FILE_NODE - a pointer to a file node
441d638c6eeSSascha Wildner *
442d638c6eeSSascha Wildner * DESCRIPTION: Look for the given filename in the file dependency tree.
443d638c6eeSSascha Wildner * Returns the file node if it exists, returns NULL if it does not.
444d638c6eeSSascha Wildner *
445d638c6eeSSascha Wildner ******************************************************************************/
446d638c6eeSSascha Wildner
447d638c6eeSSascha Wildner ACPI_FILE_NODE*
CvFilenameExists(char * Filename,ACPI_FILE_NODE * Head)448d638c6eeSSascha Wildner CvFilenameExists(
449d638c6eeSSascha Wildner char *Filename,
450d638c6eeSSascha Wildner ACPI_FILE_NODE *Head)
451d638c6eeSSascha Wildner {
452d638c6eeSSascha Wildner ACPI_FILE_NODE *Current = Head;
453d638c6eeSSascha Wildner
454d638c6eeSSascha Wildner
4551093ca81SSascha Wildner if (!Filename)
4561093ca81SSascha Wildner {
4571093ca81SSascha Wildner return (NULL);
4581093ca81SSascha Wildner }
4591093ca81SSascha Wildner
460d638c6eeSSascha Wildner while (Current)
461d638c6eeSSascha Wildner {
462d638c6eeSSascha Wildner if (!AcpiUtStricmp (Current->Filename, Filename))
463d638c6eeSSascha Wildner {
464d638c6eeSSascha Wildner return (Current);
465d638c6eeSSascha Wildner }
4661093ca81SSascha Wildner
467d638c6eeSSascha Wildner Current = Current->Next;
468d638c6eeSSascha Wildner }
469d638c6eeSSascha Wildner return (NULL);
470d638c6eeSSascha Wildner }
471d638c6eeSSascha Wildner
472d638c6eeSSascha Wildner
473d638c6eeSSascha Wildner /*******************************************************************************
474d638c6eeSSascha Wildner *
475d638c6eeSSascha Wildner * FUNCTION: CvFileAddressLookup
476d638c6eeSSascha Wildner *
477d638c6eeSSascha Wildner * PARAMETERS: Address - address to look up
478d638c6eeSSascha Wildner * Head - file dependency tree
479d638c6eeSSascha Wildner *
4801093ca81SSascha Wildner * RETURN: ACPI_FILE_NODE - pointer to a file node containing the address
481d638c6eeSSascha Wildner *
482d638c6eeSSascha Wildner * DESCRIPTION: Look for the given address in the file dependency tree.
483d638c6eeSSascha Wildner * Returns the first file node where the given address is within
484d638c6eeSSascha Wildner * the file node's starting and ending address.
485d638c6eeSSascha Wildner *
486d638c6eeSSascha Wildner ******************************************************************************/
487d638c6eeSSascha Wildner
488d638c6eeSSascha Wildner static ACPI_FILE_NODE *
CvFileAddressLookup(char * Address,ACPI_FILE_NODE * Head)489d638c6eeSSascha Wildner CvFileAddressLookup(
490d638c6eeSSascha Wildner char *Address,
491d638c6eeSSascha Wildner ACPI_FILE_NODE *Head)
492d638c6eeSSascha Wildner {
493d638c6eeSSascha Wildner ACPI_FILE_NODE *Current = Head;
494d638c6eeSSascha Wildner
495d638c6eeSSascha Wildner
496d638c6eeSSascha Wildner while (Current)
497d638c6eeSSascha Wildner {
498d638c6eeSSascha Wildner if ((Address >= Current->FileStart) &&
499d638c6eeSSascha Wildner (Address < Current->FileEnd ||
500d638c6eeSSascha Wildner !Current->FileEnd))
501d638c6eeSSascha Wildner {
502d638c6eeSSascha Wildner return (Current);
503d638c6eeSSascha Wildner }
5041093ca81SSascha Wildner
505d638c6eeSSascha Wildner Current = Current->Next;
506d638c6eeSSascha Wildner }
507d638c6eeSSascha Wildner
508d638c6eeSSascha Wildner return (NULL);
509d638c6eeSSascha Wildner }
510d638c6eeSSascha Wildner
511d638c6eeSSascha Wildner
512d638c6eeSSascha Wildner /*******************************************************************************
513d638c6eeSSascha Wildner *
514d638c6eeSSascha Wildner * FUNCTION: CvLabelFileNode
515d638c6eeSSascha Wildner *
516d638c6eeSSascha Wildner * PARAMETERS: Op
517d638c6eeSSascha Wildner *
518d638c6eeSSascha Wildner * RETURN: None
519d638c6eeSSascha Wildner *
520d638c6eeSSascha Wildner * DESCRIPTION: Takes a given parse op, looks up its Op->Common.Aml field
52100ffa116SSascha Wildner * within the file tree and fills in appropriate file information
522d638c6eeSSascha Wildner * from a matching node within the tree.
523d638c6eeSSascha Wildner * This is referred as ASL_CV_LABEL_FILENODE.
524d638c6eeSSascha Wildner *
525d638c6eeSSascha Wildner ******************************************************************************/
526d638c6eeSSascha Wildner
527d638c6eeSSascha Wildner void
CvLabelFileNode(ACPI_PARSE_OBJECT * Op)528d638c6eeSSascha Wildner CvLabelFileNode(
529d638c6eeSSascha Wildner ACPI_PARSE_OBJECT *Op)
530d638c6eeSSascha Wildner {
531d638c6eeSSascha Wildner ACPI_FILE_NODE *Node;
532d638c6eeSSascha Wildner
533d638c6eeSSascha Wildner
534d638c6eeSSascha Wildner if (!Op)
535d638c6eeSSascha Wildner {
536d638c6eeSSascha Wildner return;
537d638c6eeSSascha Wildner }
538d638c6eeSSascha Wildner
5391093ca81SSascha Wildner Node = CvFileAddressLookup ((char *)
5401093ca81SSascha Wildner Op->Common.Aml, AcpiGbl_FileTreeRoot);
541d638c6eeSSascha Wildner if (!Node)
542d638c6eeSSascha Wildner {
543d638c6eeSSascha Wildner return;
544d638c6eeSSascha Wildner }
545d638c6eeSSascha Wildner
546d638c6eeSSascha Wildner Op->Common.CvFilename = Node->Filename;
547d638c6eeSSascha Wildner if (Node->Parent)
548d638c6eeSSascha Wildner {
549d638c6eeSSascha Wildner Op->Common.CvParentFilename = Node->Parent->Filename;
550d638c6eeSSascha Wildner }
551d638c6eeSSascha Wildner else
552d638c6eeSSascha Wildner {
553d638c6eeSSascha Wildner Op->Common.CvParentFilename = Node->Filename;
554d638c6eeSSascha Wildner }
555d638c6eeSSascha Wildner }
556d638c6eeSSascha Wildner
557d638c6eeSSascha Wildner
558d638c6eeSSascha Wildner /*******************************************************************************
559d638c6eeSSascha Wildner *
560d638c6eeSSascha Wildner * FUNCTION: CvAddToFileTree
561d638c6eeSSascha Wildner *
562d638c6eeSSascha Wildner * PARAMETERS: Filename - Address containing the name of the current
563d638c6eeSSascha Wildner * filename
564d638c6eeSSascha Wildner * PreviousFilename - Address containing the name of the previous
565d638c6eeSSascha Wildner * filename
566d638c6eeSSascha Wildner *
5671093ca81SSascha Wildner * RETURN: None
568d638c6eeSSascha Wildner *
569d638c6eeSSascha Wildner * DESCRIPTION: Add this filename to the AcpiGbl_FileTree if it does not exist.
570d638c6eeSSascha Wildner *
571d638c6eeSSascha Wildner ******************************************************************************/
572d638c6eeSSascha Wildner
573d638c6eeSSascha Wildner static void
CvAddToFileTree(char * Filename,char * PreviousFilename)574d638c6eeSSascha Wildner CvAddToFileTree (
575d638c6eeSSascha Wildner char *Filename,
576d638c6eeSSascha Wildner char *PreviousFilename)
577d638c6eeSSascha Wildner {
578d638c6eeSSascha Wildner ACPI_FILE_NODE *Node;
579d638c6eeSSascha Wildner
580d638c6eeSSascha Wildner
581d638c6eeSSascha Wildner if (!AcpiUtStricmp(Filename, AcpiGbl_RootFilename) &&
582d638c6eeSSascha Wildner PreviousFilename)
583d638c6eeSSascha Wildner {
584d638c6eeSSascha Wildner Node = CvFilenameExists (PreviousFilename, AcpiGbl_FileTreeRoot);
585d638c6eeSSascha Wildner if (Node)
586d638c6eeSSascha Wildner {
587d638c6eeSSascha Wildner /*
588d638c6eeSSascha Wildner * Set the end point of the PreviousFilename to the address
589d638c6eeSSascha Wildner * of Filename.
590d638c6eeSSascha Wildner */
591d638c6eeSSascha Wildner Node->FileEnd = Filename;
592d638c6eeSSascha Wildner }
593d638c6eeSSascha Wildner }
594d638c6eeSSascha Wildner else if (!AcpiUtStricmp(Filename, AcpiGbl_RootFilename) &&
595d638c6eeSSascha Wildner !PreviousFilename)
596d638c6eeSSascha Wildner {
597d638c6eeSSascha Wildner return;
598d638c6eeSSascha Wildner }
599d638c6eeSSascha Wildner
600d638c6eeSSascha Wildner Node = CvFilenameExists (Filename, AcpiGbl_FileTreeRoot);
601d638c6eeSSascha Wildner if (Node && PreviousFilename)
602d638c6eeSSascha Wildner {
603d638c6eeSSascha Wildner /*
6041093ca81SSascha Wildner * Update the end of the previous file and all of their parents'
6051093ca81SSascha Wildner * ending addresses. This is done to ensure that parent file
6061093ca81SSascha Wildner * ranges extend to the end of their childrens' files.
607d638c6eeSSascha Wildner */
608d638c6eeSSascha Wildner Node = CvFilenameExists (PreviousFilename, AcpiGbl_FileTreeRoot);
609d638c6eeSSascha Wildner if (Node && (Node->FileEnd < Filename))
610d638c6eeSSascha Wildner {
611d638c6eeSSascha Wildner Node->FileEnd = Filename;
612d638c6eeSSascha Wildner Node = Node->Parent;
613d638c6eeSSascha Wildner while (Node)
614d638c6eeSSascha Wildner {
615d638c6eeSSascha Wildner if (Node->FileEnd < Filename)
616d638c6eeSSascha Wildner {
617d638c6eeSSascha Wildner Node->FileEnd = Filename;
618d638c6eeSSascha Wildner }
6191093ca81SSascha Wildner
620d638c6eeSSascha Wildner Node = Node->Parent;
621d638c6eeSSascha Wildner }
622d638c6eeSSascha Wildner }
623d638c6eeSSascha Wildner }
624d638c6eeSSascha Wildner else
625d638c6eeSSascha Wildner {
626d638c6eeSSascha Wildner Node = AcpiGbl_FileTreeRoot;
627d638c6eeSSascha Wildner AcpiGbl_FileTreeRoot = AcpiOsAcquireObject (AcpiGbl_FileCache);
6281093ca81SSascha Wildner
629d638c6eeSSascha Wildner AcpiGbl_FileTreeRoot->Next = Node;
630d638c6eeSSascha Wildner AcpiGbl_FileTreeRoot->Parent = NULL;
631d638c6eeSSascha Wildner AcpiGbl_FileTreeRoot->Filename = Filename;
632d638c6eeSSascha Wildner AcpiGbl_FileTreeRoot->FileStart = Filename;
633d638c6eeSSascha Wildner AcpiGbl_FileTreeRoot->IncludeWritten = FALSE;
634d638c6eeSSascha Wildner AcpiGbl_FileTreeRoot->File = fopen(Filename, "w+");
635d638c6eeSSascha Wildner
636d638c6eeSSascha Wildner /*
637d638c6eeSSascha Wildner * If we can't open the file, we need to abort here before we
638d638c6eeSSascha Wildner * accidentally write to a NULL file.
639d638c6eeSSascha Wildner */
640d638c6eeSSascha Wildner if (!AcpiGbl_FileTreeRoot->File)
641d638c6eeSSascha Wildner {
642d638c6eeSSascha Wildner /* delete the .xxx file */
643d638c6eeSSascha Wildner
644d638c6eeSSascha Wildner FlDeleteFile (ASL_FILE_AML_OUTPUT);
645806343b9SSascha Wildner sprintf (AslGbl_MsgBuffer, "\"%s\" - %s", Filename, strerror (errno));
6461093ca81SSascha Wildner AslCommonError (ASL_ERROR, ASL_MSG_OPEN, 0, 0, 0, 0,
647806343b9SSascha Wildner NULL, AslGbl_MsgBuffer);
648d638c6eeSSascha Wildner AslAbort ();
649d638c6eeSSascha Wildner }
650d638c6eeSSascha Wildner }
651d638c6eeSSascha Wildner }
652d638c6eeSSascha Wildner
653d638c6eeSSascha Wildner
654d638c6eeSSascha Wildner /*******************************************************************************
655d638c6eeSSascha Wildner *
656d638c6eeSSascha Wildner * FUNCTION: CvSetFileParent
657d638c6eeSSascha Wildner *
658d638c6eeSSascha Wildner * PARAMETERS: ChildFile - contains the filename of the child file
659d638c6eeSSascha Wildner * ParentFile - contains the filename of the parent file.
660d638c6eeSSascha Wildner *
6611093ca81SSascha Wildner * RETURN: None
662d638c6eeSSascha Wildner *
6631093ca81SSascha Wildner * DESCRIPTION: Point the parent pointer of the Child to the node that
664d638c6eeSSascha Wildner * corresponds with the parent file node.
665d638c6eeSSascha Wildner *
666d638c6eeSSascha Wildner ******************************************************************************/
667d638c6eeSSascha Wildner
668d638c6eeSSascha Wildner static void
CvSetFileParent(char * ChildFile,char * ParentFile)669d638c6eeSSascha Wildner CvSetFileParent (
670d638c6eeSSascha Wildner char *ChildFile,
671d638c6eeSSascha Wildner char *ParentFile)
672d638c6eeSSascha Wildner {
673d638c6eeSSascha Wildner ACPI_FILE_NODE *Child;
674d638c6eeSSascha Wildner ACPI_FILE_NODE *Parent;
675d638c6eeSSascha Wildner
676d638c6eeSSascha Wildner
677d638c6eeSSascha Wildner Child = CvFilenameExists (ChildFile, AcpiGbl_FileTreeRoot);
678d638c6eeSSascha Wildner Parent = CvFilenameExists (ParentFile, AcpiGbl_FileTreeRoot);
6791093ca81SSascha Wildner
680d638c6eeSSascha Wildner if (Child && Parent)
681d638c6eeSSascha Wildner {
682d638c6eeSSascha Wildner Child->Parent = Parent;
683d638c6eeSSascha Wildner
684d638c6eeSSascha Wildner while (Child->Parent)
685d638c6eeSSascha Wildner {
686d638c6eeSSascha Wildner if (Child->Parent->FileEnd < Child->FileStart)
687d638c6eeSSascha Wildner {
688d638c6eeSSascha Wildner Child->Parent->FileEnd = Child->FileStart;
689d638c6eeSSascha Wildner }
6901093ca81SSascha Wildner
691d638c6eeSSascha Wildner Child = Child->Parent;
692d638c6eeSSascha Wildner }
693d638c6eeSSascha Wildner }
694d638c6eeSSascha Wildner }
695d638c6eeSSascha Wildner
696d638c6eeSSascha Wildner
697d638c6eeSSascha Wildner /*******************************************************************************
698d638c6eeSSascha Wildner *
699d638c6eeSSascha Wildner * FUNCTION: CvCaptureCommentsOnly
700d638c6eeSSascha Wildner *
701d638c6eeSSascha Wildner * PARAMETERS: ParserState - A parser state object
702d638c6eeSSascha Wildner *
7031093ca81SSascha Wildner * RETURN: None
704d638c6eeSSascha Wildner *
7051093ca81SSascha Wildner * DESCRIPTION: Look at the aml that the parser state is pointing to,
706d638c6eeSSascha Wildner * capture any AML_COMMENT_OP and it's arguments and increment the
707d638c6eeSSascha Wildner * aml pointer past the comment. Comments are transferred to parse
708d638c6eeSSascha Wildner * nodes through CvTransferComments() as well as
709d638c6eeSSascha Wildner * AcpiPsBuildNamedOp().
710d638c6eeSSascha Wildner * This is referred as ASL_CV_CAPTURE_COMMENTS_ONLY.
711d638c6eeSSascha Wildner *
712d638c6eeSSascha Wildner ******************************************************************************/
713d638c6eeSSascha Wildner
714d638c6eeSSascha Wildner void
CvCaptureCommentsOnly(ACPI_PARSE_STATE * ParserState)715d638c6eeSSascha Wildner CvCaptureCommentsOnly (
716d638c6eeSSascha Wildner ACPI_PARSE_STATE *ParserState)
717d638c6eeSSascha Wildner {
718d638c6eeSSascha Wildner UINT8 *Aml = ParserState->Aml;
719d638c6eeSSascha Wildner UINT16 Opcode = (UINT16) ACPI_GET8 (Aml);
720d638c6eeSSascha Wildner UINT32 Length = 0;
7217bcb6cafSSascha Wildner UINT8 CommentOption;
722d638c6eeSSascha Wildner BOOLEAN StdDefBlockFlag = FALSE;
723d638c6eeSSascha Wildner ACPI_COMMENT_NODE *CommentNode;
724d638c6eeSSascha Wildner ACPI_FILE_NODE *FileNode;
725d638c6eeSSascha Wildner
726d638c6eeSSascha Wildner
7277bcb6cafSSascha Wildner if (!AcpiGbl_CaptureComments ||
728d638c6eeSSascha Wildner Opcode != AML_COMMENT_OP)
729d638c6eeSSascha Wildner {
730d638c6eeSSascha Wildner return;
731d638c6eeSSascha Wildner }
732d638c6eeSSascha Wildner
733d638c6eeSSascha Wildner while (Opcode == AML_COMMENT_OP)
734d638c6eeSSascha Wildner {
735d638c6eeSSascha Wildner CvDbgPrint ("comment aml address: %p\n", Aml);
736d638c6eeSSascha Wildner
737d638c6eeSSascha Wildner if (CvCommentExists(ParserState->Aml))
738d638c6eeSSascha Wildner {
739d638c6eeSSascha Wildner CvDbgPrint ("Avoiding capturing an existing comment.\n");
740d638c6eeSSascha Wildner }
741d638c6eeSSascha Wildner else
742d638c6eeSSascha Wildner {
743d638c6eeSSascha Wildner CommentOption = *(Aml +1);
744d638c6eeSSascha Wildner
7451093ca81SSascha Wildner /*
7461093ca81SSascha Wildner * Increment past the comment option and point the
7471093ca81SSascha Wildner * appropriate char pointers
7481093ca81SSascha Wildner */
749d638c6eeSSascha Wildner Aml += 2;
750d638c6eeSSascha Wildner
7511093ca81SSascha Wildner /* Found a comment. Now, set pointers to these comments. */
752d638c6eeSSascha Wildner
753d638c6eeSSascha Wildner switch (CommentOption)
754d638c6eeSSascha Wildner {
755d638c6eeSSascha Wildner case STD_DEFBLK_COMMENT:
756d638c6eeSSascha Wildner
757d638c6eeSSascha Wildner StdDefBlockFlag = TRUE;
758d638c6eeSSascha Wildner
7591093ca81SSascha Wildner /*
7601093ca81SSascha Wildner * Add to a linked list of nodes. This list will be
7611093ca81SSascha Wildner * taken by the parse node created next.
7621093ca81SSascha Wildner */
7631093ca81SSascha Wildner CommentNode = AcpiOsAcquireObject (
7641093ca81SSascha Wildner AcpiGbl_RegCommentCache);
765d638c6eeSSascha Wildner CommentNode->Comment = ACPI_CAST_PTR (char, Aml);
766d638c6eeSSascha Wildner CommentNode->Next = NULL;
767d638c6eeSSascha Wildner
768d638c6eeSSascha Wildner if (!AcpiGbl_DefBlkCommentListHead)
769d638c6eeSSascha Wildner {
770d638c6eeSSascha Wildner AcpiGbl_DefBlkCommentListHead = CommentNode;
771d638c6eeSSascha Wildner AcpiGbl_DefBlkCommentListTail = CommentNode;
772d638c6eeSSascha Wildner }
773d638c6eeSSascha Wildner else
774d638c6eeSSascha Wildner {
775d638c6eeSSascha Wildner AcpiGbl_DefBlkCommentListTail->Next = CommentNode;
7761093ca81SSascha Wildner AcpiGbl_DefBlkCommentListTail =
7771093ca81SSascha Wildner AcpiGbl_DefBlkCommentListTail->Next;
778d638c6eeSSascha Wildner }
779d638c6eeSSascha Wildner break;
780d638c6eeSSascha Wildner
781d638c6eeSSascha Wildner case STANDARD_COMMENT:
782d638c6eeSSascha Wildner
783d638c6eeSSascha Wildner CvDbgPrint ("found regular comment.\n");
784d638c6eeSSascha Wildner
7851093ca81SSascha Wildner /*
7861093ca81SSascha Wildner * Add to a linked list of nodes. This list will be
7871093ca81SSascha Wildner * taken by the parse node created next.
7881093ca81SSascha Wildner */
7891093ca81SSascha Wildner CommentNode = AcpiOsAcquireObject (
7901093ca81SSascha Wildner AcpiGbl_RegCommentCache);
791d638c6eeSSascha Wildner CommentNode->Comment = ACPI_CAST_PTR (char, Aml);
792d638c6eeSSascha Wildner CommentNode->Next = NULL;
793d638c6eeSSascha Wildner
794d638c6eeSSascha Wildner if (!AcpiGbl_RegCommentListHead)
795d638c6eeSSascha Wildner {
796d638c6eeSSascha Wildner AcpiGbl_RegCommentListHead = CommentNode;
797d638c6eeSSascha Wildner AcpiGbl_RegCommentListTail = CommentNode;
798d638c6eeSSascha Wildner }
799d638c6eeSSascha Wildner else
800d638c6eeSSascha Wildner {
801d638c6eeSSascha Wildner AcpiGbl_RegCommentListTail->Next = CommentNode;
8021093ca81SSascha Wildner AcpiGbl_RegCommentListTail =
8031093ca81SSascha Wildner AcpiGbl_RegCommentListTail->Next;
804d638c6eeSSascha Wildner }
805d638c6eeSSascha Wildner break;
806d638c6eeSSascha Wildner
807d638c6eeSSascha Wildner case ENDBLK_COMMENT:
808d638c6eeSSascha Wildner
809d638c6eeSSascha Wildner CvDbgPrint ("found endblk comment.\n");
810d638c6eeSSascha Wildner
8111093ca81SSascha Wildner /* Add to a linked list of nodes. This will be
8121093ca81SSascha Wildner * taken by the next created parse node.
8131093ca81SSascha Wildner */
8141093ca81SSascha Wildner CommentNode = AcpiOsAcquireObject (
8151093ca81SSascha Wildner AcpiGbl_RegCommentCache);
816d638c6eeSSascha Wildner CommentNode->Comment = ACPI_CAST_PTR (char, Aml);
817d638c6eeSSascha Wildner CommentNode->Next = NULL;
818d638c6eeSSascha Wildner
819d638c6eeSSascha Wildner if (!AcpiGbl_EndBlkCommentListHead)
820d638c6eeSSascha Wildner {
821d638c6eeSSascha Wildner AcpiGbl_EndBlkCommentListHead = CommentNode;
822d638c6eeSSascha Wildner AcpiGbl_EndBlkCommentListTail = CommentNode;
823d638c6eeSSascha Wildner }
824d638c6eeSSascha Wildner else
825d638c6eeSSascha Wildner {
826d638c6eeSSascha Wildner AcpiGbl_EndBlkCommentListTail->Next = CommentNode;
8271093ca81SSascha Wildner AcpiGbl_EndBlkCommentListTail =
8281093ca81SSascha Wildner AcpiGbl_EndBlkCommentListTail->Next;
829d638c6eeSSascha Wildner }
830d638c6eeSSascha Wildner break;
831d638c6eeSSascha Wildner
832d638c6eeSSascha Wildner case INLINE_COMMENT:
833d638c6eeSSascha Wildner
834d638c6eeSSascha Wildner CvDbgPrint ("found inline comment.\n");
8351093ca81SSascha Wildner AcpiGbl_CurrentInlineComment =
8361093ca81SSascha Wildner ACPI_CAST_PTR (char, Aml);
837d638c6eeSSascha Wildner break;
838d638c6eeSSascha Wildner
839d638c6eeSSascha Wildner case ENDNODE_COMMENT:
840d638c6eeSSascha Wildner
841d638c6eeSSascha Wildner CvDbgPrint ("found EndNode comment.\n");
8421093ca81SSascha Wildner AcpiGbl_CurrentEndNodeComment =
8431093ca81SSascha Wildner ACPI_CAST_PTR (char, Aml);
844d638c6eeSSascha Wildner break;
845d638c6eeSSascha Wildner
846d638c6eeSSascha Wildner case CLOSE_BRACE_COMMENT:
847d638c6eeSSascha Wildner
848d638c6eeSSascha Wildner CvDbgPrint ("found close brace comment.\n");
8491093ca81SSascha Wildner AcpiGbl_CurrentCloseBraceComment =
8501093ca81SSascha Wildner ACPI_CAST_PTR (char, Aml);
851d638c6eeSSascha Wildner break;
852d638c6eeSSascha Wildner
853d638c6eeSSascha Wildner case END_DEFBLK_COMMENT:
854d638c6eeSSascha Wildner
8551093ca81SSascha Wildner CvDbgPrint ("Found comment that belongs after"
8561093ca81SSascha Wildner " the } for a definition block.\n");
8571093ca81SSascha Wildner AcpiGbl_CurrentScope->Common.CloseBraceComment =
8581093ca81SSascha Wildner ACPI_CAST_PTR (char, Aml);
859d638c6eeSSascha Wildner break;
860d638c6eeSSascha Wildner
861d638c6eeSSascha Wildner case FILENAME_COMMENT:
862d638c6eeSSascha Wildner
8631093ca81SSascha Wildner CvDbgPrint ("Found a filename: %s\n",
8641093ca81SSascha Wildner ACPI_CAST_PTR (char, Aml));
8651093ca81SSascha Wildner FileNode = CvFilenameExists (
8661093ca81SSascha Wildner ACPI_CAST_PTR (char, Aml), AcpiGbl_FileTreeRoot);
867d638c6eeSSascha Wildner
868d638c6eeSSascha Wildner /*
869d638c6eeSSascha Wildner * If there is an INCLUDE_COMMENT followed by a
870d638c6eeSSascha Wildner * FILENAME_COMMENT, then the INCLUDE_COMMENT is a comment
871d638c6eeSSascha Wildner * that is emitted before the #include for the file.
872d638c6eeSSascha Wildner * We will save the IncludeComment within the FileNode
873d638c6eeSSascha Wildner * associated with this FILENAME_COMMENT.
874d638c6eeSSascha Wildner */
875d638c6eeSSascha Wildner if (FileNode && AcpiGbl_IncCommentListHead)
876d638c6eeSSascha Wildner {
877d638c6eeSSascha Wildner FileNode->IncludeComment = AcpiGbl_IncCommentListHead;
878d638c6eeSSascha Wildner AcpiGbl_IncCommentListHead = NULL;
879d638c6eeSSascha Wildner AcpiGbl_IncCommentListTail = NULL;
880d638c6eeSSascha Wildner }
881d638c6eeSSascha Wildner break;
882d638c6eeSSascha Wildner
883d638c6eeSSascha Wildner case PARENTFILENAME_COMMENT:
884d638c6eeSSascha Wildner CvDbgPrint (" Found a parent filename.\n");
885d638c6eeSSascha Wildner break;
886d638c6eeSSascha Wildner
887d638c6eeSSascha Wildner case INCLUDE_COMMENT:
888d638c6eeSSascha Wildner
889d638c6eeSSascha Wildner /*
890d638c6eeSSascha Wildner * Add to a linked list. This list will be taken by the
891d638c6eeSSascha Wildner * parse node created next. See the FILENAME_COMMENT case
892d638c6eeSSascha Wildner * for more details
893d638c6eeSSascha Wildner */
8941093ca81SSascha Wildner CommentNode = AcpiOsAcquireObject (
8951093ca81SSascha Wildner AcpiGbl_RegCommentCache);
896d638c6eeSSascha Wildner CommentNode->Comment = ACPI_CAST_PTR (char, Aml);
897d638c6eeSSascha Wildner CommentNode->Next = NULL;
898d638c6eeSSascha Wildner
899d638c6eeSSascha Wildner if (!AcpiGbl_IncCommentListHead)
900d638c6eeSSascha Wildner {
901d638c6eeSSascha Wildner AcpiGbl_IncCommentListHead = CommentNode;
902d638c6eeSSascha Wildner AcpiGbl_IncCommentListTail = CommentNode;
903d638c6eeSSascha Wildner }
904d638c6eeSSascha Wildner else
905d638c6eeSSascha Wildner {
906d638c6eeSSascha Wildner AcpiGbl_IncCommentListTail->Next = CommentNode;
9071093ca81SSascha Wildner AcpiGbl_IncCommentListTail =
9081093ca81SSascha Wildner AcpiGbl_IncCommentListTail->Next;
909d638c6eeSSascha Wildner }
910d638c6eeSSascha Wildner
9111093ca81SSascha Wildner CvDbgPrint ("Found a include comment: %s\n",
9121093ca81SSascha Wildner CommentNode->Comment);
913d638c6eeSSascha Wildner break;
914d638c6eeSSascha Wildner
915d638c6eeSSascha Wildner default:
916d638c6eeSSascha Wildner
917d638c6eeSSascha Wildner /* Not a valid comment option. Revert the AML */
918d638c6eeSSascha Wildner
919d638c6eeSSascha Wildner goto DefBlock;
920d638c6eeSSascha Wildner
9211093ca81SSascha Wildner } /* End switch statement */
922d638c6eeSSascha Wildner
9231093ca81SSascha Wildner } /* End else */
924d638c6eeSSascha Wildner
9251093ca81SSascha Wildner /* Determine the length and move forward that amount */
926d638c6eeSSascha Wildner
927d638c6eeSSascha Wildner Length = 0;
928d638c6eeSSascha Wildner while (ParserState->Aml[Length])
929d638c6eeSSascha Wildner {
930d638c6eeSSascha Wildner Length++;
931d638c6eeSSascha Wildner }
932d638c6eeSSascha Wildner
933d638c6eeSSascha Wildner ParserState->Aml += Length + 1;
934d638c6eeSSascha Wildner
935d638c6eeSSascha Wildner /* Peek at the next Opcode. */
936d638c6eeSSascha Wildner
937d638c6eeSSascha Wildner Aml = ParserState->Aml;
938d638c6eeSSascha Wildner Opcode = (UINT16) ACPI_GET8 (Aml);
939d638c6eeSSascha Wildner }
940d638c6eeSSascha Wildner
941d638c6eeSSascha Wildner DefBlock:
942d638c6eeSSascha Wildner if (StdDefBlockFlag)
943d638c6eeSSascha Wildner {
944d638c6eeSSascha Wildner /*
945d638c6eeSSascha Wildner * Give all of its comments to the current scope, which is known as
946d638c6eeSSascha Wildner * the definition block, since STD_DEFBLK_COMMENT only appears after
947d638c6eeSSascha Wildner * definition block headers.
948d638c6eeSSascha Wildner */
949d638c6eeSSascha Wildner AcpiGbl_CurrentScope->Common.CommentList
950d638c6eeSSascha Wildner = AcpiGbl_DefBlkCommentListHead;
951d638c6eeSSascha Wildner AcpiGbl_DefBlkCommentListHead = NULL;
952d638c6eeSSascha Wildner AcpiGbl_DefBlkCommentListTail = NULL;
953d638c6eeSSascha Wildner }
954d638c6eeSSascha Wildner }
955d638c6eeSSascha Wildner
956d638c6eeSSascha Wildner
957d638c6eeSSascha Wildner /*******************************************************************************
958d638c6eeSSascha Wildner *
959d638c6eeSSascha Wildner * FUNCTION: CvCaptureComments
960d638c6eeSSascha Wildner *
961d638c6eeSSascha Wildner * PARAMETERS: ParserState - A parser state object
962d638c6eeSSascha Wildner *
9631093ca81SSascha Wildner * RETURN: None
964d638c6eeSSascha Wildner *
965d638c6eeSSascha Wildner * DESCRIPTION: Wrapper function for CvCaptureCommentsOnly
966d638c6eeSSascha Wildner * This is referred as ASL_CV_CAPTURE_COMMENTS.
967d638c6eeSSascha Wildner *
968d638c6eeSSascha Wildner ******************************************************************************/
969d638c6eeSSascha Wildner
970d638c6eeSSascha Wildner void
CvCaptureComments(ACPI_WALK_STATE * WalkState)971d638c6eeSSascha Wildner CvCaptureComments (
972d638c6eeSSascha Wildner ACPI_WALK_STATE *WalkState)
973d638c6eeSSascha Wildner {
974d638c6eeSSascha Wildner UINT8 *Aml;
975d638c6eeSSascha Wildner UINT16 Opcode;
976d638c6eeSSascha Wildner const ACPI_OPCODE_INFO *OpInfo;
977d638c6eeSSascha Wildner
978d638c6eeSSascha Wildner
9797bcb6cafSSascha Wildner if (!AcpiGbl_CaptureComments)
980d638c6eeSSascha Wildner {
981d638c6eeSSascha Wildner return;
982d638c6eeSSascha Wildner }
983d638c6eeSSascha Wildner
984d638c6eeSSascha Wildner /*
9851093ca81SSascha Wildner * Before parsing, check to see that comments that come directly
9861093ca81SSascha Wildner * after deferred opcodes aren't being processed.
987d638c6eeSSascha Wildner */
988d638c6eeSSascha Wildner Aml = WalkState->ParserState.Aml;
989d638c6eeSSascha Wildner Opcode = (UINT16) ACPI_GET8 (Aml);
990d638c6eeSSascha Wildner OpInfo = AcpiPsGetOpcodeInfo (Opcode);
991d638c6eeSSascha Wildner
992d638c6eeSSascha Wildner if (!(OpInfo->Flags & AML_DEFER) ||
993d638c6eeSSascha Wildner ((OpInfo->Flags & AML_DEFER) &&
994d638c6eeSSascha Wildner (WalkState->PassNumber != ACPI_IMODE_LOAD_PASS1)))
995d638c6eeSSascha Wildner {
996d638c6eeSSascha Wildner CvCaptureCommentsOnly (&WalkState->ParserState);
997d638c6eeSSascha Wildner WalkState->Aml = WalkState->ParserState.Aml;
998d638c6eeSSascha Wildner }
999d638c6eeSSascha Wildner
1000d638c6eeSSascha Wildner }
1001d638c6eeSSascha Wildner
1002d638c6eeSSascha Wildner
1003d638c6eeSSascha Wildner /*******************************************************************************
1004d638c6eeSSascha Wildner *
1005d638c6eeSSascha Wildner * FUNCTION: CvTransferComments
1006d638c6eeSSascha Wildner *
1007d638c6eeSSascha Wildner * PARAMETERS: Op - Transfer comments to this Op
1008d638c6eeSSascha Wildner *
10091093ca81SSascha Wildner * RETURN: None
1010d638c6eeSSascha Wildner *
101100ffa116SSascha Wildner * DESCRIPTION: Transfer all of the comments stored in global containers to the
1012d638c6eeSSascha Wildner * given Op. This will be invoked shortly after the parser creates
1013d638c6eeSSascha Wildner * a ParseOp.
1014d638c6eeSSascha Wildner * This is referred as ASL_CV_TRANSFER_COMMENTS.
1015d638c6eeSSascha Wildner *
1016d638c6eeSSascha Wildner ******************************************************************************/
1017d638c6eeSSascha Wildner
1018d638c6eeSSascha Wildner void
CvTransferComments(ACPI_PARSE_OBJECT * Op)1019d638c6eeSSascha Wildner CvTransferComments (
1020d638c6eeSSascha Wildner ACPI_PARSE_OBJECT *Op)
1021d638c6eeSSascha Wildner {
10221093ca81SSascha Wildner
1023d638c6eeSSascha Wildner Op->Common.InlineComment = AcpiGbl_CurrentInlineComment;
1024d638c6eeSSascha Wildner AcpiGbl_CurrentInlineComment = NULL;
1025d638c6eeSSascha Wildner
1026d638c6eeSSascha Wildner Op->Common.EndNodeComment = AcpiGbl_CurrentEndNodeComment;
1027d638c6eeSSascha Wildner AcpiGbl_CurrentEndNodeComment = NULL;
1028d638c6eeSSascha Wildner
1029d638c6eeSSascha Wildner Op->Common.CloseBraceComment = AcpiGbl_CurrentCloseBraceComment;
1030d638c6eeSSascha Wildner AcpiGbl_CurrentCloseBraceComment = NULL;
1031d638c6eeSSascha Wildner
1032d638c6eeSSascha Wildner Op->Common.CommentList = AcpiGbl_RegCommentListHead;
1033d638c6eeSSascha Wildner AcpiGbl_RegCommentListHead = NULL;
1034d638c6eeSSascha Wildner AcpiGbl_RegCommentListTail = NULL;
1035d638c6eeSSascha Wildner
1036d638c6eeSSascha Wildner Op->Common.EndBlkComment = AcpiGbl_EndBlkCommentListHead;
1037d638c6eeSSascha Wildner AcpiGbl_EndBlkCommentListHead = NULL;
1038d638c6eeSSascha Wildner AcpiGbl_EndBlkCommentListTail = NULL;
1039d638c6eeSSascha Wildner }
1040