xref: /titanic_52/usr/src/uts/intel/io/acpica/executer/exnames.c (revision 385cc6b4ad1792caef3f84eb61eed3f27085801f)
1db2bae30SDana Myers /******************************************************************************
2db2bae30SDana Myers  *
3db2bae30SDana Myers  * Module Name: exnames - interpreter/scanner name load/execute
4db2bae30SDana Myers  *
5db2bae30SDana Myers  *****************************************************************************/
6db2bae30SDana Myers 
726f3cdf0SGordon Ross /*
8*385cc6b4SJerry Jelinek  * Copyright (C) 2000 - 2016, Intel Corp.
9db2bae30SDana Myers  * All rights reserved.
10db2bae30SDana Myers  *
1126f3cdf0SGordon Ross  * Redistribution and use in source and binary forms, with or without
1226f3cdf0SGordon Ross  * modification, are permitted provided that the following conditions
1326f3cdf0SGordon Ross  * are met:
1426f3cdf0SGordon Ross  * 1. Redistributions of source code must retain the above copyright
1526f3cdf0SGordon Ross  *    notice, this list of conditions, and the following disclaimer,
1626f3cdf0SGordon Ross  *    without modification.
1726f3cdf0SGordon Ross  * 2. Redistributions in binary form must reproduce at minimum a disclaimer
1826f3cdf0SGordon Ross  *    substantially similar to the "NO WARRANTY" disclaimer below
1926f3cdf0SGordon Ross  *    ("Disclaimer") and any redistribution must be conditioned upon
2026f3cdf0SGordon Ross  *    including a substantially similar Disclaimer requirement for further
2126f3cdf0SGordon Ross  *    binary redistribution.
2226f3cdf0SGordon Ross  * 3. Neither the names of the above-listed copyright holders nor the names
2326f3cdf0SGordon Ross  *    of any contributors may be used to endorse or promote products derived
2426f3cdf0SGordon Ross  *    from this software without specific prior written permission.
25db2bae30SDana Myers  *
2626f3cdf0SGordon Ross  * Alternatively, this software may be distributed under the terms of the
2726f3cdf0SGordon Ross  * GNU General Public License ("GPL") version 2 as published by the Free
2826f3cdf0SGordon Ross  * Software Foundation.
29db2bae30SDana Myers  *
3026f3cdf0SGordon Ross  * NO WARRANTY
3126f3cdf0SGordon Ross  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
3226f3cdf0SGordon Ross  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
3326f3cdf0SGordon Ross  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
3426f3cdf0SGordon Ross  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
3526f3cdf0SGordon Ross  * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
3626f3cdf0SGordon Ross  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
3726f3cdf0SGordon Ross  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
3826f3cdf0SGordon Ross  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
3926f3cdf0SGordon Ross  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
4026f3cdf0SGordon Ross  * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
4126f3cdf0SGordon Ross  * POSSIBILITY OF SUCH DAMAGES.
4226f3cdf0SGordon Ross  */
43db2bae30SDana Myers 
44db2bae30SDana Myers #include "acpi.h"
45aa2aa9a6SDana Myers #include "accommon.h"
46db2bae30SDana Myers #include "acinterp.h"
47db2bae30SDana Myers #include "amlcode.h"
48db2bae30SDana Myers 
49db2bae30SDana Myers #define _COMPONENT          ACPI_EXECUTER
50db2bae30SDana Myers         ACPI_MODULE_NAME    ("exnames")
51db2bae30SDana Myers 
52db2bae30SDana Myers /* Local prototypes */
53db2bae30SDana Myers 
54db2bae30SDana Myers static char *
55db2bae30SDana Myers AcpiExAllocateNameString (
56db2bae30SDana Myers     UINT32                  PrefixCount,
57db2bae30SDana Myers     UINT32                  NumNameSegs);
58db2bae30SDana Myers 
59db2bae30SDana Myers static ACPI_STATUS
60db2bae30SDana Myers AcpiExNameSegment (
61db2bae30SDana Myers     UINT8                   **InAmlAddress,
62db2bae30SDana Myers     char                    *NameString);
63db2bae30SDana Myers 
64db2bae30SDana Myers 
65db2bae30SDana Myers /*******************************************************************************
66db2bae30SDana Myers  *
67db2bae30SDana Myers  * FUNCTION:    AcpiExAllocateNameString
68db2bae30SDana Myers  *
69db2bae30SDana Myers  * PARAMETERS:  PrefixCount         - Count of parent levels. Special cases:
70db2bae30SDana Myers  *                                    (-1)==root,  0==none
71db2bae30SDana Myers  *              NumNameSegs         - count of 4-character name segments
72db2bae30SDana Myers  *
73db2bae30SDana Myers  * RETURN:      A pointer to the allocated string segment. This segment must
74db2bae30SDana Myers  *              be deleted by the caller.
75db2bae30SDana Myers  *
76db2bae30SDana Myers  * DESCRIPTION: Allocate a buffer for a name string. Ensure allocated name
77db2bae30SDana Myers  *              string is long enough, and set up prefix if any.
78db2bae30SDana Myers  *
79db2bae30SDana Myers  ******************************************************************************/
80db2bae30SDana Myers 
81db2bae30SDana Myers static char *
82db2bae30SDana Myers AcpiExAllocateNameString (
83db2bae30SDana Myers     UINT32                  PrefixCount,
84db2bae30SDana Myers     UINT32                  NumNameSegs)
85db2bae30SDana Myers {
86db2bae30SDana Myers     char                    *TempPtr;
87db2bae30SDana Myers     char                    *NameString;
88db2bae30SDana Myers     UINT32                   SizeNeeded;
89db2bae30SDana Myers 
90db2bae30SDana Myers     ACPI_FUNCTION_TRACE (ExAllocateNameString);
91db2bae30SDana Myers 
92db2bae30SDana Myers 
93db2bae30SDana Myers     /*
94db2bae30SDana Myers      * Allow room for all \ and ^ prefixes, all segments and a MultiNamePrefix.
95db2bae30SDana Myers      * Also, one byte for the null terminator.
96db2bae30SDana Myers      * This may actually be somewhat longer than needed.
97db2bae30SDana Myers      */
98db2bae30SDana Myers     if (PrefixCount == ACPI_UINT32_MAX)
99db2bae30SDana Myers     {
100db2bae30SDana Myers         /* Special case for root */
101db2bae30SDana Myers 
102db2bae30SDana Myers         SizeNeeded = 1 + (ACPI_NAME_SIZE * NumNameSegs) + 2 + 1;
103db2bae30SDana Myers     }
104db2bae30SDana Myers     else
105db2bae30SDana Myers     {
106db2bae30SDana Myers         SizeNeeded = PrefixCount + (ACPI_NAME_SIZE * NumNameSegs) + 2 + 1;
107db2bae30SDana Myers     }
108db2bae30SDana Myers 
109db2bae30SDana Myers     /*
110db2bae30SDana Myers      * Allocate a buffer for the name.
111db2bae30SDana Myers      * This buffer must be deleted by the caller!
112db2bae30SDana Myers      */
113db2bae30SDana Myers     NameString = ACPI_ALLOCATE (SizeNeeded);
114db2bae30SDana Myers     if (!NameString)
115db2bae30SDana Myers     {
116db2bae30SDana Myers         ACPI_ERROR ((AE_INFO,
11726f3cdf0SGordon Ross             "Could not allocate size %u", SizeNeeded));
118db2bae30SDana Myers         return_PTR (NULL);
119db2bae30SDana Myers     }
120db2bae30SDana Myers 
121db2bae30SDana Myers     TempPtr = NameString;
122db2bae30SDana Myers 
123db2bae30SDana Myers     /* Set up Root or Parent prefixes if needed */
124db2bae30SDana Myers 
125db2bae30SDana Myers     if (PrefixCount == ACPI_UINT32_MAX)
126db2bae30SDana Myers     {
127db2bae30SDana Myers         *TempPtr++ = AML_ROOT_PREFIX;
128db2bae30SDana Myers     }
129db2bae30SDana Myers     else
130db2bae30SDana Myers     {
131db2bae30SDana Myers         while (PrefixCount--)
132db2bae30SDana Myers         {
133db2bae30SDana Myers             *TempPtr++ = AML_PARENT_PREFIX;
134db2bae30SDana Myers         }
135db2bae30SDana Myers     }
136db2bae30SDana Myers 
137db2bae30SDana Myers 
138db2bae30SDana Myers     /* Set up Dual or Multi prefixes if needed */
139db2bae30SDana Myers 
140db2bae30SDana Myers     if (NumNameSegs > 2)
141db2bae30SDana Myers     {
142db2bae30SDana Myers         /* Set up multi prefixes   */
143db2bae30SDana Myers 
144db2bae30SDana Myers         *TempPtr++ = AML_MULTI_NAME_PREFIX_OP;
145db2bae30SDana Myers         *TempPtr++ = (char) NumNameSegs;
146db2bae30SDana Myers     }
147db2bae30SDana Myers     else if (2 == NumNameSegs)
148db2bae30SDana Myers     {
149db2bae30SDana Myers         /* Set up dual prefixes */
150db2bae30SDana Myers 
151db2bae30SDana Myers         *TempPtr++ = AML_DUAL_NAME_PREFIX;
152db2bae30SDana Myers     }
153db2bae30SDana Myers 
154db2bae30SDana Myers     /*
155db2bae30SDana Myers      * Terminate string following prefixes. AcpiExNameSegment() will
156db2bae30SDana Myers      * append the segment(s)
157db2bae30SDana Myers      */
158db2bae30SDana Myers     *TempPtr = 0;
159db2bae30SDana Myers 
160db2bae30SDana Myers     return_PTR (NameString);
161db2bae30SDana Myers }
162db2bae30SDana Myers 
163*385cc6b4SJerry Jelinek 
164db2bae30SDana Myers /*******************************************************************************
165db2bae30SDana Myers  *
166db2bae30SDana Myers  * FUNCTION:    AcpiExNameSegment
167db2bae30SDana Myers  *
168db2bae30SDana Myers  * PARAMETERS:  InAmlAddress    - Pointer to the name in the AML code
169db2bae30SDana Myers  *              NameString      - Where to return the name. The name is appended
170db2bae30SDana Myers  *                                to any existing string to form a namepath
171db2bae30SDana Myers  *
172db2bae30SDana Myers  * RETURN:      Status
173db2bae30SDana Myers  *
174db2bae30SDana Myers  * DESCRIPTION: Extract an ACPI name (4 bytes) from the AML byte stream
175db2bae30SDana Myers  *
176db2bae30SDana Myers  ******************************************************************************/
177db2bae30SDana Myers 
178db2bae30SDana Myers static ACPI_STATUS
179db2bae30SDana Myers AcpiExNameSegment (
180db2bae30SDana Myers     UINT8                   **InAmlAddress,
181db2bae30SDana Myers     char                    *NameString)
182db2bae30SDana Myers {
183db2bae30SDana Myers     char                    *AmlAddress = (void *) *InAmlAddress;
184db2bae30SDana Myers     ACPI_STATUS             Status = AE_OK;
185db2bae30SDana Myers     UINT32                  Index;
186db2bae30SDana Myers     char                    CharBuf[5];
187db2bae30SDana Myers 
188db2bae30SDana Myers 
189db2bae30SDana Myers     ACPI_FUNCTION_TRACE (ExNameSegment);
190db2bae30SDana Myers 
191db2bae30SDana Myers 
192db2bae30SDana Myers     /*
193*385cc6b4SJerry Jelinek      * If first character is a digit, then we know that we aren't looking
194*385cc6b4SJerry Jelinek      * at a valid name segment
195db2bae30SDana Myers      */
196db2bae30SDana Myers     CharBuf[0] = *AmlAddress;
197db2bae30SDana Myers 
198db2bae30SDana Myers     if ('0' <= CharBuf[0] && CharBuf[0] <= '9')
199db2bae30SDana Myers     {
200db2bae30SDana Myers         ACPI_ERROR ((AE_INFO, "Invalid leading digit: %c", CharBuf[0]));
201db2bae30SDana Myers         return_ACPI_STATUS (AE_CTRL_PENDING);
202db2bae30SDana Myers     }
203db2bae30SDana Myers 
204db2bae30SDana Myers     ACPI_DEBUG_PRINT ((ACPI_DB_LOAD, "Bytes from stream:\n"));
205db2bae30SDana Myers 
206db2bae30SDana Myers     for (Index = 0;
207*385cc6b4SJerry Jelinek         (Index < ACPI_NAME_SIZE) && (AcpiUtValidNameChar (*AmlAddress, 0));
208db2bae30SDana Myers         Index++)
209db2bae30SDana Myers     {
210db2bae30SDana Myers         CharBuf[Index] = *AmlAddress++;
211db2bae30SDana Myers         ACPI_DEBUG_PRINT ((ACPI_DB_LOAD, "%c\n", CharBuf[Index]));
212db2bae30SDana Myers     }
213db2bae30SDana Myers 
214db2bae30SDana Myers 
215db2bae30SDana Myers     /* Valid name segment  */
216db2bae30SDana Myers 
217db2bae30SDana Myers     if (Index == 4)
218db2bae30SDana Myers     {
219db2bae30SDana Myers         /* Found 4 valid characters */
220db2bae30SDana Myers 
221db2bae30SDana Myers         CharBuf[4] = '\0';
222db2bae30SDana Myers 
223db2bae30SDana Myers         if (NameString)
224db2bae30SDana Myers         {
225*385cc6b4SJerry Jelinek             strcat (NameString, CharBuf);
226db2bae30SDana Myers             ACPI_DEBUG_PRINT ((ACPI_DB_NAMES,
227db2bae30SDana Myers                 "Appended to - %s\n", NameString));
228db2bae30SDana Myers         }
229db2bae30SDana Myers         else
230db2bae30SDana Myers         {
231db2bae30SDana Myers             ACPI_DEBUG_PRINT ((ACPI_DB_NAMES,
232db2bae30SDana Myers                 "No Name string - %s\n", CharBuf));
233db2bae30SDana Myers         }
234db2bae30SDana Myers     }
235db2bae30SDana Myers     else if (Index == 0)
236db2bae30SDana Myers     {
237db2bae30SDana Myers         /*
238db2bae30SDana Myers          * First character was not a valid name character,
239db2bae30SDana Myers          * so we are looking at something other than a name.
240db2bae30SDana Myers          */
241db2bae30SDana Myers         ACPI_DEBUG_PRINT ((ACPI_DB_INFO,
242db2bae30SDana Myers             "Leading character is not alpha: %02Xh (not a name)\n",
243db2bae30SDana Myers             CharBuf[0]));
244db2bae30SDana Myers         Status = AE_CTRL_PENDING;
245db2bae30SDana Myers     }
246db2bae30SDana Myers     else
247db2bae30SDana Myers     {
248db2bae30SDana Myers         /*
249db2bae30SDana Myers          * Segment started with one or more valid characters, but fewer than
250db2bae30SDana Myers          * the required 4
251db2bae30SDana Myers          */
252db2bae30SDana Myers         Status = AE_AML_BAD_NAME;
253db2bae30SDana Myers         ACPI_ERROR ((AE_INFO,
25426f3cdf0SGordon Ross             "Bad character 0x%02x in name, at %p",
255db2bae30SDana Myers             *AmlAddress, AmlAddress));
256db2bae30SDana Myers     }
257db2bae30SDana Myers 
258db2bae30SDana Myers     *InAmlAddress = ACPI_CAST_PTR (UINT8, AmlAddress);
259db2bae30SDana Myers     return_ACPI_STATUS (Status);
260db2bae30SDana Myers }
261db2bae30SDana Myers 
262db2bae30SDana Myers 
263db2bae30SDana Myers /*******************************************************************************
264db2bae30SDana Myers  *
265db2bae30SDana Myers  * FUNCTION:    AcpiExGetNameString
266db2bae30SDana Myers  *
267db2bae30SDana Myers  * PARAMETERS:  DataType            - Object type to be associated with this
268db2bae30SDana Myers  *                                    name
269db2bae30SDana Myers  *              InAmlAddress        - Pointer to the namestring in the AML code
270db2bae30SDana Myers  *              OutNameString       - Where the namestring is returned
271db2bae30SDana Myers  *              OutNameLength       - Length of the returned string
272db2bae30SDana Myers  *
273db2bae30SDana Myers  * RETURN:      Status, namestring and length
274db2bae30SDana Myers  *
275db2bae30SDana Myers  * DESCRIPTION: Extract a full namepath from the AML byte stream,
276db2bae30SDana Myers  *              including any prefixes.
277db2bae30SDana Myers  *
278db2bae30SDana Myers  ******************************************************************************/
279db2bae30SDana Myers 
280db2bae30SDana Myers ACPI_STATUS
281db2bae30SDana Myers AcpiExGetNameString (
282db2bae30SDana Myers     ACPI_OBJECT_TYPE        DataType,
283db2bae30SDana Myers     UINT8                   *InAmlAddress,
284db2bae30SDana Myers     char                    **OutNameString,
285db2bae30SDana Myers     UINT32                  *OutNameLength)
286db2bae30SDana Myers {
287db2bae30SDana Myers     ACPI_STATUS             Status = AE_OK;
288db2bae30SDana Myers     UINT8                   *AmlAddress = InAmlAddress;
289db2bae30SDana Myers     char                    *NameString = NULL;
290db2bae30SDana Myers     UINT32                  NumSegments;
291db2bae30SDana Myers     UINT32                  PrefixCount = 0;
292db2bae30SDana Myers     BOOLEAN                 HasPrefix = FALSE;
293db2bae30SDana Myers 
294db2bae30SDana Myers 
295db2bae30SDana Myers     ACPI_FUNCTION_TRACE_PTR (ExGetNameString, AmlAddress);
296db2bae30SDana Myers 
297db2bae30SDana Myers 
298db2bae30SDana Myers     if (ACPI_TYPE_LOCAL_REGION_FIELD == DataType   ||
299db2bae30SDana Myers         ACPI_TYPE_LOCAL_BANK_FIELD == DataType     ||
300db2bae30SDana Myers         ACPI_TYPE_LOCAL_INDEX_FIELD == DataType)
301db2bae30SDana Myers     {
302db2bae30SDana Myers         /* Disallow prefixes for types associated with FieldUnit names */
303db2bae30SDana Myers 
304db2bae30SDana Myers         NameString = AcpiExAllocateNameString (0, 1);
305db2bae30SDana Myers         if (!NameString)
306db2bae30SDana Myers         {
307db2bae30SDana Myers             Status = AE_NO_MEMORY;
308db2bae30SDana Myers         }
309db2bae30SDana Myers         else
310db2bae30SDana Myers         {
311db2bae30SDana Myers             Status = AcpiExNameSegment (&AmlAddress, NameString);
312db2bae30SDana Myers         }
313db2bae30SDana Myers     }
314db2bae30SDana Myers     else
315db2bae30SDana Myers     {
316db2bae30SDana Myers         /*
317db2bae30SDana Myers          * DataType is not a field name.
318db2bae30SDana Myers          * Examine first character of name for root or parent prefix operators
319db2bae30SDana Myers          */
320db2bae30SDana Myers         switch (*AmlAddress)
321db2bae30SDana Myers         {
322db2bae30SDana Myers         case AML_ROOT_PREFIX:
323db2bae30SDana Myers 
324db2bae30SDana Myers             ACPI_DEBUG_PRINT ((ACPI_DB_LOAD, "RootPrefix(\\) at %p\n",
325db2bae30SDana Myers                 AmlAddress));
326db2bae30SDana Myers 
327db2bae30SDana Myers             /*
328db2bae30SDana Myers              * Remember that we have a RootPrefix --
329db2bae30SDana Myers              * see comment in AcpiExAllocateNameString()
330db2bae30SDana Myers              */
331db2bae30SDana Myers             AmlAddress++;
332db2bae30SDana Myers             PrefixCount = ACPI_UINT32_MAX;
333db2bae30SDana Myers             HasPrefix = TRUE;
334db2bae30SDana Myers             break;
335db2bae30SDana Myers 
336db2bae30SDana Myers         case AML_PARENT_PREFIX:
337db2bae30SDana Myers 
338db2bae30SDana Myers             /* Increment past possibly multiple parent prefixes */
339db2bae30SDana Myers 
340db2bae30SDana Myers             do
341db2bae30SDana Myers             {
342db2bae30SDana Myers                 ACPI_DEBUG_PRINT ((ACPI_DB_LOAD, "ParentPrefix (^) at %p\n",
343db2bae30SDana Myers                     AmlAddress));
344db2bae30SDana Myers 
345db2bae30SDana Myers                 AmlAddress++;
346db2bae30SDana Myers                 PrefixCount++;
347db2bae30SDana Myers 
348db2bae30SDana Myers             } while (*AmlAddress == AML_PARENT_PREFIX);
349db2bae30SDana Myers 
350db2bae30SDana Myers             HasPrefix = TRUE;
351db2bae30SDana Myers             break;
352db2bae30SDana Myers 
353db2bae30SDana Myers         default:
354db2bae30SDana Myers 
355db2bae30SDana Myers             /* Not a prefix character */
356db2bae30SDana Myers 
357db2bae30SDana Myers             break;
358db2bae30SDana Myers         }
359db2bae30SDana Myers 
360db2bae30SDana Myers         /* Examine first character of name for name segment prefix operator */
361db2bae30SDana Myers 
362db2bae30SDana Myers         switch (*AmlAddress)
363db2bae30SDana Myers         {
364db2bae30SDana Myers         case AML_DUAL_NAME_PREFIX:
365db2bae30SDana Myers 
366db2bae30SDana Myers             ACPI_DEBUG_PRINT ((ACPI_DB_LOAD, "DualNamePrefix at %p\n",
367db2bae30SDana Myers                 AmlAddress));
368db2bae30SDana Myers 
369db2bae30SDana Myers             AmlAddress++;
370db2bae30SDana Myers             NameString = AcpiExAllocateNameString (PrefixCount, 2);
371db2bae30SDana Myers             if (!NameString)
372db2bae30SDana Myers             {
373db2bae30SDana Myers                 Status = AE_NO_MEMORY;
374db2bae30SDana Myers                 break;
375db2bae30SDana Myers             }
376db2bae30SDana Myers 
377db2bae30SDana Myers             /* Indicate that we processed a prefix */
378db2bae30SDana Myers 
379db2bae30SDana Myers             HasPrefix = TRUE;
380db2bae30SDana Myers 
381db2bae30SDana Myers             Status = AcpiExNameSegment (&AmlAddress, NameString);
382db2bae30SDana Myers             if (ACPI_SUCCESS (Status))
383db2bae30SDana Myers             {
384db2bae30SDana Myers                 Status = AcpiExNameSegment (&AmlAddress, NameString);
385db2bae30SDana Myers             }
386db2bae30SDana Myers             break;
387db2bae30SDana Myers 
388db2bae30SDana Myers         case AML_MULTI_NAME_PREFIX_OP:
389db2bae30SDana Myers 
390db2bae30SDana Myers             ACPI_DEBUG_PRINT ((ACPI_DB_LOAD, "MultiNamePrefix at %p\n",
391db2bae30SDana Myers                 AmlAddress));
392db2bae30SDana Myers 
393db2bae30SDana Myers             /* Fetch count of segments remaining in name path */
394db2bae30SDana Myers 
395db2bae30SDana Myers             AmlAddress++;
396db2bae30SDana Myers             NumSegments = *AmlAddress;
397db2bae30SDana Myers 
398*385cc6b4SJerry Jelinek             NameString = AcpiExAllocateNameString (
399*385cc6b4SJerry Jelinek                 PrefixCount, NumSegments);
400db2bae30SDana Myers             if (!NameString)
401db2bae30SDana Myers             {
402db2bae30SDana Myers                 Status = AE_NO_MEMORY;
403db2bae30SDana Myers                 break;
404db2bae30SDana Myers             }
405db2bae30SDana Myers 
406db2bae30SDana Myers             /* Indicate that we processed a prefix */
407db2bae30SDana Myers 
408db2bae30SDana Myers             AmlAddress++;
409db2bae30SDana Myers             HasPrefix = TRUE;
410db2bae30SDana Myers 
411db2bae30SDana Myers             while (NumSegments &&
412db2bae30SDana Myers                     (Status = AcpiExNameSegment (&AmlAddress, NameString)) ==
413db2bae30SDana Myers                         AE_OK)
414db2bae30SDana Myers             {
415db2bae30SDana Myers                 NumSegments--;
416db2bae30SDana Myers             }
417db2bae30SDana Myers 
418db2bae30SDana Myers             break;
419db2bae30SDana Myers 
420db2bae30SDana Myers         case 0:
421db2bae30SDana Myers 
422db2bae30SDana Myers             /* NullName valid as of 8-12-98 ASL/AML Grammar Update */
423db2bae30SDana Myers 
424db2bae30SDana Myers             if (PrefixCount == ACPI_UINT32_MAX)
425db2bae30SDana Myers             {
426db2bae30SDana Myers                 ACPI_DEBUG_PRINT ((ACPI_DB_EXEC,
427db2bae30SDana Myers                     "NameSeg is \"\\\" followed by NULL\n"));
428db2bae30SDana Myers             }
429db2bae30SDana Myers 
430db2bae30SDana Myers             /* Consume the NULL byte */
431db2bae30SDana Myers 
432db2bae30SDana Myers             AmlAddress++;
433db2bae30SDana Myers             NameString = AcpiExAllocateNameString (PrefixCount, 0);
434db2bae30SDana Myers             if (!NameString)
435db2bae30SDana Myers             {
436db2bae30SDana Myers                 Status = AE_NO_MEMORY;
437db2bae30SDana Myers                 break;
438db2bae30SDana Myers             }
439db2bae30SDana Myers 
440db2bae30SDana Myers             break;
441db2bae30SDana Myers 
442db2bae30SDana Myers         default:
443db2bae30SDana Myers 
444db2bae30SDana Myers             /* Name segment string */
445db2bae30SDana Myers 
446db2bae30SDana Myers             NameString = AcpiExAllocateNameString (PrefixCount, 1);
447db2bae30SDana Myers             if (!NameString)
448db2bae30SDana Myers             {
449db2bae30SDana Myers                 Status = AE_NO_MEMORY;
450db2bae30SDana Myers                 break;
451db2bae30SDana Myers             }
452db2bae30SDana Myers 
453db2bae30SDana Myers             Status = AcpiExNameSegment (&AmlAddress, NameString);
454db2bae30SDana Myers             break;
455db2bae30SDana Myers         }
456db2bae30SDana Myers     }
457db2bae30SDana Myers 
458db2bae30SDana Myers     if (AE_CTRL_PENDING == Status && HasPrefix)
459db2bae30SDana Myers     {
460db2bae30SDana Myers         /* Ran out of segments after processing a prefix */
461db2bae30SDana Myers 
462db2bae30SDana Myers         ACPI_ERROR ((AE_INFO,
463db2bae30SDana Myers             "Malformed Name at %p", NameString));
464db2bae30SDana Myers         Status = AE_AML_BAD_NAME;
465db2bae30SDana Myers     }
466db2bae30SDana Myers 
467db2bae30SDana Myers     if (ACPI_FAILURE (Status))
468db2bae30SDana Myers     {
469db2bae30SDana Myers         if (NameString)
470db2bae30SDana Myers         {
471db2bae30SDana Myers             ACPI_FREE (NameString);
472db2bae30SDana Myers         }
473db2bae30SDana Myers         return_ACPI_STATUS (Status);
474db2bae30SDana Myers     }
475db2bae30SDana Myers 
476db2bae30SDana Myers     *OutNameString = NameString;
477db2bae30SDana Myers     *OutNameLength = (UINT32) (AmlAddress - InAmlAddress);
478db2bae30SDana Myers 
479db2bae30SDana Myers     return_ACPI_STATUS (Status);
480db2bae30SDana Myers }
481