pxe_image.c File Reference

PXE image format. More...

#include <string.h>
#include <pxe.h>
#include <pxe_call.h>
#include <pic8259.h>
#include <ipxe/image.h>
#include <ipxe/segment.h>
#include <ipxe/netdevice.h>
#include <ipxe/features.h>
#include <ipxe/console.h>
#include <ipxe/efi/efi.h>
#include <ipxe/efi/IndustryStandard/PeImage.h>

Go to the source code of this file.

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
	FEATURE (FEATURE_IMAGE, "PXE", DHCP_EB_FEATURE_PXE, 1)
static int	pxe_exec (struct image *image)
	Execute PXE image. More...
int	pxe_probe (struct image *image)
	Probe PXE image. More...
int	pxe_probe_no_mz (struct image *image)
	Probe PXE image (with rejection of potential EFI images) More...
struct image_type pxe_image_type []	__image_type (PROBE_PXE)
	PXE image type. More...

Variables
const char *	pxe_cmdline
	PXE command line. More...

Detailed Description

PXE image format.

Definition in file pxe_image.c.

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER_OR_UBDL

)

FEATURE()

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

pxe_exec()

static int pxe_exec ( struct image *  image )

static

Execute PXE image.

Parameters

image

PXE image

Return values

rc	Return status code

Definition at line 56 of file pxe_image.c.

                                            {
        void *buffer = real_to_virt ( 0, 0x7c00 );
        struct net_device *netdev;
        int rc;

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

        /* Copy image to segment */
        memcpy ( buffer, image->data, image->len );

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

        /* Activate PXE */
        pxe_activate ( netdev );

        /* Construct fake DHCP packets */
        pxe_fake_cached_info();

        /* Set PXE command line */
        pxe_cmdline = image->cmdline;

        /* Reset console since PXE NBP will probably use it */
        console_reset();

        /* Disable IRQ, if applicable */
        if ( netdev_irq_supported ( netdev ) && netdev->dev->desc.irq )
                disable_irq ( netdev->dev->desc.irq );

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

        /* Clear PXE command line */
        pxe_cmdline = NULL;

        /* Deactivate PXE */
        pxe_deactivate();

        /* Try to reopen network device.  Ignore errors, since the NBP
         * may have called PXENV_STOP_UNDI.
         */
        netdev_open ( netdev );
        netdev_put ( netdev );

        return rc;
}

References buffer, image::cmdline, console_reset(), image::data, DBGC, device::desc, net_device::dev, ENODEV, device_description::irq, last_opened_netdev(), image::len, memcpy(), image::name, netdev, netdev_get(), netdev_irq_supported(), netdev_open(), netdev_put(), NULL, prep_segment(), pxe_activate(), pxe_cmdline, pxe_deactivate(), pxe_fake_cached_info(), pxe_start_nbp(), rc, real_to_virt(), and strerror().

pxe_probe()

int pxe_probe

(

struct image *

image

)

Probe PXE image.

Parameters

image

PXE file

Return values

rc	Return status code

Definition at line 119 of file pxe_image.c.

                                      {

        /* 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 ( image->len > ( 0xa0000 - 0x7c00 ) )
                return -ENOEXEC;

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

        return 0;
}

References ENOEXEC, and image::len.

Referenced by pxe_probe_no_mz().

pxe_probe_no_mz()

int pxe_probe_no_mz

(

struct image *

image

)

Probe PXE image (with rejection of potential EFI images)

Parameters

image

PXE file

Return values

rc	Return status code

Definition at line 144 of file pxe_image.c.

                                            {
        const uint16_t *magic;
        int rc;

        /* Probe PXE image */
        if ( ( rc = pxe_probe ( image ) ) != 0 )
                return rc;

        /* Reject image with an "MZ" signature which may indicate an
         * EFI image incorrectly handed out to a BIOS system.
         */
        if ( image->len >= sizeof ( *magic ) ) {
                magic = image->data;
                if ( *magic == cpu_to_le16 ( EFI_IMAGE_DOS_SIGNATURE ) ) {
                        DBGC ( image, "IMAGE %s may be an EFI image\n",
                               image->name );
                        return -ENOTTY;
                }
        }

        return 0;
}

References cpu_to_le16, image::data, DBGC, EFI_IMAGE_DOS_SIGNATURE, ENOTTY, image::len, magic, image::name, pxe_probe(), and rc.

__image_type()

struct image_type pxe_image_type [] __image_type

(

PROBE_PXE

)

PXE image type.

Variable Documentation

pxe_cmdline

const char* pxe_cmdline

PXE command line.

Definition at line 48 of file pxe_image.c.

Referenced by pxe_exec(), and pxenv_file_cmdline().