xref: /titanic_44/usr/src/uts/intel/io/acpica/namespace/nsxfname.c (revision cb56572868bfc488bbd3ab847b09db2a25554d44)
1 /******************************************************************************
2  *
3  * Module Name: nsxfname - Public interfaces to the ACPI subsystem
4  *                         ACPI Namespace oriented interfaces
5  *
6  *****************************************************************************/
7 
8 /*
9  * Copyright (C) 2000 - 2016, Intel Corp.
10  * All rights reserved.
11  *
12  * Redistribution and use in source and binary forms, with or without
13  * modification, are permitted provided that the following conditions
14  * are met:
15  * 1. Redistributions of source code must retain the above copyright
16  *    notice, this list of conditions, and the following disclaimer,
17  *    without modification.
18  * 2. Redistributions in binary form must reproduce at minimum a disclaimer
19  *    substantially similar to the "NO WARRANTY" disclaimer below
20  *    ("Disclaimer") and any redistribution must be conditioned upon
21  *    including a substantially similar Disclaimer requirement for further
22  *    binary redistribution.
23  * 3. Neither the names of the above-listed copyright holders nor the names
24  *    of any contributors may be used to endorse or promote products derived
25  *    from this software without specific prior written permission.
26  *
27  * Alternatively, this software may be distributed under the terms of the
28  * GNU General Public License ("GPL") version 2 as published by the Free
29  * Software Foundation.
30  *
31  * NO WARRANTY
32  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
33  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
34  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
35  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
36  * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
37  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
38  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
39  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
40  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
41  * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
42  * POSSIBILITY OF SUCH DAMAGES.
43  */
44 
45 #define EXPORT_ACPI_INTERFACES
46 
47 #include "acpi.h"
48 #include "accommon.h"
49 #include "acnamesp.h"
50 #include "acparser.h"
51 #include "amlcode.h"
52 
53 
54 #define _COMPONENT          ACPI_NAMESPACE
55         ACPI_MODULE_NAME    ("nsxfname")
56 
57 /* Local prototypes */
58 
59 static char *
60 AcpiNsCopyDeviceId (
61     ACPI_PNP_DEVICE_ID      *Dest,
62     ACPI_PNP_DEVICE_ID      *Source,
63     char                    *StringArea);
64 
65 
66 /******************************************************************************
67  *
68  * FUNCTION:    AcpiGetHandle
69  *
70  * PARAMETERS:  Parent          - Object to search under (search scope).
71  *              Pathname        - Pointer to an asciiz string containing the
72  *                                name
73  *              RetHandle       - Where the return handle is returned
74  *
75  * RETURN:      Status
76  *
77  * DESCRIPTION: This routine will search for a caller specified name in the
78  *              name space. The caller can restrict the search region by
79  *              specifying a non NULL parent. The parent value is itself a
80  *              namespace handle.
81  *
82  ******************************************************************************/
83 
84 ACPI_STATUS
AcpiGetHandle(ACPI_HANDLE Parent,ACPI_STRING Pathname,ACPI_HANDLE * RetHandle)85 AcpiGetHandle (
86     ACPI_HANDLE             Parent,
87     ACPI_STRING             Pathname,
88     ACPI_HANDLE             *RetHandle)
89 {
90     ACPI_STATUS             Status;
91     ACPI_NAMESPACE_NODE     *Node = NULL;
92     ACPI_NAMESPACE_NODE     *PrefixNode = NULL;
93 
94 
95     ACPI_FUNCTION_ENTRY ();
96 
97 
98     /* Parameter Validation */
99 
100     if (!RetHandle || !Pathname)
101     {
102         return (AE_BAD_PARAMETER);
103     }
104 
105     /* Convert a parent handle to a prefix node */
106 
107     if (Parent)
108     {
109         PrefixNode = AcpiNsValidateHandle (Parent);
110         if (!PrefixNode)
111         {
112             return (AE_BAD_PARAMETER);
113         }
114     }
115 
116     /*
117      * Valid cases are:
118      * 1) Fully qualified pathname
119      * 2) Parent + Relative pathname
120      *
121      * Error for <null Parent + relative path>
122      */
123     if (ACPI_IS_ROOT_PREFIX (Pathname[0]))
124     {
125         /* Pathname is fully qualified (starts with '\') */
126 
127         /* Special case for root-only, since we can't search for it */
128 
129         if (!strcmp (Pathname, ACPI_NS_ROOT_PATH))
130         {
131             *RetHandle = ACPI_CAST_PTR (ACPI_HANDLE, AcpiGbl_RootNode);
132             return (AE_OK);
133         }
134     }
135     else if (!PrefixNode)
136     {
137         /* Relative path with null prefix is disallowed */
138 
139         return (AE_BAD_PARAMETER);
140     }
141 
142     /* Find the Node and convert to a handle */
143 
144     Status = AcpiNsGetNode (PrefixNode, Pathname, ACPI_NS_NO_UPSEARCH, &Node);
145     if (ACPI_SUCCESS (Status))
146     {
147         *RetHandle = ACPI_CAST_PTR (ACPI_HANDLE, Node);
148     }
149 
150     return (Status);
151 }
152 
ACPI_EXPORT_SYMBOL(AcpiGetHandle)153 ACPI_EXPORT_SYMBOL (AcpiGetHandle)
154 
155 
156 /******************************************************************************
157  *
158  * FUNCTION:    AcpiGetName
159  *
160  * PARAMETERS:  Handle          - Handle to be converted to a pathname
161  *              NameType        - Full pathname or single segment
162  *              Buffer          - Buffer for returned path
163  *
164  * RETURN:      Pointer to a string containing the fully qualified Name.
165  *
166  * DESCRIPTION: This routine returns the fully qualified name associated with
167  *              the Handle parameter. This and the AcpiPathnameToHandle are
168  *              complementary functions.
169  *
170  ******************************************************************************/
171 
172 ACPI_STATUS
173 AcpiGetName (
174     ACPI_HANDLE             Handle,
175     UINT32                  NameType,
176     ACPI_BUFFER             *Buffer)
177 {
178     ACPI_STATUS             Status;
179     ACPI_NAMESPACE_NODE     *Node;
180     const char              *NodeName;
181 
182 
183     /* Parameter validation */
184 
185     if (NameType > ACPI_NAME_TYPE_MAX)
186     {
187         return (AE_BAD_PARAMETER);
188     }
189 
190     Status = AcpiUtValidateBuffer (Buffer);
191     if (ACPI_FAILURE (Status))
192     {
193         return (Status);
194     }
195 
196     if (NameType == ACPI_FULL_PATHNAME ||
197         NameType == ACPI_FULL_PATHNAME_NO_TRAILING)
198     {
199         /* Get the full pathname (From the namespace root) */
200 
201         Status = AcpiNsHandleToPathname (Handle, Buffer,
202             NameType == ACPI_FULL_PATHNAME ? FALSE : TRUE);
203         return (Status);
204     }
205 
206     /*
207      * Wants the single segment ACPI name.
208      * Validate handle and convert to a namespace Node
209      */
210     Status = AcpiUtAcquireMutex (ACPI_MTX_NAMESPACE);
211     if (ACPI_FAILURE (Status))
212     {
213         return (Status);
214     }
215 
216     Node = AcpiNsValidateHandle (Handle);
217     if (!Node)
218     {
219         Status = AE_BAD_PARAMETER;
220         goto UnlockAndExit;
221     }
222 
223     /* Validate/Allocate/Clear caller buffer */
224 
225     Status = AcpiUtInitializeBuffer (Buffer, ACPI_PATH_SEGMENT_LENGTH);
226     if (ACPI_FAILURE (Status))
227     {
228         goto UnlockAndExit;
229     }
230 
231     /* Just copy the ACPI name from the Node and zero terminate it */
232 
233     NodeName = AcpiUtGetNodeName (Node);
234     ACPI_MOVE_NAME (Buffer->Pointer, NodeName);
235     ((char *) Buffer->Pointer) [ACPI_NAME_SIZE] = 0;
236     Status = AE_OK;
237 
238 
239 UnlockAndExit:
240 
241     (void) AcpiUtReleaseMutex (ACPI_MTX_NAMESPACE);
242     return (Status);
243 }
244 
ACPI_EXPORT_SYMBOL(AcpiGetName)245 ACPI_EXPORT_SYMBOL (AcpiGetName)
246 
247 
248 /******************************************************************************
249  *
250  * FUNCTION:    AcpiNsCopyDeviceId
251  *
252  * PARAMETERS:  Dest                - Pointer to the destination PNP_DEVICE_ID
253  *              Source              - Pointer to the source PNP_DEVICE_ID
254  *              StringArea          - Pointer to where to copy the dest string
255  *
256  * RETURN:      Pointer to the next string area
257  *
258  * DESCRIPTION: Copy a single PNP_DEVICE_ID, including the string data.
259  *
260  ******************************************************************************/
261 
262 static char *
263 AcpiNsCopyDeviceId (
264     ACPI_PNP_DEVICE_ID      *Dest,
265     ACPI_PNP_DEVICE_ID      *Source,
266     char                    *StringArea)
267 {
268     /* Create the destination PNP_DEVICE_ID */
269 
270     Dest->String = StringArea;
271     Dest->Length = Source->Length;
272 
273     /* Copy actual string and return a pointer to the next string area */
274 
275     memcpy (StringArea, Source->String, Source->Length);
276     return (StringArea + Source->Length);
277 }
278 
279 
280 /******************************************************************************
281  *
282  * FUNCTION:    AcpiGetObjectInfo
283  *
284  * PARAMETERS:  Handle              - Object Handle
285  *              ReturnBuffer        - Where the info is returned
286  *
287  * RETURN:      Status
288  *
289  * DESCRIPTION: Returns information about an object as gleaned from the
290  *              namespace node and possibly by running several standard
291  *              control methods (Such as in the case of a device.)
292  *
293  * For Device and Processor objects, run the Device _HID, _UID, _CID, _STA,
294  * _CLS, _ADR, _SxW, and _SxD methods.
295  *
296  * Note: Allocates the return buffer, must be freed by the caller.
297  *
298  * Note: This interface is intended to be used during the initial device
299  * discovery namespace traversal. Therefore, no complex methods can be
300  * executed, especially those that access operation regions. Therefore, do
301  * not add any additional methods that could cause problems in this area.
302  * this was the fate of the _SUB method which was found to cause such
303  * problems and was removed (11/2015).
304  *
305  ******************************************************************************/
306 
307 ACPI_STATUS
AcpiGetObjectInfo(ACPI_HANDLE Handle,ACPI_DEVICE_INFO ** ReturnBuffer)308 AcpiGetObjectInfo (
309     ACPI_HANDLE             Handle,
310     ACPI_DEVICE_INFO        **ReturnBuffer)
311 {
312     ACPI_NAMESPACE_NODE     *Node;
313     ACPI_DEVICE_INFO        *Info;
314     ACPI_PNP_DEVICE_ID_LIST *CidList = NULL;
315     ACPI_PNP_DEVICE_ID      *Hid = NULL;
316     ACPI_PNP_DEVICE_ID      *Uid = NULL;
317     ACPI_PNP_DEVICE_ID      *Cls = NULL;
318     char                    *NextIdString;
319     ACPI_OBJECT_TYPE        Type;
320     ACPI_NAME               Name;
321     UINT8                   ParamCount= 0;
322     UINT16                  Valid = 0;
323     UINT32                  InfoSize;
324     UINT32                  i;
325     ACPI_STATUS             Status;
326 
327 
328     /* Parameter validation */
329 
330     if (!Handle || !ReturnBuffer)
331     {
332         return (AE_BAD_PARAMETER);
333     }
334 
335     Status = AcpiUtAcquireMutex (ACPI_MTX_NAMESPACE);
336     if (ACPI_FAILURE (Status))
337     {
338         return (Status);
339     }
340 
341     Node = AcpiNsValidateHandle (Handle);
342     if (!Node)
343     {
344         (void) AcpiUtReleaseMutex (ACPI_MTX_NAMESPACE);
345         return (AE_BAD_PARAMETER);
346     }
347 
348     /* Get the namespace node data while the namespace is locked */
349 
350     InfoSize = sizeof (ACPI_DEVICE_INFO);
351     Type = Node->Type;
352     Name = Node->Name.Integer;
353 
354     if (Node->Type == ACPI_TYPE_METHOD)
355     {
356         ParamCount = Node->Object->Method.ParamCount;
357     }
358 
359     Status = AcpiUtReleaseMutex (ACPI_MTX_NAMESPACE);
360     if (ACPI_FAILURE (Status))
361     {
362         return (Status);
363     }
364 
365     if ((Type == ACPI_TYPE_DEVICE) ||
366         (Type == ACPI_TYPE_PROCESSOR))
367     {
368         /*
369          * Get extra info for ACPI Device/Processor objects only:
370          * Run the Device _HID, _UID, _CLS, and _CID methods.
371          *
372          * Note: none of these methods are required, so they may or may
373          * not be present for this device. The Info->Valid bitfield is used
374          * to indicate which methods were found and run successfully.
375          */
376 
377         /* Execute the Device._HID method */
378 
379         Status = AcpiUtExecute_HID (Node, &Hid);
380         if (ACPI_SUCCESS (Status))
381         {
382             InfoSize += Hid->Length;
383             Valid |= ACPI_VALID_HID;
384         }
385 
386         /* Execute the Device._UID method */
387 
388         Status = AcpiUtExecute_UID (Node, &Uid);
389         if (ACPI_SUCCESS (Status))
390         {
391             InfoSize += Uid->Length;
392             Valid |= ACPI_VALID_UID;
393         }
394 
395         /* Execute the Device._CID method */
396 
397         Status = AcpiUtExecute_CID (Node, &CidList);
398         if (ACPI_SUCCESS (Status))
399         {
400             /* Add size of CID strings and CID pointer array */
401 
402             InfoSize += (CidList->ListSize - sizeof (ACPI_PNP_DEVICE_ID_LIST));
403             Valid |= ACPI_VALID_CID;
404         }
405 
406         /* Execute the Device._CLS method */
407 
408         Status = AcpiUtExecute_CLS (Node, &Cls);
409         if (ACPI_SUCCESS (Status))
410         {
411             InfoSize += Cls->Length;
412             Valid |= ACPI_VALID_CLS;
413         }
414     }
415 
416     /*
417      * Now that we have the variable-length data, we can allocate the
418      * return buffer
419      */
420     Info = ACPI_ALLOCATE_ZEROED (InfoSize);
421     if (!Info)
422     {
423         Status = AE_NO_MEMORY;
424         goto Cleanup;
425     }
426 
427     /* Get the fixed-length data */
428 
429     if ((Type == ACPI_TYPE_DEVICE) ||
430         (Type == ACPI_TYPE_PROCESSOR))
431     {
432         /*
433          * Get extra info for ACPI Device/Processor objects only:
434          * Run the _STA, _ADR and, SxW, and _SxD methods.
435          *
436          * Notes: none of these methods are required, so they may or may
437          * not be present for this device. The Info->Valid bitfield is used
438          * to indicate which methods were found and run successfully.
439          *
440          * For _STA, if the method does not exist, then (as per the ACPI
441          * specification), the returned CurrentStatus flags will indicate
442          * that the device is present/functional/enabled. Otherwise, the
443          * CurrentStatus flags reflect the value returned from _STA.
444          */
445 
446         /* Execute the Device._STA method */
447 
448         Status = AcpiUtExecute_STA (Node, &Info->CurrentStatus);
449         if (ACPI_SUCCESS (Status))
450         {
451             Valid |= ACPI_VALID_STA;
452         }
453 
454         /* Execute the Device._ADR method */
455 
456         Status = AcpiUtEvaluateNumericObject (METHOD_NAME__ADR, Node,
457             &Info->Address);
458         if (ACPI_SUCCESS (Status))
459         {
460             Valid |= ACPI_VALID_ADR;
461         }
462 
463         /* Execute the Device._SxW methods */
464 
465         Status = AcpiUtExecutePowerMethods (Node,
466             AcpiGbl_LowestDstateNames, ACPI_NUM_SxW_METHODS,
467             Info->LowestDstates);
468         if (ACPI_SUCCESS (Status))
469         {
470             Valid |= ACPI_VALID_SXWS;
471         }
472 
473         /* Execute the Device._SxD methods */
474 
475         Status = AcpiUtExecutePowerMethods (Node,
476             AcpiGbl_HighestDstateNames, ACPI_NUM_SxD_METHODS,
477             Info->HighestDstates);
478         if (ACPI_SUCCESS (Status))
479         {
480             Valid |= ACPI_VALID_SXDS;
481         }
482     }
483 
484     /*
485      * Create a pointer to the string area of the return buffer.
486      * Point to the end of the base ACPI_DEVICE_INFO structure.
487      */
488     NextIdString = ACPI_CAST_PTR (char, Info->CompatibleIdList.Ids);
489     if (CidList)
490     {
491         /* Point past the CID PNP_DEVICE_ID array */
492 
493         NextIdString += ((ACPI_SIZE) CidList->Count * sizeof (ACPI_PNP_DEVICE_ID));
494     }
495 
496     /*
497      * Copy the HID, UID, and CIDs to the return buffer. The variable-length
498      * strings are copied to the reserved area at the end of the buffer.
499      *
500      * For HID and CID, check if the ID is a PCI Root Bridge.
501      */
502     if (Hid)
503     {
504         NextIdString = AcpiNsCopyDeviceId (&Info->HardwareId,
505             Hid, NextIdString);
506 
507         if (AcpiUtIsPciRootBridge (Hid->String))
508         {
509             Info->Flags |= ACPI_PCI_ROOT_BRIDGE;
510         }
511     }
512 
513     if (Uid)
514     {
515         NextIdString = AcpiNsCopyDeviceId (&Info->UniqueId,
516             Uid, NextIdString);
517     }
518 
519     if (CidList)
520     {
521         Info->CompatibleIdList.Count = CidList->Count;
522         Info->CompatibleIdList.ListSize = CidList->ListSize;
523 
524         /* Copy each CID */
525 
526         for (i = 0; i < CidList->Count; i++)
527         {
528             NextIdString = AcpiNsCopyDeviceId (&Info->CompatibleIdList.Ids[i],
529                 &CidList->Ids[i], NextIdString);
530 
531             if (AcpiUtIsPciRootBridge (CidList->Ids[i].String))
532             {
533                 Info->Flags |= ACPI_PCI_ROOT_BRIDGE;
534             }
535         }
536     }
537 
538     if (Cls)
539     {
540         NextIdString = AcpiNsCopyDeviceId (&Info->ClassCode,
541             Cls, NextIdString);
542     }
543 
544     /* Copy the fixed-length data */
545 
546     Info->InfoSize = InfoSize;
547     Info->Type = Type;
548     Info->Name = Name;
549     Info->ParamCount = ParamCount;
550     Info->Valid = Valid;
551 
552     *ReturnBuffer = Info;
553     Status = AE_OK;
554 
555 
556 Cleanup:
557     if (Hid)
558     {
559         ACPI_FREE (Hid);
560     }
561     if (Uid)
562     {
563         ACPI_FREE (Uid);
564     }
565     if (CidList)
566     {
567         ACPI_FREE (CidList);
568     }
569     if (Cls)
570     {
571         ACPI_FREE (Cls);
572     }
573     return (Status);
574 }
575 
ACPI_EXPORT_SYMBOL(AcpiGetObjectInfo)576 ACPI_EXPORT_SYMBOL (AcpiGetObjectInfo)
577 
578 
579 /******************************************************************************
580  *
581  * FUNCTION:    AcpiInstallMethod
582  *
583  * PARAMETERS:  Buffer         - An ACPI table containing one control method
584  *
585  * RETURN:      Status
586  *
587  * DESCRIPTION: Install a control method into the namespace. If the method
588  *              name already exists in the namespace, it is overwritten. The
589  *              input buffer must contain a valid DSDT or SSDT containing a
590  *              single control method.
591  *
592  ******************************************************************************/
593 
594 ACPI_STATUS
595 AcpiInstallMethod (
596     UINT8                   *Buffer)
597 {
598     ACPI_TABLE_HEADER       *Table = ACPI_CAST_PTR (ACPI_TABLE_HEADER, Buffer);
599     UINT8                   *AmlBuffer;
600     UINT8                   *AmlStart;
601     char                    *Path;
602     ACPI_NAMESPACE_NODE     *Node;
603     ACPI_OPERAND_OBJECT     *MethodObj;
604     ACPI_PARSE_STATE        ParserState;
605     UINT32                  AmlLength;
606     UINT16                  Opcode;
607     UINT8                   MethodFlags;
608     ACPI_STATUS             Status;
609 
610 
611     /* Parameter validation */
612 
613     if (!Buffer)
614     {
615         return (AE_BAD_PARAMETER);
616     }
617 
618     /* Table must be a DSDT or SSDT */
619 
620     if (!ACPI_COMPARE_NAME (Table->Signature, ACPI_SIG_DSDT) &&
621         !ACPI_COMPARE_NAME (Table->Signature, ACPI_SIG_SSDT))
622     {
623         return (AE_BAD_HEADER);
624     }
625 
626     /* First AML opcode in the table must be a control method */
627 
628     ParserState.Aml = Buffer + sizeof (ACPI_TABLE_HEADER);
629     Opcode = AcpiPsPeekOpcode (&ParserState);
630     if (Opcode != AML_METHOD_OP)
631     {
632         return (AE_BAD_PARAMETER);
633     }
634 
635     /* Extract method information from the raw AML */
636 
637     ParserState.Aml += AcpiPsGetOpcodeSize (Opcode);
638     ParserState.PkgEnd = AcpiPsGetNextPackageEnd (&ParserState);
639     Path = AcpiPsGetNextNamestring (&ParserState);
640 
641     MethodFlags = *ParserState.Aml++;
642     AmlStart = ParserState.Aml;
643     AmlLength = ACPI_PTR_DIFF (ParserState.PkgEnd, AmlStart);
644 
645     /*
646      * Allocate resources up-front. We don't want to have to delete a new
647      * node from the namespace if we cannot allocate memory.
648      */
649     AmlBuffer = ACPI_ALLOCATE (AmlLength);
650     if (!AmlBuffer)
651     {
652         return (AE_NO_MEMORY);
653     }
654 
655     MethodObj = AcpiUtCreateInternalObject (ACPI_TYPE_METHOD);
656     if (!MethodObj)
657     {
658         ACPI_FREE (AmlBuffer);
659         return (AE_NO_MEMORY);
660     }
661 
662     /* Lock namespace for AcpiNsLookup, we may be creating a new node */
663 
664     Status = AcpiUtAcquireMutex (ACPI_MTX_NAMESPACE);
665     if (ACPI_FAILURE (Status))
666     {
667         goto ErrorExit;
668     }
669 
670     /* The lookup either returns an existing node or creates a new one */
671 
672     Status = AcpiNsLookup (NULL, Path, ACPI_TYPE_METHOD, ACPI_IMODE_LOAD_PASS1,
673         ACPI_NS_DONT_OPEN_SCOPE | ACPI_NS_ERROR_IF_FOUND, NULL, &Node);
674 
675     (void) AcpiUtReleaseMutex (ACPI_MTX_NAMESPACE);
676 
677     if (ACPI_FAILURE (Status)) /* NsLookup */
678     {
679         if (Status != AE_ALREADY_EXISTS)
680         {
681             goto ErrorExit;
682         }
683 
684         /* Node existed previously, make sure it is a method node */
685 
686         if (Node->Type != ACPI_TYPE_METHOD)
687         {
688             Status = AE_TYPE;
689             goto ErrorExit;
690         }
691     }
692 
693     /* Copy the method AML to the local buffer */
694 
695     memcpy (AmlBuffer, AmlStart, AmlLength);
696 
697     /* Initialize the method object with the new method's information */
698 
699     MethodObj->Method.AmlStart = AmlBuffer;
700     MethodObj->Method.AmlLength = AmlLength;
701 
702     MethodObj->Method.ParamCount = (UINT8)
703         (MethodFlags & AML_METHOD_ARG_COUNT);
704 
705     if (MethodFlags & AML_METHOD_SERIALIZED)
706     {
707         MethodObj->Method.InfoFlags = ACPI_METHOD_SERIALIZED;
708 
709         MethodObj->Method.SyncLevel = (UINT8)
710             ((MethodFlags & AML_METHOD_SYNC_LEVEL) >> 4);
711     }
712 
713     /*
714      * Now that it is complete, we can attach the new method object to
715      * the method Node (detaches/deletes any existing object)
716      */
717     Status = AcpiNsAttachObject (Node, MethodObj, ACPI_TYPE_METHOD);
718 
719     /*
720      * Flag indicates AML buffer is dynamic, must be deleted later.
721      * Must be set only after attach above.
722      */
723     Node->Flags |= ANOBJ_ALLOCATED_BUFFER;
724 
725     /* Remove local reference to the method object */
726 
727     AcpiUtRemoveReference (MethodObj);
728     return (Status);
729 
730 
731 ErrorExit:
732 
733     ACPI_FREE (AmlBuffer);
734     ACPI_FREE (MethodObj);
735     return (Status);
736 }
737 
738 ACPI_EXPORT_SYMBOL (AcpiInstallMethod)
739