pxe_image.c File Reference

PXE image format. More...

#include <pxe.h>
#include <pxe_call.h>
#include <gpxe/uaccess.h>
#include <gpxe/image.h>
#include <gpxe/segment.h>
#include <gpxe/netdevice.h>
#include <gpxe/features.h>

Go to the source code of this file.

Functions
	FILE_LICENCE (GPL2_OR_LATER)
	FEATURE (FEATURE_IMAGE,"PXE", DHCP_EB_FEATURE_PXE, 1)
struct image_type pxe_image_type	__image_type (PROBE_PXE)
	PXE image type.
static int	pxe_exec (struct image *image)
	Execute PXE image.
int	pxe_load (struct image *image)
	Load PXE image into memory.

---

Detailed Description

PXE image format.

Definition in file pxe_image.c.

---

Function Documentation

FILE_LICENCE

(

GPL2_OR_LATER

)

FEATURE	(	FEATURE_IMAGE	,
		"PXE"	,
		DHCP_EB_FEATURE_PXE	,
		1
	)

struct image_type pxe_image_type __image_type

(

PROBE_PXE

)

[read]

Initial value:

 {
        .name = "PXE",
        .load = pxe_load,
        .exec = pxe_exec,
}

PXE image type.

static int pxe_exec

(

struct image *

image

)

[static]

Execute PXE image.

Parameters:

image

PXE image

Return values:

rc

Return status code

Definition at line 46 of file pxe_image.c.

References DBGC, ENODEV, last_opened_netdev(), netdev, NULL, pxe_activate(), pxe_deactivate(), and pxe_start_nbp().

                                            {
        struct net_device *netdev;
        int rc;

        /* Arbitrarily pick the most recently opened network device */
        if ( ( netdev = last_opened_netdev() ) == NULL ) {
                DBGC ( image, "IMAGE %p could not locate PXE net device\n",
                       image );
                return -ENODEV;
        }

        /* Activate PXE */
        pxe_activate ( netdev );

        /* Start PXE NBP */
        rc = pxe_start_nbp();

        /* Deactivate PXE */
        pxe_deactivate();

        return rc;
}

int pxe_load

(

struct image *

image

)

Load PXE image into memory.

Parameters:

image

PXE file

Return values:

rc

Return status code

Definition at line 75 of file pxe_image.c.

References image::data, DBGC, ENOEXEC, image::len, memcpy_user(), prep_segment(), real_to_user(), strerror(), and image::type.

                                     {
        userptr_t buffer = real_to_user ( 0, 0x7c00 );
        size_t filesz = image->len;
        size_t memsz = image->len;
        int rc;

        /* Images too large to fit in base memory cannot be PXE
         * images.  We include this check to help prevent unrecognised
         * images from being marked as PXE images, since PXE images
         * have no signature we can check against.
         */
        if ( filesz > ( 0xa0000 - 0x7c00 ) )
                return -ENOEXEC;

        /* Rejecting zero-length images is also useful, since these
         * end up looking to the user like bugs in gPXE.
         */
        if ( ! filesz )
                return -ENOEXEC;

        /* There are no signature checks for PXE; we will accept anything */
        if ( ! image->type )
                image->type = &pxe_image_type;

        /* Verify and prepare segment */
        if ( ( rc = prep_segment ( buffer, filesz, memsz ) ) != 0 ) {
                DBGC ( image, "IMAGE %p could not prepare segment: %s\n",
                       image, strerror ( rc ) );
                return rc;
        }

        /* Copy image to segment */
        memcpy_user ( buffer, 0, image->data, 0, filesz );

        return 0;
}