tables.h File Reference

#include <uacpi/types.h>
#include <uacpi/status.h>

Include dependency graph for tables.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes
struct	uacpi_table_identifiers
struct	uacpi_table

Typedefs
typedef struct uacpi_table_identifiers	uacpi_table_identifiers
typedef struct uacpi_table	uacpi_table
typedef enum uacpi_table_installation_disposition	uacpi_table_installation_disposition
typedef uacpi_table_installation_disposition(*	uacpi_table_installation_handler) (struct acpi_sdt_hdr *hdr, uacpi_u64 *out_override_address)

Enumerations
enum	uacpi_table_installation_disposition { UACPI_TABLE_INSTALLATION_DISPOSITON_ALLOW = 0 , UACPI_TABLE_INSTALLATION_DISPOSITON_DENY , UACPI_TABLE_INSTALLATION_DISPOSITON_VIRTUAL_OVERRIDE , UACPI_TABLE_INSTALLATION_DISPOSITON_PHYSICAL_OVERRIDE }

Functions
uacpi_status	uacpi_table_install (void *, uacpi_table *out_table)
uacpi_status	uacpi_table_install_physical (uacpi_phys_addr, uacpi_table *out_table)
uacpi_status	uacpi_table_load (uacpi_size index)
uacpi_status	uacpi_table_find_by_signature (const uacpi_char *signature, uacpi_table *out_table)
uacpi_status	uacpi_table_find_next_with_same_signature (uacpi_table *in_out_table)
uacpi_status	uacpi_table_find (const uacpi_table_identifiers *id, uacpi_table *out_table)
uacpi_status	uacpi_table_ref (uacpi_table *)
uacpi_status	uacpi_table_unref (uacpi_table *)
uacpi_status	uacpi_table_fadt (struct acpi_fadt **)
uacpi_status	uacpi_set_table_installation_handler (uacpi_table_installation_handler handler)

Typedef Documentation

uacpi_table

typedef struct uacpi_table uacpi_table

uacpi_table_identifiers

typedef struct uacpi_table_identifiers uacpi_table_identifiers

uacpi_table_installation_disposition

typedef enum uacpi_table_installation_disposition uacpi_table_installation_disposition

uacpi_table_installation_handler

typedef uacpi_table_installation_disposition(* uacpi_table_installation_handler) (struct acpi_sdt_hdr *hdr, uacpi_u64 *out_override_address)

Definition at line 117 of file tables.h.

Enumeration Type Documentation

uacpi_table_installation_disposition

enum uacpi_table_installation_disposition

Enumerator
UACPI_TABLE_INSTALLATION_DISPOSITON_ALLOW
UACPI_TABLE_INSTALLATION_DISPOSITON_DENY
UACPI_TABLE_INSTALLATION_DISPOSITON_VIRTUAL_OVERRIDE
UACPI_TABLE_INSTALLATION_DISPOSITON_PHYSICAL_OVERRIDE

Definition at line 93 of file tables.h.

                                                  {
    // Allow the table to be installed as-is
    UACPI_TABLE_INSTALLATION_DISPOSITON_ALLOW = 0,
 
    /*
     * Deny the table from being installed completely. This is useful for
     * debugging various problems, e.g. AML loading bad SSDTs that cause the
     * system to hang or enter an undesired state.
     */
    UACPI_TABLE_INSTALLATION_DISPOSITON_DENY,
 
    /*
     * Override the table being installed with the table at the virtual address
     * returned in 'out_override_address'.
     */
    UACPI_TABLE_INSTALLATION_DISPOSITON_VIRTUAL_OVERRIDE,
 
    /*
     * Override the table being installed with the table at the physical address
     * returned in 'out_override_address'.
     */
    UACPI_TABLE_INSTALLATION_DISPOSITON_PHYSICAL_OVERRIDE,
} uacpi_table_installation_disposition;

Function Documentation

uacpi_set_table_installation_handler()

uacpi_status uacpi_set_table_installation_handler

(

uacpi_table_installation_handler

handler

)

Definition at line 356 of file tables.c.

{
    uacpi_status ret;
 
    ret = uacpi_acquire_native_mutex_may_be_null(table_mutex);
    if (uacpi_unlikely_error(ret))
        return ret;
 
    if (installation_handler != UACPI_NULL && handler != UACPI_NULL)
        goto out;
 
    installation_handler = handler;
 
out:
    uacpi_release_native_mutex_may_be_null(table_mutex);
    return ret;
}

uacpi_table_fadt()

uacpi_status uacpi_table_fadt

(

struct acpi_fadt **

out_fadt

)

Definition at line 1391 of file tables.c.

{
    ENSURE_TABLES_ONLINE();
 
    *out_fadt = &g_uacpi_rt_ctx.fadt;
    return UACPI_STATUS_OK;
}

uacpi_table_find()

uacpi_status uacpi_table_find	(	const uacpi_table_identifiers *	id,
		uacpi_table *	out_table
	)

Definition at line 1013 of file tables.c.

{
    ENSURE_TABLES_ONLINE();
 
    return find_table(0, id, out_table);
}

Referenced by handle_create_data_region(), and handle_load_table().

uacpi_table_find_by_signature()

uacpi_status uacpi_table_find_by_signature	(	const uacpi_char *	signature,
		uacpi_table *	out_table
	)

Definition at line 975 of file tables.c.

{
    struct uacpi_table_identifiers id = {
        .signature = {
            .text = {
                signature_string[0],
                signature_string[1],
                signature_string[2],
                signature_string[3]
            }
        }
    };
 
    ENSURE_TABLES_ONLINE();
 
    return find_table(0, &id, out_table);
}

Referenced by uacpi_namespace_load().

uacpi_table_find_next_with_same_signature()

uacpi_status uacpi_table_find_next_with_same_signature

(

uacpi_table *

in_out_table

)

Definition at line 995 of file tables.c.

{
    struct uacpi_table_identifiers id = { 0 };
 
    ENSURE_TABLES_ONLINE();
 
    if (uacpi_unlikely(in_out_table->ptr == UACPI_NULL))
        return UACPI_STATUS_INVALID_ARGUMENT;
 
    uacpi_memcpy(&id.signature, in_out_table->hdr->signature,
                 sizeof(id.signature));
    uacpi_table_unref(in_out_table);
 
    return find_table(in_out_table->index + 1, &id, in_out_table);
}

uacpi_table_install()

uacpi_status uacpi_table_install	(	void *	virt,
		uacpi_table *	out_table
	)

Definition at line 812 of file tables.c.

{
    ENSURE_TABLES_ONLINE();
 
    return uacpi_table_install_with_origin(
        virt, UACPI_TABLE_ORIGIN_HOST_VIRTUAL, out_table
    );
}

uacpi_table_install_physical()

uacpi_status uacpi_table_install_physical	(	uacpi_phys_addr	addr,
		uacpi_table *	out_table
	)

Definition at line 821 of file tables.c.

{
    ENSURE_TABLES_ONLINE();
 
    return uacpi_table_install_physical_with_origin(
        addr, UACPI_TABLE_ORIGIN_HOST_PHYSICAL, out_table
    );
}

uacpi_table_load()

uacpi_status uacpi_table_load

(

uacpi_size

index

)

Definition at line 1138 of file tables.c.

{
    return uacpi_table_load_with_cause(idx, UACPI_TABLE_LOAD_CAUSE_HOST);
}

uacpi_table_ref()

uacpi_status uacpi_table_ref

(

uacpi_table *

tbl

)

Definition at line 1151 of file tables.c.

{
    return table_ctl(tbl->index, &(struct table_ctl_request) {
        .type = TABLE_CTL_GET
    });
}

uacpi_table_unref()

uacpi_status uacpi_table_unref

(

uacpi_table *

tbl

)

Definition at line 1158 of file tables.c.

{
    return table_ctl(tbl->index, &(struct table_ctl_request) {
        .type = TABLE_CTL_PUT
    });
}

Referenced by free_op_region(), handle_load_table(), uacpi_namespace_load(), and uacpi_table_find_next_with_same_signature().