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)
	EFI_USE_TABLE (FDT_TABLE, &efi_fdt, 0)
static void	efi_fdt_init (void)
	Initialise EFI Flattened Device Tree. More...
struct init_fn efi_fdt_init_fn	__init_fn (INIT_EARLY)
	EFI Flattened Device Tree initialisation function. More...
static size_t	efi_fdt_len (const void *data)
	Determine length of EFI Flattened Device Tree. More...
int	efi_fdt_install (const char *cmdline)
	Install EFI Flattened Device Tree table. More...
int	efi_fdt_uninstall (void)
	Uninstall EFI Flattened Device Tree table. More...

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

Detailed Description

EFI Flattened Device Tree.

Definition in file efi_fdt.c.

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER_OR_UBDL

)

EFI_USE_TABLE()

EFI_USE_TABLE	(	FDT_TABLE	,
		&	efi_fdt,
		0
	)

efi_fdt_init()

static void efi_fdt_init ( void  )

static

Initialise EFI Flattened Device Tree.

Definition at line 49 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, EFI_SYSTEM_TABLE::BootServices, DBGC, efi_fdt, efi_systab, EfiBootServicesData, fdt_parse(), fdt::len, memcpy(), fdt::raw, rc, strerror(), and sysfdt.

__init_fn()

struct init_fn efi_fdt_init_fn __init_fn

(

INIT_EARLY

)

EFI Flattened Device Tree initialisation function.

efi_fdt_len()

static 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 90 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 114 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 146 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 42 of file efi_fdt.c.

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

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 97 of file efi_fdt.c.

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 103 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 106 of file efi_fdt.c.

Referenced by efi_fdt_install(), and efi_fdt_uninstall().