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