bofm.c File Reference

IBM BladeCenter Open Fabric Manager (BOFM) More...

#include <stdint.h>
#include <string.h>
#include <errno.h>
#include <ipxe/list.h>
#include <ipxe/ethernet.h>
#include <ipxe/bofm.h>

Go to the source code of this file.

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
static	LIST_HEAD (bofmdevs)
	List of BOFM devices. More...
int	bofm_register (struct bofm_device *bofm)
	Register BOFM device. More...
void	bofm_unregister (struct bofm_device *bofm)
	Unregister BOFM device. More...
static struct bofm_device *	bofm_find_busdevfn (unsigned int busdevfn)
	Find BOFM device matching PCI bus:dev.fn address. More...
int	bofm_find_driver (struct pci_device *pci)
	Find BOFM driver for PCI device. More...
static int	bofm_probe (struct pci_device *pci)
	Probe PCI device for BOFM driver. More...
static void	bofm_remove (struct pci_device *pci)
	Remove PCI device. More...
static struct bofm_section_header *	bofm_locate_section (struct bofm_global_header *bofmhdr, uint32_t magic)
	Locate BOFM table section. More...
static int	bofm_en (struct bofm_device *bofm, struct bofm_en *en)
	Process BOFM Ethernet parameter entry. More...
int	bofm (void *bofmtab, struct pci_device *pci)
	Process BOFM table. More...

Detailed Description

IBM BladeCenter Open Fabric Manager (BOFM)

Definition in file bofm.c.

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER_OR_UBDL

)

LIST_HEAD()

static LIST_HEAD ( bofmdevs  )

static

List of BOFM devices.

bofm_register()

int bofm_register

(

struct bofm_device *

bofm

)

Register BOFM device.

Parameters

bofm	BOFM device

Return values

rc	Return status code

Definition at line 48 of file bofm.c.

                                               {

        list_add ( &bofm->list, &bofmdevs );
        DBG ( "BOFM: " PCI_FMT " registered using driver \"%s\"\n",
              PCI_ARGS ( bofm->pci ), bofm->pci->id->name );
        return 0;
}

References bofm(), DBG, list_add, PCI_ARGS, and PCI_FMT.

Referenced by bofm_dummy_probe(), and hermon_bofm_probe().

bofm_unregister()

void bofm_unregister

(

struct bofm_device *

bofm

)

Unregister BOFM device.

Parameters

bofm	BOFM device

Definition at line 61 of file bofm.c.

                                                  {

        list_del ( &bofm->list );
        DBG ( "BOFM: " PCI_FMT " unregistered\n", PCI_ARGS ( bofm->pci ) );
}

References bofm(), DBG, list_del, PCI_ARGS, and PCI_FMT.

Referenced by bofm_dummy_remove(), and hermon_bofm_remove().

bofm_find_busdevfn()

static struct bofm_device* bofm_find_busdevfn ( unsigned int  busdevfn )

static

Find BOFM device matching PCI bus:dev.fn address.

Parameters

busdevfn

PCI bus:dev.fn address

Return values

bofm	BOFM device, or NULL

Definition at line 73 of file bofm.c.

                                                                         {
        struct bofm_device *bofm;

        list_for_each_entry ( bofm, &bofmdevs, list ) {
                if ( bofm->pci->busdevfn == busdevfn )
                        return bofm;
        }
        return NULL;
}

References bofm(), busdevfn, bofm_device::list, list_for_each_entry, and NULL.

Referenced by bofm().

bofm_find_driver()

int bofm_find_driver

(

struct pci_device *

pci

)

Find BOFM driver for PCI device.

Parameters

pci	PCI device

Return values

rc	Return status code

Definition at line 89 of file bofm.c.

                                                {
        struct pci_driver *driver;
        struct pci_device_id *id;
        unsigned int i;

        for_each_table_entry ( driver, BOFM_DRIVERS ) {
                for ( i = 0 ; i < driver->id_count ; i++ ) {
                        id = &driver->ids[i];
                        if ( ( id->vendor == pci->vendor ) &&
                             ( id->device == pci->device ) ) {
                                pci_set_driver ( pci, driver, id );
                                return 0;
                        }
                }
        }
        return -ENOENT;
}

References BOFM_DRIVERS, pci_device::device, ENOENT, for_each_table_entry, id, pci_driver::id_count, pci_driver::ids, pci_set_driver(), and pci_device::vendor.

Referenced by bofm(), and efi_bofm_supported().

bofm_probe()

static int bofm_probe ( struct pci_device *  pci )

static

Probe PCI device for BOFM driver.

Parameters

pci	PCI device

Return values

rc	Return status code

Definition at line 113 of file bofm.c.

                                                 {
        int rc;

        /* Probe device */
        if ( ( rc = pci_probe ( pci ) ) != 0 ) {
                DBG ( "BOFM: " PCI_FMT " could not load driver: %s\n",
                      PCI_ARGS ( pci ), strerror ( rc ) );
                return rc;
        }

        return 0;
}

References DBG, PCI_ARGS, PCI_FMT, pci_probe(), rc, and strerror().

Referenced by bofm().

bofm_remove()

static void bofm_remove ( struct pci_device *  pci )

static

Remove PCI device.

Parameters

pci	PCI device

Definition at line 131 of file bofm.c.

                                                   {

        /* Note that the IBM BIOS may re-read the expansion ROM after
         * the BOFM initialisation call.  The BOFM driver must ensure
         * that the card is left in a state in which expansion ROM
         * reads will succeed.  (For example, if a card contains an
         * embedded CPU that may issue reads to the same underlying
         * flash device, and these reads are not locked against reads
         * via the expansion ROM BAR, then the CPU must be stopped.)
         *
         * If this is not done, then occasional corrupted reads from
         * the expansion ROM will be seen, and the BIOS may complain
         * about a ROM checksum error.
         */
        pci_remove ( pci );
        DBG ( "BOFM: " PCI_FMT " removed\n", PCI_ARGS ( pci ) );
}

References DBG, PCI_ARGS, PCI_FMT, and pci_remove().

Referenced by bofm().

bofm_locate_section()

static struct bofm_section_header* bofm_locate_section ( struct bofm_global_header *  bofmhdr, uint32_t  magic  )

static

Locate BOFM table section.

Parameters

bofmhdr	BOFM table header
magic	Section magic

Return values

bofmsec

BOFM section header, or NULL if not found

Definition at line 157 of file bofm.c.

                                                                           {
        struct bofm_section_header *bofmsec;
        size_t offset;

        /* Scan for section */
        for ( offset = sizeof ( *bofmhdr ) ; offset < bofmhdr->length ;
              offset += ( sizeof ( *bofmsec ) + bofmsec->length ) ) {
                bofmsec = ( ( ( void * ) bofmhdr ) + offset );
                if ( bofmsec->magic == magic )
                        return bofmsec;
                if ( bofmsec->magic == BOFM_DONE_MAGIC )
                        break;
        }
        return NULL;
}

References BOFM_DONE_MAGIC, bofm_global_header::length, bofm_section_header::length, magic, bofm_section_header::magic, NULL, and offset.

Referenced by bofm().

bofm_en()

static int bofm_en ( struct bofm_device *  bofm, struct bofm_en *  en  )

static

Process BOFM Ethernet parameter entry.

Parameters

bofm	BOFM device
en	EN parameter entry

Return values

rc	Return status code

Definition at line 180 of file bofm.c.

                                                                    {
        uint8_t mac[6];
        int rc;

        /* Retrieve current MAC address */
        if ( ( rc = bofm->op->harvest ( bofm, en->mport, mac ) ) != 0 ) {
                DBG ( "BOFM: " PCI_FMT " mport %d could not harvest: %s\n",
                      PCI_ARGS ( bofm->pci ), en->mport, strerror ( rc ) );
                return rc;
        }

        /* Harvest MAC address if necessary */
        if ( en->options & BOFM_EN_RQ_HVST_MASK ) {
                DBG ( "BOFM: " PCI_FMT " mport %d harvested MAC %s\n",
                      PCI_ARGS ( bofm->pci ), en->mport, eth_ntoa ( mac ) );
                memcpy ( en->mac_a, mac, sizeof ( en->mac_a ) );
                en->options |= ( BOFM_EN_EN_A | BOFM_EN_HVST );
        }

        /* Mark as changed if necessary */
        if ( ( en->options & BOFM_EN_EN_A ) &&
             ( memcmp ( en->mac_a, mac, sizeof ( en->mac_a ) ) != 0 ) ) {
                DBG ( "BOFM: " PCI_FMT " mport %d MAC %s",
                      PCI_ARGS ( bofm->pci ), en->mport, eth_ntoa ( mac ) );
                DBG ( " changed to %s\n", eth_ntoa ( en->mac_a ) );
                en->options |= BOFM_EN_CHG_CHANGED;
        }

        /* Apply MAC address if necessary */
        if ( ( en->options & BOFM_EN_EN_A ) &&
             ( en->options & BOFM_EN_USAGE_ENTRY ) &&
             ( ! ( en->options & BOFM_EN_USAGE_HARVEST ) ) ) {
                DBG ( "BOFM: " PCI_FMT " mport %d applied MAC %s\n",
                      PCI_ARGS ( bofm->pci ), en->mport,
                      eth_ntoa ( en->mac_a ) );
                memcpy ( mac, en->mac_a, sizeof ( mac ) );
        }

        /* Store MAC address */
        if ( ( rc = bofm->op->update ( bofm, en->mport, mac ) ) != 0 ) {
                DBG ( "BOFM: " PCI_FMT " mport %d could not update: %s\n",
                      PCI_ARGS ( bofm->pci ), en->mport, strerror ( rc ) );
                return rc;
        }

        return 0;
}

References bofm(), BOFM_EN_CHG_CHANGED, BOFM_EN_EN_A, BOFM_EN_HVST, BOFM_EN_RQ_HVST_MASK, BOFM_EN_USAGE_ENTRY, BOFM_EN_USAGE_HARVEST, DBG, en, eth_ntoa(), mac, bofm_en::mac_a, memcmp(), memcpy(), bofm_en::mport, bofm_en::options, PCI_ARGS, PCI_FMT, rc, and strerror().

bofm()

int bofm	(	void *	bofmtab,
		struct pci_device *	pci
	)

Process BOFM table.

Parameters

bofmtab	BOFM table
pci	PCI device

Return values

bofmrc

BOFM return status

Definition at line 235 of file bofm.c.

                                                   {
        struct bofm_global_header *bofmhdr;
        struct bofm_section_header *bofmsec;
        struct bofm_en *en;
        struct bofm_device *bofm;
        size_t offset;
        int skip;
        int rc;
        int bofmrc;

        /* Read BOFM structure */
        bofmhdr = bofmtab;
        if ( bofmhdr->magic != BOFM_IOAA_MAGIC ) {
                DBG ( "BOFM: invalid table signature " BOFM_MAGIC_FMT "\n",
                      BOFM_MAGIC_ARGS ( bofmhdr->magic ) );
                bofmrc = BOFM_ERR_INVALID_ACTION;
                goto err_bad_signature;
        }
        DBG ( "BOFM: " BOFM_MAGIC_FMT " (profile \"%s\")\n",
              BOFM_MAGIC_ARGS ( bofmhdr->action ), bofmhdr->profile );

        /* Determine whether or not we should skip normal POST
         * initialisation.
         */
        switch ( bofmhdr->action ) {
        case BOFM_ACTION_UPDT:
        case BOFM_ACTION_DFLT:
        case BOFM_ACTION_HVST:
                skip = BOFM_SKIP_INIT;
                break;
        case BOFM_ACTION_PARM:
        case BOFM_ACTION_NONE:
                skip = 0;
                break;
        default:
                DBG ( "BOFM: invalid action " BOFM_MAGIC_FMT "\n",
                      BOFM_MAGIC_ARGS ( bofmhdr->action ) );
                bofmrc = BOFM_ERR_INVALID_ACTION;
                goto err_bad_action;
        }

        /* Find BOFM driver */
        if ( ( rc = bofm_find_driver ( pci ) ) != 0 ) {
                DBG ( "BOFM: " PCI_FMT " has no driver\n", PCI_ARGS ( pci ) );
                bofmrc = BOFM_ERR_DEVICE_ERROR;
                goto err_find_driver;
        }

        /* Probe driver for PCI device */
        if ( ( rc = bofm_probe ( pci ) ) != 0 ) {
                bofmrc = BOFM_ERR_DEVICE_ERROR;
                goto err_probe;
        }

        /* Locate EN section, if present */
        bofmsec = bofm_locate_section ( bofmhdr, BOFM_EN_MAGIC );
        if ( ! bofmsec ) {
                DBG ( "BOFM: No EN section found\n" );
                bofmrc = ( BOFM_SUCCESS | skip );
                goto err_no_en_section;
        }

        /* Iterate through EN entries */
        for ( offset = sizeof ( *bofmsec ) ; offset < bofmsec->length ;
              offset += sizeof ( *en ) ) {
                en = ( ( ( void * ) bofmsec ) + offset );
                DBG2 ( "BOFM: EN entry found:\n" );
                DBG2_HDA ( offset, en, sizeof ( *en ) );
                if ( ( en->options & BOFM_EN_MAP_MASK ) != BOFM_EN_MAP_PFA ) {
                        DBG ( "BOFM: slot %d port %d has no PCI mapping\n",
                              en->slot, ( en->port + 1 ) );
                        continue;
                }
                DBG ( "BOFM: slot %d port %d%s is " PCI_FMT " mport %d\n",
                      en->slot, ( en->port + 1 ),
                      ( ( en->slot || en->port ) ? "" : "(?)" ), 0,
                      PCI_BUS ( en->busdevfn ), PCI_SLOT ( en->busdevfn ),
                      PCI_FUNC ( en->busdevfn ), en->mport );
                bofm = bofm_find_busdevfn ( en->busdevfn );
                if ( ! bofm ) {
                        DBG ( "BOFM: " PCI_FMT " mport %d ignored\n", 0,
                              PCI_BUS ( en->busdevfn ),
                              PCI_SLOT ( en->busdevfn ),
                              PCI_FUNC ( en->busdevfn ), en->mport );
                        continue;
                }
                if ( ( rc = bofm_en ( bofm, en ) ) == 0 ) {
                        en->options |= BOFM_EN_CSM_SUCCESS;
                } else {
                        en->options |= BOFM_EN_CSM_FAILED;
                }
                DBG2 ( "BOFM: EN entry after processing:\n" );
                DBG2_HDA ( offset, en, sizeof ( *en ) );
        }

        bofmrc = ( BOFM_SUCCESS | skip );

 err_no_en_section:
        bofm_remove ( pci );
 err_probe:
 err_find_driver:
 err_bad_action:
 err_bad_signature:
        return bofmrc;
}

References bofm_global_header::action, bofm(), BOFM_ACTION_DFLT, BOFM_ACTION_HVST, BOFM_ACTION_NONE, BOFM_ACTION_PARM, BOFM_ACTION_UPDT, BOFM_EN_CSM_FAILED, BOFM_EN_CSM_SUCCESS, BOFM_EN_MAGIC, BOFM_EN_MAP_MASK, BOFM_EN_MAP_PFA, BOFM_ERR_DEVICE_ERROR, BOFM_ERR_INVALID_ACTION, bofm_find_busdevfn(), bofm_find_driver(), BOFM_IOAA_MAGIC, bofm_locate_section(), BOFM_MAGIC_ARGS, BOFM_MAGIC_FMT, bofm_probe(), bofm_remove(), BOFM_SKIP_INIT, BOFM_SUCCESS, bofm_en::busdevfn, DBG, DBG2, DBG2_HDA, en, bofm_section_header::length, bofm_global_header::magic, bofm_en::mport, offset, bofm_en::options, bofm_device::pci, PCI_ARGS, PCI_BUS, PCI_FMT, PCI_FUNC, PCI_SLOT, bofm_en::port, bofm_global_header::profile, rc, and bofm_en::slot.

Referenced by bofm(), bofm_dummy_harvest(), bofm_en(), bofm_find_busdevfn(), bofm_init(), bofm_register(), bofm_test(), bofm_unregister(), efi_bofm_start(), hermon_bofm_harvest(), and hermon_bofm_update().