sys/contrib/dev/acpica-unix-20040527/NAMESPACE/nsalloc.c

   1 /*******************************************************************************
   2  *
   3  * Module Name: nsalloc - Namespace allocation and deletion utilities
   4  *              $Revision: 87 $
   5  *
   6  ******************************************************************************/
   7
   8 /******************************************************************************
   9  *
  10  * 1. Copyright Notice
  11  *
  12  * Some or all of this work - Copyright (c) 1999 - 2004, Intel Corp.
  13  * All rights reserved.
  14  *
  15  * 2. License
  16  *
  17  * 2.1. This is your license from Intel Corp. under its intellectual property
  18  * rights.  You may have additional license terms from the party that provided
  19  * you this software, covering your right to use that party's intellectual
  20  * property rights.
  21  *
  22  * 2.2. Intel grants, free of charge, to any person ("Licensee") obtaining a
  23  * copy of the source code appearing in this file ("Covered Code") an
  24  * irrevocable, perpetual, worldwide license under Intel's copyrights in the
  25  * base code distributed originally by Intel ("Original Intel Code") to copy,
  26  * make derivatives, distribute, use and display any portion of the Covered
  27  * Code in any form, with the right to sublicense such rights; and
  28  *
  29  * 2.3. Intel grants Licensee a non-exclusive and non-transferable patent
  30  * license (with the right to sublicense), under only those claims of Intel
  31  * patents that are infringed by the Original Intel Code, to make, use, sell,
  32  * offer to sell, and import the Covered Code and derivative works thereof
  33  * solely to the minimum extent necessary to exercise the above copyright
  34  * license, and in no event shall the patent license extend to any additions
  35  * to or modifications of the Original Intel Code.  No other license or right
  36  * is granted directly or by implication, estoppel or otherwise;
  37  *
  38  * The above copyright and patent license is granted only if the following
  39  * conditions are met:
  40  *
  41  * 3. Conditions
  42  *
  43  * 3.1. Redistribution of Source with Rights to Further Distribute Source.
  44  * Redistribution of source code of any substantial portion of the Covered
  45  * Code or modification with rights to further distribute source must include
  46  * the above Copyright Notice, the above License, this list of Conditions,
  47  * and the following Disclaimer and Export Compliance provision.  In addition,
  48  * Licensee must cause all Covered Code to which Licensee contributes to
  49  * contain a file documenting the changes Licensee made to create that Covered
  50  * Code and the date of any change.  Licensee must include in that file the
  51  * documentation of any changes made by any predecessor Licensee.  Licensee
  52  * must include a prominent statement that the modification is derived,
  53  * directly or indirectly, from Original Intel Code.
  54  *
  55  * 3.2. Redistribution of Source with no Rights to Further Distribute Source.
  56  * Redistribution of source code of any substantial portion of the Covered
  57  * Code or modification without rights to further distribute source must
  58  * include the following Disclaimer and Export Compliance provision in the
  59  * documentation and/or other materials provided with distribution.  In
  60  * addition, Licensee may not authorize further sublicense of source of any
  61  * portion of the Covered Code, and must include terms to the effect that the
  62  * license from Licensee to its licensee is limited to the intellectual
  63  * property embodied in the software Licensee provides to its licensee, and
  64  * not to intellectual property embodied in modifications its licensee may
  65  * make.
  66  *
  67  * 3.3. Redistribution of Executable. Redistribution in executable form of any
  68  * substantial portion of the Covered Code or modification must reproduce the
  69  * above Copyright Notice, and the following Disclaimer and Export Compliance
  70  * provision in the documentation and/or other materials provided with the
  71  * distribution.
  72  *
  73  * 3.4. Intel retains all right, title, and interest in and to the Original
  74  * Intel Code.
  75  *
  76  * 3.5. Neither the name Intel nor any other trademark owned or controlled by
  77  * Intel shall be used in advertising or otherwise to promote the sale, use or
  78  * other dealings in products derived from or relating to the Covered Code
  79  * without prior written authorization from Intel.
  80  *
  81  * 4. Disclaimer and Export Compliance
  82  *
  83  * 4.1. INTEL MAKES NO WARRANTY OF ANY KIND REGARDING ANY SOFTWARE PROVIDED
  84  * HERE.  ANY SOFTWARE ORIGINATING FROM INTEL OR DERIVED FROM INTEL SOFTWARE
  85  * IS PROVIDED "AS IS," AND INTEL WILL NOT PROVIDE ANY SUPPORT,  ASSISTANCE,
  86  * INSTALLATION, TRAINING OR OTHER SERVICES.  INTEL WILL NOT PROVIDE ANY
  87  * UPDATES, ENHANCEMENTS OR EXTENSIONS.  INTEL SPECIFICALLY DISCLAIMS ANY
  88  * IMPLIED WARRANTIES OF MERCHANTABILITY, NONINFRINGEMENT AND FITNESS FOR A
  89  * PARTICULAR PURPOSE.
  90  *
  91  * 4.2. IN NO EVENT SHALL INTEL HAVE ANY LIABILITY TO LICENSEE, ITS LICENSEES
  92  * OR ANY OTHER THIRD PARTY, FOR ANY LOST PROFITS, LOST DATA, LOSS OF USE OR
  93  * COSTS OF PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES, OR FOR ANY INDIRECT,
  94  * SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THIS AGREEMENT, UNDER ANY
  95  * CAUSE OF ACTION OR THEORY OF LIABILITY, AND IRRESPECTIVE OF WHETHER INTEL
  96  * HAS ADVANCE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES.  THESE LIMITATIONS
  97  * SHALL APPLY NOTWITHSTANDING THE FAILURE OF THE ESSENTIAL PURPOSE OF ANY
  98  * LIMITED REMEDY.
  99  *
 100  * 4.3. Licensee shall not export, either directly or indirectly, any of this
 101  * software or system incorporating such software without first obtaining any
 102  * required license or other approval from the U. S. Department of Commerce or
 103  * any other agency or department of the United States Government.  In the
 104  * event Licensee exports any such software from the United States or
 105  * re-exports any such software from a foreign destination, Licensee shall
 106  * ensure that the distribution and export/re-export of the software is in
 107  * compliance with all laws, regulations, orders, or other restrictions of the
 108  * U.S. Export Administration Regulations. Licensee agrees that neither it nor
 109  * any of its subsidiaries will export/re-export any technical data, process,
 110  * software, or service, directly or indirectly, to any country for which the
 111  * United States government or any agency thereof requires an export license,
 112  * other governmental approval, or letter of assurance, without first obtaining
 113  * such license, approval or letter.
 114  *
 115  *****************************************************************************/
 116
 117
 118 #define __NSALLOC_C__
 119
 120 #include "acpi.h"
 121 #include "acnamesp.h"
 122
 123
 124 #define _COMPONENT          ACPI_NAMESPACE
 125         ACPI_MODULE_NAME    ("nsalloc")
 126
 127
 128 /*******************************************************************************
 129  *
 130  * FUNCTION:    AcpiNsCreateNode
 131  *
 132  * PARAMETERS:  AcpiName        - Name of the new node
 133  *
 134  * RETURN:      None
 135  *
 136  * DESCRIPTION: Create a namespace node
 137  *
 138  ******************************************************************************/
 139
 140 ACPI_NAMESPACE_NODE *
 141 AcpiNsCreateNode (
 142     UINT32                  Name)
 143 {
 144     ACPI_NAMESPACE_NODE     *Node;
 145
 146
 147     ACPI_FUNCTION_TRACE ("NsCreateNode");
 148
 149
 150     Node = ACPI_MEM_CALLOCATE (sizeof (ACPI_NAMESPACE_NODE));
 151     if (!Node)
 152     {
 153         return_PTR (NULL);
 154     }
 155
 156     ACPI_MEM_TRACKING (AcpiGbl_MemoryLists[ACPI_MEM_LIST_NSNODE].TotalAllocated++);
 157
 158     Node->Name.Integer   = Name;
 159     Node->ReferenceCount = 1;
 160     ACPI_SET_DESCRIPTOR_TYPE (Node, ACPI_DESC_TYPE_NAMED);
 161
 162     return_PTR (Node);
 163 }
 164
 165
 166 /*******************************************************************************
 167  *
 168  * FUNCTION:    AcpiNsDeleteNode
 169  *
 170  * PARAMETERS:  Node            - Node to be deleted
 171  *
 172  * RETURN:      None
 173  *
 174  * DESCRIPTION: Delete a namespace node
 175  *
 176  ******************************************************************************/
 177
 178 void
 179 AcpiNsDeleteNode (
 180     ACPI_NAMESPACE_NODE     *Node)
 181 {
 182     ACPI_NAMESPACE_NODE     *ParentNode;
 183     ACPI_NAMESPACE_NODE     *PrevNode;
 184     ACPI_NAMESPACE_NODE     *NextNode;
 185
 186
 187     ACPI_FUNCTION_TRACE_PTR ("NsDeleteNode", Node);
 188
 189
 190     ParentNode = AcpiNsGetParentNode (Node);
 191
 192     PrevNode = NULL;
 193     NextNode = ParentNode->Child;
 194
 195     /* Find the node that is the previous peer in the parent's child list */
 196
 197     while (NextNode != Node)
 198     {
 199         PrevNode = NextNode;
 200         NextNode = PrevNode->Peer;
 201     }
 202
 203     if (PrevNode)
 204     {
 205         /* Node is not first child, unlink it */
 206
 207         PrevNode->Peer = NextNode->Peer;
 208         if (NextNode->Flags & ANOBJ_END_OF_PEER_LIST)
 209         {
 210             PrevNode->Flags |= ANOBJ_END_OF_PEER_LIST;
 211         }
 212     }
 213     else
 214     {
 215         /* Node is first child (has no previous peer) */
 216
 217         if (NextNode->Flags & ANOBJ_END_OF_PEER_LIST)
 218         {
 219             /* No peers at all */
 220
 221             ParentNode->Child = NULL;
 222         }
 223         else
 224         {   /* Link peer list to parent */
 225
 226             ParentNode->Child = NextNode->Peer;
 227         }
 228     }
 229
 230
 231     ACPI_MEM_TRACKING (AcpiGbl_MemoryLists[ACPI_MEM_LIST_NSNODE].TotalFreed++);
 232
 233     /*
 234      * Detach an object if there is one then delete the node
 235      */
 236     AcpiNsDetachObject (Node);
 237     ACPI_MEM_FREE (Node);
 238     return_VOID;
 239 }
 240
 241
 242 #ifdef ACPI_ALPHABETIC_NAMESPACE
 243 /*******************************************************************************
 244  *
 245  * FUNCTION:    AcpiNsCompareNames
 246  *
 247  * PARAMETERS:  Name1           - First name to compare
 248  *              Name2           - Second name to compare
 249  *
 250  * RETURN:      value from strncmp
 251  *
 252  * DESCRIPTION: Compare two ACPI names.  Names that are prefixed with an
 253  *              underscore are forced to be alphabetically first.
 254  *
 255  ******************************************************************************/
 256
 257 int
 258 AcpiNsCompareNames (
 259     char                    *Name1,
 260     char                    *Name2)
 261 {
 262     char                    ReversedName1[ACPI_NAME_SIZE];
 263     char                    ReversedName2[ACPI_NAME_SIZE];
 264     UINT32                  i;
 265     UINT32                  j;
 266
 267
 268     /*
 269      * Replace all instances of "underscore" with a value that is smaller so
 270      * that all names that are prefixed with underscore(s) are alphabetically
 271      * first.
 272      *
 273      * Reverse the name bytewise so we can just do a 32-bit compare instead
 274      * of a strncmp.
 275      */
 276     for (i = 0, j= (ACPI_NAME_SIZE - 1); i < ACPI_NAME_SIZE; i++, j--)
 277     {
 278         ReversedName1[j] = Name1[i];
 279         if (Name1[i] == '_')
 280         {
 281             ReversedName1[j] = '*';
 282         }
 283
 284         ReversedName2[j] = Name2[i];
 285         if (Name2[i] == '_')
 286         {
 287             ReversedName2[j] = '*';
 288         }
 289     }
 290
 291     return (*(int *) ReversedName1 - *(int *) ReversedName2);
 292 }
 293 #endif
 294
 295
 296 /*******************************************************************************
 297  *
 298  * FUNCTION:    AcpiNsInstallNode
 299  *
 300  * PARAMETERS:  WalkState       - Current state of the walk
 301  *              ParentNode      - The parent of the new Node
 302  *              Node            - The new Node to install
 303  *              Type            - ACPI object type of the new Node
 304  *
 305  * RETURN:      None
 306  *
 307  * DESCRIPTION: Initialize a new namespace node and install it amongst
 308  *              its peers.
 309  *
 310  *              Note: Current namespace lookup is linear search.  However, the
 311  *              nodes are linked in alphabetical order to 1) put all reserved
 312  *              names (start with underscore) first, and to 2) make a readable
 313  *              namespace dump.
 314  *
 315  ******************************************************************************/
 316
 317 void
 318 AcpiNsInstallNode (
 319     ACPI_WALK_STATE         *WalkState,
 320     ACPI_NAMESPACE_NODE     *ParentNode,    /* Parent */
 321     ACPI_NAMESPACE_NODE     *Node,          /* New Child*/
 322     ACPI_OBJECT_TYPE        Type)
 323 {
 324     UINT16                  OwnerId = 0;
 325     ACPI_NAMESPACE_NODE     *ChildNode;
 326 #ifdef ACPI_ALPHABETIC_NAMESPACE
 327
 328     ACPI_NAMESPACE_NODE     *PreviousChildNode;
 329 #endif
 330
 331
 332     ACPI_FUNCTION_TRACE ("NsInstallNode");
 333
 334
 335     /*
 336      * Get the owner ID from the Walk state
 337      * The owner ID is used to track table deletion and
 338      * deletion of objects created by methods
 339      */
 340     if (WalkState)
 341     {
 342         OwnerId = WalkState->OwnerId;
 343     }
 344
 345     /* Link the new entry into the parent and existing children */
 346
 347     ChildNode = ParentNode->Child;
 348     if (!ChildNode)
 349     {
 350         ParentNode->Child = Node;
 351         Node->Flags |= ANOBJ_END_OF_PEER_LIST;
 352         Node->Peer = ParentNode;
 353     }
 354     else
 355     {
 356 #ifdef ACPI_ALPHABETIC_NAMESPACE
 357         /*
 358          * Walk the list whilst searching for the correct
 359          * alphabetic placement.
 360          */
 361         PreviousChildNode = NULL;
 362         while (AcpiNsCompareNames (AcpiUtGetNodeName (ChildNode), AcpiUtGetNodeName (Node)) < 0)
 363         {
 364             if (ChildNode->Flags & ANOBJ_END_OF_PEER_LIST)
 365             {
 366                 /* Last peer;  Clear end-of-list flag */
 367
 368                 ChildNode->Flags &= ~ANOBJ_END_OF_PEER_LIST;
 369
 370                 /* This node is the new peer to the child node */
 371
 372                 ChildNode->Peer = Node;
 373
 374                 /* This node is the new end-of-list */
 375
 376                 Node->Flags |= ANOBJ_END_OF_PEER_LIST;
 377                 Node->Peer = ParentNode;
 378                 break;
 379             }
 380
 381             /* Get next peer */
 382
 383             PreviousChildNode = ChildNode;
 384             ChildNode = ChildNode->Peer;
 385         }
 386
 387         /* Did the node get inserted at the end-of-list? */
 388
 389         if (!(Node->Flags & ANOBJ_END_OF_PEER_LIST))
 390         {
 391             /*
 392              * Loop above terminated without reaching the end-of-list.
 393              * Insert the new node at the current location
 394              */
 395             if (PreviousChildNode)
 396             {
 397                 /* Insert node alphabetically */
 398
 399                 Node->Peer = ChildNode;
 400                 PreviousChildNode->Peer = Node;
 401             }
 402             else
 403             {
 404                 /* Insert node alphabetically at start of list */
 405
 406                 Node->Peer = ChildNode;
 407                 ParentNode->Child = Node;
 408             }
 409         }
 410 #else
 411         while (!(ChildNode->Flags & ANOBJ_END_OF_PEER_LIST))
 412         {
 413             ChildNode = ChildNode->Peer;
 414         }
 415
 416         ChildNode->Peer = Node;
 417
 418         /* Clear end-of-list flag */
 419
 420         ChildNode->Flags &= ~ANOBJ_END_OF_PEER_LIST;
 421         Node->Flags     |= ANOBJ_END_OF_PEER_LIST;
 422         Node->Peer = ParentNode;
 423 #endif
 424     }
 425
 426     /* Init the new entry */
 427
 428     Node->OwnerId = OwnerId;
 429     Node->Type = (UINT8) Type;
 430
 431     ACPI_DEBUG_PRINT ((ACPI_DB_NAMES,
 432         "%4.4s (%s) [Node %p Owner %X] added to %4.4s (%s) [Node %p]\n",
 433         AcpiUtGetNodeName (Node), AcpiUtGetTypeName (Node->Type), Node, OwnerId,
 434         AcpiUtGetNodeName (ParentNode), AcpiUtGetTypeName (ParentNode->Type),
 435         ParentNode));
 436
 437     /*
 438      * Increment the reference count(s) of all parents up to
 439      * the root!
 440      */
 441     while ((Node = AcpiNsGetParentNode (Node)) != NULL)
 442     {
 443         Node->ReferenceCount++;
 444     }
 445
 446     return_VOID;
 447 }
 448
 449
 450 /*******************************************************************************
 451  *
 452  * FUNCTION:    AcpiNsDeleteChildren
 453  *
 454  * PARAMETERS:  ParentNode      - Delete this objects children
 455  *
 456  * RETURN:      None.
 457  *
 458  * DESCRIPTION: Delete all children of the parent object. In other words,
 459  *              deletes a "scope".
 460  *
 461  ******************************************************************************/
 462
 463 void
 464 AcpiNsDeleteChildren (
 465     ACPI_NAMESPACE_NODE     *ParentNode)
 466 {
 467     ACPI_NAMESPACE_NODE     *ChildNode;
 468     ACPI_NAMESPACE_NODE     *NextNode;
 469     ACPI_NAMESPACE_NODE     *Node;
 470     UINT8                   Flags;
 471
 472
 473     ACPI_FUNCTION_TRACE_PTR ("NsDeleteChildren", ParentNode);
 474
 475
 476     if (!ParentNode)
 477     {
 478         return_VOID;
 479     }
 480
 481     /* If no children, all done! */
 482
 483     ChildNode = ParentNode->Child;
 484     if (!ChildNode)
 485     {
 486         return_VOID;
 487     }
 488
 489     /*
 490      * Deallocate all children at this level
 491      */
 492     do
 493     {
 494         /* Get the things we need */
 495
 496         NextNode    = ChildNode->Peer;
 497         Flags       = ChildNode->Flags;
 498
 499         /* Grandchildren should have all been deleted already */
 500
 501         if (ChildNode->Child)
 502         {
 503             ACPI_DEBUG_PRINT ((ACPI_DB_ERROR, "Found a grandchild! P=%p C=%p\n",
 504                 ParentNode, ChildNode));
 505         }
 506
 507         /* Now we can free this child object */
 508
 509         ACPI_MEM_TRACKING (AcpiGbl_MemoryLists[ACPI_MEM_LIST_NSNODE].TotalFreed++);
 510
 511         ACPI_DEBUG_PRINT ((ACPI_DB_ALLOCATIONS, "Object %p, Remaining %X\n",
 512             ChildNode, AcpiGbl_CurrentNodeCount));
 513
 514         /*
 515          * Detach an object if there is one, then free the child node
 516          */
 517         AcpiNsDetachObject (ChildNode);
 518
 519         /*
 520          * Decrement the reference count(s) of all parents up to
 521          * the root! (counts were incremented when the node was created)
 522          */
 523         Node = ChildNode;
 524         while ((Node = AcpiNsGetParentNode (Node)) != NULL)
 525         {
 526             Node->ReferenceCount--;
 527         }
 528
 529         /* There should be only one reference remaining on this node */
 530
 531         if (ChildNode->ReferenceCount != 1)
 532         {
 533             ACPI_REPORT_WARNING (("Existing references (%d) on node being deleted (%p)\n",
 534                 ChildNode->ReferenceCount, ChildNode));
 535         }
 536
 537         /* Now we can delete the node */
 538
 539         ACPI_MEM_FREE (ChildNode);
 540
 541         /* And move on to the next child in the list */
 542
 543         ChildNode = NextNode;
 544
 545     } while (!(Flags & ANOBJ_END_OF_PEER_LIST));
 546
 547
 548     /* Clear the parent's child pointer */
 549
 550     ParentNode->Child = NULL;
 551
 552     return_VOID;
 553 }
 554
 555
 556 /*******************************************************************************
 557  *
 558  * FUNCTION:    AcpiNsDeleteNamespaceSubtree
 559  *
 560  * PARAMETERS:  ParentNode      - Root of the subtree to be deleted
 561  *
 562  * RETURN:      None.
 563  *
 564  * DESCRIPTION: Delete a subtree of the namespace.  This includes all objects
 565  *              stored within the subtree.
 566  *
 567  ******************************************************************************/
 568
 569 void
 570 AcpiNsDeleteNamespaceSubtree (
 571     ACPI_NAMESPACE_NODE     *ParentNode)
 572 {
 573     ACPI_NAMESPACE_NODE     *ChildNode = NULL;
 574     UINT32                  Level = 1;
 575
 576
 577     ACPI_FUNCTION_TRACE ("NsDeleteNamespaceSubtree");
 578
 579
 580     if (!ParentNode)
 581     {
 582         return_VOID;
 583     }
 584
 585     /*
 586      * Traverse the tree of objects until we bubble back up
 587      * to where we started.
 588      */
 589     while (Level > 0)
 590     {
 591         /* Get the next node in this scope (NULL if none) */
 592
 593         ChildNode = AcpiNsGetNextNode (ACPI_TYPE_ANY, ParentNode,
 594                                             ChildNode);
 595         if (ChildNode)
 596         {
 597             /* Found a child node - detach any attached object */
 598
 599             AcpiNsDetachObject (ChildNode);
 600
 601             /* Check if this node has any children */
 602
 603             if (AcpiNsGetNextNode (ACPI_TYPE_ANY, ChildNode, 0))
 604             {
 605                 /*
 606                  * There is at least one child of this node,
 607                  * visit the node
 608                  */
 609                 Level++;
 610                 ParentNode    = ChildNode;
 611                 ChildNode     = 0;
 612             }
 613         }
 614         else
 615         {
 616             /*
 617              * No more children of this parent node.
 618              * Move up to the grandparent.
 619              */
 620             Level--;
 621
 622             /*
 623              * Now delete all of the children of this parent
 624              * all at the same time.
 625              */
 626             AcpiNsDeleteChildren (ParentNode);
 627
 628             /* New "last child" is this parent node */
 629
 630             ChildNode = ParentNode;
 631
 632             /* Move up the tree to the grandparent */
 633
 634             ParentNode = AcpiNsGetParentNode (ParentNode);
 635         }
 636     }
 637
 638     return_VOID;
 639 }
 640
 641
 642 /*******************************************************************************
 643  *
 644  * FUNCTION:    AcpiNsRemoveReference
 645  *
 646  * PARAMETERS:  Node           - Named node whose reference count is to be
 647  *                               decremented
 648  *
 649  * RETURN:      None.
 650  *
 651  * DESCRIPTION: Remove a Node reference.  Decrements the reference count
 652  *              of all parent Nodes up to the root.  Any node along
 653  *              the way that reaches zero references is freed.
 654  *
 655  ******************************************************************************/
 656
 657 void
 658 AcpiNsRemoveReference (
 659     ACPI_NAMESPACE_NODE     *Node)
 660 {
 661     ACPI_NAMESPACE_NODE     *ParentNode;
 662     ACPI_NAMESPACE_NODE     *ThisNode;
 663
 664
 665     ACPI_FUNCTION_ENTRY ();
 666
 667
 668     /*
 669      * Decrement the reference count(s) of this node and all
 670      * nodes up to the root,  Delete anything with zero remaining references.
 671      */
 672     ThisNode = Node;
 673     while (ThisNode)
 674     {
 675         /* Prepare to move up to parent */
 676
 677         ParentNode = AcpiNsGetParentNode (ThisNode);
 678
 679         /* Decrement the reference count on this node */
 680
 681         ThisNode->ReferenceCount--;
 682
 683         /* Delete the node if no more references */
 684
 685         if (!ThisNode->ReferenceCount)
 686         {
 687             /* Delete all children and delete the node */
 688
 689             AcpiNsDeleteChildren (ThisNode);
 690             AcpiNsDeleteNode (ThisNode);
 691         }
 692
 693         ThisNode = ParentNode;
 694     }
 695 }
 696
 697
 698 /*******************************************************************************
 699  *
 700  * FUNCTION:    AcpiNsDeleteNamespaceByOwner
 701  *
 702  * PARAMETERS:  OwnerId     - All nodes with this owner will be deleted
 703  *
 704  * RETURN:      Status
 705  *
 706  * DESCRIPTION: Delete entries within the namespace that are owned by a
 707  *              specific ID.  Used to delete entire ACPI tables.  All
 708  *              reference counts are updated.
 709  *
 710  ******************************************************************************/
 711
 712 void
 713 AcpiNsDeleteNamespaceByOwner (
 714     UINT16                  OwnerId)
 715 {
 716     ACPI_NAMESPACE_NODE     *ChildNode;
 717     ACPI_NAMESPACE_NODE     *DeletionNode;
 718     UINT32                  Level;
 719     ACPI_NAMESPACE_NODE     *ParentNode;
 720
 721
 722     ACPI_FUNCTION_TRACE_U32 ("NsDeleteNamespaceByOwner", OwnerId);
 723
 724
 725     ParentNode    = AcpiGbl_RootNode;
 726     ChildNode     = NULL;
 727     DeletionNode  = NULL;
 728     Level         = 1;
 729
 730     /*
 731      * Traverse the tree of nodes until we bubble back up
 732      * to where we started.
 733      */
 734     while (Level > 0)
 735     {
 736         /*
 737          * Get the next child of this parent node. When ChildNode is NULL,
 738          * the first child of the parent is returned
 739          */
 740         ChildNode = AcpiNsGetNextNode (ACPI_TYPE_ANY, ParentNode, ChildNode);
 741
 742         if (DeletionNode)
 743         {
 744             AcpiNsRemoveReference (DeletionNode);
 745             DeletionNode = NULL;
 746         }
 747
 748         if (ChildNode)
 749         {
 750             if (ChildNode->OwnerId == OwnerId)
 751             {
 752                 /* Found a matching child node - detach any attached object */
 753
 754                 AcpiNsDetachObject (ChildNode);
 755             }
 756
 757             /* Check if this node has any children */
 758
 759             if (AcpiNsGetNextNode (ACPI_TYPE_ANY, ChildNode, NULL))
 760             {
 761                 /*
 762                  * There is at least one child of this node,
 763                  * visit the node
 764                  */
 765                 Level++;
 766                 ParentNode    = ChildNode;
 767                 ChildNode     = NULL;
 768             }
 769             else if (ChildNode->OwnerId == OwnerId)
 770             {
 771                 DeletionNode = ChildNode;
 772             }
 773         }
 774         else
 775         {
 776             /*
 777              * No more children of this parent node.
 778              * Move up to the grandparent.
 779              */
 780             Level--;
 781             if (Level != 0)
 782             {
 783                 if (ParentNode->OwnerId == OwnerId)
 784                 {
 785                     DeletionNode = ParentNode;
 786                 }
 787             }
 788
 789             /* New "last child" is this parent node */
 790
 791             ChildNode = ParentNode;
 792
 793             /* Move up the tree to the grandparent */
 794
 795             ParentNode = AcpiNsGetParentNode (ParentNode);
 796         }
 797     }
 798
 799     return_VOID;
 800 }
 801
 802