Branch data     Line data    Source code

       1                 :            : // SPDX-License-Identifier: BSD-3-Clause OR GPL-2.0
       2                 :            : /*******************************************************************************
       3                 :            :  *
       4                 :            :  * Module Name: nsxfobj - Public interfaces to the ACPI subsystem
       5                 :            :  *                         ACPI Object oriented interfaces
       6                 :            :  *
       7                 :            :  ******************************************************************************/
       8                 :            : 
       9                 :            : #define EXPORT_ACPI_INTERFACES
      10                 :            : 
      11                 :            : #include <acpi/acpi.h>
      12                 :            : #include "accommon.h"
      13                 :            : #include "acnamesp.h"
      14                 :            : 
      15                 :            : #define _COMPONENT          ACPI_NAMESPACE
      16                 :            : ACPI_MODULE_NAME("nsxfobj")
      17                 :            : 
      18                 :            : /*******************************************************************************
      19                 :            :  *
      20                 :            :  * FUNCTION:    acpi_get_type
      21                 :            :  *
      22                 :            :  * PARAMETERS:  handle          - Handle of object whose type is desired
      23                 :            :  *              ret_type        - Where the type will be placed
      24                 :            :  *
      25                 :            :  * RETURN:      Status
      26                 :            :  *
      27                 :            :  * DESCRIPTION: This routine returns the type associatd with a particular handle
      28                 :            :  *
      29                 :            :  ******************************************************************************/
      30                 :      23400 : acpi_status acpi_get_type(acpi_handle handle, acpi_object_type *ret_type)
      31                 :            : {
      32                 :      23400 :         struct acpi_namespace_node *node;
      33                 :      23400 :         acpi_status status;
      34                 :            : 
      35                 :            :         /* Parameter Validation */
      36                 :            : 
      37         [ +  - ]:      23400 :         if (!ret_type) {
      38                 :            :                 return (AE_BAD_PARAMETER);
      39                 :            :         }
      40                 :            : 
      41                 :            :         /* Special case for the predefined Root Node (return type ANY) */
      42                 :            : 
      43         [ +  + ]:      23400 :         if (handle == ACPI_ROOT_OBJECT) {
      44                 :         78 :                 *ret_type = ACPI_TYPE_ANY;
      45                 :         78 :                 return (AE_OK);
      46                 :            :         }
      47                 :            : 
      48                 :      23322 :         status = acpi_ut_acquire_mutex(ACPI_MTX_NAMESPACE);
      49         [ +  - ]:      23322 :         if (ACPI_FAILURE(status)) {
      50                 :            :                 return (status);
      51                 :            :         }
      52                 :            : 
      53                 :            :         /* Convert and validate the handle */
      54                 :            : 
      55                 :      23322 :         node = acpi_ns_validate_handle(handle);
      56         [ -  + ]:      23322 :         if (!node) {
      57                 :          0 :                 (void)acpi_ut_release_mutex(ACPI_MTX_NAMESPACE);
      58                 :          0 :                 return (AE_BAD_PARAMETER);
      59                 :            :         }
      60                 :            : 
      61                 :      23322 :         *ret_type = node->type;
      62                 :            : 
      63                 :      23322 :         status = acpi_ut_release_mutex(ACPI_MTX_NAMESPACE);
      64                 :      23322 :         return (status);
      65                 :            : }
      66                 :            : 
      67                 :            : ACPI_EXPORT_SYMBOL(acpi_get_type)
      68                 :            : 
      69                 :            : /*******************************************************************************
      70                 :            :  *
      71                 :            :  * FUNCTION:    acpi_get_parent
      72                 :            :  *
      73                 :            :  * PARAMETERS:  handle          - Handle of object whose parent is desired
      74                 :            :  *              ret_handle      - Where the parent handle will be placed
      75                 :            :  *
      76                 :            :  * RETURN:      Status
      77                 :            :  *
      78                 :            :  * DESCRIPTION: Returns a handle to the parent of the object represented by
      79                 :            :  *              Handle.
      80                 :            :  *
      81                 :            :  ******************************************************************************/
      82                 :      12870 : acpi_status acpi_get_parent(acpi_handle handle, acpi_handle *ret_handle)
      83                 :            : {
      84                 :      12870 :         struct acpi_namespace_node *node;
      85                 :      12870 :         struct acpi_namespace_node *parent_node;
      86                 :      12870 :         acpi_status status;
      87                 :            : 
      88         [ +  - ]:      12870 :         if (!ret_handle) {
      89                 :            :                 return (AE_BAD_PARAMETER);
      90                 :            :         }
      91                 :            : 
      92                 :            :         /* Special case for the predefined Root Node (no parent) */
      93                 :            : 
      94         [ +  + ]:      12870 :         if (handle == ACPI_ROOT_OBJECT) {
      95                 :            :                 return (AE_NULL_ENTRY);
      96                 :            :         }
      97                 :            : 
      98                 :      12792 :         status = acpi_ut_acquire_mutex(ACPI_MTX_NAMESPACE);
      99         [ +  - ]:      12792 :         if (ACPI_FAILURE(status)) {
     100                 :            :                 return (status);
     101                 :            :         }
     102                 :            : 
     103                 :            :         /* Convert and validate the handle */
     104                 :            : 
     105                 :      12792 :         node = acpi_ns_validate_handle(handle);
     106         [ -  + ]:      12792 :         if (!node) {
     107                 :          0 :                 status = AE_BAD_PARAMETER;
     108                 :          0 :                 goto unlock_and_exit;
     109                 :            :         }
     110                 :            : 
     111                 :            :         /* Get the parent entry */
     112                 :            : 
     113                 :      12792 :         parent_node = node->parent;
     114                 :      12792 :         *ret_handle = ACPI_CAST_PTR(acpi_handle, parent_node);
     115                 :            : 
     116                 :            :         /* Return exception if parent is null */
     117                 :            : 
     118         [ +  + ]:      12792 :         if (!parent_node) {
     119                 :        312 :                 status = AE_NULL_ENTRY;
     120                 :            :         }
     121                 :            : 
     122                 :      12480 : unlock_and_exit:
     123                 :            : 
     124                 :      12792 :         (void)acpi_ut_release_mutex(ACPI_MTX_NAMESPACE);
     125                 :      12792 :         return (status);
     126                 :            : }
     127                 :            : 
     128                 :            : ACPI_EXPORT_SYMBOL(acpi_get_parent)
     129                 :            : 
     130                 :            : /*******************************************************************************
     131                 :            :  *
     132                 :            :  * FUNCTION:    acpi_get_next_object
     133                 :            :  *
     134                 :            :  * PARAMETERS:  type            - Type of object to be searched for
     135                 :            :  *              parent          - Parent object whose children we are getting
     136                 :            :  *              last_child      - Previous child that was found.
     137                 :            :  *                                The NEXT child will be returned
     138                 :            :  *              ret_handle      - Where handle to the next object is placed
     139                 :            :  *
     140                 :            :  * RETURN:      Status
     141                 :            :  *
     142                 :            :  * DESCRIPTION: Return the next peer object within the namespace. If Handle is
     143                 :            :  *              valid, Scope is ignored. Otherwise, the first object within
     144                 :            :  *              Scope is returned.
     145                 :            :  *
     146                 :            :  ******************************************************************************/
     147                 :            : acpi_status
     148                 :          0 : acpi_get_next_object(acpi_object_type type,
     149                 :            :                      acpi_handle parent,
     150                 :            :                      acpi_handle child, acpi_handle *ret_handle)
     151                 :            : {
     152                 :          0 :         acpi_status status;
     153                 :          0 :         struct acpi_namespace_node *node;
     154                 :          0 :         struct acpi_namespace_node *parent_node = NULL;
     155                 :          0 :         struct acpi_namespace_node *child_node = NULL;
     156                 :            : 
     157                 :            :         /* Parameter validation */
     158                 :            : 
     159         [ #  # ]:          0 :         if (type > ACPI_TYPE_EXTERNAL_MAX) {
     160                 :            :                 return (AE_BAD_PARAMETER);
     161                 :            :         }
     162                 :            : 
     163                 :          0 :         status = acpi_ut_acquire_mutex(ACPI_MTX_NAMESPACE);
     164         [ #  # ]:          0 :         if (ACPI_FAILURE(status)) {
     165                 :            :                 return (status);
     166                 :            :         }
     167                 :            : 
     168                 :            :         /* If null handle, use the parent */
     169                 :            : 
     170         [ #  # ]:          0 :         if (!child) {
     171                 :            : 
     172                 :            :                 /* Start search at the beginning of the specified scope */
     173                 :            : 
     174                 :          0 :                 parent_node = acpi_ns_validate_handle(parent);
     175         [ #  # ]:          0 :                 if (!parent_node) {
     176                 :          0 :                         status = AE_BAD_PARAMETER;
     177                 :          0 :                         goto unlock_and_exit;
     178                 :            :                 }
     179                 :            :         } else {
     180                 :            :                 /* Non-null handle, ignore the parent */
     181                 :            :                 /* Convert and validate the handle */
     182                 :            : 
     183                 :          0 :                 child_node = acpi_ns_validate_handle(child);
     184         [ #  # ]:          0 :                 if (!child_node) {
     185                 :          0 :                         status = AE_BAD_PARAMETER;
     186                 :          0 :                         goto unlock_and_exit;
     187                 :            :                 }
     188                 :            :         }
     189                 :            : 
     190                 :            :         /* Internal function does the real work */
     191                 :            : 
     192                 :          0 :         node = acpi_ns_get_next_node_typed(type, parent_node, child_node);
     193         [ #  # ]:          0 :         if (!node) {
     194                 :          0 :                 status = AE_NOT_FOUND;
     195                 :          0 :                 goto unlock_and_exit;
     196                 :            :         }
     197                 :            : 
     198         [ #  # ]:          0 :         if (ret_handle) {
     199                 :          0 :                 *ret_handle = ACPI_CAST_PTR(acpi_handle, node);
     200                 :            :         }
     201                 :            : 
     202                 :          0 : unlock_and_exit:
     203                 :            : 
     204                 :          0 :         (void)acpi_ut_release_mutex(ACPI_MTX_NAMESPACE);
     205                 :          0 :         return (status);
     206                 :            : }
     207                 :            : 
     208                 :            : ACPI_EXPORT_SYMBOL(acpi_get_next_object)