embedded.c File Reference

Embedded image support. More...

#include <string.h>
#include <ipxe/image.h>
#include <ipxe/init.h>

Go to the source code of this file.

Macros
#define	EMBED(_index, _path, _name)
#define	EMBED(_index, _path, _name)

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
	FILE_SECBOOT (PERMITTED)
static void	embedded_init (void)
	Register all embedded images.
struct init_fn embedded_init_fn	__init_fn (INIT_LATE)
	Embedded image initialisation function.

Variables
static struct image	embedded_images []

Detailed Description

Embedded image support.

Embedded images are images built into the iPXE binary and do not require fetching over the network.

Definition in file embedded.c.

Macro Definition Documentation

EMBED [1/2]

#define EMBED	(		_index,
			_path,
			_name )

Value:

        extern char embedded_image_ ## _index ## _data[];               \
        extern size_t ABS_SYMBOL ( embedded_image_ ## _index ## _len );       \
        __asm__ ( ".section \".data\", \"aw\", " PROGBITS "\n\t"        \
                  "\nembedded_image_" #_index "_data:\n\t"              \
                  ".incbin \"" _path "\"\n\t"                           \
                  "\nembedded_image_" #_index "_end:\n\t"               \
                  ".equ embedded_image_" #_index "_len, "               \
                        "( embedded_image_" #_index "_end - "           \
                        "  embedded_image_" #_index "_data )\n\t"       \
                  ".previous\n\t" );

Definition at line 18 of file embedded.c.

#define EMBED( _index, _path, _name )                                   \
        extern char embedded_image_ ## _index ## _data[];               \
        extern size_t ABS_SYMBOL ( embedded_image_ ## _index ## _len ); \
        __asm__ ( ".section \".data\", \"aw\", " PROGBITS "\n\t"        \
                  "\nembedded_image_" #_index "_data:\n\t"              \
                  ".incbin \"" _path "\"\n\t"                           \
                  "\nembedded_image_" #_index "_end:\n\t"               \
                  ".equ embedded_image_" #_index "_len, "               \
                        "( embedded_image_" #_index "_end - "           \
                        "  embedded_image_" #_index "_data )\n\t"       \
                  ".previous\n\t" );

EMBED [2/2]

#define EMBED	(		_index,
			_path,
			_name )

Value:

        {                                       \
        .refcnt = REF_INIT ( free_image ),                            \
        .name = _name,                                                  \
        .flags = ( IMAGE_STATIC | IMAGE_STATIC_NAME ),                     \
        .rwdata = embedded_image_ ## _index ## _data,                   \
        .len = ABS_VALUE_INIT ( embedded_image_ ## _index ## _len ),   \
},

Definition at line 18 of file embedded.c.

#define EMBED( _index, _path, _name )                                   \
        extern char embedded_image_ ## _index ## _data[];               \
        extern size_t ABS_SYMBOL ( embedded_image_ ## _index ## _len ); \
        __asm__ ( ".section \".data\", \"aw\", " PROGBITS "\n\t"        \
                  "\nembedded_image_" #_index "_data:\n\t"              \
                  ".incbin \"" _path "\"\n\t"                           \
                  "\nembedded_image_" #_index "_end:\n\t"               \
                  ".equ embedded_image_" #_index "_len, "               \
                        "( embedded_image_" #_index "_end - "           \
                        "  embedded_image_" #_index "_data )\n\t"       \
                  ".previous\n\t" );

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER_OR_UBDL

)

FILE_SECBOOT()

FILE_SECBOOT

(

PERMITTED

)

embedded_init()

void embedded_init ( void )

static

Register all embedded images.

Definition at line 47 of file embedded.c.

                                   {
        int i;
        struct image *image;
        void *data;
        int rc;
 
        /* Skip if we have no embedded images */
        if ( ! sizeof ( embedded_images ) )
                return;
 
        /* Fix up data pointers and register images */
        for ( i = 0 ; i < ( int ) ( sizeof ( embedded_images ) /
                                    sizeof ( embedded_images[0] ) ) ; i++ ) {
                image = &embedded_images[i];
                DBG ( "Embedded image \"%s\": %zd bytes at %p\n",
                      image->name, image->len, data );
                if ( ( rc = register_image ( image ) ) != 0 ) {
                        DBG ( "Could not register embedded image \"%s\": "
                              "%s\n", image->name, strerror ( rc ) );
                        return;
                }
        }
 
        /* Select the first image */
        image = &embedded_images[0];
        if ( ( rc = image_select ( image ) ) != 0 ) {
                DBG ( "Could not select embedded image \"%s\": %s\n",
                      image->name, strerror ( rc ) );
                return;
        }
 
        /* Trust the selected image implicitly */
        image_trust ( image );
}

References data, DBG, embedded_images, image_select(), image_trust(), image::len, image::name, rc, register_image(), and strerror().

Referenced by __init_fn().

__init_fn()

struct init_fn embedded_init_fn __init_fn

(

INIT_LATE

)

Embedded image initialisation function.

References __init_fn, embedded_init(), and INIT_LATE.

Variable Documentation

embedded_images

struct image embedded_images[]

static

Initial value:

= {
        EMBED_ALL
}

Definition at line 40 of file embedded.c.

                                        {
        EMBED_ALL
};

Referenced by embedded_init().