sys/contrib/dev/acpica/source/components/namespace/nsxfname.c

   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 - 2014, 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
  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 (!ACPI_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
 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     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     {
 198         /* Get the full pathname (From the namespace root) */
 199
 200         Status = AcpiNsHandleToPathname (Handle, Buffer);
 201         return (Status);
 202     }
 203
 204     /*
 205      * Wants the single segment ACPI name.
 206      * Validate handle and convert to a namespace Node
 207      */
 208     Status = AcpiUtAcquireMutex (ACPI_MTX_NAMESPACE);
 209     if (ACPI_FAILURE (Status))
 210     {
 211         return (Status);
 212     }
 213
 214     Node = AcpiNsValidateHandle (Handle);
 215     if (!Node)
 216     {
 217         Status = AE_BAD_PARAMETER;
 218         goto UnlockAndExit;
 219     }
 220
 221     /* Validate/Allocate/Clear caller buffer */
 222
 223     Status = AcpiUtInitializeBuffer (Buffer, ACPI_PATH_SEGMENT_LENGTH);
 224     if (ACPI_FAILURE (Status))
 225     {
 226         goto UnlockAndExit;
 227     }
 228
 229     /* Just copy the ACPI name from the Node and zero terminate it */
 230
 231     NodeName = AcpiUtGetNodeName (Node);
 232     ACPI_MOVE_NAME (Buffer->Pointer, NodeName);
 233     ((char *) Buffer->Pointer) [ACPI_NAME_SIZE] = 0;
 234     Status = AE_OK;
 235
 236
 237 UnlockAndExit:
 238
 239     (void) AcpiUtReleaseMutex (ACPI_MTX_NAMESPACE);
 240     return (Status);
 241 }
 242
 243 ACPI_EXPORT_SYMBOL (AcpiGetName)
 244
 245
 246 /******************************************************************************
 247  *
 248  * FUNCTION:    AcpiNsCopyDeviceId
 249  *
 250  * PARAMETERS:  Dest                - Pointer to the destination PNP_DEVICE_ID
 251  *              Source              - Pointer to the source PNP_DEVICE_ID
 252  *              StringArea          - Pointer to where to copy the dest string
 253  *
 254  * RETURN:      Pointer to the next string area
 255  *
 256  * DESCRIPTION: Copy a single PNP_DEVICE_ID, including the string data.
 257  *
 258  ******************************************************************************/
 259
 260 static char *
 261 AcpiNsCopyDeviceId (
 262     ACPI_PNP_DEVICE_ID      *Dest,
 263     ACPI_PNP_DEVICE_ID      *Source,
 264     char                    *StringArea)
 265 {
 266
 267     /* Create the destination PNP_DEVICE_ID */
 268
 269     Dest->String = StringArea;
 270     Dest->Length = Source->Length;
 271
 272     /* Copy actual string and return a pointer to the next string area */
 273
 274     ACPI_MEMCPY (StringArea, Source->String, Source->Length);
 275     return (StringArea + Source->Length);
 276 }
 277
 278
 279 /******************************************************************************
 280  *
 281  * FUNCTION:    AcpiGetObjectInfo
 282  *
 283  * PARAMETERS:  Handle              - Object Handle
 284  *              ReturnBuffer        - Where the info is returned
 285  *
 286  * RETURN:      Status
 287  *
 288  * DESCRIPTION: Returns information about an object as gleaned from the
 289  *              namespace node and possibly by running several standard
 290  *              control methods (Such as in the case of a device.)
 291  *
 292  * For Device and Processor objects, run the Device _HID, _UID, _CID, _SUB,
 293  * _STA, _ADR, _SxW, and _SxD methods.
 294  *
 295  * Note: Allocates the return buffer, must be freed by the caller.
 296  *
 297  ******************************************************************************/
 298
 299 ACPI_STATUS
 300 AcpiGetObjectInfo (
 301     ACPI_HANDLE             Handle,
 302     ACPI_DEVICE_INFO        **ReturnBuffer)
 303 {
 304     ACPI_NAMESPACE_NODE     *Node;
 305     ACPI_DEVICE_INFO        *Info;
 306     ACPI_PNP_DEVICE_ID_LIST *CidList = NULL;
 307     ACPI_PNP_DEVICE_ID      *Hid = NULL;
 308     ACPI_PNP_DEVICE_ID      *Uid = NULL;
 309     ACPI_PNP_DEVICE_ID      *Sub = NULL;
 310     char                    *NextIdString;
 311     ACPI_OBJECT_TYPE        Type;
 312     ACPI_NAME               Name;
 313     UINT8                   ParamCount= 0;
 314     UINT8                   Valid = 0;
 315     UINT32                  InfoSize;
 316     UINT32                  i;
 317     ACPI_STATUS             Status;
 318
 319
 320     /* Parameter validation */
 321
 322     if (!Handle || !ReturnBuffer)
 323     {
 324         return (AE_BAD_PARAMETER);
 325     }
 326
 327     Status = AcpiUtAcquireMutex (ACPI_MTX_NAMESPACE);
 328     if (ACPI_FAILURE (Status))
 329     {
 330         return (Status);
 331     }
 332
 333     Node = AcpiNsValidateHandle (Handle);
 334     if (!Node)
 335     {
 336         (void) AcpiUtReleaseMutex (ACPI_MTX_NAMESPACE);
 337         return (AE_BAD_PARAMETER);
 338     }
 339
 340     /* Get the namespace node data while the namespace is locked */
 341
 342     InfoSize = sizeof (ACPI_DEVICE_INFO);
 343     Type = Node->Type;
 344     Name = Node->Name.Integer;
 345
 346     if (Node->Type == ACPI_TYPE_METHOD)
 347     {
 348         ParamCount = Node->Object->Method.ParamCount;
 349     }
 350
 351     Status = AcpiUtReleaseMutex (ACPI_MTX_NAMESPACE);
 352     if (ACPI_FAILURE (Status))
 353     {
 354         return (Status);
 355     }
 356
 357     if ((Type == ACPI_TYPE_DEVICE) ||
 358         (Type == ACPI_TYPE_PROCESSOR))
 359     {
 360         /*
 361          * Get extra info for ACPI Device/Processor objects only:
 362          * Run the Device _HID, _UID, _SUB, and _CID methods.
 363          *
 364          * Note: none of these methods are required, so they may or may
 365          * not be present for this device. The Info->Valid bitfield is used
 366          * to indicate which methods were found and run successfully.
 367          */
 368
 369         /* Execute the Device._HID method */
 370
 371         Status = AcpiUtExecute_HID (Node, &Hid);
 372         if (ACPI_SUCCESS (Status))
 373         {
 374             InfoSize += Hid->Length;
 375             Valid |= ACPI_VALID_HID;
 376         }
 377
 378         /* Execute the Device._UID method */
 379
 380         Status = AcpiUtExecute_UID (Node, &Uid);
 381         if (ACPI_SUCCESS (Status))
 382         {
 383             InfoSize += Uid->Length;
 384             Valid |= ACPI_VALID_UID;
 385         }
 386
 387         /* Execute the Device._SUB method */
 388
 389         Status = AcpiUtExecute_SUB (Node, &Sub);
 390         if (ACPI_SUCCESS (Status))
 391         {
 392             InfoSize += Sub->Length;
 393             Valid |= ACPI_VALID_SUB;
 394         }
 395
 396         /* Execute the Device._CID method */
 397
 398         Status = AcpiUtExecute_CID (Node, &CidList);
 399         if (ACPI_SUCCESS (Status))
 400         {
 401             /* Add size of CID strings and CID pointer array */
 402
 403             InfoSize += (CidList->ListSize - sizeof (ACPI_PNP_DEVICE_ID_LIST));
 404             Valid |= ACPI_VALID_CID;
 405         }
 406     }
 407
 408     /*
 409      * Now that we have the variable-length data, we can allocate the
 410      * return buffer
 411      */
 412     Info = ACPI_ALLOCATE_ZEROED (InfoSize);
 413     if (!Info)
 414     {
 415         Status = AE_NO_MEMORY;
 416         goto Cleanup;
 417     }
 418
 419     /* Get the fixed-length data */
 420
 421     if ((Type == ACPI_TYPE_DEVICE) ||
 422         (Type == ACPI_TYPE_PROCESSOR))
 423     {
 424         /*
 425          * Get extra info for ACPI Device/Processor objects only:
 426          * Run the _STA, _ADR and, SxW, and _SxD methods.
 427          *
 428          * Notes: none of these methods are required, so they may or may
 429          * not be present for this device. The Info->Valid bitfield is used
 430          * to indicate which methods were found and run successfully.
 431          *
 432          * For _STA, if the method does not exist, then (as per the ACPI
 433          * specification), the returned CurrentStatus flags will indicate
 434          * that the device is present/functional/enabled. Otherwise, the
 435          * CurrentStatus flags reflect the value returned from _STA.
 436          */
 437
 438         /* Execute the Device._STA method */
 439
 440         Status = AcpiUtExecute_STA (Node, &Info->CurrentStatus);
 441         if (ACPI_SUCCESS (Status))
 442         {
 443             Valid |= ACPI_VALID_STA;
 444         }
 445
 446         /* Execute the Device._ADR method */
 447
 448         Status = AcpiUtEvaluateNumericObject (METHOD_NAME__ADR, Node,
 449                     &Info->Address);
 450         if (ACPI_SUCCESS (Status))
 451         {
 452             Valid |= ACPI_VALID_ADR;
 453         }
 454
 455         /* Execute the Device._SxW methods */
 456
 457         Status = AcpiUtExecutePowerMethods (Node,
 458                     AcpiGbl_LowestDstateNames, ACPI_NUM_SxW_METHODS,
 459                     Info->LowestDstates);
 460         if (ACPI_SUCCESS (Status))
 461         {
 462             Valid |= ACPI_VALID_SXWS;
 463         }
 464
 465         /* Execute the Device._SxD methods */
 466
 467         Status = AcpiUtExecutePowerMethods (Node,
 468                     AcpiGbl_HighestDstateNames, ACPI_NUM_SxD_METHODS,
 469                     Info->HighestDstates);
 470         if (ACPI_SUCCESS (Status))
 471         {
 472             Valid |= ACPI_VALID_SXDS;
 473         }
 474     }
 475
 476     /*
 477      * Create a pointer to the string area of the return buffer.
 478      * Point to the end of the base ACPI_DEVICE_INFO structure.
 479      */
 480     NextIdString = ACPI_CAST_PTR (char, Info->CompatibleIdList.Ids);
 481     if (CidList)
 482     {
 483         /* Point past the CID PNP_DEVICE_ID array */
 484
 485         NextIdString += ((ACPI_SIZE) CidList->Count * sizeof (ACPI_PNP_DEVICE_ID));
 486     }
 487
 488     /*
 489      * Copy the HID, UID, SUB, and CIDs to the return buffer.
 490      * The variable-length strings are copied to the reserved area
 491      * at the end of the buffer.
 492      *
 493      * For HID and CID, check if the ID is a PCI Root Bridge.
 494      */
 495     if (Hid)
 496     {
 497         NextIdString = AcpiNsCopyDeviceId (&Info->HardwareId,
 498             Hid, NextIdString);
 499
 500         if (AcpiUtIsPciRootBridge (Hid->String))
 501         {
 502             Info->Flags |= ACPI_PCI_ROOT_BRIDGE;
 503         }
 504     }
 505
 506     if (Uid)
 507     {
 508         NextIdString = AcpiNsCopyDeviceId (&Info->UniqueId,
 509             Uid, NextIdString);
 510     }
 511
 512     if (Sub)
 513     {
 514         NextIdString = AcpiNsCopyDeviceId (&Info->SubsystemId,
 515             Sub, NextIdString);
 516     }
 517
 518     if (CidList)
 519     {
 520         Info->CompatibleIdList.Count = CidList->Count;
 521         Info->CompatibleIdList.ListSize = CidList->ListSize;
 522
 523         /* Copy each CID */
 524
 525         for (i = 0; i < CidList->Count; i++)
 526         {
 527             NextIdString = AcpiNsCopyDeviceId (&Info->CompatibleIdList.Ids[i],
 528                 &CidList->Ids[i], NextIdString);
 529
 530             if (AcpiUtIsPciRootBridge (CidList->Ids[i].String))
 531             {
 532                 Info->Flags |= ACPI_PCI_ROOT_BRIDGE;
 533             }
 534         }
 535     }
 536
 537     /* Copy the fixed-length data */
 538
 539     Info->InfoSize = InfoSize;
 540     Info->Type = Type;
 541     Info->Name = Name;
 542     Info->ParamCount = ParamCount;
 543     Info->Valid = Valid;
 544
 545     *ReturnBuffer = Info;
 546     Status = AE_OK;
 547
 548
 549 Cleanup:
 550     if (Hid)
 551     {
 552         ACPI_FREE (Hid);
 553     }
 554     if (Uid)
 555     {
 556         ACPI_FREE (Uid);
 557     }
 558     if (Sub)
 559     {
 560         ACPI_FREE (Sub);
 561     }
 562     if (CidList)
 563     {
 564         ACPI_FREE (CidList);
 565     }
 566     return (Status);
 567 }
 568
 569 ACPI_EXPORT_SYMBOL (AcpiGetObjectInfo)
 570
 571
 572 /******************************************************************************
 573  *
 574  * FUNCTION:    AcpiInstallMethod
 575  *
 576  * PARAMETERS:  Buffer         - An ACPI table containing one control method
 577  *
 578  * RETURN:      Status
 579  *
 580  * DESCRIPTION: Install a control method into the namespace. If the method
 581  *              name already exists in the namespace, it is overwritten. The
 582  *              input buffer must contain a valid DSDT or SSDT containing a
 583  *              single control method.
 584  *
 585  ******************************************************************************/
 586
 587 ACPI_STATUS
 588 AcpiInstallMethod (
 589     UINT8                   *Buffer)
 590 {
 591     ACPI_TABLE_HEADER       *Table = ACPI_CAST_PTR (ACPI_TABLE_HEADER, Buffer);
 592     UINT8                   *AmlBuffer;
 593     UINT8                   *AmlStart;
 594     char                    *Path;
 595     ACPI_NAMESPACE_NODE     *Node;
 596     ACPI_OPERAND_OBJECT     *MethodObj;
 597     ACPI_PARSE_STATE        ParserState;
 598     UINT32                  AmlLength;
 599     UINT16                  Opcode;
 600     UINT8                   MethodFlags;
 601     ACPI_STATUS             Status;
 602
 603
 604     /* Parameter validation */
 605
 606     if (!Buffer)
 607     {
 608         return (AE_BAD_PARAMETER);
 609     }
 610
 611     /* Table must be a DSDT or SSDT */
 612
 613     if (!ACPI_COMPARE_NAME (Table->Signature, ACPI_SIG_DSDT) &&
 614         !ACPI_COMPARE_NAME (Table->Signature, ACPI_SIG_SSDT))
 615     {
 616         return (AE_BAD_HEADER);
 617     }
 618
 619     /* First AML opcode in the table must be a control method */
 620
 621     ParserState.Aml = Buffer + sizeof (ACPI_TABLE_HEADER);
 622     Opcode = AcpiPsPeekOpcode (&ParserState);
 623     if (Opcode != AML_METHOD_OP)
 624     {
 625         return (AE_BAD_PARAMETER);
 626     }
 627
 628     /* Extract method information from the raw AML */
 629
 630     ParserState.Aml += AcpiPsGetOpcodeSize (Opcode);
 631     ParserState.PkgEnd = AcpiPsGetNextPackageEnd (&ParserState);
 632     Path = AcpiPsGetNextNamestring (&ParserState);
 633     MethodFlags = *ParserState.Aml++;
 634     AmlStart = ParserState.Aml;
 635     AmlLength = ACPI_PTR_DIFF (ParserState.PkgEnd, AmlStart);
 636
 637     /*
 638      * Allocate resources up-front. We don't want to have to delete a new
 639      * node from the namespace if we cannot allocate memory.
 640      */
 641     AmlBuffer = ACPI_ALLOCATE (AmlLength);
 642     if (!AmlBuffer)
 643     {
 644         return (AE_NO_MEMORY);
 645     }
 646
 647     MethodObj = AcpiUtCreateInternalObject (ACPI_TYPE_METHOD);
 648     if (!MethodObj)
 649     {
 650         ACPI_FREE (AmlBuffer);
 651         return (AE_NO_MEMORY);
 652     }
 653
 654     /* Lock namespace for AcpiNsLookup, we may be creating a new node */
 655
 656     Status = AcpiUtAcquireMutex (ACPI_MTX_NAMESPACE);
 657     if (ACPI_FAILURE (Status))
 658     {
 659         goto ErrorExit;
 660     }
 661
 662     /* The lookup either returns an existing node or creates a new one */
 663
 664     Status = AcpiNsLookup (NULL, Path, ACPI_TYPE_METHOD, ACPI_IMODE_LOAD_PASS1,
 665                 ACPI_NS_DONT_OPEN_SCOPE | ACPI_NS_ERROR_IF_FOUND, NULL, &Node);
 666
 667     (void) AcpiUtReleaseMutex (ACPI_MTX_NAMESPACE);
 668
 669     if (ACPI_FAILURE (Status)) /* NsLookup */
 670     {
 671         if (Status != AE_ALREADY_EXISTS)
 672         {
 673             goto ErrorExit;
 674         }
 675
 676         /* Node existed previously, make sure it is a method node */
 677
 678         if (Node->Type != ACPI_TYPE_METHOD)
 679         {
 680             Status = AE_TYPE;
 681             goto ErrorExit;
 682         }
 683     }
 684
 685     /* Copy the method AML to the local buffer */
 686
 687     ACPI_MEMCPY (AmlBuffer, AmlStart, AmlLength);
 688
 689     /* Initialize the method object with the new method's information */
 690
 691     MethodObj->Method.AmlStart = AmlBuffer;
 692     MethodObj->Method.AmlLength = AmlLength;
 693
 694     MethodObj->Method.ParamCount = (UINT8)
 695         (MethodFlags & AML_METHOD_ARG_COUNT);
 696
 697     if (MethodFlags & AML_METHOD_SERIALIZED)
 698     {
 699         MethodObj->Method.InfoFlags = ACPI_METHOD_SERIALIZED;
 700
 701         MethodObj->Method.SyncLevel = (UINT8)
 702             ((MethodFlags & AML_METHOD_SYNC_LEVEL) >> 4);
 703     }
 704
 705     /*
 706      * Now that it is complete, we can attach the new method object to
 707      * the method Node (detaches/deletes any existing object)
 708      */
 709     Status = AcpiNsAttachObject (Node, MethodObj, ACPI_TYPE_METHOD);
 710
 711     /*
 712      * Flag indicates AML buffer is dynamic, must be deleted later.
 713      * Must be set only after attach above.
 714      */
 715     Node->Flags |= ANOBJ_ALLOCATED_BUFFER;
 716
 717     /* Remove local reference to the method object */
 718
 719     AcpiUtRemoveReference (MethodObj);
 720     return (Status);
 721
 722
 723 ErrorExit:
 724
 725     ACPI_FREE (AmlBuffer);
 726     ACPI_FREE (MethodObj);
 727     return (Status);
 728 }
 729
 730 ACPI_EXPORT_SYMBOL (AcpiInstallMethod)