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