1/******************************************************************************
  2 *
  3 * Name: actables.h - ACPI table management
  4 *
  5 *****************************************************************************/
  6
  7/*
  8 * Copyright (C) 2000 - 2012, Intel Corp.
  9 * All rights reserved.
 10 *
 11 * Redistribution and use in source and binary forms, with or without
 12 * modification, are permitted provided that the following conditions
 13 * are met:
 14 * 1. Redistributions of source code must retain the above copyright
 15 *    notice, this list of conditions, and the following disclaimer,
 16 *    without modification.
 17 * 2. Redistributions in binary form must reproduce at minimum a disclaimer
 18 *    substantially similar to the "NO WARRANTY" disclaimer below
 19 *    ("Disclaimer") and any redistribution must be conditioned upon
 20 *    including a substantially similar Disclaimer requirement for further
 21 *    binary redistribution.
 22 * 3. Neither the names of the above-listed copyright holders nor the names
 23 *    of any contributors may be used to endorse or promote products derived
 24 *    from this software without specific prior written permission.
 25 *
 26 * Alternatively, this software may be distributed under the terms of the
 27 * GNU General Public License ("GPL") version 2 as published by the Free
 28 * Software Foundation.
 29 *
 30 * NO WARRANTY
 31 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 32 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 33 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
 34 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
 35 * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 36 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 37 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 38 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
 39 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
 40 * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 41 * POSSIBILITY OF SUCH DAMAGES.
 42 */
 43
 44#ifndef __ACTABLES_H__
 45#define __ACTABLES_H__
 46
 47acpi_status acpi_allocate_root_table(u32 initial_table_count);
 48
 49/*
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 50 * tbfadt - FADT parse/convert/validate
 51 */
 52void acpi_tb_parse_fadt(u32 table_index);
 53
 54void acpi_tb_create_local_fadt(struct acpi_table_header *table, u32 length);
 55
 56/*
 57 * tbfind - find ACPI table
 58 */
 59acpi_status
 60acpi_tb_find_table(char *signature,
 61		   char *oem_id, char *oem_table_id, u32 *table_index);
 62
 63/*
 64 * tbinstal - Table removal and deletion
 65 */
 66acpi_status acpi_tb_resize_root_table_list(void);
 67
 68acpi_status acpi_tb_verify_table(struct acpi_table_desc *table_desc);
 69
 70struct acpi_table_header *acpi_tb_table_override(struct acpi_table_header
 71						 *table_header,
 72						 struct acpi_table_desc
 73						 *table_desc);
 74
 75acpi_status
 76acpi_tb_add_table(struct acpi_table_desc *table_desc, u32 *table_index);
 
 
 
 
 
 
 77
 78acpi_status
 79acpi_tb_store_table(acpi_physical_address address,
 80		    struct acpi_table_header *table,
 81		    u32 length, u8 flags, u32 *table_index);
 
 
 
 82
 83void acpi_tb_delete_table(struct acpi_table_desc *table_desc);
 
 
 
 
 
 
 
 
 
 
 
 84
 85void acpi_tb_terminate(void);
 86
 87acpi_status acpi_tb_delete_namespace_by_owner(u32 table_index);
 88
 89acpi_status acpi_tb_allocate_owner_id(u32 table_index);
 90
 91acpi_status acpi_tb_release_owner_id(u32 table_index);
 92
 93acpi_status acpi_tb_get_owner_id(u32 table_index, acpi_owner_id *owner_id);
 94
 95u8 acpi_tb_is_table_loaded(u32 table_index);
 96
 97void acpi_tb_set_table_loaded_flag(u32 table_index, u8 is_loaded);
 98
 99/*
100 * tbutils - table manager utilities
101 */
102acpi_status acpi_tb_initialize_facs(void);
103
104u8 acpi_tb_tables_loaded(void);
105
106void
107acpi_tb_print_table_header(acpi_physical_address address,
108			   struct acpi_table_header *header);
109
110u8 acpi_tb_checksum(u8 *buffer, u32 length);
111
112acpi_status
113acpi_tb_verify_checksum(struct acpi_table_header *table, u32 length);
114
115void acpi_tb_check_dsdt_header(void);
116
117struct acpi_table_header *acpi_tb_copy_dsdt(u32 table_index);
118
119void
120acpi_tb_install_table(acpi_physical_address address,
121		      char *signature, u32 table_index);
122
123acpi_status acpi_tb_parse_root_table(acpi_physical_address rsdp_address);
 
 
 
 
 
 
 
 
 
 
 
124
125#endif				/* __ACTABLES_H__ */

  1/* SPDX-License-Identifier: BSD-3-Clause OR GPL-2.0 */
  2/******************************************************************************
  3 *
  4 * Name: actables.h - ACPI table management
  5 *
  6 * Copyright (C) 2000 - 2023, Intel Corp.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
  7 *
  8 *****************************************************************************/
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
  9
 10#ifndef __ACTABLES_H__
 11#define __ACTABLES_H__
 12
 13acpi_status acpi_allocate_root_table(u32 initial_table_count);
 14
 15/*
 16 * tbxfroot - Root pointer utilities
 17 */
 18u32 acpi_tb_get_rsdp_length(struct acpi_table_rsdp *rsdp);
 19
 20acpi_status acpi_tb_validate_rsdp(struct acpi_table_rsdp *rsdp);
 21
 22u8 *acpi_tb_scan_memory_for_rsdp(u8 *start_address, u32 length);
 23
 24/*
 25 * tbdata - table data structure management
 26 */
 27acpi_status
 28acpi_tb_get_next_table_descriptor(u32 *table_index,
 29				  struct acpi_table_desc **table_desc);
 30
 31void
 32acpi_tb_init_table_descriptor(struct acpi_table_desc *table_desc,
 33			      acpi_physical_address address,
 34			      u8 flags, struct acpi_table_header *table);
 35
 36acpi_status
 37acpi_tb_acquire_temp_table(struct acpi_table_desc *table_desc,
 38			   acpi_physical_address address,
 39			   u8 flags, struct acpi_table_header *table);
 40
 41void acpi_tb_release_temp_table(struct acpi_table_desc *table_desc);
 42
 43acpi_status acpi_tb_validate_temp_table(struct acpi_table_desc *table_desc);
 44
 45acpi_status
 46acpi_tb_verify_temp_table(struct acpi_table_desc *table_desc,
 47			  char *signature, u32 *table_index);
 48
 49u8 acpi_tb_is_table_loaded(u32 table_index);
 50
 51void acpi_tb_set_table_loaded_flag(u32 table_index, u8 is_loaded);
 52
 53/*
 54 * tbfadt - FADT parse/convert/validate
 55 */
 56void acpi_tb_parse_fadt(void);
 57
 58void acpi_tb_create_local_fadt(struct acpi_table_header *table, u32 length);
 59
 60/*
 61 * tbfind - find ACPI table
 62 */
 63acpi_status
 64acpi_tb_find_table(char *signature,
 65		   char *oem_id, char *oem_table_id, u32 *table_index);
 66
 67/*
 68 * tbinstal - Table removal and deletion
 69 */
 70acpi_status acpi_tb_resize_root_table_list(void);
 71
 72acpi_status acpi_tb_validate_table(struct acpi_table_desc *table_desc);
 73
 74void acpi_tb_invalidate_table(struct acpi_table_desc *table_desc);
 75
 76void acpi_tb_override_table(struct acpi_table_desc *old_table_desc);
 
 77
 78acpi_status
 79acpi_tb_acquire_table(struct acpi_table_desc *table_desc,
 80		      struct acpi_table_header **table_ptr,
 81		      u32 *table_length, u8 *table_flags);
 82
 83void
 84acpi_tb_release_table(struct acpi_table_header *table,
 85		      u32 table_length, u8 table_flags);
 86
 87acpi_status
 88acpi_tb_install_standard_table(acpi_physical_address address,
 89			       u8 flags,
 90			       struct acpi_table_header *table,
 91			       u8 reload, u8 override, u32 *table_index);
 92
 93void acpi_tb_uninstall_table(struct acpi_table_desc *table_desc);
 94
 95acpi_status
 96acpi_tb_load_table(u32 table_index, struct acpi_namespace_node *parent_node);
 97
 98acpi_status
 99acpi_tb_install_and_load_table(acpi_physical_address address,
100			       u8 flags,
101			       struct acpi_table_header *table,
102			       u8 override, u32 *table_index);
103
104acpi_status acpi_tb_unload_table(u32 table_index);
105
106void acpi_tb_notify_table(u32 event, void *table);
107
108void acpi_tb_terminate(void);
109
110acpi_status acpi_tb_delete_namespace_by_owner(u32 table_index);
111
112acpi_status acpi_tb_allocate_owner_id(u32 table_index);
113
114acpi_status acpi_tb_release_owner_id(u32 table_index);
115
116acpi_status acpi_tb_get_owner_id(u32 table_index, acpi_owner_id *owner_id);
117
 
 
 
 
118/*
119 * tbutils - table manager utilities
120 */
121acpi_status acpi_tb_initialize_facs(void);
122
 
 
123void
124acpi_tb_print_table_header(acpi_physical_address address,
125			   struct acpi_table_header *header);
126
 
 
 
 
 
127void acpi_tb_check_dsdt_header(void);
128
129struct acpi_table_header *acpi_tb_copy_dsdt(u32 table_index);
130
131void
132acpi_tb_install_table_with_override(struct acpi_table_desc *new_table_desc,
133				    u8 override, u32 *table_index);
134
135acpi_status acpi_tb_parse_root_table(acpi_physical_address rsdp_address);
136
137acpi_status
138acpi_tb_get_table(struct acpi_table_desc *table_desc,
139		  struct acpi_table_header **out_table);
140
141void acpi_tb_put_table(struct acpi_table_desc *table_desc);
142
143/*
144 * tbxfload
145 */
146acpi_status acpi_tb_load_namespace(void);
147
148#endif				/* __ACTABLES_H__ */