nsutils.c revision 1.1.1.2.4.2
1 1.1.1.2.4.2 rmind /****************************************************************************** 2 1.1.1.2.4.2 rmind * 3 1.1.1.2.4.2 rmind * Module Name: nsutils - Utilities for accessing ACPI namespace, accessing 4 1.1.1.2.4.2 rmind * parents and siblings and Scope manipulation 5 1.1.1.2.4.2 rmind * 6 1.1.1.2.4.2 rmind *****************************************************************************/ 7 1.1.1.2.4.2 rmind 8 1.1.1.2.4.2 rmind /* 9 1.1.1.2.4.2 rmind * Copyright (C) 2000 - 2011, Intel Corp. 10 1.1.1.2.4.2 rmind * All rights reserved. 11 1.1.1.2.4.2 rmind * 12 1.1.1.2.4.2 rmind * Redistribution and use in source and binary forms, with or without 13 1.1.1.2.4.2 rmind * modification, are permitted provided that the following conditions 14 1.1.1.2.4.2 rmind * are met: 15 1.1.1.2.4.2 rmind * 1. Redistributions of source code must retain the above copyright 16 1.1.1.2.4.2 rmind * notice, this list of conditions, and the following disclaimer, 17 1.1.1.2.4.2 rmind * without modification. 18 1.1.1.2.4.2 rmind * 2. Redistributions in binary form must reproduce at minimum a disclaimer 19 1.1.1.2.4.2 rmind * substantially similar to the "NO WARRANTY" disclaimer below 20 1.1.1.2.4.2 rmind * ("Disclaimer") and any redistribution must be conditioned upon 21 1.1.1.2.4.2 rmind * including a substantially similar Disclaimer requirement for further 22 1.1.1.2.4.2 rmind * binary redistribution. 23 1.1.1.2.4.2 rmind * 3. Neither the names of the above-listed copyright holders nor the names 24 1.1.1.2.4.2 rmind * of any contributors may be used to endorse or promote products derived 25 1.1.1.2.4.2 rmind * from this software without specific prior written permission. 26 1.1.1.2.4.2 rmind * 27 1.1.1.2.4.2 rmind * Alternatively, this software may be distributed under the terms of the 28 1.1.1.2.4.2 rmind * GNU General Public License ("GPL") version 2 as published by the Free 29 1.1.1.2.4.2 rmind * Software Foundation. 30 1.1.1.2.4.2 rmind * 31 1.1.1.2.4.2 rmind * NO WARRANTY 32 1.1.1.2.4.2 rmind * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 33 1.1.1.2.4.2 rmind * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 34 1.1.1.2.4.2 rmind * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR 35 1.1.1.2.4.2 rmind * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 36 1.1.1.2.4.2 rmind * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 37 1.1.1.2.4.2 rmind * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 38 1.1.1.2.4.2 rmind * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 39 1.1.1.2.4.2 rmind * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, 40 1.1.1.2.4.2 rmind * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING 41 1.1.1.2.4.2 rmind * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 42 1.1.1.2.4.2 rmind * POSSIBILITY OF SUCH DAMAGES. 43 1.1.1.2.4.2 rmind */ 44 1.1.1.2.4.2 rmind 45 1.1.1.2.4.2 rmind #define __NSUTILS_C__ 46 1.1.1.2.4.2 rmind 47 1.1.1.2.4.2 rmind #include "acpi.h" 48 1.1.1.2.4.2 rmind #include "accommon.h" 49 1.1.1.2.4.2 rmind #include "acnamesp.h" 50 1.1.1.2.4.2 rmind #include "amlcode.h" 51 1.1.1.2.4.2 rmind 52 1.1.1.2.4.2 rmind #define _COMPONENT ACPI_NAMESPACE 53 1.1.1.2.4.2 rmind ACPI_MODULE_NAME ("nsutils") 54 1.1.1.2.4.2 rmind 55 1.1.1.2.4.2 rmind /* Local prototypes */ 56 1.1.1.2.4.2 rmind 57 1.1.1.2.4.2 rmind static BOOLEAN 58 1.1.1.2.4.2 rmind AcpiNsValidPathSeparator ( 59 1.1.1.2.4.2 rmind char Sep); 60 1.1.1.2.4.2 rmind 61 1.1.1.2.4.2 rmind #ifdef ACPI_OBSOLETE_FUNCTIONS 62 1.1.1.2.4.2 rmind ACPI_NAME 63 1.1.1.2.4.2 rmind AcpiNsFindParentName ( 64 1.1.1.2.4.2 rmind ACPI_NAMESPACE_NODE *NodeToSearch); 65 1.1.1.2.4.2 rmind #endif 66 1.1.1.2.4.2 rmind 67 1.1.1.2.4.2 rmind 68 1.1.1.2.4.2 rmind /******************************************************************************* 69 1.1.1.2.4.2 rmind * 70 1.1.1.2.4.2 rmind * FUNCTION: AcpiNsPrintNodePathname 71 1.1.1.2.4.2 rmind * 72 1.1.1.2.4.2 rmind * PARAMETERS: Node - Object 73 1.1.1.2.4.2 rmind * Message - Prefix message 74 1.1.1.2.4.2 rmind * 75 1.1.1.2.4.2 rmind * DESCRIPTION: Print an object's full namespace pathname 76 1.1.1.2.4.2 rmind * Manages allocation/freeing of a pathname buffer 77 1.1.1.2.4.2 rmind * 78 1.1.1.2.4.2 rmind ******************************************************************************/ 79 1.1.1.2.4.2 rmind 80 1.1.1.2.4.2 rmind void 81 1.1.1.2.4.2 rmind AcpiNsPrintNodePathname ( 82 1.1.1.2.4.2 rmind ACPI_NAMESPACE_NODE *Node, 83 1.1.1.2.4.2 rmind const char *Message) 84 1.1.1.2.4.2 rmind { 85 1.1.1.2.4.2 rmind ACPI_BUFFER Buffer; 86 1.1.1.2.4.2 rmind ACPI_STATUS Status; 87 1.1.1.2.4.2 rmind 88 1.1.1.2.4.2 rmind 89 1.1.1.2.4.2 rmind if (!Node) 90 1.1.1.2.4.2 rmind { 91 1.1.1.2.4.2 rmind AcpiOsPrintf ("[NULL NAME]"); 92 1.1.1.2.4.2 rmind return; 93 1.1.1.2.4.2 rmind } 94 1.1.1.2.4.2 rmind 95 1.1.1.2.4.2 rmind /* Convert handle to full pathname and print it (with supplied message) */ 96 1.1.1.2.4.2 rmind 97 1.1.1.2.4.2 rmind Buffer.Length = ACPI_ALLOCATE_LOCAL_BUFFER; 98 1.1.1.2.4.2 rmind 99 1.1.1.2.4.2 rmind Status = AcpiNsHandleToPathname (Node, &Buffer); 100 1.1.1.2.4.2 rmind if (ACPI_SUCCESS (Status)) 101 1.1.1.2.4.2 rmind { 102 1.1.1.2.4.2 rmind if (Message) 103 1.1.1.2.4.2 rmind { 104 1.1.1.2.4.2 rmind AcpiOsPrintf ("%s ", Message); 105 1.1.1.2.4.2 rmind } 106 1.1.1.2.4.2 rmind 107 1.1.1.2.4.2 rmind AcpiOsPrintf ("[%s] (Node %p)", (char *) Buffer.Pointer, Node); 108 1.1.1.2.4.2 rmind ACPI_FREE (Buffer.Pointer); 109 1.1.1.2.4.2 rmind } 110 1.1.1.2.4.2 rmind } 111 1.1.1.2.4.2 rmind 112 1.1.1.2.4.2 rmind 113 1.1.1.2.4.2 rmind /******************************************************************************* 114 1.1.1.2.4.2 rmind * 115 1.1.1.2.4.2 rmind * FUNCTION: AcpiNsValidRootPrefix 116 1.1.1.2.4.2 rmind * 117 1.1.1.2.4.2 rmind * PARAMETERS: Prefix - Character to be checked 118 1.1.1.2.4.2 rmind * 119 1.1.1.2.4.2 rmind * RETURN: TRUE if a valid prefix 120 1.1.1.2.4.2 rmind * 121 1.1.1.2.4.2 rmind * DESCRIPTION: Check if a character is a valid ACPI Root prefix 122 1.1.1.2.4.2 rmind * 123 1.1.1.2.4.2 rmind ******************************************************************************/ 124 1.1.1.2.4.2 rmind 125 1.1.1.2.4.2 rmind BOOLEAN 126 1.1.1.2.4.2 rmind AcpiNsValidRootPrefix ( 127 1.1.1.2.4.2 rmind char Prefix) 128 1.1.1.2.4.2 rmind { 129 1.1.1.2.4.2 rmind 130 1.1.1.2.4.2 rmind return ((BOOLEAN) (Prefix == '\\')); 131 1.1.1.2.4.2 rmind } 132 1.1.1.2.4.2 rmind 133 1.1.1.2.4.2 rmind 134 1.1.1.2.4.2 rmind /******************************************************************************* 135 1.1.1.2.4.2 rmind * 136 1.1.1.2.4.2 rmind * FUNCTION: AcpiNsValidPathSeparator 137 1.1.1.2.4.2 rmind * 138 1.1.1.2.4.2 rmind * PARAMETERS: Sep - Character to be checked 139 1.1.1.2.4.2 rmind * 140 1.1.1.2.4.2 rmind * RETURN: TRUE if a valid path separator 141 1.1.1.2.4.2 rmind * 142 1.1.1.2.4.2 rmind * DESCRIPTION: Check if a character is a valid ACPI path separator 143 1.1.1.2.4.2 rmind * 144 1.1.1.2.4.2 rmind ******************************************************************************/ 145 1.1.1.2.4.2 rmind 146 1.1.1.2.4.2 rmind static BOOLEAN 147 1.1.1.2.4.2 rmind AcpiNsValidPathSeparator ( 148 1.1.1.2.4.2 rmind char Sep) 149 1.1.1.2.4.2 rmind { 150 1.1.1.2.4.2 rmind 151 1.1.1.2.4.2 rmind return ((BOOLEAN) (Sep == '.')); 152 1.1.1.2.4.2 rmind } 153 1.1.1.2.4.2 rmind 154 1.1.1.2.4.2 rmind 155 1.1.1.2.4.2 rmind /******************************************************************************* 156 1.1.1.2.4.2 rmind * 157 1.1.1.2.4.2 rmind * FUNCTION: AcpiNsGetType 158 1.1.1.2.4.2 rmind * 159 1.1.1.2.4.2 rmind * PARAMETERS: Node - Parent Node to be examined 160 1.1.1.2.4.2 rmind * 161 1.1.1.2.4.2 rmind * RETURN: Type field from Node whose handle is passed 162 1.1.1.2.4.2 rmind * 163 1.1.1.2.4.2 rmind * DESCRIPTION: Return the type of a Namespace node 164 1.1.1.2.4.2 rmind * 165 1.1.1.2.4.2 rmind ******************************************************************************/ 166 1.1.1.2.4.2 rmind 167 1.1.1.2.4.2 rmind ACPI_OBJECT_TYPE 168 1.1.1.2.4.2 rmind AcpiNsGetType ( 169 1.1.1.2.4.2 rmind ACPI_NAMESPACE_NODE *Node) 170 1.1.1.2.4.2 rmind { 171 1.1.1.2.4.2 rmind ACPI_FUNCTION_TRACE (NsGetType); 172 1.1.1.2.4.2 rmind 173 1.1.1.2.4.2 rmind 174 1.1.1.2.4.2 rmind if (!Node) 175 1.1.1.2.4.2 rmind { 176 1.1.1.2.4.2 rmind ACPI_WARNING ((AE_INFO, "Null Node parameter")); 177 1.1.1.2.4.2 rmind return_UINT32 (ACPI_TYPE_ANY); 178 1.1.1.2.4.2 rmind } 179 1.1.1.2.4.2 rmind 180 1.1.1.2.4.2 rmind return_UINT32 ((ACPI_OBJECT_TYPE) Node->Type); 181 1.1.1.2.4.2 rmind } 182 1.1.1.2.4.2 rmind 183 1.1.1.2.4.2 rmind 184 1.1.1.2.4.2 rmind /******************************************************************************* 185 1.1.1.2.4.2 rmind * 186 1.1.1.2.4.2 rmind * FUNCTION: AcpiNsLocal 187 1.1.1.2.4.2 rmind * 188 1.1.1.2.4.2 rmind * PARAMETERS: Type - A namespace object type 189 1.1.1.2.4.2 rmind * 190 1.1.1.2.4.2 rmind * RETURN: LOCAL if names must be found locally in objects of the 191 1.1.1.2.4.2 rmind * passed type, 0 if enclosing scopes should be searched 192 1.1.1.2.4.2 rmind * 193 1.1.1.2.4.2 rmind * DESCRIPTION: Returns scope rule for the given object type. 194 1.1.1.2.4.2 rmind * 195 1.1.1.2.4.2 rmind ******************************************************************************/ 196 1.1.1.2.4.2 rmind 197 1.1.1.2.4.2 rmind UINT32 198 1.1.1.2.4.2 rmind AcpiNsLocal ( 199 1.1.1.2.4.2 rmind ACPI_OBJECT_TYPE Type) 200 1.1.1.2.4.2 rmind { 201 1.1.1.2.4.2 rmind ACPI_FUNCTION_TRACE (NsLocal); 202 1.1.1.2.4.2 rmind 203 1.1.1.2.4.2 rmind 204 1.1.1.2.4.2 rmind if (!AcpiUtValidObjectType (Type)) 205 1.1.1.2.4.2 rmind { 206 1.1.1.2.4.2 rmind /* Type code out of range */ 207 1.1.1.2.4.2 rmind 208 1.1.1.2.4.2 rmind ACPI_WARNING ((AE_INFO, "Invalid Object Type 0x%X", Type)); 209 1.1.1.2.4.2 rmind return_UINT32 (ACPI_NS_NORMAL); 210 1.1.1.2.4.2 rmind } 211 1.1.1.2.4.2 rmind 212 1.1.1.2.4.2 rmind return_UINT32 ((UINT32) AcpiGbl_NsProperties[Type] & ACPI_NS_LOCAL); 213 1.1.1.2.4.2 rmind } 214 1.1.1.2.4.2 rmind 215 1.1.1.2.4.2 rmind 216 1.1.1.2.4.2 rmind /******************************************************************************* 217 1.1.1.2.4.2 rmind * 218 1.1.1.2.4.2 rmind * FUNCTION: AcpiNsGetInternalNameLength 219 1.1.1.2.4.2 rmind * 220 1.1.1.2.4.2 rmind * PARAMETERS: Info - Info struct initialized with the 221 1.1.1.2.4.2 rmind * external name pointer. 222 1.1.1.2.4.2 rmind * 223 1.1.1.2.4.2 rmind * RETURN: None 224 1.1.1.2.4.2 rmind * 225 1.1.1.2.4.2 rmind * DESCRIPTION: Calculate the length of the internal (AML) namestring 226 1.1.1.2.4.2 rmind * corresponding to the external (ASL) namestring. 227 1.1.1.2.4.2 rmind * 228 1.1.1.2.4.2 rmind ******************************************************************************/ 229 1.1.1.2.4.2 rmind 230 1.1.1.2.4.2 rmind void 231 1.1.1.2.4.2 rmind AcpiNsGetInternalNameLength ( 232 1.1.1.2.4.2 rmind ACPI_NAMESTRING_INFO *Info) 233 1.1.1.2.4.2 rmind { 234 1.1.1.2.4.2 rmind const char *NextExternalChar; 235 1.1.1.2.4.2 rmind UINT32 i; 236 1.1.1.2.4.2 rmind 237 1.1.1.2.4.2 rmind 238 1.1.1.2.4.2 rmind ACPI_FUNCTION_ENTRY (); 239 1.1.1.2.4.2 rmind 240 1.1.1.2.4.2 rmind 241 1.1.1.2.4.2 rmind NextExternalChar = Info->ExternalName; 242 1.1.1.2.4.2 rmind Info->NumCarats = 0; 243 1.1.1.2.4.2 rmind Info->NumSegments = 0; 244 1.1.1.2.4.2 rmind Info->FullyQualified = FALSE; 245 1.1.1.2.4.2 rmind 246 1.1.1.2.4.2 rmind /* 247 1.1.1.2.4.2 rmind * For the internal name, the required length is 4 bytes per segment, plus 248 1.1.1.2.4.2 rmind * 1 each for RootPrefix, MultiNamePrefixOp, segment count, trailing null 249 1.1.1.2.4.2 rmind * (which is not really needed, but no there's harm in putting it there) 250 1.1.1.2.4.2 rmind * 251 1.1.1.2.4.2 rmind * strlen() + 1 covers the first NameSeg, which has no path separator 252 1.1.1.2.4.2 rmind */ 253 1.1.1.2.4.2 rmind if (AcpiNsValidRootPrefix (*NextExternalChar)) 254 1.1.1.2.4.2 rmind { 255 1.1.1.2.4.2 rmind Info->FullyQualified = TRUE; 256 1.1.1.2.4.2 rmind NextExternalChar++; 257 1.1.1.2.4.2 rmind 258 1.1.1.2.4.2 rmind /* Skip redundant RootPrefix, like \\_SB.PCI0.SBRG.EC0 */ 259 1.1.1.2.4.2 rmind 260 1.1.1.2.4.2 rmind while (AcpiNsValidRootPrefix (*NextExternalChar)) 261 1.1.1.2.4.2 rmind { 262 1.1.1.2.4.2 rmind NextExternalChar++; 263 1.1.1.2.4.2 rmind } 264 1.1.1.2.4.2 rmind } 265 1.1.1.2.4.2 rmind else 266 1.1.1.2.4.2 rmind { 267 1.1.1.2.4.2 rmind /* Handle Carat prefixes */ 268 1.1.1.2.4.2 rmind 269 1.1.1.2.4.2 rmind while (*NextExternalChar == '^') 270 1.1.1.2.4.2 rmind { 271 1.1.1.2.4.2 rmind Info->NumCarats++; 272 1.1.1.2.4.2 rmind NextExternalChar++; 273 1.1.1.2.4.2 rmind } 274 1.1.1.2.4.2 rmind } 275 1.1.1.2.4.2 rmind 276 1.1.1.2.4.2 rmind /* 277 1.1.1.2.4.2 rmind * Determine the number of ACPI name "segments" by counting the number of 278 1.1.1.2.4.2 rmind * path separators within the string. Start with one segment since the 279 1.1.1.2.4.2 rmind * segment count is [(# separators) + 1], and zero separators is ok. 280 1.1.1.2.4.2 rmind */ 281 1.1.1.2.4.2 rmind if (*NextExternalChar) 282 1.1.1.2.4.2 rmind { 283 1.1.1.2.4.2 rmind Info->NumSegments = 1; 284 1.1.1.2.4.2 rmind for (i = 0; NextExternalChar[i]; i++) 285 1.1.1.2.4.2 rmind { 286 1.1.1.2.4.2 rmind if (AcpiNsValidPathSeparator (NextExternalChar[i])) 287 1.1.1.2.4.2 rmind { 288 1.1.1.2.4.2 rmind Info->NumSegments++; 289 1.1.1.2.4.2 rmind } 290 1.1.1.2.4.2 rmind } 291 1.1.1.2.4.2 rmind } 292 1.1.1.2.4.2 rmind 293 1.1.1.2.4.2 rmind Info->Length = (ACPI_NAME_SIZE * Info->NumSegments) + 294 1.1.1.2.4.2 rmind 4 + Info->NumCarats; 295 1.1.1.2.4.2 rmind 296 1.1.1.2.4.2 rmind Info->NextExternalChar = NextExternalChar; 297 1.1.1.2.4.2 rmind } 298 1.1.1.2.4.2 rmind 299 1.1.1.2.4.2 rmind 300 1.1.1.2.4.2 rmind /******************************************************************************* 301 1.1.1.2.4.2 rmind * 302 1.1.1.2.4.2 rmind * FUNCTION: AcpiNsBuildInternalName 303 1.1.1.2.4.2 rmind * 304 1.1.1.2.4.2 rmind * PARAMETERS: Info - Info struct fully initialized 305 1.1.1.2.4.2 rmind * 306 1.1.1.2.4.2 rmind * RETURN: Status 307 1.1.1.2.4.2 rmind * 308 1.1.1.2.4.2 rmind * DESCRIPTION: Construct the internal (AML) namestring 309 1.1.1.2.4.2 rmind * corresponding to the external (ASL) namestring. 310 1.1.1.2.4.2 rmind * 311 1.1.1.2.4.2 rmind ******************************************************************************/ 312 1.1.1.2.4.2 rmind 313 1.1.1.2.4.2 rmind ACPI_STATUS 314 1.1.1.2.4.2 rmind AcpiNsBuildInternalName ( 315 1.1.1.2.4.2 rmind ACPI_NAMESTRING_INFO *Info) 316 1.1.1.2.4.2 rmind { 317 1.1.1.2.4.2 rmind UINT32 NumSegments = Info->NumSegments; 318 1.1.1.2.4.2 rmind char *InternalName = Info->InternalName; 319 1.1.1.2.4.2 rmind const char *ExternalName = Info->NextExternalChar; 320 1.1.1.2.4.2 rmind char *Result = NULL; 321 1.1.1.2.4.2 rmind UINT32 i; 322 1.1.1.2.4.2 rmind 323 1.1.1.2.4.2 rmind 324 1.1.1.2.4.2 rmind ACPI_FUNCTION_TRACE (NsBuildInternalName); 325 1.1.1.2.4.2 rmind 326 1.1.1.2.4.2 rmind 327 1.1.1.2.4.2 rmind /* Setup the correct prefixes, counts, and pointers */ 328 1.1.1.2.4.2 rmind 329 1.1.1.2.4.2 rmind if (Info->FullyQualified) 330 1.1.1.2.4.2 rmind { 331 1.1.1.2.4.2 rmind InternalName[0] = '\\'; 332 1.1.1.2.4.2 rmind 333 1.1.1.2.4.2 rmind if (NumSegments <= 1) 334 1.1.1.2.4.2 rmind { 335 1.1.1.2.4.2 rmind Result = &InternalName[1]; 336 1.1.1.2.4.2 rmind } 337 1.1.1.2.4.2 rmind else if (NumSegments == 2) 338 1.1.1.2.4.2 rmind { 339 1.1.1.2.4.2 rmind InternalName[1] = AML_DUAL_NAME_PREFIX; 340 1.1.1.2.4.2 rmind Result = &InternalName[2]; 341 1.1.1.2.4.2 rmind } 342 1.1.1.2.4.2 rmind else 343 1.1.1.2.4.2 rmind { 344 1.1.1.2.4.2 rmind InternalName[1] = AML_MULTI_NAME_PREFIX_OP; 345 1.1.1.2.4.2 rmind InternalName[2] = (char) NumSegments; 346 1.1.1.2.4.2 rmind Result = &InternalName[3]; 347 1.1.1.2.4.2 rmind } 348 1.1.1.2.4.2 rmind } 349 1.1.1.2.4.2 rmind else 350 1.1.1.2.4.2 rmind { 351 1.1.1.2.4.2 rmind /* 352 1.1.1.2.4.2 rmind * Not fully qualified. 353 1.1.1.2.4.2 rmind * Handle Carats first, then append the name segments 354 1.1.1.2.4.2 rmind */ 355 1.1.1.2.4.2 rmind i = 0; 356 1.1.1.2.4.2 rmind if (Info->NumCarats) 357 1.1.1.2.4.2 rmind { 358 1.1.1.2.4.2 rmind for (i = 0; i < Info->NumCarats; i++) 359 1.1.1.2.4.2 rmind { 360 1.1.1.2.4.2 rmind InternalName[i] = '^'; 361 1.1.1.2.4.2 rmind } 362 1.1.1.2.4.2 rmind } 363 1.1.1.2.4.2 rmind 364 1.1.1.2.4.2 rmind if (NumSegments <= 1) 365 1.1.1.2.4.2 rmind { 366 1.1.1.2.4.2 rmind Result = &InternalName[i]; 367 1.1.1.2.4.2 rmind } 368 1.1.1.2.4.2 rmind else if (NumSegments == 2) 369 1.1.1.2.4.2 rmind { 370 1.1.1.2.4.2 rmind InternalName[i] = AML_DUAL_NAME_PREFIX; 371 1.1.1.2.4.2 rmind Result = &InternalName[(ACPI_SIZE) i+1]; 372 1.1.1.2.4.2 rmind } 373 1.1.1.2.4.2 rmind else 374 1.1.1.2.4.2 rmind { 375 1.1.1.2.4.2 rmind InternalName[i] = AML_MULTI_NAME_PREFIX_OP; 376 1.1.1.2.4.2 rmind InternalName[(ACPI_SIZE) i+1] = (char) NumSegments; 377 1.1.1.2.4.2 rmind Result = &InternalName[(ACPI_SIZE) i+2]; 378 1.1.1.2.4.2 rmind } 379 1.1.1.2.4.2 rmind } 380 1.1.1.2.4.2 rmind 381 1.1.1.2.4.2 rmind /* Build the name (minus path separators) */ 382 1.1.1.2.4.2 rmind 383 1.1.1.2.4.2 rmind for (; NumSegments; NumSegments--) 384 1.1.1.2.4.2 rmind { 385 1.1.1.2.4.2 rmind for (i = 0; i < ACPI_NAME_SIZE; i++) 386 1.1.1.2.4.2 rmind { 387 1.1.1.2.4.2 rmind if (AcpiNsValidPathSeparator (*ExternalName) || 388 1.1.1.2.4.2 rmind (*ExternalName == 0)) 389 1.1.1.2.4.2 rmind { 390 1.1.1.2.4.2 rmind /* Pad the segment with underscore(s) if segment is short */ 391 1.1.1.2.4.2 rmind 392 1.1.1.2.4.2 rmind Result[i] = '_'; 393 1.1.1.2.4.2 rmind } 394 1.1.1.2.4.2 rmind else 395 1.1.1.2.4.2 rmind { 396 1.1.1.2.4.2 rmind /* Convert the character to uppercase and save it */ 397 1.1.1.2.4.2 rmind 398 1.1.1.2.4.2 rmind Result[i] = (char) ACPI_TOUPPER ((int) *ExternalName); 399 1.1.1.2.4.2 rmind ExternalName++; 400 1.1.1.2.4.2 rmind } 401 1.1.1.2.4.2 rmind } 402 1.1.1.2.4.2 rmind 403 1.1.1.2.4.2 rmind /* Now we must have a path separator, or the pathname is bad */ 404 1.1.1.2.4.2 rmind 405 1.1.1.2.4.2 rmind if (!AcpiNsValidPathSeparator (*ExternalName) && 406 1.1.1.2.4.2 rmind (*ExternalName != 0)) 407 1.1.1.2.4.2 rmind { 408 1.1.1.2.4.2 rmind return_ACPI_STATUS (AE_BAD_PARAMETER); 409 1.1.1.2.4.2 rmind } 410 1.1.1.2.4.2 rmind 411 1.1.1.2.4.2 rmind /* Move on the next segment */ 412 1.1.1.2.4.2 rmind 413 1.1.1.2.4.2 rmind ExternalName++; 414 1.1.1.2.4.2 rmind Result += ACPI_NAME_SIZE; 415 1.1.1.2.4.2 rmind } 416 1.1.1.2.4.2 rmind 417 1.1.1.2.4.2 rmind /* Terminate the string */ 418 1.1.1.2.4.2 rmind 419 1.1.1.2.4.2 rmind *Result = 0; 420 1.1.1.2.4.2 rmind 421 1.1.1.2.4.2 rmind if (Info->FullyQualified) 422 1.1.1.2.4.2 rmind { 423 1.1.1.2.4.2 rmind ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "Returning [%p] (abs) \"\\%s\"\n", 424 1.1.1.2.4.2 rmind InternalName, InternalName)); 425 1.1.1.2.4.2 rmind } 426 1.1.1.2.4.2 rmind else 427 1.1.1.2.4.2 rmind { 428 1.1.1.2.4.2 rmind ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "Returning [%p] (rel) \"%s\"\n", 429 1.1.1.2.4.2 rmind InternalName, InternalName)); 430 1.1.1.2.4.2 rmind } 431 1.1.1.2.4.2 rmind 432 1.1.1.2.4.2 rmind return_ACPI_STATUS (AE_OK); 433 1.1.1.2.4.2 rmind } 434 1.1.1.2.4.2 rmind 435 1.1.1.2.4.2 rmind 436 1.1.1.2.4.2 rmind /******************************************************************************* 437 1.1.1.2.4.2 rmind * 438 1.1.1.2.4.2 rmind * FUNCTION: AcpiNsInternalizeName 439 1.1.1.2.4.2 rmind * 440 1.1.1.2.4.2 rmind * PARAMETERS: *ExternalName - External representation of name 441 1.1.1.2.4.2 rmind * **Converted Name - Where to return the resulting 442 1.1.1.2.4.2 rmind * internal represention of the name 443 1.1.1.2.4.2 rmind * 444 1.1.1.2.4.2 rmind * RETURN: Status 445 1.1.1.2.4.2 rmind * 446 1.1.1.2.4.2 rmind * DESCRIPTION: Convert an external representation (e.g. "\_PR_.CPU0") 447 1.1.1.2.4.2 rmind * to internal form (e.g. 5c 2f 02 5f 50 52 5f 43 50 55 30) 448 1.1.1.2.4.2 rmind * 449 1.1.1.2.4.2 rmind *******************************************************************************/ 450 1.1.1.2.4.2 rmind 451 1.1.1.2.4.2 rmind ACPI_STATUS 452 1.1.1.2.4.2 rmind AcpiNsInternalizeName ( 453 1.1.1.2.4.2 rmind const char *ExternalName, 454 1.1.1.2.4.2 rmind char **ConvertedName) 455 1.1.1.2.4.2 rmind { 456 1.1.1.2.4.2 rmind char *InternalName; 457 1.1.1.2.4.2 rmind ACPI_NAMESTRING_INFO Info; 458 1.1.1.2.4.2 rmind ACPI_STATUS Status; 459 1.1.1.2.4.2 rmind 460 1.1.1.2.4.2 rmind 461 1.1.1.2.4.2 rmind ACPI_FUNCTION_TRACE (NsInternalizeName); 462 1.1.1.2.4.2 rmind 463 1.1.1.2.4.2 rmind 464 1.1.1.2.4.2 rmind if ((!ExternalName) || 465 1.1.1.2.4.2 rmind (*ExternalName == 0) || 466 1.1.1.2.4.2 rmind (!ConvertedName)) 467 1.1.1.2.4.2 rmind { 468 1.1.1.2.4.2 rmind return_ACPI_STATUS (AE_BAD_PARAMETER); 469 1.1.1.2.4.2 rmind } 470 1.1.1.2.4.2 rmind 471 1.1.1.2.4.2 rmind /* Get the length of the new internal name */ 472 1.1.1.2.4.2 rmind 473 1.1.1.2.4.2 rmind Info.ExternalName = ExternalName; 474 1.1.1.2.4.2 rmind AcpiNsGetInternalNameLength (&Info); 475 1.1.1.2.4.2 rmind 476 1.1.1.2.4.2 rmind /* We need a segment to store the internal name */ 477 1.1.1.2.4.2 rmind 478 1.1.1.2.4.2 rmind InternalName = ACPI_ALLOCATE_ZEROED (Info.Length); 479 1.1.1.2.4.2 rmind if (!InternalName) 480 1.1.1.2.4.2 rmind { 481 1.1.1.2.4.2 rmind return_ACPI_STATUS (AE_NO_MEMORY); 482 1.1.1.2.4.2 rmind } 483 1.1.1.2.4.2 rmind 484 1.1.1.2.4.2 rmind /* Build the name */ 485 1.1.1.2.4.2 rmind 486 1.1.1.2.4.2 rmind Info.InternalName = InternalName; 487 1.1.1.2.4.2 rmind Status = AcpiNsBuildInternalName (&Info); 488 1.1.1.2.4.2 rmind if (ACPI_FAILURE (Status)) 489 1.1.1.2.4.2 rmind { 490 1.1.1.2.4.2 rmind ACPI_FREE (InternalName); 491 1.1.1.2.4.2 rmind return_ACPI_STATUS (Status); 492 1.1.1.2.4.2 rmind } 493 1.1.1.2.4.2 rmind 494 1.1.1.2.4.2 rmind *ConvertedName = InternalName; 495 1.1.1.2.4.2 rmind return_ACPI_STATUS (AE_OK); 496 1.1.1.2.4.2 rmind } 497 1.1.1.2.4.2 rmind 498 1.1.1.2.4.2 rmind 499 1.1.1.2.4.2 rmind /******************************************************************************* 500 1.1.1.2.4.2 rmind * 501 1.1.1.2.4.2 rmind * FUNCTION: AcpiNsExternalizeName 502 1.1.1.2.4.2 rmind * 503 1.1.1.2.4.2 rmind * PARAMETERS: InternalNameLength - Lenth of the internal name below 504 1.1.1.2.4.2 rmind * InternalName - Internal representation of name 505 1.1.1.2.4.2 rmind * ConvertedNameLength - Where the length is returned 506 1.1.1.2.4.2 rmind * ConvertedName - Where the resulting external name 507 1.1.1.2.4.2 rmind * is returned 508 1.1.1.2.4.2 rmind * 509 1.1.1.2.4.2 rmind * RETURN: Status 510 1.1.1.2.4.2 rmind * 511 1.1.1.2.4.2 rmind * DESCRIPTION: Convert internal name (e.g. 5c 2f 02 5f 50 52 5f 43 50 55 30) 512 1.1.1.2.4.2 rmind * to its external (printable) form (e.g. "\_PR_.CPU0") 513 1.1.1.2.4.2 rmind * 514 1.1.1.2.4.2 rmind ******************************************************************************/ 515 1.1.1.2.4.2 rmind 516 1.1.1.2.4.2 rmind ACPI_STATUS 517 1.1.1.2.4.2 rmind AcpiNsExternalizeName ( 518 1.1.1.2.4.2 rmind UINT32 InternalNameLength, 519 1.1.1.2.4.2 rmind const char *InternalName, 520 1.1.1.2.4.2 rmind UINT32 *ConvertedNameLength, 521 1.1.1.2.4.2 rmind char **ConvertedName) 522 1.1.1.2.4.2 rmind { 523 1.1.1.2.4.2 rmind UINT32 NamesIndex = 0; 524 1.1.1.2.4.2 rmind UINT32 NumSegments = 0; 525 1.1.1.2.4.2 rmind UINT32 RequiredLength; 526 1.1.1.2.4.2 rmind UINT32 PrefixLength = 0; 527 1.1.1.2.4.2 rmind UINT32 i = 0; 528 1.1.1.2.4.2 rmind UINT32 j = 0; 529 1.1.1.2.4.2 rmind 530 1.1.1.2.4.2 rmind 531 1.1.1.2.4.2 rmind ACPI_FUNCTION_TRACE (NsExternalizeName); 532 1.1.1.2.4.2 rmind 533 1.1.1.2.4.2 rmind 534 1.1.1.2.4.2 rmind if (!InternalNameLength || 535 1.1.1.2.4.2 rmind !InternalName || 536 1.1.1.2.4.2 rmind !ConvertedName) 537 1.1.1.2.4.2 rmind { 538 1.1.1.2.4.2 rmind return_ACPI_STATUS (AE_BAD_PARAMETER); 539 1.1.1.2.4.2 rmind } 540 1.1.1.2.4.2 rmind 541 1.1.1.2.4.2 rmind /* Check for a prefix (one '\' | one or more '^') */ 542 1.1.1.2.4.2 rmind 543 1.1.1.2.4.2 rmind switch (InternalName[0]) 544 1.1.1.2.4.2 rmind { 545 1.1.1.2.4.2 rmind case '\\': 546 1.1.1.2.4.2 rmind PrefixLength = 1; 547 1.1.1.2.4.2 rmind break; 548 1.1.1.2.4.2 rmind 549 1.1.1.2.4.2 rmind case '^': 550 1.1.1.2.4.2 rmind for (i = 0; i < InternalNameLength; i++) 551 1.1.1.2.4.2 rmind { 552 1.1.1.2.4.2 rmind if (InternalName[i] == '^') 553 1.1.1.2.4.2 rmind { 554 1.1.1.2.4.2 rmind PrefixLength = i + 1; 555 1.1.1.2.4.2 rmind } 556 1.1.1.2.4.2 rmind else 557 1.1.1.2.4.2 rmind { 558 1.1.1.2.4.2 rmind break; 559 1.1.1.2.4.2 rmind } 560 1.1.1.2.4.2 rmind } 561 1.1.1.2.4.2 rmind 562 1.1.1.2.4.2 rmind if (i == InternalNameLength) 563 1.1.1.2.4.2 rmind { 564 1.1.1.2.4.2 rmind PrefixLength = i; 565 1.1.1.2.4.2 rmind } 566 1.1.1.2.4.2 rmind 567 1.1.1.2.4.2 rmind break; 568 1.1.1.2.4.2 rmind 569 1.1.1.2.4.2 rmind default: 570 1.1.1.2.4.2 rmind break; 571 1.1.1.2.4.2 rmind } 572 1.1.1.2.4.2 rmind 573 1.1.1.2.4.2 rmind /* 574 1.1.1.2.4.2 rmind * Check for object names. Note that there could be 0-255 of these 575 1.1.1.2.4.2 rmind * 4-byte elements. 576 1.1.1.2.4.2 rmind */ 577 1.1.1.2.4.2 rmind if (PrefixLength < InternalNameLength) 578 1.1.1.2.4.2 rmind { 579 1.1.1.2.4.2 rmind switch (InternalName[PrefixLength]) 580 1.1.1.2.4.2 rmind { 581 1.1.1.2.4.2 rmind case AML_MULTI_NAME_PREFIX_OP: 582 1.1.1.2.4.2 rmind 583 1.1.1.2.4.2 rmind /* <count> 4-byte names */ 584 1.1.1.2.4.2 rmind 585 1.1.1.2.4.2 rmind NamesIndex = PrefixLength + 2; 586 1.1.1.2.4.2 rmind NumSegments = (UINT8) 587 1.1.1.2.4.2 rmind InternalName[(ACPI_SIZE) PrefixLength + 1]; 588 1.1.1.2.4.2 rmind break; 589 1.1.1.2.4.2 rmind 590 1.1.1.2.4.2 rmind case AML_DUAL_NAME_PREFIX: 591 1.1.1.2.4.2 rmind 592 1.1.1.2.4.2 rmind /* Two 4-byte names */ 593 1.1.1.2.4.2 rmind 594 1.1.1.2.4.2 rmind NamesIndex = PrefixLength + 1; 595 1.1.1.2.4.2 rmind NumSegments = 2; 596 1.1.1.2.4.2 rmind break; 597 1.1.1.2.4.2 rmind 598 1.1.1.2.4.2 rmind case 0: 599 1.1.1.2.4.2 rmind 600 1.1.1.2.4.2 rmind /* NullName */ 601 1.1.1.2.4.2 rmind 602 1.1.1.2.4.2 rmind NamesIndex = 0; 603 1.1.1.2.4.2 rmind NumSegments = 0; 604 1.1.1.2.4.2 rmind break; 605 1.1.1.2.4.2 rmind 606 1.1.1.2.4.2 rmind default: 607 1.1.1.2.4.2 rmind 608 1.1.1.2.4.2 rmind /* one 4-byte name */ 609 1.1.1.2.4.2 rmind 610 1.1.1.2.4.2 rmind NamesIndex = PrefixLength; 611 1.1.1.2.4.2 rmind NumSegments = 1; 612 1.1.1.2.4.2 rmind break; 613 1.1.1.2.4.2 rmind } 614 1.1.1.2.4.2 rmind } 615 1.1.1.2.4.2 rmind 616 1.1.1.2.4.2 rmind /* 617 1.1.1.2.4.2 rmind * Calculate the length of ConvertedName, which equals the length 618 1.1.1.2.4.2 rmind * of the prefix, length of all object names, length of any required 619 1.1.1.2.4.2 rmind * punctuation ('.') between object names, plus the NULL terminator. 620 1.1.1.2.4.2 rmind */ 621 1.1.1.2.4.2 rmind RequiredLength = PrefixLength + (4 * NumSegments) + 622 1.1.1.2.4.2 rmind ((NumSegments > 0) ? (NumSegments - 1) : 0) + 1; 623 1.1.1.2.4.2 rmind 624 1.1.1.2.4.2 rmind /* 625 1.1.1.2.4.2 rmind * Check to see if we're still in bounds. If not, there's a problem 626 1.1.1.2.4.2 rmind * with InternalName (invalid format). 627 1.1.1.2.4.2 rmind */ 628 1.1.1.2.4.2 rmind if (RequiredLength > InternalNameLength) 629 1.1.1.2.4.2 rmind { 630 1.1.1.2.4.2 rmind ACPI_ERROR ((AE_INFO, "Invalid internal name")); 631 1.1.1.2.4.2 rmind return_ACPI_STATUS (AE_BAD_PATHNAME); 632 1.1.1.2.4.2 rmind } 633 1.1.1.2.4.2 rmind 634 1.1.1.2.4.2 rmind /* Build the ConvertedName */ 635 1.1.1.2.4.2 rmind 636 1.1.1.2.4.2 rmind *ConvertedName = ACPI_ALLOCATE_ZEROED (RequiredLength); 637 1.1.1.2.4.2 rmind if (!(*ConvertedName)) 638 1.1.1.2.4.2 rmind { 639 1.1.1.2.4.2 rmind return_ACPI_STATUS (AE_NO_MEMORY); 640 1.1.1.2.4.2 rmind } 641 1.1.1.2.4.2 rmind 642 1.1.1.2.4.2 rmind j = 0; 643 1.1.1.2.4.2 rmind 644 1.1.1.2.4.2 rmind for (i = 0; i < PrefixLength; i++) 645 1.1.1.2.4.2 rmind { 646 1.1.1.2.4.2 rmind (*ConvertedName)[j++] = InternalName[i]; 647 1.1.1.2.4.2 rmind } 648 1.1.1.2.4.2 rmind 649 1.1.1.2.4.2 rmind if (NumSegments > 0) 650 1.1.1.2.4.2 rmind { 651 1.1.1.2.4.2 rmind for (i = 0; i < NumSegments; i++) 652 1.1.1.2.4.2 rmind { 653 1.1.1.2.4.2 rmind if (i > 0) 654 1.1.1.2.4.2 rmind { 655 1.1.1.2.4.2 rmind (*ConvertedName)[j++] = '.'; 656 1.1.1.2.4.2 rmind } 657 1.1.1.2.4.2 rmind 658 1.1.1.2.4.2 rmind (*ConvertedName)[j++] = InternalName[NamesIndex++]; 659 1.1.1.2.4.2 rmind (*ConvertedName)[j++] = InternalName[NamesIndex++]; 660 1.1.1.2.4.2 rmind (*ConvertedName)[j++] = InternalName[NamesIndex++]; 661 1.1.1.2.4.2 rmind (*ConvertedName)[j++] = InternalName[NamesIndex++]; 662 1.1.1.2.4.2 rmind } 663 1.1.1.2.4.2 rmind } 664 1.1.1.2.4.2 rmind 665 1.1.1.2.4.2 rmind if (ConvertedNameLength) 666 1.1.1.2.4.2 rmind { 667 1.1.1.2.4.2 rmind *ConvertedNameLength = (UINT32) RequiredLength; 668 1.1.1.2.4.2 rmind } 669 1.1.1.2.4.2 rmind 670 1.1.1.2.4.2 rmind return_ACPI_STATUS (AE_OK); 671 1.1.1.2.4.2 rmind } 672 1.1.1.2.4.2 rmind 673 1.1.1.2.4.2 rmind 674 1.1.1.2.4.2 rmind /******************************************************************************* 675 1.1.1.2.4.2 rmind * 676 1.1.1.2.4.2 rmind * FUNCTION: AcpiNsValidateHandle 677 1.1.1.2.4.2 rmind * 678 1.1.1.2.4.2 rmind * PARAMETERS: Handle - Handle to be validated and typecast to a 679 1.1.1.2.4.2 rmind * namespace node. 680 1.1.1.2.4.2 rmind * 681 1.1.1.2.4.2 rmind * RETURN: A pointer to a namespace node 682 1.1.1.2.4.2 rmind * 683 1.1.1.2.4.2 rmind * DESCRIPTION: Convert a namespace handle to a namespace node. Handles special 684 1.1.1.2.4.2 rmind * cases for the root node. 685 1.1.1.2.4.2 rmind * 686 1.1.1.2.4.2 rmind * NOTE: Real integer handles would allow for more verification 687 1.1.1.2.4.2 rmind * and keep all pointers within this subsystem - however this introduces 688 1.1.1.2.4.2 rmind * more overhead and has not been necessary to this point. Drivers 689 1.1.1.2.4.2 rmind * holding handles are typically notified before a node becomes invalid 690 1.1.1.2.4.2 rmind * due to a table unload. 691 1.1.1.2.4.2 rmind * 692 1.1.1.2.4.2 rmind ******************************************************************************/ 693 1.1.1.2.4.2 rmind 694 1.1.1.2.4.2 rmind ACPI_NAMESPACE_NODE * 695 1.1.1.2.4.2 rmind AcpiNsValidateHandle ( 696 1.1.1.2.4.2 rmind ACPI_HANDLE Handle) 697 1.1.1.2.4.2 rmind { 698 1.1.1.2.4.2 rmind 699 1.1.1.2.4.2 rmind ACPI_FUNCTION_ENTRY (); 700 1.1.1.2.4.2 rmind 701 1.1.1.2.4.2 rmind 702 1.1.1.2.4.2 rmind /* Parameter validation */ 703 1.1.1.2.4.2 rmind 704 1.1.1.2.4.2 rmind if ((!Handle) || (Handle == ACPI_ROOT_OBJECT)) 705 1.1.1.2.4.2 rmind { 706 1.1.1.2.4.2 rmind return (AcpiGbl_RootNode); 707 1.1.1.2.4.2 rmind } 708 1.1.1.2.4.2 rmind 709 1.1.1.2.4.2 rmind /* We can at least attempt to verify the handle */ 710 1.1.1.2.4.2 rmind 711 1.1.1.2.4.2 rmind if (ACPI_GET_DESCRIPTOR_TYPE (Handle) != ACPI_DESC_TYPE_NAMED) 712 1.1.1.2.4.2 rmind { 713 1.1.1.2.4.2 rmind return (NULL); 714 1.1.1.2.4.2 rmind } 715 1.1.1.2.4.2 rmind 716 1.1.1.2.4.2 rmind return (ACPI_CAST_PTR (ACPI_NAMESPACE_NODE, Handle)); 717 1.1.1.2.4.2 rmind } 718 1.1.1.2.4.2 rmind 719 1.1.1.2.4.2 rmind 720 1.1.1.2.4.2 rmind /******************************************************************************* 721 1.1.1.2.4.2 rmind * 722 1.1.1.2.4.2 rmind * FUNCTION: AcpiNsTerminate 723 1.1.1.2.4.2 rmind * 724 1.1.1.2.4.2 rmind * PARAMETERS: none 725 1.1.1.2.4.2 rmind * 726 1.1.1.2.4.2 rmind * RETURN: none 727 1.1.1.2.4.2 rmind * 728 1.1.1.2.4.2 rmind * DESCRIPTION: free memory allocated for namespace and ACPI table storage. 729 1.1.1.2.4.2 rmind * 730 1.1.1.2.4.2 rmind ******************************************************************************/ 731 1.1.1.2.4.2 rmind 732 1.1.1.2.4.2 rmind void 733 1.1.1.2.4.2 rmind AcpiNsTerminate ( 734 1.1.1.2.4.2 rmind void) 735 1.1.1.2.4.2 rmind { 736 1.1.1.2.4.2 rmind ACPI_OPERAND_OBJECT *ObjDesc; 737 1.1.1.2.4.2 rmind 738 1.1.1.2.4.2 rmind 739 1.1.1.2.4.2 rmind ACPI_FUNCTION_TRACE (NsTerminate); 740 1.1.1.2.4.2 rmind 741 1.1.1.2.4.2 rmind 742 1.1.1.2.4.2 rmind /* 743 1.1.1.2.4.2 rmind * 1) Free the entire namespace -- all nodes and objects 744 1.1.1.2.4.2 rmind * 745 1.1.1.2.4.2 rmind * Delete all object descriptors attached to namepsace nodes 746 1.1.1.2.4.2 rmind */ 747 1.1.1.2.4.2 rmind AcpiNsDeleteNamespaceSubtree (AcpiGbl_RootNode); 748 1.1.1.2.4.2 rmind 749 1.1.1.2.4.2 rmind /* Detach any objects attached to the root */ 750 1.1.1.2.4.2 rmind 751 1.1.1.2.4.2 rmind ObjDesc = AcpiNsGetAttachedObject (AcpiGbl_RootNode); 752 1.1.1.2.4.2 rmind if (ObjDesc) 753 1.1.1.2.4.2 rmind { 754 1.1.1.2.4.2 rmind AcpiNsDetachObject (AcpiGbl_RootNode); 755 1.1.1.2.4.2 rmind } 756 1.1.1.2.4.2 rmind 757 1.1.1.2.4.2 rmind ACPI_DEBUG_PRINT ((ACPI_DB_INFO, "Namespace freed\n")); 758 1.1.1.2.4.2 rmind return_VOID; 759 1.1.1.2.4.2 rmind } 760 1.1.1.2.4.2 rmind 761 1.1.1.2.4.2 rmind 762 1.1.1.2.4.2 rmind /******************************************************************************* 763 1.1.1.2.4.2 rmind * 764 1.1.1.2.4.2 rmind * FUNCTION: AcpiNsOpensScope 765 1.1.1.2.4.2 rmind * 766 1.1.1.2.4.2 rmind * PARAMETERS: Type - A valid namespace type 767 1.1.1.2.4.2 rmind * 768 1.1.1.2.4.2 rmind * RETURN: NEWSCOPE if the passed type "opens a name scope" according 769 1.1.1.2.4.2 rmind * to the ACPI specification, else 0 770 1.1.1.2.4.2 rmind * 771 1.1.1.2.4.2 rmind ******************************************************************************/ 772 1.1.1.2.4.2 rmind 773 1.1.1.2.4.2 rmind UINT32 774 1.1.1.2.4.2 rmind AcpiNsOpensScope ( 775 1.1.1.2.4.2 rmind ACPI_OBJECT_TYPE Type) 776 1.1.1.2.4.2 rmind { 777 1.1.1.2.4.2 rmind ACPI_FUNCTION_TRACE_STR (NsOpensScope, AcpiUtGetTypeName (Type)); 778 1.1.1.2.4.2 rmind 779 1.1.1.2.4.2 rmind 780 1.1.1.2.4.2 rmind if (!AcpiUtValidObjectType (Type)) 781 1.1.1.2.4.2 rmind { 782 1.1.1.2.4.2 rmind /* type code out of range */ 783 1.1.1.2.4.2 rmind 784 1.1.1.2.4.2 rmind ACPI_WARNING ((AE_INFO, "Invalid Object Type 0x%X", Type)); 785 1.1.1.2.4.2 rmind return_UINT32 (ACPI_NS_NORMAL); 786 1.1.1.2.4.2 rmind } 787 1.1.1.2.4.2 rmind 788 1.1.1.2.4.2 rmind return_UINT32 (((UINT32) AcpiGbl_NsProperties[Type]) & ACPI_NS_NEWSCOPE); 789 1.1.1.2.4.2 rmind } 790 1.1.1.2.4.2 rmind 791 1.1.1.2.4.2 rmind 792 1.1.1.2.4.2 rmind /******************************************************************************* 793 1.1.1.2.4.2 rmind * 794 1.1.1.2.4.2 rmind * FUNCTION: AcpiNsGetNode 795 1.1.1.2.4.2 rmind * 796 1.1.1.2.4.2 rmind * PARAMETERS: *Pathname - Name to be found, in external (ASL) format. The 797 1.1.1.2.4.2 rmind * \ (backslash) and ^ (carat) prefixes, and the 798 1.1.1.2.4.2 rmind * . (period) to separate segments are supported. 799 1.1.1.2.4.2 rmind * PrefixNode - Root of subtree to be searched, or NS_ALL for the 800 1.1.1.2.4.2 rmind * root of the name space. If Name is fully 801 1.1.1.2.4.2 rmind * qualified (first INT8 is '\'), the passed value 802 1.1.1.2.4.2 rmind * of Scope will not be accessed. 803 1.1.1.2.4.2 rmind * Flags - Used to indicate whether to perform upsearch or 804 1.1.1.2.4.2 rmind * not. 805 1.1.1.2.4.2 rmind * ReturnNode - Where the Node is returned 806 1.1.1.2.4.2 rmind * 807 1.1.1.2.4.2 rmind * DESCRIPTION: Look up a name relative to a given scope and return the 808 1.1.1.2.4.2 rmind * corresponding Node. NOTE: Scope can be null. 809 1.1.1.2.4.2 rmind * 810 1.1.1.2.4.2 rmind * MUTEX: Locks namespace 811 1.1.1.2.4.2 rmind * 812 1.1.1.2.4.2 rmind ******************************************************************************/ 813 1.1.1.2.4.2 rmind 814 1.1.1.2.4.2 rmind ACPI_STATUS 815 1.1.1.2.4.2 rmind AcpiNsGetNode ( 816 1.1.1.2.4.2 rmind ACPI_NAMESPACE_NODE *PrefixNode, 817 1.1.1.2.4.2 rmind const char *Pathname, 818 1.1.1.2.4.2 rmind UINT32 Flags, 819 1.1.1.2.4.2 rmind ACPI_NAMESPACE_NODE **ReturnNode) 820 1.1.1.2.4.2 rmind { 821 1.1.1.2.4.2 rmind ACPI_GENERIC_STATE ScopeInfo; 822 1.1.1.2.4.2 rmind ACPI_STATUS Status; 823 1.1.1.2.4.2 rmind char *InternalPath; 824 1.1.1.2.4.2 rmind 825 1.1.1.2.4.2 rmind 826 1.1.1.2.4.2 rmind ACPI_FUNCTION_TRACE_PTR (NsGetNode, ACPI_CAST_PTR (char, Pathname)); 827 1.1.1.2.4.2 rmind 828 1.1.1.2.4.2 rmind 829 1.1.1.2.4.2 rmind if (!Pathname) 830 1.1.1.2.4.2 rmind { 831 1.1.1.2.4.2 rmind *ReturnNode = PrefixNode; 832 1.1.1.2.4.2 rmind if (!PrefixNode) 833 1.1.1.2.4.2 rmind { 834 1.1.1.2.4.2 rmind *ReturnNode = AcpiGbl_RootNode; 835 1.1.1.2.4.2 rmind } 836 1.1.1.2.4.2 rmind return_ACPI_STATUS (AE_OK); 837 1.1.1.2.4.2 rmind } 838 1.1.1.2.4.2 rmind 839 1.1.1.2.4.2 rmind /* Convert path to internal representation */ 840 1.1.1.2.4.2 rmind 841 1.1.1.2.4.2 rmind Status = AcpiNsInternalizeName (Pathname, &InternalPath); 842 1.1.1.2.4.2 rmind if (ACPI_FAILURE (Status)) 843 1.1.1.2.4.2 rmind { 844 1.1.1.2.4.2 rmind return_ACPI_STATUS (Status); 845 1.1.1.2.4.2 rmind } 846 1.1.1.2.4.2 rmind 847 1.1.1.2.4.2 rmind /* Must lock namespace during lookup */ 848 1.1.1.2.4.2 rmind 849 1.1.1.2.4.2 rmind Status = AcpiUtAcquireMutex (ACPI_MTX_NAMESPACE); 850 1.1.1.2.4.2 rmind if (ACPI_FAILURE (Status)) 851 1.1.1.2.4.2 rmind { 852 1.1.1.2.4.2 rmind goto Cleanup; 853 1.1.1.2.4.2 rmind } 854 1.1.1.2.4.2 rmind 855 1.1.1.2.4.2 rmind /* Setup lookup scope (search starting point) */ 856 1.1.1.2.4.2 rmind 857 1.1.1.2.4.2 rmind ScopeInfo.Scope.Node = PrefixNode; 858 1.1.1.2.4.2 rmind 859 1.1.1.2.4.2 rmind /* Lookup the name in the namespace */ 860 1.1.1.2.4.2 rmind 861 1.1.1.2.4.2 rmind Status = AcpiNsLookup (&ScopeInfo, InternalPath, ACPI_TYPE_ANY, 862 1.1.1.2.4.2 rmind ACPI_IMODE_EXECUTE, (Flags | ACPI_NS_DONT_OPEN_SCOPE), 863 1.1.1.2.4.2 rmind NULL, ReturnNode); 864 1.1.1.2.4.2 rmind if (ACPI_FAILURE (Status)) 865 1.1.1.2.4.2 rmind { 866 1.1.1.2.4.2 rmind ACPI_DEBUG_PRINT ((ACPI_DB_EXEC, "%s, %s\n", 867 1.1.1.2.4.2 rmind Pathname, AcpiFormatException (Status))); 868 1.1.1.2.4.2 rmind } 869 1.1.1.2.4.2 rmind 870 1.1.1.2.4.2 rmind (void) AcpiUtReleaseMutex (ACPI_MTX_NAMESPACE); 871 1.1.1.2.4.2 rmind 872 1.1.1.2.4.2 rmind Cleanup: 873 1.1.1.2.4.2 rmind ACPI_FREE (InternalPath); 874 1.1.1.2.4.2 rmind return_ACPI_STATUS (Status); 875 1.1.1.2.4.2 rmind } 876
Indexes created Tue Sep 30 20:09:53 GMT 2025