patch-2.4.22 linux-2.4.22/drivers/acpi/namespace/nsxfobj.c
Next file: linux-2.4.22/drivers/acpi/numa.c
Previous file: linux-2.4.22/drivers/acpi/namespace/nsxfname.c
Back to the patch index
Back to the overall index
- Lines: 761
- Date:
2003-08-25 04:44:41.000000000 -0700
- Orig file:
linux-2.4.21/drivers/acpi/namespace/nsxfobj.c
- Orig date:
2001-10-24 14:06:22.000000000 -0700
diff -urN linux-2.4.21/drivers/acpi/namespace/nsxfobj.c linux-2.4.22/drivers/acpi/namespace/nsxfobj.c
@@ -2,345 +2,60 @@
*
* Module Name: nsxfobj - Public interfaces to the ACPI subsystem
* ACPI Object oriented interfaces
- * $Revision: 95 $
*
******************************************************************************/
/*
- * Copyright (C) 2000, 2001 R. Byron Moore
+ * Copyright (C) 2000 - 2003, R. Byron Moore
+ * All rights reserved.
*
- * This program is free software; you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation; either version 2 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program; if not, write to the Free Software
- * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ * 1. Redistributions of source code must retain the above copyright
+ * notice, this list of conditions, and the following disclaimer,
+ * without modification.
+ * 2. Redistributions in binary form must reproduce at minimum a disclaimer
+ * substantially similar to the "NO WARRANTY" disclaimer below
+ * ("Disclaimer") and any redistribution must be conditioned upon
+ * including a substantially similar Disclaimer requirement for further
+ * binary redistribution.
+ * 3. Neither the names of the above-listed copyright holders nor the names
+ * of any contributors may be used to endorse or promote products derived
+ * from this software without specific prior written permission.
+ *
+ * Alternatively, this software may be distributed under the terms of the
+ * GNU General Public License ("GPL") version 2 as published by the Free
+ * Software Foundation.
+ *
+ * NO WARRANTY
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
+ * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+ * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+ * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+ * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
+ * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGES.
*/
-#include "acpi.h"
-#include "acinterp.h"
-#include "acnamesp.h"
-#include "acdispat.h"
+#include <acpi/acpi.h>
+#include <acpi/acnamesp.h>
#define _COMPONENT ACPI_NAMESPACE
- MODULE_NAME ("nsxfobj")
-
-
-/*******************************************************************************
- *
- * FUNCTION: Acpi_evaluate_object
- *
- * PARAMETERS: Handle - Object handle (optional)
- * *Pathname - Object pathname (optional)
- * **External_params - List of parameters to pass to method,
- * terminated by NULL. May be NULL
- * if no parameters are being passed.
- * *Return_buffer - Where to put method's return value (if
- * any). If NULL, no value is returned.
- *
- * RETURN: Status
- *
- * DESCRIPTION: Find and evaluate the given object, passing the given
- * parameters if necessary. One of "Handle" or "Pathname" must
- * be valid (non-null)
- *
- ******************************************************************************/
-
-acpi_status
-acpi_evaluate_object (
- acpi_handle handle,
- acpi_string pathname,
- acpi_object_list *external_params,
- acpi_buffer *return_buffer)
-{
- acpi_status status;
- acpi_operand_object **internal_params = NULL;
- acpi_operand_object *internal_return_obj = NULL;
- u32 buffer_space_needed;
- u32 user_buffer_length;
- u32 i;
-
-
- FUNCTION_TRACE ("Acpi_evaluate_object");
-
-
- /*
- * If there are parameters to be passed to the object
- * (which must be a control method), the external objects
- * must be converted to internal objects
- */
- if (external_params && external_params->count) {
- /*
- * Allocate a new parameter block for the internal objects
- * Add 1 to count to allow for null terminated internal list
- */
- internal_params = ACPI_MEM_CALLOCATE ((external_params->count + 1) * sizeof (void *));
- if (!internal_params) {
- return_ACPI_STATUS (AE_NO_MEMORY);
- }
-
-
- /*
- * Convert each external object in the list to an
- * internal object
- */
- for (i = 0; i < external_params->count; i++) {
- status = acpi_ut_copy_eobject_to_iobject (&external_params->pointer[i],
- &internal_params[i]);
-
- if (ACPI_FAILURE (status)) {
- acpi_ut_delete_internal_object_list (internal_params);
- return_ACPI_STATUS (status);
- }
- }
- internal_params[external_params->count] = NULL;
- }
-
-
- /*
- * Three major cases:
- * 1) Fully qualified pathname
- * 2) No handle, not fully qualified pathname (error)
- * 3) Valid handle
- */
- if ((pathname) &&
- (acpi_ns_valid_root_prefix (pathname[0]))) {
- /*
- * The path is fully qualified, just evaluate by name
- */
- status = acpi_ns_evaluate_by_name (pathname, internal_params, &internal_return_obj);
- }
-
- else if (!handle) {
- /*
- * A handle is optional iff a fully qualified pathname
- * is specified. Since we've already handled fully
- * qualified names above, this is an error
- */
- if (!pathname) {
- ACPI_DEBUG_PRINT ((ACPI_DB_ERROR, "Both Handle and Pathname are NULL\n"));
- }
-
- else {
- ACPI_DEBUG_PRINT ((ACPI_DB_ERROR, "Handle is NULL and Pathname is relative\n"));
- }
-
- status = AE_BAD_PARAMETER;
- }
-
- else {
- /*
- * We get here if we have a handle -- and if we have a
- * pathname it is relative. The handle will be validated
- * in the lower procedures
- */
- if (!pathname) {
- /*
- * The null pathname case means the handle is for
- * the actual object to be evaluated
- */
- status = acpi_ns_evaluate_by_handle (handle, internal_params, &internal_return_obj);
- }
-
- else {
- /*
- * Both a Handle and a relative Pathname
- */
- status = acpi_ns_evaluate_relative (handle, pathname, internal_params,
- &internal_return_obj);
- }
- }
-
-
- /*
- * If we are expecting a return value, and all went well above,
- * copy the return value to an external object.
- */
-
- if (return_buffer) {
- user_buffer_length = return_buffer->length;
- return_buffer->length = 0;
-
- if (internal_return_obj) {
- if (VALID_DESCRIPTOR_TYPE (internal_return_obj, ACPI_DESC_TYPE_NAMED)) {
- /*
- * If we got an Node as a return object,
- * this means the object we are evaluating
- * has nothing interesting to return (such
- * as a mutex, etc.) We return an error
- * because these types are essentially
- * unsupported by this interface. We
- * don't check up front because this makes
- * it easier to add support for various
- * types at a later date if necessary.
- */
- status = AE_TYPE;
- internal_return_obj = NULL; /* No need to delete an Node */
- }
-
- if (ACPI_SUCCESS (status)) {
- /*
- * Find out how large a buffer is needed
- * to contain the returned object
- */
- status = acpi_ut_get_object_size (internal_return_obj,
- &buffer_space_needed);
- if (ACPI_SUCCESS (status)) {
- /*
- * Check if there is enough room in the
- * caller's buffer
- */
- if (user_buffer_length < buffer_space_needed) {
- /*
- * Caller's buffer is too small, can't
- * give him partial results fail the call
- * but return the buffer size needed
- */
- ACPI_DEBUG_PRINT ((ACPI_DB_INFO,
- "Needed buffer size %X, received %X\n",
- buffer_space_needed, user_buffer_length));
-
- return_buffer->length = buffer_space_needed;
- status = AE_BUFFER_OVERFLOW;
- }
-
- else {
- /*
- * We have enough space for the object, build it
- */
- status = acpi_ut_copy_iobject_to_eobject (internal_return_obj,
- return_buffer);
- return_buffer->length = buffer_space_needed;
- }
- }
- }
- }
- }
-
-
- /* Delete the return and parameter objects */
-
- if (internal_return_obj) {
- /*
- * Delete the internal return object. (Or at least
- * decrement the reference count by one)
- */
- acpi_ut_remove_reference (internal_return_obj);
- }
-
- /*
- * Free the input parameter list (if we created one),
- */
- if (internal_params) {
- /* Free the allocated parameter block */
-
- acpi_ut_delete_internal_object_list (internal_params);
- }
-
- return_ACPI_STATUS (status);
-}
-
+ ACPI_MODULE_NAME ("nsxfobj")
/*******************************************************************************
*
- * FUNCTION: Acpi_get_next_object
- *
- * PARAMETERS: Type - Type of object to be searched for
- * Parent - Parent object whose children we are getting
- * Last_child - Previous child that was found.
- * The NEXT child will be returned
- * Ret_handle - Where handle to the next object is placed
- *
- * RETURN: Status
- *
- * DESCRIPTION: Return the next peer object within the namespace. If Handle is
- * valid, Scope is ignored. Otherwise, the first object within
- * Scope is returned.
- *
- ******************************************************************************/
-
-acpi_status
-acpi_get_next_object (
- acpi_object_type type,
- acpi_handle parent,
- acpi_handle child,
- acpi_handle *ret_handle)
-{
- acpi_status status = AE_OK;
- acpi_namespace_node *node;
- acpi_namespace_node *parent_node = NULL;
- acpi_namespace_node *child_node = NULL;
-
-
- /* Parameter validation */
-
- if (type > ACPI_TYPE_MAX) {
- return (AE_BAD_PARAMETER);
- }
-
- acpi_ut_acquire_mutex (ACPI_MTX_NAMESPACE);
-
- /* If null handle, use the parent */
-
- if (!child) {
- /* Start search at the beginning of the specified scope */
-
- parent_node = acpi_ns_map_handle_to_node (parent);
- if (!parent_node) {
- status = AE_BAD_PARAMETER;
- goto unlock_and_exit;
- }
- }
-
- /* Non-null handle, ignore the parent */
-
- else {
- /* Convert and validate the handle */
-
- child_node = acpi_ns_map_handle_to_node (child);
- if (!child_node) {
- status = AE_BAD_PARAMETER;
- goto unlock_and_exit;
- }
- }
-
-
- /* Internal function does the real work */
-
- node = acpi_ns_get_next_node ((acpi_object_type8) type,
- parent_node, child_node);
- if (!node) {
- status = AE_NOT_FOUND;
- goto unlock_and_exit;
- }
-
- if (ret_handle) {
- *ret_handle = acpi_ns_convert_entry_to_handle (node);
- }
-
-
-unlock_and_exit:
-
- acpi_ut_release_mutex (ACPI_MTX_NAMESPACE);
- return (status);
-}
-
-
-/*******************************************************************************
- *
- * FUNCTION: Acpi_get_type
+ * FUNCTION: acpi_get_type
*
* PARAMETERS: Handle - Handle of object whose type is desired
- * *Ret_type - Where the type will be placed
+ * *ret_type - Where the type will be placed
*
* RETURN: Status
*
@@ -350,10 +65,11 @@
acpi_status
acpi_get_type (
- acpi_handle handle,
- acpi_object_type *ret_type)
+ acpi_handle handle,
+ acpi_object_type *ret_type)
{
- acpi_namespace_node *node;
+ struct acpi_namespace_node *node;
+ acpi_status status;
/* Parameter Validation */
@@ -371,30 +87,33 @@
return (AE_OK);
}
- acpi_ut_acquire_mutex (ACPI_MTX_NAMESPACE);
+ status = acpi_ut_acquire_mutex (ACPI_MTX_NAMESPACE);
+ if (ACPI_FAILURE (status)) {
+ return (status);
+ }
/* Convert and validate the handle */
node = acpi_ns_map_handle_to_node (handle);
if (!node) {
- acpi_ut_release_mutex (ACPI_MTX_NAMESPACE);
+ (void) acpi_ut_release_mutex (ACPI_MTX_NAMESPACE);
return (AE_BAD_PARAMETER);
}
*ret_type = node->type;
- acpi_ut_release_mutex (ACPI_MTX_NAMESPACE);
- return (AE_OK);
+ status = acpi_ut_release_mutex (ACPI_MTX_NAMESPACE);
+ return (status);
}
/*******************************************************************************
*
- * FUNCTION: Acpi_get_parent
+ * FUNCTION: acpi_get_parent
*
* PARAMETERS: Handle - Handle of object whose parent is desired
- * Ret_handle - Where the parent handle will be placed
+ * ret_handle - Where the parent handle will be placed
*
* RETURN: Status
*
@@ -405,11 +124,11 @@
acpi_status
acpi_get_parent (
- acpi_handle handle,
- acpi_handle *ret_handle)
+ acpi_handle handle,
+ acpi_handle *ret_handle)
{
- acpi_namespace_node *node;
- acpi_status status = AE_OK;
+ struct acpi_namespace_node *node;
+ acpi_status status;
if (!ret_handle) {
@@ -422,8 +141,10 @@
return (AE_NULL_ENTRY);
}
-
- acpi_ut_acquire_mutex (ACPI_MTX_NAMESPACE);
+ status = acpi_ut_acquire_mutex (ACPI_MTX_NAMESPACE);
+ if (ACPI_FAILURE (status)) {
+ return (status);
+ }
/* Convert and validate the handle */
@@ -433,237 +154,106 @@
goto unlock_and_exit;
}
-
/* Get the parent entry */
*ret_handle =
- acpi_ns_convert_entry_to_handle (acpi_ns_get_parent_object (node));
+ acpi_ns_convert_entry_to_handle (acpi_ns_get_parent_node (node));
- /* Return exeption if parent is null */
+ /* Return exception if parent is null */
- if (!acpi_ns_get_parent_object (node)) {
+ if (!acpi_ns_get_parent_node (node)) {
status = AE_NULL_ENTRY;
}
unlock_and_exit:
- acpi_ut_release_mutex (ACPI_MTX_NAMESPACE);
+ (void) acpi_ut_release_mutex (ACPI_MTX_NAMESPACE);
return (status);
}
/*******************************************************************************
*
- * FUNCTION: Acpi_walk_namespace
- *
- * PARAMETERS: Type - acpi_object_type to search for
- * Start_object - Handle in namespace where search begins
- * Max_depth - Depth to which search is to reach
- * User_function - Called when an object of "Type" is found
- * Context - Passed to user function
- * Return_value - Location where return value of
- * User_function is put if terminated early
- *
- * RETURNS Return value from the User_function if terminated early.
- * Otherwise, returns NULL.
- *
- * DESCRIPTION: Performs a modified depth-first walk of the namespace tree,
- * starting (and ending) at the object specified by Start_handle.
- * The User_function is called whenever an object that matches
- * the type parameter is found. If the user function returns
- * a non-zero value, the search is terminated immediately and this
- * value is returned to the caller.
- *
- * The point of this procedure is to provide a generic namespace
- * walk routine that can be called from multiple places to
- * provide multiple services; the User Function can be tailored
- * to each task, whether it is a print function, a compare
- * function, etc.
+ * FUNCTION: acpi_get_next_object
*
- ******************************************************************************/
-
-acpi_status
-acpi_walk_namespace (
- acpi_object_type type,
- acpi_handle start_object,
- u32 max_depth,
- acpi_walk_callback user_function,
- void *context,
- void **return_value)
-{
- acpi_status status;
-
-
- FUNCTION_TRACE ("Acpi_walk_namespace");
-
-
- /* Parameter validation */
-
- if ((type > ACPI_TYPE_MAX) ||
- (!max_depth) ||
- (!user_function)) {
- return_ACPI_STATUS (AE_BAD_PARAMETER);
- }
-
- /*
- * Lock the namespace around the walk.
- * The namespace will be unlocked/locked around each call
- * to the user function - since this function
- * must be allowed to make Acpi calls itself.
- */
- acpi_ut_acquire_mutex (ACPI_MTX_NAMESPACE);
- status = acpi_ns_walk_namespace ((acpi_object_type8) type, start_object,
- max_depth, NS_WALK_UNLOCK, user_function, context,
- return_value);
-
- acpi_ut_release_mutex (ACPI_MTX_NAMESPACE);
-
- return_ACPI_STATUS (status);
-}
-
-
-/*******************************************************************************
- *
- * FUNCTION: Acpi_ns_get_device_callback
- *
- * PARAMETERS: Callback from Acpi_get_device
+ * PARAMETERS: Type - Type of object to be searched for
+ * Parent - Parent object whose children we are getting
+ * last_child - Previous child that was found.
+ * The NEXT child will be returned
+ * ret_handle - Where handle to the next object is placed
*
* RETURN: Status
*
- * DESCRIPTION: Takes callbacks from Walk_namespace and filters out all non-
- * present devices, or if they specified a HID, it filters based
- * on that.
+ * DESCRIPTION: Return the next peer object within the namespace. If Handle is
+ * valid, Scope is ignored. Otherwise, the first object within
+ * Scope is returned.
*
******************************************************************************/
-static acpi_status
-acpi_ns_get_device_callback (
- acpi_handle obj_handle,
- u32 nesting_level,
- void *context,
- void **return_value)
+acpi_status
+acpi_get_next_object (
+ acpi_object_type type,
+ acpi_handle parent,
+ acpi_handle child,
+ acpi_handle *ret_handle)
{
- acpi_status status;
- acpi_namespace_node *node;
- u32 flags;
- acpi_device_id device_id;
- acpi_get_devices_info *info;
+ acpi_status status;
+ struct acpi_namespace_node *node;
+ struct acpi_namespace_node *parent_node = NULL;
+ struct acpi_namespace_node *child_node = NULL;
- info = context;
-
- acpi_ut_acquire_mutex (ACPI_MTX_NAMESPACE);
- node = acpi_ns_map_handle_to_node (obj_handle);
- acpi_ut_release_mutex (ACPI_MTX_NAMESPACE);
+ /* Parameter validation */
- if (!node) {
+ if (type > ACPI_TYPE_EXTERNAL_MAX) {
return (AE_BAD_PARAMETER);
}
- /*
- * Run _STA to determine if device is present
- */
- status = acpi_ut_execute_STA (node, &flags);
+ status = acpi_ut_acquire_mutex (ACPI_MTX_NAMESPACE);
if (ACPI_FAILURE (status)) {
- return (AE_CTRL_DEPTH);
+ return (status);
}
- if (!(flags & 0x01)) {
- /* don't return at the device or children of the device if not there */
- return (AE_CTRL_DEPTH);
- }
+ /* If null handle, use the parent */
- /*
- * Filter based on device HID
- */
- if (info->hid != NULL) {
- status = acpi_ut_execute_HID (node, &device_id);
- if (status == AE_NOT_FOUND) {
- return (AE_OK);
- }
+ if (!child) {
+ /* Start search at the beginning of the specified scope */
- else if (ACPI_FAILURE (status)) {
- return (AE_CTRL_DEPTH);
+ parent_node = acpi_ns_map_handle_to_node (parent);
+ if (!parent_node) {
+ status = AE_BAD_PARAMETER;
+ goto unlock_and_exit;
}
+ }
+ else {
+ /* Non-null handle, ignore the parent */
+ /* Convert and validate the handle */
- if (STRNCMP (device_id.buffer, info->hid, sizeof (device_id.buffer)) != 0) {
- return (AE_OK);
+ child_node = acpi_ns_map_handle_to_node (child);
+ if (!child_node) {
+ status = AE_BAD_PARAMETER;
+ goto unlock_and_exit;
}
}
- info->user_function (obj_handle, nesting_level, info->context, return_value);
- return (AE_OK);
-}
-
-
-/*******************************************************************************
- *
- * FUNCTION: Acpi_get_devices
- *
- * PARAMETERS: HID - HID to search for. Can be NULL.
- * User_function - Called when a matching object is found
- * Context - Passed to user function
- * Return_value - Location where return value of
- * User_function is put if terminated early
- *
- * RETURNS Return value from the User_function if terminated early.
- * Otherwise, returns NULL.
- *
- * DESCRIPTION: Performs a modified depth-first walk of the namespace tree,
- * starting (and ending) at the object specified by Start_handle.
- * The User_function is called whenever an object that matches
- * the type parameter is found. If the user function returns
- * a non-zero value, the search is terminated immediately and this
- * value is returned to the caller.
- *
- * This is a wrapper for Walk_namespace, but the callback performs
- * additional filtering. Please see Acpi_get_device_callback.
- *
- ******************************************************************************/
-
-acpi_status
-acpi_get_devices (
- NATIVE_CHAR *HID,
- acpi_walk_callback user_function,
- void *context,
- void **return_value)
-{
- acpi_status status;
- acpi_get_devices_info info;
-
-
- FUNCTION_TRACE ("Acpi_get_devices");
-
-
- /* Parameter validation */
+ /* Internal function does the real work */
- if (!user_function) {
- return_ACPI_STATUS (AE_BAD_PARAMETER);
+ node = acpi_ns_get_next_node (type, parent_node, child_node);
+ if (!node) {
+ status = AE_NOT_FOUND;
+ goto unlock_and_exit;
}
- /*
- * We're going to call their callback from OUR callback, so we need
- * to know what it is, and their context parameter.
- */
- info.context = context;
- info.user_function = user_function;
- info.hid = HID;
+ if (ret_handle) {
+ *ret_handle = acpi_ns_convert_entry_to_handle (node);
+ }
- /*
- * Lock the namespace around the walk.
- * The namespace will be unlocked/locked around each call
- * to the user function - since this function
- * must be allowed to make Acpi calls itself.
- */
- acpi_ut_acquire_mutex (ACPI_MTX_NAMESPACE);
- status = acpi_ns_walk_namespace (ACPI_TYPE_DEVICE,
- ACPI_ROOT_OBJECT, ACPI_UINT32_MAX,
- NS_WALK_UNLOCK,
- acpi_ns_get_device_callback, &info,
- return_value);
- acpi_ut_release_mutex (ACPI_MTX_NAMESPACE);
+unlock_and_exit:
- return_ACPI_STATUS (status);
+ (void) acpi_ut_release_mutex (ACPI_MTX_NAMESPACE);
+ return (status);
}
+
+
FUNET's LINUX-ADM group, linux-adm@nic.funet.fi
TCL-scripts by Sam Shen (who was at: slshen@lbl.gov)