sdi.c File Reference

System Deployment Image (SDI) More...

#include <stdint.h>
#include <string.h>
#include <errno.h>
#include <realmode.h>
#include <sdi.h>
#include <ipxe/image.h>
#include <ipxe/features.h>

Go to the source code of this file.

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
	FEATURE (FEATURE_IMAGE, "SDI", DHCP_EB_FEATURE_SDI, 1)
static int	sdi_exec (struct image *image)
	Execute SDI image. More...
static int	sdi_probe (struct image *image)
	Probe SDI image. More...
struct image_type sdi_image_type	__image_type (PROBE_NORMAL)
	SDI image type. More...

Detailed Description

System Deployment Image (SDI)

Based on the MSDN article "RAM boot using SDI in Windows XP Embedded with Service Pack 1", available at the time of writing from:

http://msdn.microsoft.com/en-us/library/ms838543.aspx

Definition in file sdi.c.

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER_OR_UBDL

)

FEATURE()

FEATURE	(	FEATURE_IMAGE	,
		"SDI"	,
		DHCP_EB_FEATURE_SDI	,
		1
	)

sdi_exec()

static int sdi_exec ( struct image *  image )

static

Execute SDI image.

Parameters

image

SDI file

Return values

rc	Return status code

Definition at line 53 of file sdi.c.

                                            {
        const struct sdi_header *sdi;
        uint32_t sdiptr;

        /* Sanity check */
        assert ( image->len >= sizeof ( *sdi ) );
        sdi = image->data;

        /* Check that image is bootable */
        if ( sdi->boot_size == 0 ) {
                DBGC ( image, "SDI %s is not bootable\n", image->name );
                return -ENOTTY;
        }
        DBGC ( image, "SDI %s image at %08lx+%08zx\n",
               image->name, virt_to_phys ( image->data ), image->len );
        DBGC ( image, "SDI %s boot code at %08llx+%llx\n", image->name,
               ( virt_to_phys ( image->data ) + sdi->boot_offset ),
               sdi->boot_size );

        /* Copy boot code */
        memcpy ( real_to_virt ( SDI_BOOT_SEG, SDI_BOOT_OFF ),
                 ( image->data + sdi->boot_offset ), sdi->boot_size );

        /* Jump to boot code */
        sdiptr = ( virt_to_phys ( image->data ) | SDI_WTF );
        __asm__ __volatile__ ( REAL_CODE ( "ljmp %0, %1\n\t" )
                               : : "i" ( SDI_BOOT_SEG ),
                                   "i" ( SDI_BOOT_OFF ),
                                   "d" ( sdiptr ) );

        /* There is no way for the image to return, since we provide
         * no return address.
         */
        assert ( 0 );

        return -ECANCELED; /* -EIMPOSSIBLE */
}

References __asm__(), __volatile__(), assert(), sdi_header::boot_offset, sdi_header::boot_size, image::data, DBGC, ECANCELED, ENOTTY, image::len, memcpy(), image::name, REAL_CODE, real_to_virt(), SDI_BOOT_OFF, SDI_BOOT_SEG, and SDI_WTF.

sdi_probe()

static int sdi_probe ( struct image *  image )

static

Probe SDI image.

Parameters

image

SDI file

Return values

rc	Return status code

Definition at line 97 of file sdi.c.

                                             {
        const struct sdi_header *sdi;

        /* Sanity check */
        if ( image->len < sizeof ( *sdi ) ) {
                DBGC ( image, "SDI %s too short for SDI header\n",
                       image->name );
                return -ENOEXEC;
        }
        sdi = image->data;

        /* Check signature */
        if ( sdi->magic != SDI_MAGIC ) {
                DBGC ( image, "SDI %s is not an SDI image\n",
                       image->name );
                return -ENOEXEC;
        }

        return 0;
}

References image::data, DBGC, ENOEXEC, image::len, sdi_header::magic, image::name, and SDI_MAGIC.

__image_type()

struct image_type sdi_image_type __image_type

(

PROBE_NORMAL

)

SDI image type.