1*35786f68SRobert Mustacchi /******************************************************************************
2*35786f68SRobert Mustacchi *
3*35786f68SRobert Mustacchi * Module Name: cvcompiler - ASL-/ASL+ converter functions
4*35786f68SRobert Mustacchi *
5*35786f68SRobert Mustacchi *****************************************************************************/
6*35786f68SRobert Mustacchi
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.
12*35786f68SRobert Mustacchi * All rights reserved.
13*35786f68SRobert Mustacchi *
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 *
119*35786f68SRobert Mustacchi * Redistribution and use in source and binary forms, with or without
120*35786f68SRobert Mustacchi * modification, are permitted provided that the following conditions
121*35786f68SRobert Mustacchi * are met:
122*35786f68SRobert Mustacchi * 1. Redistributions of source code must retain the above copyright
123*35786f68SRobert Mustacchi * notice, this list of conditions, and the following disclaimer,
124*35786f68SRobert Mustacchi * without modification.
125*35786f68SRobert Mustacchi * 2. Redistributions in binary form must reproduce at minimum a disclaimer
126*35786f68SRobert Mustacchi * substantially similar to the "NO WARRANTY" disclaimer below
127*35786f68SRobert Mustacchi * ("Disclaimer") and any redistribution must be conditioned upon
128*35786f68SRobert Mustacchi * including a substantially similar Disclaimer requirement for further
129*35786f68SRobert Mustacchi * binary redistribution.
130*35786f68SRobert Mustacchi * 3. Neither the names of the above-listed copyright holders nor the names
131*35786f68SRobert Mustacchi * of any contributors may be used to endorse or promote products derived
132*35786f68SRobert Mustacchi * from this software without specific prior written permission.
133*35786f68SRobert Mustacchi *
134*35786f68SRobert Mustacchi * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
135*35786f68SRobert Mustacchi * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
136*35786f68SRobert Mustacchi * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
137*35786f68SRobert Mustacchi * 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 *****************************************************************************/
151*35786f68SRobert Mustacchi
152*35786f68SRobert Mustacchi #include "aslcompiler.h"
153*35786f68SRobert Mustacchi #include "acparser.h"
154*35786f68SRobert Mustacchi #include "amlcode.h"
155*35786f68SRobert Mustacchi #include "acdebug.h"
156*35786f68SRobert Mustacchi #include "acconvert.h"
157*35786f68SRobert Mustacchi
158*35786f68SRobert Mustacchi
159*35786f68SRobert Mustacchi /* Local prototypes */
160*35786f68SRobert Mustacchi
161*35786f68SRobert Mustacchi static void
162*35786f68SRobert Mustacchi CvPrintInclude(
163*35786f68SRobert Mustacchi ACPI_FILE_NODE *FNode,
164*35786f68SRobert Mustacchi UINT32 Level);
165*35786f68SRobert Mustacchi
166*35786f68SRobert Mustacchi static BOOLEAN
167*35786f68SRobert Mustacchi CvListIsSingleton (
168*35786f68SRobert Mustacchi ACPI_COMMENT_NODE *CommentList);
169*35786f68SRobert Mustacchi
170*35786f68SRobert Mustacchi
171*35786f68SRobert Mustacchi /*******************************************************************************
172*35786f68SRobert Mustacchi *
173*35786f68SRobert Mustacchi * FUNCTION: CvPrintOneCommentList
174*35786f68SRobert Mustacchi *
175*35786f68SRobert Mustacchi * PARAMETERS: CommentList
176*35786f68SRobert Mustacchi * Level
177*35786f68SRobert Mustacchi *
178*35786f68SRobert Mustacchi * RETURN: None
179*35786f68SRobert Mustacchi *
180*35786f68SRobert Mustacchi * DESCRIPTION: Prints all comments within the given list.
181*35786f68SRobert Mustacchi * This is referred as ASL_CV_PRINT_ONE_COMMENT_LIST.
182*35786f68SRobert Mustacchi *
183*35786f68SRobert Mustacchi ******************************************************************************/
184*35786f68SRobert Mustacchi
185*35786f68SRobert Mustacchi void
CvPrintOneCommentList(ACPI_COMMENT_NODE * CommentList,UINT32 Level)186*35786f68SRobert Mustacchi CvPrintOneCommentList (
187*35786f68SRobert Mustacchi ACPI_COMMENT_NODE *CommentList,
188*35786f68SRobert Mustacchi UINT32 Level)
189*35786f68SRobert Mustacchi {
190*35786f68SRobert Mustacchi ACPI_COMMENT_NODE *Current = CommentList;
191*35786f68SRobert Mustacchi ACPI_COMMENT_NODE *Previous;
192*35786f68SRobert Mustacchi
193*35786f68SRobert Mustacchi
194*35786f68SRobert Mustacchi while (Current)
195*35786f68SRobert Mustacchi {
196*35786f68SRobert Mustacchi Previous = Current;
197*35786f68SRobert Mustacchi if (Current->Comment)
198*35786f68SRobert Mustacchi {
199*35786f68SRobert Mustacchi AcpiDmIndent(Level);
200*35786f68SRobert Mustacchi AcpiOsPrintf("%s\n", Current->Comment);
201*35786f68SRobert Mustacchi Current->Comment = NULL;
202*35786f68SRobert Mustacchi }
203*35786f68SRobert Mustacchi
204*35786f68SRobert Mustacchi Current = Current->Next;
205*35786f68SRobert Mustacchi AcpiOsReleaseObject(AcpiGbl_RegCommentCache, Previous);
206*35786f68SRobert Mustacchi }
207*35786f68SRobert Mustacchi }
208*35786f68SRobert Mustacchi
209*35786f68SRobert Mustacchi
210*35786f68SRobert Mustacchi /*******************************************************************************
211*35786f68SRobert Mustacchi *
212*35786f68SRobert Mustacchi * FUNCTION: CvListIsSingleton
213*35786f68SRobert Mustacchi *
214*35786f68SRobert Mustacchi * PARAMETERS: CommentList - check to see if this is a single item list.
215*35786f68SRobert Mustacchi *
216*35786f68SRobert Mustacchi * RETURN: BOOLEAN
217*35786f68SRobert Mustacchi *
218*35786f68SRobert Mustacchi * DESCRIPTION: Returns TRUE if CommentList only contains 1 node.
219*35786f68SRobert Mustacchi *
220*35786f68SRobert Mustacchi ******************************************************************************/
221*35786f68SRobert Mustacchi
222*35786f68SRobert Mustacchi static BOOLEAN
CvListIsSingleton(ACPI_COMMENT_NODE * CommentList)223*35786f68SRobert Mustacchi CvListIsSingleton (
224*35786f68SRobert Mustacchi ACPI_COMMENT_NODE *CommentList)
225*35786f68SRobert Mustacchi
226*35786f68SRobert Mustacchi {
227*35786f68SRobert Mustacchi
228*35786f68SRobert Mustacchi if (!CommentList)
229*35786f68SRobert Mustacchi {
230*35786f68SRobert Mustacchi return (FALSE);
231*35786f68SRobert Mustacchi }
232*35786f68SRobert Mustacchi else if (CommentList->Next)
233*35786f68SRobert Mustacchi {
234*35786f68SRobert Mustacchi return (FALSE);
235*35786f68SRobert Mustacchi }
236*35786f68SRobert Mustacchi
237*35786f68SRobert Mustacchi return (TRUE);
238*35786f68SRobert Mustacchi }
239*35786f68SRobert Mustacchi
240*35786f68SRobert Mustacchi
241*35786f68SRobert Mustacchi /*******************************************************************************
242*35786f68SRobert Mustacchi *
243*35786f68SRobert Mustacchi * FUNCTION: CvPrintOneCommentType
244*35786f68SRobert Mustacchi *
245*35786f68SRobert Mustacchi * PARAMETERS: Op
246*35786f68SRobert Mustacchi * CommentType
247*35786f68SRobert Mustacchi * EndStr - String to print after printing the comment
248*35786f68SRobert Mustacchi * Level - indentation level for comment lists.
249*35786f68SRobert Mustacchi *
250*35786f68SRobert Mustacchi * RETURN: None
251*35786f68SRobert Mustacchi *
252*35786f68SRobert Mustacchi * DESCRIPTION: Prints all comments of CommentType within the given Op and
253*35786f68SRobert Mustacchi * clears the printed comment from the Op.
254*35786f68SRobert Mustacchi * This is referred as ASL_CV_PRINT_ONE_COMMENT.
255*35786f68SRobert Mustacchi *
256*35786f68SRobert Mustacchi ******************************************************************************/
257*35786f68SRobert Mustacchi
258*35786f68SRobert Mustacchi void
CvPrintOneCommentType(ACPI_PARSE_OBJECT * Op,UINT8 CommentType,char * EndStr,UINT32 Level)259*35786f68SRobert Mustacchi CvPrintOneCommentType (
260*35786f68SRobert Mustacchi ACPI_PARSE_OBJECT *Op,
261*35786f68SRobert Mustacchi UINT8 CommentType,
262*35786f68SRobert Mustacchi char* EndStr,
263*35786f68SRobert Mustacchi UINT32 Level)
264*35786f68SRobert Mustacchi {
265*35786f68SRobert Mustacchi BOOLEAN CommentExists = FALSE;
266*35786f68SRobert Mustacchi char **CommentToPrint = NULL;
267*35786f68SRobert Mustacchi
268*35786f68SRobert Mustacchi
269*35786f68SRobert Mustacchi switch (CommentType)
270*35786f68SRobert Mustacchi {
271*35786f68SRobert Mustacchi case AML_COMMENT_STANDARD:
272*35786f68SRobert Mustacchi
273*35786f68SRobert Mustacchi if (CvListIsSingleton (Op->Common.CommentList))
274*35786f68SRobert Mustacchi {
275*35786f68SRobert Mustacchi CvPrintOneCommentList (Op->Common.CommentList, Level);
276*35786f68SRobert Mustacchi AcpiOsPrintf ("\n");
277*35786f68SRobert Mustacchi }
278*35786f68SRobert Mustacchi else
279*35786f68SRobert Mustacchi {
280*35786f68SRobert Mustacchi CvPrintOneCommentList (Op->Common.CommentList, Level);
281*35786f68SRobert Mustacchi }
282*35786f68SRobert Mustacchi
283*35786f68SRobert Mustacchi Op->Common.CommentList = NULL;
284*35786f68SRobert Mustacchi return;
285*35786f68SRobert Mustacchi
286*35786f68SRobert Mustacchi case AML_COMMENT_ENDBLK:
287*35786f68SRobert Mustacchi
288*35786f68SRobert Mustacchi if (Op->Common.EndBlkComment)
289*35786f68SRobert Mustacchi {
290*35786f68SRobert Mustacchi CvPrintOneCommentList (Op->Common.EndBlkComment, Level);
291*35786f68SRobert Mustacchi Op->Common.EndBlkComment = NULL;
292*35786f68SRobert Mustacchi AcpiDmIndent(Level);
293*35786f68SRobert Mustacchi }
294*35786f68SRobert Mustacchi return;
295*35786f68SRobert Mustacchi
296*35786f68SRobert Mustacchi case AMLCOMMENT_INLINE:
297*35786f68SRobert Mustacchi
298*35786f68SRobert Mustacchi CommentToPrint = &Op->Common.InlineComment;
299*35786f68SRobert Mustacchi break;
300*35786f68SRobert Mustacchi
301*35786f68SRobert Mustacchi case AML_COMMENT_END_NODE:
302*35786f68SRobert Mustacchi
303*35786f68SRobert Mustacchi CommentToPrint = &Op->Common.EndNodeComment;
304*35786f68SRobert Mustacchi break;
305*35786f68SRobert Mustacchi
306*35786f68SRobert Mustacchi case AML_NAMECOMMENT:
307*35786f68SRobert Mustacchi
308*35786f68SRobert Mustacchi CommentToPrint = &Op->Common.NameComment;
309*35786f68SRobert Mustacchi break;
310*35786f68SRobert Mustacchi
311*35786f68SRobert Mustacchi case AML_COMMENT_CLOSE_BRACE:
312*35786f68SRobert Mustacchi
313*35786f68SRobert Mustacchi CommentToPrint = &Op->Common.CloseBraceComment;
314*35786f68SRobert Mustacchi break;
315*35786f68SRobert Mustacchi
316*35786f68SRobert Mustacchi default:
317*35786f68SRobert Mustacchi return;
318*35786f68SRobert Mustacchi }
319*35786f68SRobert Mustacchi
320*35786f68SRobert Mustacchi if (*CommentToPrint)
321*35786f68SRobert Mustacchi {
322*35786f68SRobert Mustacchi CommentExists = TRUE;
323*35786f68SRobert Mustacchi AcpiOsPrintf ("%s", *CommentToPrint);
324*35786f68SRobert Mustacchi *CommentToPrint = NULL;
325*35786f68SRobert Mustacchi }
326*35786f68SRobert Mustacchi
327*35786f68SRobert Mustacchi if (CommentExists && EndStr)
328*35786f68SRobert Mustacchi {
329*35786f68SRobert Mustacchi AcpiOsPrintf ("%s", EndStr);
330*35786f68SRobert Mustacchi }
331*35786f68SRobert Mustacchi }
332*35786f68SRobert Mustacchi
333*35786f68SRobert Mustacchi
334*35786f68SRobert Mustacchi /*******************************************************************************
335*35786f68SRobert Mustacchi *
336*35786f68SRobert Mustacchi * FUNCTION: CvCloseBraceWriteComment
337*35786f68SRobert Mustacchi *
338*35786f68SRobert Mustacchi * PARAMETERS: Op
339*35786f68SRobert Mustacchi * Level
340*35786f68SRobert Mustacchi *
341*35786f68SRobert Mustacchi * RETURN: None
342*35786f68SRobert Mustacchi *
343*35786f68SRobert Mustacchi * DESCRIPTION: Print a close brace } and any open brace comments associated
344*35786f68SRobert Mustacchi * with this parse object.
345*35786f68SRobert Mustacchi * This is referred as ASL_CV_CLOSE_BRACE.
346*35786f68SRobert Mustacchi *
347*35786f68SRobert Mustacchi ******************************************************************************/
348*35786f68SRobert Mustacchi
349*35786f68SRobert Mustacchi void
CvCloseBraceWriteComment(ACPI_PARSE_OBJECT * Op,UINT32 Level)350*35786f68SRobert Mustacchi CvCloseBraceWriteComment(
351*35786f68SRobert Mustacchi ACPI_PARSE_OBJECT *Op,
352*35786f68SRobert Mustacchi UINT32 Level)
353*35786f68SRobert Mustacchi {
354*35786f68SRobert Mustacchi
355*35786f68SRobert Mustacchi if (!AcpiGbl_CaptureComments)
356*35786f68SRobert Mustacchi {
357*35786f68SRobert Mustacchi AcpiOsPrintf ("}");
358*35786f68SRobert Mustacchi return;
359*35786f68SRobert Mustacchi }
360*35786f68SRobert Mustacchi
361*35786f68SRobert Mustacchi CvPrintOneCommentType (Op, AML_COMMENT_ENDBLK, NULL, Level);
362*35786f68SRobert Mustacchi AcpiOsPrintf ("}");
363*35786f68SRobert Mustacchi CvPrintOneCommentType (Op, AML_COMMENT_CLOSE_BRACE, NULL, Level);
364*35786f68SRobert Mustacchi }
365*35786f68SRobert Mustacchi
366*35786f68SRobert Mustacchi
367*35786f68SRobert Mustacchi /*******************************************************************************
368*35786f68SRobert Mustacchi *
369*35786f68SRobert Mustacchi * FUNCTION: CvCloseParenWriteComment
370*35786f68SRobert Mustacchi *
371*35786f68SRobert Mustacchi * PARAMETERS: Op
372*35786f68SRobert Mustacchi * Level
373*35786f68SRobert Mustacchi *
374*35786f68SRobert Mustacchi * RETURN: None
375*35786f68SRobert Mustacchi *
376*35786f68SRobert Mustacchi * DESCRIPTION: Print a closing paren ) and any end node comments associated
377*35786f68SRobert Mustacchi * with this parse object.
378*35786f68SRobert Mustacchi * This is referred as ASL_CV_CLOSE_PAREN.
379*35786f68SRobert Mustacchi *
380*35786f68SRobert Mustacchi ******************************************************************************/
381*35786f68SRobert Mustacchi
382*35786f68SRobert Mustacchi void
CvCloseParenWriteComment(ACPI_PARSE_OBJECT * Op,UINT32 Level)383*35786f68SRobert Mustacchi CvCloseParenWriteComment(
384*35786f68SRobert Mustacchi ACPI_PARSE_OBJECT *Op,
385*35786f68SRobert Mustacchi UINT32 Level)
386*35786f68SRobert Mustacchi {
387*35786f68SRobert Mustacchi
388*35786f68SRobert Mustacchi if (!AcpiGbl_CaptureComments)
389*35786f68SRobert Mustacchi {
390*35786f68SRobert Mustacchi AcpiOsPrintf (")");
391*35786f68SRobert Mustacchi return;
392*35786f68SRobert Mustacchi }
393*35786f68SRobert Mustacchi
394*35786f68SRobert Mustacchi /*
395*35786f68SRobert Mustacchi * If this op has a BLOCK_BRACE, then output the comment when the
396*35786f68SRobert Mustacchi * disassembler calls CvCloseBraceWriteComment
397*35786f68SRobert Mustacchi */
398*35786f68SRobert Mustacchi if (AcpiDmBlockType (Op) == BLOCK_PAREN)
399*35786f68SRobert Mustacchi {
400*35786f68SRobert Mustacchi CvPrintOneCommentType (Op, AML_COMMENT_ENDBLK, NULL, Level);
401*35786f68SRobert Mustacchi }
402*35786f68SRobert Mustacchi
403*35786f68SRobert Mustacchi AcpiOsPrintf (")");
404*35786f68SRobert Mustacchi
405*35786f68SRobert Mustacchi if (Op->Common.EndNodeComment)
406*35786f68SRobert Mustacchi {
407*35786f68SRobert Mustacchi CvPrintOneCommentType (Op, AML_COMMENT_END_NODE, NULL, Level);
408*35786f68SRobert Mustacchi }
409*35786f68SRobert Mustacchi else if ((Op->Common.Parent->Common.AmlOpcode == AML_IF_OP) &&
410*35786f68SRobert Mustacchi Op->Common.Parent->Common.EndNodeComment)
411*35786f68SRobert Mustacchi {
412*35786f68SRobert Mustacchi CvPrintOneCommentType (Op->Common.Parent,
413*35786f68SRobert Mustacchi AML_COMMENT_END_NODE, NULL, Level);
414*35786f68SRobert Mustacchi }
415*35786f68SRobert Mustacchi }
416*35786f68SRobert Mustacchi
417*35786f68SRobert Mustacchi
418*35786f68SRobert Mustacchi /*******************************************************************************
419*35786f68SRobert Mustacchi *
420*35786f68SRobert Mustacchi * FUNCTION: CvFileHasSwitched
421*35786f68SRobert Mustacchi *
422*35786f68SRobert Mustacchi * PARAMETERS: Op
423*35786f68SRobert Mustacchi *
424*35786f68SRobert Mustacchi * RETURN: BOOLEAN
425*35786f68SRobert Mustacchi *
426*35786f68SRobert Mustacchi * DESCRIPTION: Determine whether if a file has switched.
427*35786f68SRobert Mustacchi * TRUE - file has switched.
428*35786f68SRobert Mustacchi * FALSE - file has not switched.
429*35786f68SRobert Mustacchi * This is referred as ASL_CV_FILE_HAS_SWITCHED.
430*35786f68SRobert Mustacchi *
431*35786f68SRobert Mustacchi ******************************************************************************/
432*35786f68SRobert Mustacchi
433*35786f68SRobert Mustacchi BOOLEAN
CvFileHasSwitched(ACPI_PARSE_OBJECT * Op)434*35786f68SRobert Mustacchi CvFileHasSwitched(
435*35786f68SRobert Mustacchi ACPI_PARSE_OBJECT *Op)
436*35786f68SRobert Mustacchi {
437*35786f68SRobert Mustacchi
438*35786f68SRobert Mustacchi if (Op->Common.CvFilename &&
439*35786f68SRobert Mustacchi AcpiGbl_CurrentFilename &&
440*35786f68SRobert Mustacchi AcpiUtStricmp(Op->Common.CvFilename, AcpiGbl_CurrentFilename))
441*35786f68SRobert Mustacchi {
442*35786f68SRobert Mustacchi return (TRUE);
443*35786f68SRobert Mustacchi }
444*35786f68SRobert Mustacchi
445*35786f68SRobert Mustacchi return (FALSE);
446*35786f68SRobert Mustacchi }
447*35786f68SRobert Mustacchi
448*35786f68SRobert Mustacchi
449*35786f68SRobert Mustacchi /*******************************************************************************
450*35786f68SRobert Mustacchi *
451*35786f68SRobert Mustacchi * FUNCTION: CvPrintInclude
452*35786f68SRobert Mustacchi *
453*35786f68SRobert Mustacchi * PARAMETERS: FNode - Write an Include statement for the file that is pointed
454*35786f68SRobert Mustacchi * by FNode->File.
455*35786f68SRobert Mustacchi * Level - indentation level
456*35786f68SRobert Mustacchi *
457*35786f68SRobert Mustacchi * RETURN: None
458*35786f68SRobert Mustacchi *
459*35786f68SRobert Mustacchi * DESCRIPTION: Write the ASL Include statement for FNode->File in the file
460*35786f68SRobert Mustacchi * indicated by FNode->Parent->File. Note this function emits
461*35786f68SRobert Mustacchi * actual ASL code rather than comments. This switches the output
462*35786f68SRobert Mustacchi * file to FNode->Parent->File.
463*35786f68SRobert Mustacchi *
464*35786f68SRobert Mustacchi ******************************************************************************/
465*35786f68SRobert Mustacchi
466*35786f68SRobert Mustacchi static void
CvPrintInclude(ACPI_FILE_NODE * FNode,UINT32 Level)467*35786f68SRobert Mustacchi CvPrintInclude(
468*35786f68SRobert Mustacchi ACPI_FILE_NODE *FNode,
469*35786f68SRobert Mustacchi UINT32 Level)
470*35786f68SRobert Mustacchi {
471*35786f68SRobert Mustacchi
472*35786f68SRobert Mustacchi if (!FNode || FNode->IncludeWritten)
473*35786f68SRobert Mustacchi {
474*35786f68SRobert Mustacchi return;
475*35786f68SRobert Mustacchi }
476*35786f68SRobert Mustacchi
477*35786f68SRobert Mustacchi CvDbgPrint ("Writing include for %s within %s\n",
478*35786f68SRobert Mustacchi FNode->Filename, FNode->Parent->Filename);
479*35786f68SRobert Mustacchi AcpiOsRedirectOutput (FNode->Parent->File);
480*35786f68SRobert Mustacchi CvPrintOneCommentList (FNode->IncludeComment, Level);
481*35786f68SRobert Mustacchi
482*35786f68SRobert Mustacchi AcpiDmIndent (Level);
483*35786f68SRobert Mustacchi AcpiOsPrintf ("Include (\"%s\")\n", FNode->Filename);
484*35786f68SRobert Mustacchi CvDbgPrint ("emitted the following: Include (\"%s\")\n",
485*35786f68SRobert Mustacchi FNode->Filename);
486*35786f68SRobert Mustacchi FNode->IncludeWritten = TRUE;
487*35786f68SRobert Mustacchi }
488*35786f68SRobert Mustacchi
489*35786f68SRobert Mustacchi
490*35786f68SRobert Mustacchi /*******************************************************************************
491*35786f68SRobert Mustacchi *
492*35786f68SRobert Mustacchi * FUNCTION: CvSwitchFiles
493*35786f68SRobert Mustacchi *
494*35786f68SRobert Mustacchi * PARAMETERS: Level - indentation level
495*35786f68SRobert Mustacchi * Op
496*35786f68SRobert Mustacchi *
497*35786f68SRobert Mustacchi * RETURN: None
498*35786f68SRobert Mustacchi *
499*35786f68SRobert Mustacchi * DESCRIPTION: Switch the outputfile and write ASL Include statement. Note,
500*35786f68SRobert Mustacchi * this function emits actual ASL code rather than comments.
501*35786f68SRobert Mustacchi * This is referred as ASL_CV_SWITCH_FILES.
502*35786f68SRobert Mustacchi *
503*35786f68SRobert Mustacchi ******************************************************************************/
504*35786f68SRobert Mustacchi
505*35786f68SRobert Mustacchi void
CvSwitchFiles(UINT32 Level,ACPI_PARSE_OBJECT * Op)506*35786f68SRobert Mustacchi CvSwitchFiles(
507*35786f68SRobert Mustacchi UINT32 Level,
508*35786f68SRobert Mustacchi ACPI_PARSE_OBJECT *Op)
509*35786f68SRobert Mustacchi {
510*35786f68SRobert Mustacchi char *Filename = Op->Common.CvFilename;
511*35786f68SRobert Mustacchi ACPI_FILE_NODE *FNode;
512*35786f68SRobert Mustacchi ACPI_FILE_NODE *Current;
513*35786f68SRobert Mustacchi
514*35786f68SRobert Mustacchi
515*35786f68SRobert Mustacchi CvDbgPrint ("Switching from %s to %s\n", AcpiGbl_CurrentFilename,
516*35786f68SRobert Mustacchi Filename);
517*35786f68SRobert Mustacchi FNode = CvFilenameExists (Filename, AcpiGbl_FileTreeRoot);
518*35786f68SRobert Mustacchi if (!FNode)
519*35786f68SRobert Mustacchi {
520*35786f68SRobert Mustacchi /*
521*35786f68SRobert Mustacchi * At this point, each Filename should exist in AcpiGbl_FileTreeRoot
522*35786f68SRobert Mustacchi * if it does not exist, then abort.
523*35786f68SRobert Mustacchi */
524*35786f68SRobert Mustacchi FlDeleteFile (ASL_FILE_AML_OUTPUT);
525*35786f68SRobert Mustacchi sprintf (MsgBuffer, "\"Cannot find %s\" - %s",
526*35786f68SRobert Mustacchi Filename, strerror (errno));
527*35786f68SRobert Mustacchi AslCommonError (ASL_ERROR, ASL_MSG_OPEN, 0, 0, 0, 0,
528*35786f68SRobert Mustacchi NULL, MsgBuffer);
529*35786f68SRobert Mustacchi AslAbort ();
530*35786f68SRobert Mustacchi }
531*35786f68SRobert Mustacchi
532*35786f68SRobert Mustacchi Current = FNode;
533*35786f68SRobert Mustacchi
534*35786f68SRobert Mustacchi /*
535*35786f68SRobert Mustacchi * If the previous file is a descendent of the current file,
536*35786f68SRobert Mustacchi * make sure that Include statements from the current file
537*35786f68SRobert Mustacchi * to the previous have been emitted.
538*35786f68SRobert Mustacchi */
539*35786f68SRobert Mustacchi while (Current &&
540*35786f68SRobert Mustacchi Current->Parent &&
541*35786f68SRobert Mustacchi AcpiUtStricmp (Current->Filename, AcpiGbl_CurrentFilename))
542*35786f68SRobert Mustacchi {
543*35786f68SRobert Mustacchi CvPrintInclude (Current, Level);
544*35786f68SRobert Mustacchi Current = Current->Parent;
545*35786f68SRobert Mustacchi }
546*35786f68SRobert Mustacchi
547*35786f68SRobert Mustacchi /* Redirect output to Op->Common.CvFilename */
548*35786f68SRobert Mustacchi
549*35786f68SRobert Mustacchi AcpiOsRedirectOutput (FNode->File);
550*35786f68SRobert Mustacchi AcpiGbl_CurrentFilename = FNode->Filename;
551*35786f68SRobert Mustacchi }
552