efi_fdt.c File Reference

EFI Flattened Device Tree. More...

#include <string.h>
#include <byteswap.h>
#include <ipxe/fdt.h>
#include <ipxe/init.h>
#include <ipxe/efi/efi.h>
#include <ipxe/efi/efi_table.h>
#include <ipxe/efi/efi_fdt.h>
#include <ipxe/efi/Guid/Fdt.h>

Go to the source code of this file.

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
	FILE_SECBOOT (PERMITTED)
	EFI_USE_TABLE (FDT_TABLE, &efi_fdt, 0)
static void	efi_fdt_init (void)
	Initialise EFI Flattened Device Tree.
struct init_fn efi_fdt_init_fn	__init_fn (INIT_EARLY)
	EFI Flattened Device Tree initialisation function.
static size_t	efi_fdt_len (const void *data)
	Determine length of EFI Flattened Device Tree.
int	efi_fdt_install (const char *cmdline)
	Install EFI Flattened Device Tree table.
int	efi_fdt_uninstall (void)
	Uninstall EFI Flattened Device Tree table.

Variables
static struct fdt_header *	efi_fdt
	EFI Flattened Device Tree configuration table.
static struct efi_table	efi_fdt_table
	EFI Flattened Device Tree table type.
static void *	efi_fdt_backup
	EFI Flattened Device Tree table backup.
static struct fdt_header *	efi_fdt_installed
	EFI Flattened Device Tree installed table.

Detailed Description

EFI Flattened Device Tree.

Definition in file efi_fdt.c.

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER_OR_UBDL

)

FILE_SECBOOT()

FILE_SECBOOT

(

PERMITTED

)

EFI_USE_TABLE()

EFI_USE_TABLE	(	FDT_TABLE	,
		&	efi_fdt,
		0	)

References efi_fdt.

efi_fdt_init()

void efi_fdt_init ( void )

static

Initialise EFI Flattened Device Tree.

Definition at line 50 of file efi_fdt.c.

                                  {
        EFI_BOOT_SERVICES *bs = efi_systab->BootServices;
        EFI_STATUS efirc;
        int rc;
 
        /* Do nothing if no configuration table is present */
        if ( ! efi_fdt ) {
                DBGC ( &efi_fdt, "EFIFDT has no configuration table\n" );
                return;
        }
        DBGC ( &efi_fdt, "EFIFDT configuration table at %p\n", efi_fdt );
 
        /* Parse as system device tree */
        if ( ( rc = fdt_parse ( &sysfdt, efi_fdt, -1UL ) ) != 0 ) {
                DBGC ( &efi_fdt, "EFIFDT could not parse: %s\n",
                       strerror ( rc ) );
                return;
        }
 
        /* Create copy, since table may be removed at any time */
        if ( ( efirc = bs->AllocatePool ( EfiBootServicesData, sysfdt.len,
                                          &sysfdt.raw ) ) != 0 ) {
                DBGC ( &efi_fdt, "EFIFDT could not create copy\n" );
                sysfdt.len = 0;
                return;
        }
        memcpy ( sysfdt.raw, efi_fdt, sysfdt.len );
}

References EFI_BOOT_SERVICES::AllocatePool, DBGC, efi_fdt, efi_systab, EfiBootServicesData, fdt_parse(), memcpy(), rc, strerror(), and sysfdt.

Referenced by __init_fn().

__init_fn()

struct init_fn efi_fdt_init_fn __init_fn

(

INIT_EARLY

)

EFI Flattened Device Tree initialisation function.

References __init_fn, efi_fdt_init(), and INIT_EARLY.

efi_fdt_len()

size_t efi_fdt_len ( const void * data )

static

Determine length of EFI Flattened Device Tree.

Parameters

data	Configuration table data (presumed valid)

Return values

len	Length of table

Definition at line 91 of file efi_fdt.c.

                                               {
        const struct fdt_header *hdr = data;
 
        return be32_to_cpu ( hdr->totalsize );
}

References be32_to_cpu, data, and hdr.

efi_fdt_install()

int efi_fdt_install

(

const char *

cmdline

)

Install EFI Flattened Device Tree table.

Parameters

cmdline

Command line, or NULL

Return values

rc	Return status code

Definition at line 115 of file efi_fdt.c.

                                            {
        int rc;
 
        /* Create device tree */
        if ( ( rc = fdt_create ( &efi_fdt_installed, cmdline, 0, 0 ) ) != 0 ) {
                DBGC ( &efi_fdt, "EFI_FDT could not install: %s\n",
                       strerror ( rc ) );
                goto err_create;
        }
 
        /* Install table */
        if ( ( rc = efi_install_table ( &efi_fdt_table, efi_fdt_installed,
                                        &efi_fdt_backup ) ) != 0 ) {
                DBGC ( &efi_fdt, "EFIFDT could not install: %s\n",
                       strerror ( rc ) );
                goto err_install;
        }
 
        return 0;
 
        efi_uninstall_table ( &efi_fdt_table, &efi_fdt_backup );
 err_install:
        fdt_remove ( efi_fdt_installed );
 err_create:
        return rc;
}

References cmdline, DBGC, efi_fdt, efi_fdt_backup, efi_fdt_installed, efi_fdt_table, efi_install_table(), efi_uninstall_table(), fdt_create(), fdt_remove(), rc, and strerror().

efi_fdt_uninstall()

int efi_fdt_uninstall

(

void

)

Uninstall EFI Flattened Device Tree table.

Uninstall EFI Flattened Device Tree table (when no FDT support is present)

Return values

rc	Return status code

Definition at line 147 of file efi_fdt.c.

                               {
        int rc;
 
        /* Uninstall table */
        if ( ( rc = efi_uninstall_table ( &efi_fdt_table,
                                          &efi_fdt_backup ) ) != 0 ) {
                DBGC ( &efi_fdt, "EFIFDT could not %sinstall: %s\n",
                       ( efi_fdt_backup ? "re" : "un" ), strerror ( rc ) );
                /* Leak memory: there is nothing else we can do */
                return rc;
        }
 
        /* Remove table */
        fdt_remove ( efi_fdt_installed );
 
        return 0;
}

References DBGC, efi_fdt, efi_fdt_backup, efi_fdt_installed, efi_fdt_table, efi_uninstall_table(), fdt_remove(), rc, and strerror().

Variable Documentation

efi_fdt

struct fdt_header* efi_fdt

static

EFI Flattened Device Tree configuration table.

Definition at line 43 of file efi_fdt.c.

Referenced by efi_fdt_init(), efi_fdt_install(), efi_fdt_uninstall(), EFI_USE_TABLE(), and PROVIDE_REQUIRING_SYMBOL().

efi_fdt_table

struct efi_table efi_fdt_table

static

Initial value:

= {
        .guid = &efi_fdt_table_guid,
        .len = efi_fdt_len,
}

EFI Flattened Device Tree table type.

Definition at line 98 of file efi_fdt.c.

                                        {
        .guid = &efi_fdt_table_guid,
        .len = efi_fdt_len,
};

Referenced by efi_fdt_install(), and efi_fdt_uninstall().

efi_fdt_backup

void* efi_fdt_backup

static

EFI Flattened Device Tree table backup.

Definition at line 104 of file efi_fdt.c.

Referenced by efi_fdt_install(), and efi_fdt_uninstall().

efi_fdt_installed

struct fdt_header* efi_fdt_installed

static

EFI Flattened Device Tree installed table.

Definition at line 107 of file efi_fdt.c.

Referenced by efi_fdt_install(), and efi_fdt_uninstall().