Fedora kernel-2.6.17-1.2142_FC4 patched with stable patch-2.6.17.4-vs2.0.2-rc26.diff
[linux-2.6.git] / include / acpi / acnamesp.h
index 8b3cdc3..b667a80 100644 (file)
@@ -5,7 +5,7 @@
  *****************************************************************************/
 
 /*
- * Copyright (C) 2000 - 2005, R. Byron Moore
+ * Copyright (C) 2000 - 2006, R. Byron Moore
  * All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
@@ -44,7 +44,6 @@
 #ifndef __ACNAMESP_H__
 #define __ACNAMESP_H__
 
-
 /* To search the entire name space, pass this as search_base */
 
 #define ACPI_NS_ALL                 ((acpi_handle)0)
  * and should be one-to-one with values of acpi_object_type
  */
 #define ACPI_NS_NORMAL              0
-#define ACPI_NS_NEWSCOPE            1   /* a definition of this type opens a name scope */
-#define ACPI_NS_LOCAL               2   /* suppress search of enclosing scopes */
-
-
-/* Definitions of the predefined namespace names  */
-
-#define ACPI_UNKNOWN_NAME           (u32) 0x3F3F3F3F     /* Unknown name is  "????" */
-#define ACPI_ROOT_NAME              (u32) 0x5F5F5F5C     /* Root name is     "\___" */
-#define ACPI_SYS_BUS_NAME           (u32) 0x5F53425F     /* Sys bus name is  "_SB_" */
-
-#define ACPI_NS_ROOT_PATH           "\\"
-#define ACPI_NS_SYSTEM_BUS          "_SB_"
-
+#define ACPI_NS_NEWSCOPE            1  /* a definition of this type opens a name scope */
+#define ACPI_NS_LOCAL               2  /* suppress search of enclosing scopes */
 
 /* Flags for acpi_ns_lookup, acpi_ns_search_and_enter */
 
 #define ACPI_NS_WALK_UNLOCK         TRUE
 #define ACPI_NS_WALK_NO_UNLOCK      FALSE
 
+/*
+ * nsinit - Namespace initialization
+ */
+acpi_status acpi_ns_initialize_objects(void);
 
-acpi_status
-acpi_ns_load_namespace (
-       void);
-
-acpi_status
-acpi_ns_initialize_objects (
-       void);
-
-acpi_status
-acpi_ns_initialize_devices (
-       void);
-
-
-/* Namespace init - nsxfinit */
-
-acpi_status
-acpi_ns_init_one_device (
-       acpi_handle                     obj_handle,
-       u32                             nesting_level,
-       void                            *context,
-       void                            **return_value);
-
-acpi_status
-acpi_ns_init_one_object (
-       acpi_handle                     obj_handle,
-       u32                             level,
-       void                            *context,
-       void                            **return_value);
+acpi_status acpi_ns_initialize_devices(void);
 
+/*
+ * nsload -  Namespace loading
+ */
+acpi_status acpi_ns_load_namespace(void);
 
 acpi_status
-acpi_ns_walk_namespace (
-       acpi_object_type                type,
-       acpi_handle                     start_object,
-       u32                             max_depth,
-       u8                              unlock_before_callback,
-       acpi_walk_callback              user_function,
-       void                            *context,
-       void                            **return_value);
-
-struct acpi_namespace_node *
-acpi_ns_get_next_node (
-       acpi_object_type                type,
-       struct acpi_namespace_node      *parent,
-       struct acpi_namespace_node      *child);
-
-void
-acpi_ns_delete_namespace_by_owner (
-       u16                             table_id);
-
-
-/* Namespace loading - nsload */
+acpi_ns_load_table(struct acpi_table_desc *table_desc,
+                  struct acpi_namespace_node *node);
 
+/*
+ * nswalk - walk the namespace
+ */
 acpi_status
-acpi_ns_one_complete_parse (
-       u32                             pass_number,
-       struct acpi_table_desc          *table_desc);
+acpi_ns_walk_namespace(acpi_object_type type,
+                      acpi_handle start_object,
+                      u32 max_depth,
+                      u8 unlock_before_callback,
+                      acpi_walk_callback user_function,
+                      void *context, void **return_value);
 
-acpi_status
-acpi_ns_parse_table (
-       struct acpi_table_desc          *table_desc,
-       struct acpi_namespace_node      *scope);
+struct acpi_namespace_node *acpi_ns_get_next_node(acpi_object_type type,
+                                                 struct acpi_namespace_node
+                                                 *parent,
+                                                 struct acpi_namespace_node
+                                                 *child);
 
+/*
+ * nsparse - table parsing
+ */
 acpi_status
-acpi_ns_load_table (
-       struct acpi_table_desc          *table_desc,
-       struct acpi_namespace_node      *node);
+acpi_ns_parse_table(struct acpi_table_desc *table_desc,
+                   struct acpi_namespace_node *scope);
 
 acpi_status
-acpi_ns_load_table_by_type (
-       acpi_table_type                 table_type);
-
+acpi_ns_one_complete_parse(u8 pass_number, struct acpi_table_desc *table_desc);
 
 /*
- * Top-level namespace access - nsaccess
+ * nsaccess - Top-level namespace access
  */
+acpi_status acpi_ns_root_initialize(void);
 
 acpi_status
-acpi_ns_root_initialize (
-       void);
-
-acpi_status
-acpi_ns_lookup (
-       union acpi_generic_state        *scope_info,
-       char                            *name,
-       acpi_object_type                type,
-       acpi_interpreter_mode           interpreter_mode,
-       u32                             flags,
-       struct acpi_walk_state          *walk_state,
-       struct acpi_namespace_node      **ret_node);
-
+acpi_ns_lookup(union acpi_generic_state *scope_info,
+              char *name,
+              acpi_object_type type,
+              acpi_interpreter_mode interpreter_mode,
+              u32 flags,
+              struct acpi_walk_state *walk_state,
+              struct acpi_namespace_node **ret_node);
 
 /*
- * Named object allocation/deallocation - nsalloc
+ * nsalloc - Named object allocation/deallocation
  */
+struct acpi_namespace_node *acpi_ns_create_node(u32 name);
 
-struct acpi_namespace_node *
-acpi_ns_create_node (
-       u32                             name);
-
-void
-acpi_ns_delete_node (
-       struct acpi_namespace_node      *node);
-
-void
-acpi_ns_delete_namespace_subtree (
-       struct acpi_namespace_node      *parent_handle);
+void acpi_ns_delete_node(struct acpi_namespace_node *node);
 
 void
-acpi_ns_detach_object (
-       struct acpi_namespace_node      *node);
-
-void
-acpi_ns_delete_children (
-       struct acpi_namespace_node      *parent);
-
-int
-acpi_ns_compare_names (
-       char                            *name1,
-       char                            *name2);
-
-void
-acpi_ns_remove_reference (
-       struct acpi_namespace_node      *node);
-
+acpi_ns_delete_namespace_subtree(struct acpi_namespace_node *parent_handle);
 
-/*
- * Namespace modification - nsmodify
- */
+void acpi_ns_delete_namespace_by_owner(acpi_owner_id owner_id);
 
-#ifdef ACPI_FUTURE_USAGE
-acpi_status
-acpi_ns_unload_namespace (
-       acpi_handle                     handle);
+void acpi_ns_detach_object(struct acpi_namespace_node *node);
 
-acpi_status
-acpi_ns_delete_subtree (
-       acpi_handle                     start_handle);
-#endif
+void acpi_ns_delete_children(struct acpi_namespace_node *parent);
 
+int acpi_ns_compare_names(char *name1, char *name2);
 
 /*
- * Namespace dump/print utilities - nsdump
+ * nsdump - Namespace dump/print utilities
  */
+#ifdef ACPI_FUTURE_USAGE
+void acpi_ns_dump_tables(acpi_handle search_base, u32 max_depth);
+#endif                         /* ACPI_FUTURE_USAGE */
 
-#ifdef ACPI_FUTURE_USAGE
-void
-acpi_ns_dump_tables (
-       acpi_handle                     search_base,
-       u32                             max_depth);
-#endif
+void acpi_ns_dump_entry(acpi_handle handle, u32 debug_level);
 
 void
-acpi_ns_dump_entry (
-       acpi_handle                     handle,
-       u32                             debug_level);
-
-void
-acpi_ns_dump_pathname (
-       acpi_handle                     handle,
-       char                            *msg,
-       u32                             level,
-       u32                             component);
-
-void
-acpi_ns_print_pathname (
-       u32                             num_segments,
-       char                            *pathname);
-
-#ifdef ACPI_FUTURE_USAGE
-acpi_status
-acpi_ns_dump_one_device (
-       acpi_handle                     obj_handle,
-       u32                             level,
-       void                            *context,
-       void                            **return_value);
+acpi_ns_dump_pathname(acpi_handle handle, char *msg, u32 level, u32 component);
 
-void
-acpi_ns_dump_root_devices (
-       void);
-#endif  /*  ACPI_FUTURE_USAGE  */
+void acpi_ns_print_pathname(u32 num_segments, char *pathname);
 
 acpi_status
-acpi_ns_dump_one_object (
-       acpi_handle                     obj_handle,
-       u32                             level,
-       void                            *context,
-       void                            **return_value);
+acpi_ns_dump_one_object(acpi_handle obj_handle,
+                       u32 level, void *context, void **return_value);
 
-#ifdef ACPI_FUTURE_USAGE
+#ifdef ACPI_FUTURE_USAGE
 void
-acpi_ns_dump_objects (
-       acpi_object_type                type,
-       u8                              display_type,
-       u32                             max_depth,
-       u32                             ownder_id,
-       acpi_handle                     start_handle);
-#endif
-
+acpi_ns_dump_objects(acpi_object_type type,
+                    u8 display_type,
+                    u32 max_depth,
+                    acpi_owner_id owner_id, acpi_handle start_handle);
+#endif                         /* ACPI_FUTURE_USAGE */
 
 /*
- * Namespace evaluation functions - nseval
+ * nseval - Namespace evaluation functions
  */
+acpi_status acpi_ns_evaluate_by_handle(struct acpi_parameter_info *info);
 
 acpi_status
-acpi_ns_evaluate_by_handle (
-       struct acpi_parameter_info      *info);
-
-acpi_status
-acpi_ns_evaluate_by_name (
-       char                            *pathname,
-       struct acpi_parameter_info      *info);
-
-acpi_status
-acpi_ns_evaluate_relative (
-       char                            *pathname,
-       struct acpi_parameter_info      *info);
+acpi_ns_evaluate_by_name(char *pathname, struct acpi_parameter_info *info);
 
 acpi_status
-acpi_ns_execute_control_method (
-       struct acpi_parameter_info      *info);
-
-acpi_status
-acpi_ns_get_object_value (
-       struct acpi_parameter_info      *info);
-
-
-/*
- * Parent/Child/Peer utility functions
- */
-
-#ifdef ACPI_FUTURE_USAGE
-acpi_name
-acpi_ns_find_parent_name (
-       struct acpi_namespace_node      *node_to_search);
-#endif
-
+acpi_ns_evaluate_relative(char *pathname, struct acpi_parameter_info *info);
 
 /*
- * Name and Scope manipulation - nsnames
+ * nsnames - Name and Scope manipulation
  */
+u32 acpi_ns_opens_scope(acpi_object_type type);
 
-u32
-acpi_ns_opens_scope (
-       acpi_object_type                type);
-
-void
-acpi_ns_build_external_path (
-       struct acpi_namespace_node      *node,
-       acpi_size                       size,
-       char                            *name_buffer);
-
-char *
-acpi_ns_get_external_pathname (
-       struct acpi_namespace_node      *node);
+char *acpi_ns_get_external_pathname(struct acpi_namespace_node *node);
 
-char *
-acpi_ns_name_of_current_scope (
-       struct acpi_walk_state          *walk_state);
+char *acpi_ns_name_of_current_scope(struct acpi_walk_state *walk_state);
 
 acpi_status
-acpi_ns_handle_to_pathname (
-       acpi_handle                     target_handle,
-       struct acpi_buffer              *buffer);
+acpi_ns_handle_to_pathname(acpi_handle target_handle,
+                          struct acpi_buffer *buffer);
 
 u8
-acpi_ns_pattern_match (
-       struct acpi_namespace_node      *obj_node,
-       char                            *search_for);
+acpi_ns_pattern_match(struct acpi_namespace_node *obj_node, char *search_for);
 
 acpi_status
-acpi_ns_get_node_by_path (
-       char                            *external_pathname,
-       struct acpi_namespace_node      *in_prefix_node,
-       u32                             flags,
-       struct acpi_namespace_node      **out_node);
-
-acpi_size
-acpi_ns_get_pathname_length (
-       struct acpi_namespace_node      *node);
+acpi_ns_get_node_by_path(char *external_pathname,
+                        struct acpi_namespace_node *in_prefix_node,
+                        u32 flags, struct acpi_namespace_node **out_node);
 
+acpi_size acpi_ns_get_pathname_length(struct acpi_namespace_node *node);
 
 /*
- * Object management for namespace nodes - nsobject
+ * nsobject - Object management for namespace nodes
  */
-
 acpi_status
-acpi_ns_attach_object (
-       struct acpi_namespace_node      *node,
-       union acpi_operand_object       *object,
-       acpi_object_type                type);
+acpi_ns_attach_object(struct acpi_namespace_node *node,
+                     union acpi_operand_object *object, acpi_object_type type);
 
-union acpi_operand_object *
-acpi_ns_get_attached_object (
-       struct acpi_namespace_node      *node);
+union acpi_operand_object *acpi_ns_get_attached_object(struct
+                                                      acpi_namespace_node
+                                                      *node);
 
-union acpi_operand_object *
-acpi_ns_get_secondary_object (
-       union acpi_operand_object       *obj_desc);
+union acpi_operand_object *acpi_ns_get_secondary_object(union
+                                                       acpi_operand_object
+                                                       *obj_desc);
 
 acpi_status
-acpi_ns_attach_data (
-       struct acpi_namespace_node      *node,
-       acpi_object_handler             handler,
-       void                            *data);
+acpi_ns_attach_data(struct acpi_namespace_node *node,
+                   acpi_object_handler handler, void *data);
 
 acpi_status
-acpi_ns_detach_data (
-       struct acpi_namespace_node      *node,
-       acpi_object_handler             handler);
+acpi_ns_detach_data(struct acpi_namespace_node *node,
+                   acpi_object_handler handler);
 
 acpi_status
-acpi_ns_get_attached_data (
-       struct acpi_namespace_node      *node,
-       acpi_object_handler             handler,
-       void                            **data);
-
+acpi_ns_get_attached_data(struct acpi_namespace_node *node,
+                         acpi_object_handler handler, void **data);
 
 /*
- * Namespace searching and entry - nssearch
+ * nssearch - Namespace searching and entry
  */
-
 acpi_status
-acpi_ns_search_and_enter (
-       u32                             entry_name,
-       struct acpi_walk_state          *walk_state,
-       struct acpi_namespace_node      *node,
-       acpi_interpreter_mode           interpreter_mode,
-       acpi_object_type                type,
-       u32                             flags,
-       struct acpi_namespace_node      **ret_node);
+acpi_ns_search_and_enter(u32 entry_name,
+                        struct acpi_walk_state *walk_state,
+                        struct acpi_namespace_node *node,
+                        acpi_interpreter_mode interpreter_mode,
+                        acpi_object_type type,
+                        u32 flags, struct acpi_namespace_node **ret_node);
 
 acpi_status
-acpi_ns_search_node (
-       u32                             entry_name,
-       struct acpi_namespace_node      *node,
-       acpi_object_type                type,
-       struct acpi_namespace_node      **ret_node);
+acpi_ns_search_node(u32 entry_name,
+                   struct acpi_namespace_node *node,
+                   acpi_object_type type,
+                   struct acpi_namespace_node **ret_node);
 
 void
-acpi_ns_install_node (
-       struct acpi_walk_state          *walk_state,
-       struct acpi_namespace_node      *parent_node,
-       struct acpi_namespace_node      *node,
-       acpi_object_type                type);
-
+acpi_ns_install_node(struct acpi_walk_state *walk_state,
+                    struct acpi_namespace_node *parent_node,
+                    struct acpi_namespace_node *node, acpi_object_type type);
 
 /*
- * Utility functions - nsutils
+ * nsutils - Utility functions
  */
+u8 acpi_ns_valid_root_prefix(char prefix);
 
-u8
-acpi_ns_valid_root_prefix (
-       char                            prefix);
-
-u8
-acpi_ns_valid_path_separator (
-       char                            sep);
+acpi_object_type acpi_ns_get_type(struct acpi_namespace_node *node);
 
-acpi_object_type
-acpi_ns_get_type (
-       struct acpi_namespace_node      *node);
-
-u32
-acpi_ns_local (
-       acpi_object_type                type);
+u32 acpi_ns_local(acpi_object_type type);
 
 void
-acpi_ns_report_error (
-       char                            *module_name,
-       u32                             line_number,
-       u32                             component_id,
-       char                            *internal_name,
-       acpi_status                     lookup_status);
+acpi_ns_report_error(char *module_name,
+                    u32 line_number,
+                    char *internal_name, acpi_status lookup_status);
 
 void
-acpi_ns_report_method_error (
-       char                            *module_name,
-       u32                             line_number,
-       u32                             component_id,
-       char                            *message,
-       struct acpi_namespace_node      *node,
-       char                            *path,
-       acpi_status                     lookup_status);
+acpi_ns_report_method_error(char *module_name,
+                           u32 line_number,
+                           char *message,
+                           struct acpi_namespace_node *node,
+                           char *path, acpi_status lookup_status);
 
-void
-acpi_ns_print_node_pathname (
-       struct acpi_namespace_node      *node,
-       char                            *msg);
+void acpi_ns_print_node_pathname(struct acpi_namespace_node *node, char *msg);
 
-acpi_status
-acpi_ns_build_internal_name (
-       struct acpi_namestring_info     *info);
+acpi_status acpi_ns_build_internal_name(struct acpi_namestring_info *info);
 
-void
-acpi_ns_get_internal_name_length (
-       struct acpi_namestring_info     *info);
+void acpi_ns_get_internal_name_length(struct acpi_namestring_info *info);
 
-acpi_status
-acpi_ns_internalize_name (
-       char                            *dotted_name,
-       char                            **converted_name);
+acpi_status acpi_ns_internalize_name(char *dotted_name, char **converted_name);
 
 acpi_status
-acpi_ns_externalize_name (
-       u32                             internal_name_length,
-       char                            *internal_name,
-       u32                             *converted_name_length,
-       char                            **converted_name);
-
-struct acpi_namespace_node *
-acpi_ns_map_handle_to_node (
-       acpi_handle                     handle);
+acpi_ns_externalize_name(u32 internal_name_length,
+                        char *internal_name,
+                        u32 * converted_name_length, char **converted_name);
 
-acpi_handle
-acpi_ns_convert_entry_to_handle(
-       struct acpi_namespace_node      *node);
-
-void
-acpi_ns_terminate (
-       void);
+struct acpi_namespace_node *acpi_ns_map_handle_to_node(acpi_handle handle);
 
-struct acpi_namespace_node *
-acpi_ns_get_parent_node (
-       struct acpi_namespace_node      *node);
+acpi_handle acpi_ns_convert_entry_to_handle(struct acpi_namespace_node *node);
 
+void acpi_ns_terminate(void);
 
-struct acpi_namespace_node *
-acpi_ns_get_next_valid_node (
-       struct acpi_namespace_node      *node);
+struct acpi_namespace_node *acpi_ns_get_parent_node(struct acpi_namespace_node
+                                                   *node);
 
+struct acpi_namespace_node *acpi_ns_get_next_valid_node(struct
+                                                       acpi_namespace_node
+                                                       *node);
 
-#endif /* __ACNAMESP_H__ */
+#endif                         /* __ACNAMESP_H__ */