3  * Module Name: rsxface - Public interfaces to the resource manager
11  * Some or all of this work - Copyright (c) 1999 - 2025, Intel Corp.
28  * 2.3. Intel grants Licensee a non-exclusive and non-transferable patent
104  * re-exports any such software from a foreign destination, Licensee shall
105  * ensure that the distribution and export/re-export of the software is in
108  * any of its subsidiaries will export/re-export any technical data, process,
130  * 3. Neither the names of the above-listed copyright holders nor the names
154 #include <contrib/dev/acpica/include/acpi.h>
155 #include <contrib/dev/acpica/include/accommon.h>
156 #include <contrib/dev/acpica/include/acresrc.h>
157 #include <contrib/dev/acpica/include/acnamesp.h>
162 /* Local macros for 16,32-bit to 64-bit conversion */
164 #define ACPI_COPY_FIELD(Out, In, Field)  ((Out)->Field = (In)->Field)
198  * PARAMETERS:  DeviceHandle    - Handle to a device
199  *              Buffer          - Pointer to a data buffer
200  *              ReturnNode      - Pointer to where the device node is returned
235     if (Node->Type != ACPI_TYPE_DEVICE)  in AcpiRsValidateParameters()
243      * if there is a non-zero buffer length we also need a valid pointer in  in AcpiRsValidateParameters()
262  * PARAMETERS:  DeviceHandle    - Handle to the Bus device we are querying
263  *              RetBuffer       - Pointer to a buffer to receive the
312  * PARAMETERS:  DeviceHandle    - Handle to the device object for the  in ACPI_EXPORT_SYMBOL()
314  *              RetBuffer       - Pointer to a buffer to receive the  in ACPI_EXPORT_SYMBOL()
363  * PARAMETERS:  DeviceHandle    - Handle to the device object for the  in ACPI_EXPORT_SYMBOL()
365  *              RetBuffer       - Pointer to a buffer to receive the  in ACPI_EXPORT_SYMBOL()
411  * PARAMETERS:  DeviceHandle    - Handle to the device object for the  in ACPI_EXPORT_SYMBOL()
413  *              InBuffer        - Pointer to a buffer containing the  in ACPI_EXPORT_SYMBOL()
440         (!InBuffer->Pointer) ||  in ACPI_EXPORT_SYMBOL()
441         (!InBuffer->Length))  in ACPI_EXPORT_SYMBOL()
465  * PARAMETERS:  DeviceHandle    - Handle to the device object for the  in ACPI_EXPORT_SYMBOL()
467  *              InBuffer        - Pointer to a buffer containing the  in ACPI_EXPORT_SYMBOL()
511  * PARAMETERS:  Resource        - Pointer to a resource  in ACPI_EXPORT_SYMBOL()
512  *              Out             - Pointer to the users's return buffer  in ACPI_EXPORT_SYMBOL()
519  *              caller from having to duplicate code for different-sized  in ACPI_EXPORT_SYMBOL()
540     switch (Resource->Type)  in ACPI_EXPORT_SYMBOL()
545             ACPI_RESOURCE_ADDRESS16, &Resource->Data);  in ACPI_EXPORT_SYMBOL()
552             ACPI_RESOURCE_ADDRESS32, &Resource->Data);  in ACPI_EXPORT_SYMBOL()
560         memcpy (Out, &Resource->Data, sizeof (ACPI_RESOURCE_ADDRESS64));  in ACPI_EXPORT_SYMBOL()
578  * PARAMETERS:  DeviceHandle    - Handle for the parent device object  in ACPI_EXPORT_SYMBOL()
579  *              Name            - Method name for the parent resource  in ACPI_EXPORT_SYMBOL()
581  *              Uuid            - Pointer to the UUID to be matched.  in ACPI_EXPORT_SYMBOL()
582  *                                includes both subtype and 16-byte UUID  in ACPI_EXPORT_SYMBOL()
583  *              RetBuffer       - Where the vendor resource is returned  in ACPI_EXPORT_SYMBOL()
588  *              vendor-defined resource that matches the supplied UUID and  in ACPI_EXPORT_SYMBOL()
589  *              UUID subtype. Returns a ACPI_RESOURCE of type Vendor.  in ACPI_EXPORT_SYMBOL()
597     ACPI_VENDOR_UUID        *Uuid,  in ACPI_EXPORT_SYMBOL()
606     if (!Uuid || !RetBuffer)  in ACPI_EXPORT_SYMBOL()
611     Info.Uuid = Uuid;  in ACPI_EXPORT_SYMBOL()
638  * DESCRIPTION: Match a vendor resource via the ACPI 3.0 UUID  in ACPI_EXPORT_SYMBOL()
655     if (Resource->Type != ACPI_RESOURCE_TYPE_VENDOR)  in ACPI_EXPORT_SYMBOL()
660     Vendor = &Resource->Data.VendorTyped;  in ACPI_EXPORT_SYMBOL()
665      * 1) Length of descriptor data must be at least as long as a UUID struct  in ACPI_EXPORT_SYMBOL()
666      * 2) The UUID subtypes must match  in ACPI_EXPORT_SYMBOL()
667      * 3) The UUID data must match  in ACPI_EXPORT_SYMBOL()
669     if ((Vendor->ByteLength < (ACPI_UUID_LENGTH + 1)) ||  in ACPI_EXPORT_SYMBOL()
670         (Vendor->UuidSubtype != Info->Uuid->Subtype)  ||  in ACPI_EXPORT_SYMBOL()
671         (memcmp (Vendor->Uuid, Info->Uuid->Data, ACPI_UUID_LENGTH)))  in ACPI_EXPORT_SYMBOL()
678     Buffer = Info->Buffer;  in ACPI_EXPORT_SYMBOL()
679     Status = AcpiUtInitializeBuffer (Buffer, Resource->Length);  in ACPI_EXPORT_SYMBOL()
687     memcpy (Buffer->Pointer, Resource, Resource->Length);  in ACPI_EXPORT_SYMBOL()
688     Buffer->Length = Resource->Length;  in ACPI_EXPORT_SYMBOL()
692     Info->Status = AE_OK;  in ACPI_EXPORT_SYMBOL()
701  * PARAMETERS:  Buffer          - Formatted buffer returned by one of the
703  *              UserFunction    - Called for each resource
704  *              Context         - Passed to UserFunction
729     if (!Buffer || !Buffer->Pointer || !UserFunction)  in AcpiWalkResourceBuffer()
736     Resource = ACPI_CAST_PTR (ACPI_RESOURCE, Buffer->Pointer);  in AcpiWalkResourceBuffer()
738         ACPI_RESOURCE, Buffer->Pointer, Buffer->Length);  in AcpiWalkResourceBuffer()
746         if (Resource->Type > ACPI_RESOURCE_TYPE_MAX)  in AcpiWalkResourceBuffer()
754         if (!Resource->Length)  in AcpiWalkResourceBuffer()
773         /* EndTag indicates end-of-list */  in AcpiWalkResourceBuffer()
775         if (Resource->Type == ACPI_RESOURCE_TYPE_END_TAG)  in AcpiWalkResourceBuffer()
795  * PARAMETERS:  DeviceHandle    - Handle to the device object for the  in ACPI_EXPORT_SYMBOL()
797  *              Name            - Method name of the resources we want.  in ACPI_EXPORT_SYMBOL()
800  *              UserFunction    - Called for each resource  in ACPI_EXPORT_SYMBOL()
801  *              Context         - Passed to UserFunction  in ACPI_EXPORT_SYMBOL()