undiload.h File Reference

UNDI load/unload. More...

Go to the source code of this file.

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
int	undi_load (struct undi_device *undi, struct undi_rom *undirom)
	Call UNDI loader to create a pixie.
int	undi_unload (struct undi_device *undi)
	Unload a pixie.
static int	undi_load_pci (struct undi_device *undi, struct undi_rom *undirom, unsigned int pci_busdevfn)
	Call UNDI loader to create a pixie.

Detailed Description

UNDI load/unload.

Definition in file undiload.h.

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER_OR_UBDL

)

undi_load()

int undi_load ( struct undi_device * undi, struct undi_rom * undirom )

extern

Call UNDI loader to create a pixie.

Parameters

undi	UNDI device
undirom	UNDI ROM

Return values

rc	Return status code

Definition at line 66 of file undiload.c.

                                                                     {
        struct s_PXE ppxe;
        unsigned int fbms_seg;
        uint16_t exit;
        int rc;
 
        /* Only one UNDI instance may be loaded at any given time */
        if ( undi_loader_entry.segment ) {
                DBG ( "UNDI %p cannot load multiple instances\n", undi );
                rc = -EBUSY;
                goto err_multiple;
        }
 
        /* Set up START_UNDI parameters */
        memset ( &undi_loader, 0, sizeof ( undi_loader ) );
        undi_loader.AX = undi->pci_busdevfn;
        undi_loader.BX = undi->isapnp_csn;
        undi_loader.DX = undi->isapnp_read_port;
        undi_loader.ES = BIOS_SEG;
        undi_loader.DI = find_pnp_bios();
 
        /* Allocate base memory for PXE stack */
        undi->restore_fbms = get_fbms();
        fbms_seg = ( undi->restore_fbms << 6 );
        fbms_seg -= ( ( undirom->code_size + 0x0f ) >> 4 );
        undi_loader.UNDI_CS = fbms_seg;
        fbms_seg -= ( ( undirom->data_size + 0x0f ) >> 4 );
        undi_loader.UNDI_DS = fbms_seg;
        undi->fbms = ( fbms_seg >> 6 );
        set_fbms ( undi->fbms );
        DBGC ( undi, "UNDI %p allocated [%d,%d) kB of base memory\n",
               undi, undi->fbms, undi->restore_fbms );
 
        /* Debug info */
        DBGC ( undi, "UNDI %p loading ROM %p to CS %04x:%04zx DS %04x:%04zx "
               "for ", undi, undirom, undi_loader.UNDI_CS, undirom->code_size,
               undi_loader.UNDI_DS, undirom->data_size );
        if ( undi->pci_busdevfn != UNDI_NO_PCI_BUSDEVFN ) {
                unsigned int bus = ( undi->pci_busdevfn >> 8 );
                unsigned int devfn = ( undi->pci_busdevfn & 0xff );
                DBGC ( undi, "PCI %02x:%02x.%x\n",
                       bus, PCI_SLOT ( devfn ), PCI_FUNC ( devfn ) );
        }
        if ( undi->isapnp_csn != UNDI_NO_ISAPNP_CSN ) {
                DBGC ( undi, "ISAPnP(%04x) CSN %04x\n",
                       undi->isapnp_read_port, undi->isapnp_csn );
        }
 
        /* Call loader */
        undi_loader_entry = undirom->loader_entry;
        __asm__ __volatile__ ( REAL_CODE ( "pushl %%ebp\n\t" /* gcc bug */
                                           "pushw %%ds\n\t"
                                           "pushw %%ax\n\t"
                                           "lcall *undi_loader_entry\n\t"
                                           "popl %%ebp\n\t" /* discard */
                                           "popl %%ebp\n\t" /* gcc bug */ )
                               : "=a" ( exit )
                               : "a" ( __from_data16 ( &undi_loader ) )
                               : "ebx", "ecx", "edx", "esi", "edi" );
        if ( exit != PXENV_EXIT_SUCCESS ) {
                rc = -EUNDILOAD ( undi_loader.Status );
                DBGC ( undi, "UNDI %p loader failed: %s\n",
                       undi, strerror ( rc ) );
                goto err_loader;
        }
 
        /* Populate PXE device structure */
        undi->pxenv = undi_loader.PXENVptr;
        undi->ppxe = undi_loader.PXEptr;
        copy_from_real ( &ppxe, undi->ppxe.segment, undi->ppxe.offset,
                         sizeof ( ppxe ) );
        undi->entry = ppxe.EntryPointSP;
        DBGC ( undi, "UNDI %p loaded PXENV+ %04x:%04x !PXE %04x:%04x "
               "entry %04x:%04x\n", undi, undi->pxenv.segment,
               undi->pxenv.offset, undi->ppxe.segment, undi->ppxe.offset,
               undi->entry.segment, undi->entry.offset );
 
        return 0;
 
 err_loader:
        set_fbms ( undi->restore_fbms );
        memset ( &undi_loader_entry, 0, sizeof ( undi_loader_entry ) );
 err_multiple:
        return rc;
}

References __asm__(), __from_data16, __volatile__(), BIOS_SEG, bus, undi_rom::code_size, copy_from_real, undi_rom::data_size, DBG, DBGC, EBUSY, undi_device::entry, EUNDILOAD, undi_device::fbms, find_pnp_bios(), get_fbms(), undi_device::isapnp_csn, undi_device::isapnp_read_port, undi_rom::loader_entry, memset(), undi_device::pci_busdevfn, PCI_FUNC, PCI_SLOT, ppxe, undi_device::ppxe, undi_device::pxenv, PXENV_EXIT_SUCCESS, rc, REAL_CODE, undi_device::restore_fbms, set_fbms(), strerror(), undi_loader, undi_loader_entry, UNDI_NO_ISAPNP_CSN, and UNDI_NO_PCI_BUSDEVFN.

Referenced by undi_load_pci().

undi_unload()

int undi_unload ( struct undi_device * undi )

extern

Unload a pixie.

Parameters

undi	UNDI device

Return values

rc	Return status code

Erases the PXENV+ and !PXE signatures, and frees the used base memory (if possible).

Definition at line 161 of file undiload.c.

                                             {
        static uint32_t dead = 0xdeaddead;
 
        DBGC ( undi, "UNDI %p unloading\n", undi );
 
        /* Clear entry point */
        memset ( &undi_loader_entry, 0, sizeof ( undi_loader_entry ) );
 
        /* Erase signatures */
        if ( undi->pxenv.segment )
                put_real ( dead, undi->pxenv.segment, undi->pxenv.offset );
        if ( undi->ppxe.segment )
                put_real ( dead, undi->ppxe.segment, undi->ppxe.offset );
 
        /* Free base memory, if possible */
        if ( undi->fbms == get_fbms() ) {
                DBGC ( undi, "UNDI %p freeing [%d,%d) kB of base memory\n",
                       undi, undi->fbms, undi->restore_fbms );
                set_fbms ( undi->restore_fbms );
                return 0;
        } else {
                DBGC ( undi, "UNDI %p leaking [%d,%d) kB of base memory\n",
                       undi, undi->fbms, undi->restore_fbms );
                return -EBUSY;
        }
}

References DBGC, EBUSY, undi_device::fbms, get_fbms(), memset(), undi_device::ppxe, put_real, undi_device::pxenv, undi_device::restore_fbms, set_fbms(), and undi_loader_entry.

Referenced by undipci_probe(), and undipci_remove().

undi_load_pci()

int undi_load_pci ( struct undi_device * undi, struct undi_rom * undirom, unsigned int pci_busdevfn )

inlinestatic

Call UNDI loader to create a pixie.

Parameters

undi	UNDI device
undirom	UNDI ROM
pci_busdevfn	PCI bus:dev.fn

Return values

rc	Return status code

Definition at line 26 of file undiload.h.

                                                              {
        undi->pci_busdevfn = pci_busdevfn;
        undi->isapnp_csn = UNDI_NO_ISAPNP_CSN;
        undi->isapnp_read_port = UNDI_NO_ISAPNP_READ_PORT;
        return undi_load ( undi, undirom );
}

References undi_device::isapnp_csn, undi_device::isapnp_read_port, undi_device::pci_busdevfn, undi_load(), UNDI_NO_ISAPNP_CSN, and UNDI_NO_ISAPNP_READ_PORT.

Referenced by undipci_probe().