undirom.c File Reference

UNDI expansion ROMs. More...

#include <stdint.h>
#include <stdlib.h>
#include <string.h>
#include <pxe.h>
#include <realmode.h>
#include <undirom.h>

Go to the source code of this file.

Functions
	FILE_LICENCE (GPL2_OR_LATER)
static	LIST_HEAD (undiroms)
	List of all UNDI ROMs. More...
static int	undirom_parse_pxeromid (struct undi_rom *undirom, unsigned int pxeromid)
	Parse PXE ROM ID structure. More...
static int	undirom_parse_pcirheader (struct undi_rom *undirom, unsigned int pcirheader)
	Parse PCI expansion header. More...
static int	undirom_probe (unsigned int rom_segment)
	Probe UNDI ROM. More...
static void	undirom_probe_all_roms (void)
	Create UNDI ROMs for all possible expansion ROMs. More...
struct undi_rom *	undirom_find_pci (unsigned int vendor_id, unsigned int device_id, unsigned int rombase)
	Find UNDI ROM for PCI device. More...

Detailed Description

UNDI expansion ROMs.

Definition in file undirom.c.

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER

)

LIST_HEAD()

static LIST_HEAD ( undiroms  )

static

List of all UNDI ROMs.

undirom_parse_pxeromid()

static int undirom_parse_pxeromid ( struct undi_rom *  undirom, unsigned int  pxeromid  )

static

Parse PXE ROM ID structure.

Parameters

undirom	UNDI ROM
pxeromid	Offset within ROM to PXE ROM ID structure

Return values

rc	Return status code

Definition at line 45 of file undirom.c.

                                                           {
        struct undi_rom_id undi_rom_id;
        unsigned int undiloader;

        DBGC ( undirom, "UNDIROM %p has PXE ROM ID at %04x:%04x\n", undirom,
               undirom->rom_segment, pxeromid );

        /* Read PXE ROM ID structure and verify */
        copy_from_real ( &undi_rom_id, undirom->rom_segment, pxeromid,
                         sizeof ( undi_rom_id ) );
        if ( undi_rom_id.Signature != UNDI_ROM_ID_SIGNATURE ) {
                DBGC ( undirom, "UNDIROM %p has bad PXE ROM ID signature "
                       "%08x\n", undirom, undi_rom_id.Signature );
                return -EINVAL;
        }

        /* Check for UNDI loader */
        undiloader = undi_rom_id.UNDILoader;
        if ( ! undiloader ) {
                DBGC ( undirom, "UNDIROM %p has no UNDI loader\n", undirom );
                return -EINVAL;
        }

        /* Fill in UNDI ROM loader fields */
        undirom->loader_entry.segment = undirom->rom_segment;
        undirom->loader_entry.offset = undiloader;
        undirom->code_size = undi_rom_id.CodeSize;
        undirom->data_size = undi_rom_id.DataSize;

        DBGC ( undirom, "UNDIROM %p has UNDI loader at %04x:%04x "
               "(code %04zx data %04zx)\n", undirom,
               undirom->loader_entry.segment, undirom->loader_entry.offset,
               undirom->code_size, undirom->data_size );
        return 0;
}

References undi_rom::code_size, undi_rom_id::CodeSize, copy_from_real, undi_rom::data_size, undi_rom_id::DataSize, DBGC, EINVAL, undi_rom::loader_entry, undi_rom::rom_segment, undi_rom_id::Signature, UNDI_ROM_ID_SIGNATURE, and undi_rom_id::UNDILoader.

Referenced by undirom_probe().

undirom_parse_pcirheader()

static int undirom_parse_pcirheader ( struct undi_rom *  undirom, unsigned int  pcirheader  )

static

Parse PCI expansion header.

Parameters

undirom	UNDI ROM
pcirheader	Offset within ROM to PCI expansion header

Definition at line 88 of file undirom.c.

                                                               {
        struct pcir_header pcir_header;

        DBGC ( undirom, "UNDIROM %p has PCI expansion header at %04x:%04x\n",
               undirom, undirom->rom_segment, pcirheader );

        /* Read PCI expansion header and verify */
        copy_from_real ( &pcir_header, undirom->rom_segment, pcirheader,
                         sizeof ( pcir_header ) );
        if ( pcir_header.signature != PCIR_SIGNATURE ) {
                DBGC ( undirom, "UNDIROM %p has bad PCI expansion header "
                       "signature %08x\n", undirom, pcir_header.signature );
                return -EINVAL;
        }

        /* Fill in UNDI ROM PCI device fields */
        undirom->bus_type = PCI_NIC;
        undirom->bus_id.pci.vendor_id = pcir_header.vendor_id;
        undirom->bus_id.pci.device_id = pcir_header.device_id;

        DBGC ( undirom, "UNDIROM %p is for PCI devices %04x:%04x\n", undirom,
               undirom->bus_id.pci.vendor_id, undirom->bus_id.pci.device_id );
        return 0;
        
}

References undi_rom::bus_id, undi_rom::bus_type, copy_from_real, DBGC, undi_pci_device_id::device_id, pcir_header::device_id, EINVAL, undi_device_id::pci, PCI_NIC, PCIR_SIGNATURE, undi_rom::rom_segment, pcir_header::signature, undi_pci_device_id::vendor_id, and pcir_header::vendor_id.

Referenced by undirom_probe().

undirom_probe()

static int undirom_probe ( unsigned int  rom_segment )

static

Probe UNDI ROM.

Parameters

rom_segment

ROM segment address

Return values

rc	Return status code

Definition at line 121 of file undirom.c.

                                                      {
        struct undi_rom *undirom = NULL;
        struct undi_rom_header romheader;
        size_t rom_len;
        unsigned int pxeromid;
        unsigned int pcirheader;
        int rc;

        /* Read expansion ROM header and verify */
        copy_from_real ( &romheader, rom_segment, 0, sizeof ( romheader ) );
        if ( romheader.Signature != ROM_SIGNATURE ) {
                rc = -EINVAL;
                goto err;
        }
        rom_len = ( romheader.ROMLength * 512 );

        /* Allocate memory for UNDI ROM */
        undirom = zalloc ( sizeof ( *undirom ) );
        if ( ! undirom ) {
                DBG ( "Could not allocate UNDI ROM structure\n" );
                rc = -ENOMEM;
                goto err;
        }
        DBGC ( undirom, "UNDIROM %p trying expansion ROM at %04x:0000 "
               "(%zdkB)\n", undirom, rom_segment, ( rom_len / 1024 ) );
        undirom->rom_segment = rom_segment;

        /* Check for and parse PXE ROM ID */
        pxeromid = romheader.PXEROMID;
        if ( ! pxeromid ) {
                DBGC ( undirom, "UNDIROM %p has no PXE ROM ID\n", undirom );
                rc = -EINVAL;
                goto err;
        }
        if ( pxeromid > rom_len ) {
                DBGC ( undirom, "UNDIROM %p PXE ROM ID outside ROM\n",
                       undirom );
                rc = -EINVAL;
                goto err;
        }
        if ( ( rc = undirom_parse_pxeromid ( undirom, pxeromid ) ) != 0 )
                goto err;

        /* Parse PCIR header, if present */
        pcirheader = romheader.PCIRHeader;
        if ( pcirheader )
                undirom_parse_pcirheader ( undirom, pcirheader );

        /* Add to UNDI ROM list and return */
        DBGC ( undirom, "UNDIROM %p registered\n", undirom );
        list_add_tail ( &undirom->list, &undiroms );
        return 0;

 err:
        free ( undirom );
        return rc;
}

References copy_from_real, DBG, DBGC, EINVAL, ENOMEM, free, undi_rom::list, list_add_tail, NULL, undi_rom_header::PCIRHeader, undi_rom_header::PXEROMID, rc, undi_rom::rom_segment, ROM_SIGNATURE, undi_rom_header::ROMLength, undi_rom_header::Signature, undirom_parse_pcirheader(), undirom_parse_pxeromid(), and zalloc().

Referenced by undirom_probe_all_roms().

undirom_probe_all_roms()

static void undirom_probe_all_roms ( void  )

static

Create UNDI ROMs for all possible expansion ROMs.

Return values

Definition at line 184 of file undirom.c.

                                            {
        static int probed = 0;
        unsigned int rom_segment;

        /* Perform probe only once */
        if ( probed )
                return;

        DBG ( "Scanning for PXE expansion ROMs\n" );

        /* Scan through expansion ROM region at 512 byte intervals */
        for ( rom_segment = 0xc000 ; rom_segment < 0x10000 ;
              rom_segment += 0x20 ) {
                undirom_probe ( rom_segment );
        }

        probed = 1;
}

References DBG, and undirom_probe().

Referenced by undirom_find_pci().

undirom_find_pci()

struct undi_rom* undirom_find_pci	(	unsigned int	vendor_id,
		unsigned int	device_id,
		unsigned int	rombase
	)

Find UNDI ROM for PCI device.

Parameters

vendor_id	PCI vendor ID
device_id	PCI device ID
rombase	ROM base address, or 0 for any

Return values

undirom

UNDI ROM, or NULL

Definition at line 211 of file undirom.c.

                                                            {
        struct undi_rom *undirom;

        undirom_probe_all_roms();

        list_for_each_entry ( undirom, &undiroms, list ) {
                if ( undirom->bus_type != PCI_NIC )
                        continue;
                if ( undirom->bus_id.pci.vendor_id != vendor_id )
                        continue;
                if ( undirom->bus_id.pci.device_id != device_id )
                        continue;
                if ( rombase && ( ( undirom->rom_segment << 4 ) != rombase ) )
                        continue;
                DBGC ( undirom, "UNDIROM %p matched PCI %04x:%04x (%08x)\n",
                       undirom, vendor_id, device_id, rombase );
                return undirom;
        }

        DBG ( "No UNDI ROM matched PCI %04x:%04x (%08x)\n",
              vendor_id, device_id, rombase );
        return NULL;
}

References undi_rom::bus_id, undi_rom::bus_type, DBG, DBGC, undi_pci_device_id::device_id, device_id, undi_rom::list, list_for_each_entry, NULL, undi_device_id::pci, PCI_NIC, undi_rom::rom_segment, undirom_probe_all_roms(), undi_pci_device_id::vendor_id, and vendor_id.

Referenced by undipci_find_rom().