acpi.c File Reference

ACPI support functions. More...

#include <errno.h>
#include <byteswap.h>
#include <ipxe/uaccess.h>
#include <ipxe/acpi.h>
#include <ipxe/interface.h>

Go to the source code of this file.

Macros
#define	colour   FADT_SIGNATURE
	Colour for debug messages. More...

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
	typeof (acpi_finder=acpi_find)
	ACPI table finder. More...
void	acpi_fix_checksum (struct acpi_header *acpi)
	Fix up ACPI table checksum. More...
userptr_t	acpi_table (uint32_t signature, unsigned int index)
	Locate ACPI table. More...
userptr_t	acpi_find_via_rsdt (uint32_t signature, unsigned int index)
	Locate ACPI table via RSDT. More...
static int	acpi_zsdt (userptr_t zsdt, uint32_t signature, void *data, int(*extract)(userptr_t zsdt, size_t len, size_t offset, void *data))
	Extract value from DSDT/SSDT. More...
int	acpi_extract (uint32_t signature, void *data, int(*extract)(userptr_t zsdt, size_t len, size_t offset, void *data))
	Extract value from DSDT/SSDT. More...
void	acpi_add (struct acpi_descriptor *desc)
	Add ACPI descriptor. More...
void	acpi_del (struct acpi_descriptor *desc)
	Remove ACPI descriptor. More...
struct acpi_descriptor *	acpi_describe (struct interface *intf)
	Get object's ACPI descriptor. More...
int	acpi_install (int(*install)(struct acpi_header *acpi))
	Install ACPI tables. More...

Detailed Description

ACPI support functions.

Definition in file acpi.c.

Macro Definition Documentation

colour

#define colour   FADT_SIGNATURE

Colour for debug messages.

Definition at line 39 of file acpi.c.

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER_OR_UBDL

)

typeof()

typeof

(

acpi_finder =

acpi_find

)

ACPI table finder.

May be overridden at link time to inject tables for testing.Compute ACPI table checksum

Parameters

table

Any ACPI table

Return values

checksum

0 if checksum is good

Definition at line 45 of file acpi.c.

                                                 {
        struct acpi_header acpi;
        uint8_t sum = 0;
        uint8_t data = 0;
        unsigned int i;

        /* Read table length */
        copy_from_user ( &acpi.length, table,
                         offsetof ( typeof ( acpi ), length ),
                         sizeof ( acpi.length ) );

        /* Compute checksum */
        for ( i = 0 ; i < le32_to_cpu ( acpi.length ) ; i++ ) {
                copy_from_user ( &data, table, i, sizeof ( data ) );
                sum += data;
        }

        return sum;
}

References acpi, copy_from_user(), data, le32_to_cpu, length, and offsetof.

Referenced by __attribute__(), acpi_find_via_rsdt(), ar9002_hw_proc_txdesc(), ar9003_hw_proc_txdesc(), arbel_create_recv_wq(), arbel_fill_mlx_send_wqe(), arbel_fill_rc_send_wqe(), arbel_fill_ud_send_wqe(), asn1_bit_string(), asn1_built(), dhcpv6_iaaddr(), dhcpv6_rx(), dns_question(), dns_resolv(), dns_xfer_deliver(), draw_setting_row(), efi_ifr_string(), efi_nullify_pxe(), efi_nullify_snp(), efi_path_uri(), efi_pxe_ip_filter(), efi_pxe_ip_sockaddr(), exanic_poll_rx(), exanic_transmit(), fc_fill_sockaddr(), fcoe_deliver(), fcoe_fip_rx_els_response(), hash_df(), hermon_fill_eth_send_wqe(), hermon_fill_mlx_send_wqe(), hermon_fill_rc_send_wqe(), hermon_fill_ud_send_wqe(), hv_wait_for_message(), ib_sbft_install(), ibft_install(), int13_extended_rw(), int13_get_extended_parameters(), int13_load_eltorito(), interrupt_dump(), ipv6conf_rx_router_advertisement(), jme_poll(), list_test_exec(), md4_final(), md5_final(), meme820(), natsemi_create_ring(), ncm_in_complete(), ncm_out_transmit(), ndp_rx_neighbour(), ndp_rx_neighbour_advertisement_ll_target(), ndp_rx_neighbour_solicitation_ll_source(), ndp_rx_router_advertisement(), ndp_rx_router_advertisement_ll_source(), ntlm_response(), peerblk_parse_block(), peerblk_parse_useless(), peerblk_retrieval_open(), peerdist_info_v1_block(), pxebs_list(), select_setting_row(), sha1_final(), sha256_final(), sha512_final(), tls_client_hello(), tls_send_certificate(), tls_send_client_key_exchange_dhe(), usb_describe(), and usb_get_mtu().

acpi_fix_checksum()

void acpi_fix_checksum

(

struct acpi_header *

acpi

)

Fix up ACPI table checksum.

Parameters

acpi	ACPI table header

Definition at line 85 of file acpi.c.

                                                    {

        /* Update checksum */
        acpi->checksum -= acpi_checksum ( virt_to_user ( acpi ) );
}

References acpi, and virt_to_user().

Referenced by efi_block_install(), and int13_install().

acpi_table()

userptr_t acpi_table	(	uint32_t	signature,
		unsigned int	index
	)

Locate ACPI table.

Parameters

signature	Requested table signature
index	Requested index of table with this signature

Return values

table

Table, or UNULL if not found

Definition at line 98 of file acpi.c.

                                                                {

        return ( *acpi_finder ) ( signature, index );
}

References acpi_finder, index, and signature.

Referenced by acpi_extract(), acpi_poweroff(), acpi_settings_fetch(), acpi_timer_probe(), and ecam_find().

acpi_find_via_rsdt()

userptr_t acpi_find_via_rsdt	(	uint32_t	signature,
		unsigned int	index
	)

Locate ACPI table via RSDT.

Parameters

signature	Requested table signature
index	Requested index of table with this signature

Return values

table

Table, or UNULL if not found

Definition at line 110 of file acpi.c.

                                                                        {
        struct acpi_header acpi;
        struct acpi_rsdt *rsdtab;
        typeof ( rsdtab->entry[0] ) entry;
        userptr_t rsdt;
        userptr_t table;
        size_t len;
        unsigned int count;
        unsigned int i;

        /* Locate RSDT */
        rsdt = acpi_find_rsdt();
        if ( ! rsdt ) {
                DBG ( "RSDT not found\n" );
                return UNULL;
        }

        /* Read RSDT header */
        copy_from_user ( &acpi, rsdt, 0, sizeof ( acpi ) );
        if ( acpi.signature != cpu_to_le32 ( RSDT_SIGNATURE ) ) {
                DBGC ( colour, "RSDT %#08lx has invalid signature:\n",
                       user_to_phys ( rsdt, 0 ) );
                DBGC_HDA ( colour, user_to_phys ( rsdt, 0 ), &acpi,
                           sizeof ( acpi ) );
                return UNULL;
        }
        len = le32_to_cpu ( acpi.length );
        if ( len < sizeof ( rsdtab->acpi ) ) {
                DBGC ( colour, "RSDT %#08lx has invalid length:\n",
                       user_to_phys ( rsdt, 0 ) );
                DBGC_HDA ( colour, user_to_phys ( rsdt, 0 ), &acpi,
                           sizeof ( acpi ) );
                return UNULL;
        }

        /* Calculate number of entries */
        count = ( ( len - sizeof ( rsdtab->acpi ) ) / sizeof ( entry ) );

        /* Search through entries */
        for ( i = 0 ; i < count ; i++ ) {

                /* Get table address */
                copy_from_user ( &entry, rsdt,
                                 offsetof ( typeof ( *rsdtab ), entry[i] ),
                                 sizeof ( entry ) );

                /* Read table header */
                table = phys_to_user ( entry );
                copy_from_user ( &acpi.signature, table, 0,
                                 sizeof ( acpi.signature ) );

                /* Check table signature */
                if ( acpi.signature != cpu_to_le32 ( signature ) )
                        continue;

                /* Check index */
                if ( index-- )
                        continue;

                /* Check table integrity */
                if ( acpi_checksum ( table ) != 0 ) {
                        DBGC ( colour, "RSDT %#08lx found %s with bad "
                               "checksum at %08lx\n", user_to_phys ( rsdt, 0 ),
                               acpi_name ( signature ),
                               user_to_phys ( table, 0 ) );
                        break;
                }

                DBGC ( colour, "RSDT %#08lx found %s at %08lx\n",
                       user_to_phys ( rsdt, 0 ), acpi_name ( signature ),
                       user_to_phys ( table, 0 ) );
                return table;
        }

        DBGC ( colour, "RSDT %#08lx could not find %s\n",
               user_to_phys ( rsdt, 0 ), acpi_name ( signature ) );
        return UNULL;
}

References acpi, acpi_rsdt::acpi, acpi_find_rsdt(), acpi_name(), colour, copy_from_user(), count, cpu_to_le32, DBG, DBGC, DBGC_HDA, entry, acpi_rsdt::entry, index, le32_to_cpu, len, offsetof, phys_to_user(), RSDT_SIGNATURE, signature, typeof(), UNULL, and user_to_phys().

Referenced by acpi_find().

acpi_zsdt()

static int acpi_zsdt ( userptr_t  zsdt, uint32_t  signature, void *  data, int(*)(userptr_t zsdt, size_t len, size_t offset, void *data)  extract  )

static

Extract value from DSDT/SSDT.

Parameters

zsdt	DSDT or SSDT
signature	Signature (e.g. "_S5_")
data	Data buffer
extract	Extraction method

Return values

rc	Return status code

Definition at line 198 of file acpi.c.

                                                                         {
        struct acpi_header acpi;
        uint32_t buf;
        size_t offset;
        size_t len;
        int rc;

        /* Read table header */
        copy_from_user ( &acpi, zsdt, 0, sizeof ( acpi ) );
        len = le32_to_cpu ( acpi.length );

        /* Locate signature */
        for ( offset = sizeof ( acpi ) ;
              ( ( offset + sizeof ( buf ) /* signature */ ) < len ) ;
              offset++ ) {

                /* Check signature */
                copy_from_user ( &buf, zsdt, offset, sizeof ( buf ) );
                if ( buf != cpu_to_le32 ( signature ) )
                        continue;
                DBGC ( zsdt, "DSDT/SSDT %#08lx found %s at offset %#zx\n",
                       user_to_phys ( zsdt, 0 ), acpi_name ( signature ),
                       offset );

                /* Attempt to extract data */
                if ( ( rc = extract ( zsdt, len, offset, data ) ) == 0 )
                        return 0;
        }

        return -ENOENT;
}

References acpi, acpi_name(), copy_from_user(), cpu_to_le32, data, DBGC, ENOENT, le32_to_cpu, len, offset, rc, signature, and user_to_phys().

Referenced by acpi_extract().

acpi_extract()

int acpi_extract	(	uint32_t	signature,
		void *	data,
		int(*)(userptr_t zsdt, size_t len, size_t offset, void *data)	extract
	)

Extract value from DSDT/SSDT.

Parameters

signature	Signature (e.g. "_S5_")
data	Data buffer
extract	Extraction method

Return values

rc	Return status code

Definition at line 240 of file acpi.c.

                                                                     {
        struct acpi_fadt fadtab;
        userptr_t fadt;
        userptr_t dsdt;
        userptr_t ssdt;
        unsigned int i;
        int rc;

        /* Try DSDT first */
        fadt = acpi_table ( FADT_SIGNATURE, 0 );
        if ( fadt ) {
                copy_from_user ( &fadtab, fadt, 0, sizeof ( fadtab ) );
                dsdt = phys_to_user ( fadtab.dsdt );
                if ( ( rc = acpi_zsdt ( dsdt, signature, data,
                                        extract ) ) == 0 )
                        return 0;
        }

        /* Try all SSDTs */
        for ( i = 0 ; ; i++ ) {
                ssdt = acpi_table ( SSDT_SIGNATURE, i );
                if ( ! ssdt )
                        break;
                if ( ( rc = acpi_zsdt ( ssdt, signature, data,
                                        extract ) ) == 0 )
                        return 0;
        }

        DBGC ( colour, "ACPI could not find \"%s\"\n",
               acpi_name ( signature ) );
        return -ENOENT;
}

References acpi_name(), acpi_table(), acpi_zsdt(), colour, copy_from_user(), data, DBGC, acpi_fadt::dsdt, ENOENT, FADT_SIGNATURE, phys_to_user(), rc, signature, and SSDT_SIGNATURE.

Referenced by acpi_mac(), and acpi_poweroff().

acpi_add()

void acpi_add

(

struct acpi_descriptor *

desc

)

Add ACPI descriptor.

Parameters

desc	ACPI descriptor

Definition at line 287 of file acpi.c.

                                               {

        /* Add to list of descriptors */
        ref_get ( desc->refcnt );
        list_add_tail ( &desc->list, &desc->model->descs );
}

References desc, list_add_tail, and ref_get.

Referenced by sanpath_open().

acpi_del()

void acpi_del

(

struct acpi_descriptor *

desc

)

Remove ACPI descriptor.

Parameters

desc	ACPI descriptor

Definition at line 299 of file acpi.c.

                                               {

        /* Remove from list of descriptors */
        list_check_contains_entry ( desc, &desc->model->descs, list );
        list_del ( &desc->list );
        ref_put ( desc->refcnt );
}

References desc, list_check_contains_entry, list_del, and ref_put.

Referenced by sandev_undescribe(), and sanpath_open().

acpi_describe()

struct acpi_descriptor* acpi_describe

(

struct interface *

intf

)

Get object's ACPI descriptor.

Parameters

intf

Interface

Return values

desc	ACPI descriptor, or NULL

Definition at line 313 of file acpi.c.

                                                                  {
        struct interface *dest;
        acpi_describe_TYPE ( void * ) *op =
                intf_get_dest_op ( intf, acpi_describe, &dest );
        void *object = intf_object ( dest );
        struct acpi_descriptor *desc;

        if ( op ) {
                desc = op ( object );
        } else {
                desc = NULL;
        }

        intf_put ( dest );
        return desc;
}

References acpi_describe(), acpi_describe_TYPE, desc, dest, interface::intf, intf_get_dest_op, intf_object(), intf_put(), NULL, and op.

Referenced by acpi_describe(), and sanpath_open().

acpi_install()

int acpi_install

(

int(*)(struct acpi_header *acpi)

install

)

Install ACPI tables.

Parameters

install

Table installation method

Return values

rc	Return status code

Definition at line 336 of file acpi.c.

                                                                   {
        struct acpi_model *model;
        int rc;

        for_each_table_entry ( model, ACPI_MODELS ) {
                if ( ( rc = model->install ( install ) ) != 0 )
                        return rc;
        }

        return 0;
}

References ACPI_MODELS, for_each_table_entry, acpi_model::install, and rc.

Referenced by dummy_san_describe(), efi_block_describe(), and int13_describe().