// SPDX-License-Identifier: BSD-3-Clause OR GPL-2.0 /****************************************************************************** * * Module Name: utxface - External interfaces, miscellaneous utility functions * * Copyright (C) 2000 - 2023, Intel Corp. * *****************************************************************************/ #define EXPORT_ACPI_INTERFACES #include <acpi/acpi.h> #include "accommon.h" #include "acdebug.h" #define _COMPONENT … ACPI_MODULE_NAME("utxface") /******************************************************************************* * * FUNCTION: acpi_terminate * * PARAMETERS: None * * RETURN: Status * * DESCRIPTION: Shutdown the ACPICA subsystem and release all resources. * ******************************************************************************/ acpi_status ACPI_INIT_FUNCTION acpi_terminate(void) { … } ACPI_EXPORT_SYMBOL_INIT(…) #ifndef ACPI_ASL_COMPILER #ifdef ACPI_FUTURE_USAGE /******************************************************************************* * * FUNCTION: acpi_subsystem_status * * PARAMETERS: None * * RETURN: Status of the ACPI subsystem * * DESCRIPTION: Other drivers that use the ACPI subsystem should call this * before making any other calls, to ensure the subsystem * initialized successfully. * ******************************************************************************/ acpi_status acpi_subsystem_status(void) { if (acpi_gbl_startup_flags & ACPI_INITIALIZED_OK) { return (AE_OK); } else { return (AE_ERROR); } } ACPI_EXPORT_SYMBOL(acpi_subsystem_status) /******************************************************************************* * * FUNCTION: acpi_get_system_info * * PARAMETERS: out_buffer - A buffer to receive the resources for the * device * * RETURN: status - the status of the call * * DESCRIPTION: This function is called to get information about the current * state of the ACPI subsystem. It will return system information * in the out_buffer. * * If the function fails an appropriate status will be returned * and the value of out_buffer is undefined. * ******************************************************************************/ acpi_status acpi_get_system_info(struct acpi_buffer *out_buffer) { struct acpi_system_info *info_ptr; acpi_status status; ACPI_FUNCTION_TRACE(acpi_get_system_info); /* Parameter validation */ status = acpi_ut_validate_buffer(out_buffer); if (ACPI_FAILURE(status)) { return_ACPI_STATUS(status); } /* Validate/Allocate/Clear caller buffer */ status = acpi_ut_initialize_buffer(out_buffer, sizeof(struct acpi_system_info)); if (ACPI_FAILURE(status)) { return_ACPI_STATUS(status); } /* * Populate the return buffer */ info_ptr = (struct acpi_system_info *)out_buffer->pointer; info_ptr->acpi_ca_version = ACPI_CA_VERSION; /* System flags (ACPI capabilities) */ info_ptr->flags = ACPI_SYS_MODE_ACPI; /* Timer resolution - 24 or 32 bits */ if (acpi_gbl_FADT.flags & ACPI_FADT_32BIT_TIMER) { info_ptr->timer_resolution = 24; } else { info_ptr->timer_resolution = 32; } /* Clear the reserved fields */ info_ptr->reserved1 = 0; info_ptr->reserved2 = 0; /* Current debug levels */ info_ptr->debug_layer = acpi_dbg_layer; info_ptr->debug_level = acpi_dbg_level; return_ACPI_STATUS(AE_OK); } ACPI_EXPORT_SYMBOL(acpi_get_system_info) /******************************************************************************* * * FUNCTION: acpi_get_statistics * * PARAMETERS: stats - Where the statistics are returned * * RETURN: status - the status of the call * * DESCRIPTION: Get the contents of the various system counters * ******************************************************************************/ acpi_status acpi_get_statistics(struct acpi_statistics *stats) { ACPI_FUNCTION_TRACE(acpi_get_statistics); /* Parameter validation */ if (!stats) { return_ACPI_STATUS(AE_BAD_PARAMETER); } /* Various interrupt-based event counters */ stats->sci_count = acpi_sci_count; stats->gpe_count = acpi_gpe_count; memcpy(stats->fixed_event_count, acpi_fixed_event_count, sizeof(acpi_fixed_event_count)); /* Other counters */ stats->method_count = acpi_method_count; return_ACPI_STATUS(AE_OK); } ACPI_EXPORT_SYMBOL(acpi_get_statistics) /***************************************************************************** * * FUNCTION: acpi_install_initialization_handler * * PARAMETERS: handler - Callback procedure * function - Not (currently) used, see below * * RETURN: Status * * DESCRIPTION: Install an initialization handler * * TBD: When a second function is added, must save the Function also. * ****************************************************************************/ acpi_status acpi_install_initialization_handler(acpi_init_handler handler, u32 function) { if (!handler) { return (AE_BAD_PARAMETER); } if (acpi_gbl_init_handler) { return (AE_ALREADY_EXISTS); } acpi_gbl_init_handler = handler; return (AE_OK); } ACPI_EXPORT_SYMBOL(acpi_install_initialization_handler) #endif /***************************************************************************** * * FUNCTION: acpi_purge_cached_objects * * PARAMETERS: None * * RETURN: Status * * DESCRIPTION: Empty all caches (delete the cached objects) * ****************************************************************************/ acpi_status acpi_purge_cached_objects(void) { … } ACPI_EXPORT_SYMBOL(…) /***************************************************************************** * * FUNCTION: acpi_install_interface * * PARAMETERS: interface_name - The interface to install * * RETURN: Status * * DESCRIPTION: Install an _OSI interface to the global list * ****************************************************************************/ acpi_status acpi_install_interface(acpi_string interface_name) { … } ACPI_EXPORT_SYMBOL(…) /***************************************************************************** * * FUNCTION: acpi_remove_interface * * PARAMETERS: interface_name - The interface to remove * * RETURN: Status * * DESCRIPTION: Remove an _OSI interface from the global list * ****************************************************************************/ acpi_status acpi_remove_interface(acpi_string interface_name) { … } ACPI_EXPORT_SYMBOL(…) /***************************************************************************** * * FUNCTION: acpi_install_interface_handler * * PARAMETERS: handler - The _OSI interface handler to install * NULL means "remove existing handler" * * RETURN: Status * * DESCRIPTION: Install a handler for the predefined _OSI ACPI method. * invoked during execution of the internal implementation of * _OSI. A NULL handler simply removes any existing handler. * ****************************************************************************/ acpi_status acpi_install_interface_handler(acpi_interface_handler handler) { … } ACPI_EXPORT_SYMBOL(…) /***************************************************************************** * * FUNCTION: acpi_update_interfaces * * PARAMETERS: action - Actions to be performed during the * update * * RETURN: Status * * DESCRIPTION: Update _OSI interface strings, disabling or enabling OS vendor * string or/and feature group strings. * ****************************************************************************/ acpi_status acpi_update_interfaces(u8 action) { … } /***************************************************************************** * * FUNCTION: acpi_check_address_range * * PARAMETERS: space_id - Address space ID * address - Start address * length - Length * warn - TRUE if warning on overlap desired * * RETURN: Count of the number of conflicts detected. * * DESCRIPTION: Check if the input address range overlaps any of the * ASL operation region address ranges. * ****************************************************************************/ u32 acpi_check_address_range(acpi_adr_space_type space_id, acpi_physical_address address, acpi_size length, u8 warn) { … } ACPI_EXPORT_SYMBOL(…) #endif /* !ACPI_ASL_COMPILER */ /******************************************************************************* * * FUNCTION: acpi_decode_pld_buffer * * PARAMETERS: in_buffer - Buffer returned by _PLD method * length - Length of the in_buffer * return_buffer - Where the decode buffer is returned * * RETURN: Status and the decoded _PLD buffer. User must deallocate * the buffer via ACPI_FREE. * * DESCRIPTION: Decode the bit-packed buffer returned by the _PLD method into * a local struct that is much more useful to an ACPI driver. * ******************************************************************************/ acpi_status acpi_decode_pld_buffer(u8 *in_buffer, acpi_size length, struct acpi_pld_info **return_buffer) { … } ACPI_EXPORT_SYMBOL(…)
Codebase Browser
linux