bofm_test.c File Reference

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

#include <stdint.h>
#include <stdio.h>
#include <string.h>
#include <byteswap.h>
#include <ipxe/init.h>
#include <ipxe/pci.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)
void	bofm_test (struct pci_device *pci)
	Perform BOFM test.
static int	bofm_dummy_harvest (struct bofm_device *bofm, unsigned int mport, uint8_t *mac)
	Harvest dummy Ethernet MAC.
static int	bofm_dummy_update (struct bofm_device *bofm __unused, unsigned int mport, const uint8_t *mac)
	Update Ethernet MAC for BOFM.
static int	bofm_dummy_probe (struct pci_device *pci)
	Probe dummy BOFM device.
static void	bofm_dummy_remove (struct pci_device *pci)
	Remove dummy BOFM device.
static void	bofm_test_init (void)
	Perform BOFM test at initialisation time.
struct init_fn bofm_test_init_fn	__init_fn (INIT_NORMAL)
	BOFM test initialisation function.

Variables
struct {
struct bofm_global_header   header
struct bofm_section_header   en_header
struct bofm_en   en
struct bofm_section_header   done
}	bofmtab_harvest
	Harvest test table.
struct {
struct bofm_global_header   header
struct bofm_section_header   en_header
struct bofm_en   en
struct bofm_section_header   done
}	bofmtab_update
	Update test table.
static struct bofm_operations	bofm_dummy_operations
	Dummy BOFM operations.
static struct bofm_device	bofm_dummy
	Dummy BOFM device.
static struct pci_device_id	bofm_dummy_ids [1]
	Dummy BOFM driver PCI IDs.
struct pci_driver bofm_dummy_driver	__bofm_test_driver
	Dummy BOFM driver.

Detailed Description

IBM BladeCenter Open Fabric Manager (BOFM) tests.

Definition in file bofm_test.c.

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER_OR_UBDL

)

bofm_test()

void bofm_test

(

struct pci_device *

pci

)

Perform BOFM test.

Parameters

pci	PCI device

Definition at line 105 of file bofm_test.c.

                                          {
        int bofmrc;
 
        printf ( "BOFMTEST using " PCI_FMT "\n", PCI_ARGS ( pci ) );
 
        /* Perform harvest test */
        printf ( "BOFMTEST performing harvest\n" );
        bofmtab_harvest.en.busdevfn = pci->busdevfn;
        DBG_HDA ( 0, &bofmtab_harvest, sizeof ( bofmtab_harvest ) );
        bofmrc = bofm ( &bofmtab_harvest, pci );
        printf ( "BOFMTEST harvest result %08x\n", bofmrc );
        if ( bofmtab_harvest.en.options & BOFM_EN_HVST ) {
                printf ( "BOFMTEST harvested MAC address %s\n",
                         eth_ntoa ( &bofmtab_harvest.en.mac_a ) );
        } else {
                printf ( "BOFMTEST failed to harvest a MAC address\n" );
        }
        DBG_HDA ( 0, &bofmtab_harvest, sizeof ( bofmtab_harvest ) );
 
        /* Perform update test */
        printf ( "BOFMTEST performing update\n" );
        bofmtab_update.en.busdevfn = pci->busdevfn;
        DBG_HDA ( 0, &bofmtab_update, sizeof ( bofmtab_update ) );
        bofmrc = bofm ( &bofmtab_update, pci );
        printf ( "BOFMTEST update result %08x\n", bofmrc );
        if ( bofmtab_update.en.options & BOFM_EN_CSM_SUCCESS ) {
                printf ( "BOFMTEST updated MAC address to %s\n",
                         eth_ntoa ( &bofmtab_update.en.mac_a ) );
        } else {
                printf ( "BOFMTEST failed to update MAC address\n" );
        }
        DBG_HDA ( 0, &bofmtab_update, sizeof ( bofmtab_update ) );
}

References bofm(), BOFM_EN_CSM_SUCCESS, BOFM_EN_HVST, bofmtab_harvest, bofmtab_update, pci_device::busdevfn, DBG_HDA, eth_ntoa(), PCI_ARGS, PCI_FMT, and printf().

Referenced by bofm_test_init().

bofm_dummy_harvest()

int bofm_dummy_harvest ( struct bofm_device * bofm, unsigned int mport, uint8_t * mac )

static

Harvest dummy Ethernet MAC.

Parameters

bofm	BOFM device
mport	Multi-port index
mac	MAC to fill in

Return values

rc	Return status code

Definition at line 147 of file bofm_test.c.

                                               {
        struct {
                uint16_t vendor;
                uint16_t device;
                uint16_t mport;
        } __attribute__ (( packed )) dummy_mac;
 
        /* Construct dummy MAC address */
        dummy_mac.vendor = cpu_to_be16 ( bofm->pci->vendor );
        dummy_mac.device = cpu_to_be16 ( bofm->pci->device );
        dummy_mac.mport = cpu_to_be16 ( mport );
        memcpy ( mac, &dummy_mac, sizeof ( dummy_mac ) );
        printf ( "BOFMTEST mport %d constructed dummy MAC %s\n",
                 mport, eth_ntoa ( mac ) );
 
        return 0;
}

References __attribute__, bofm(), cpu_to_be16, eth_ntoa(), mac, memcpy(), printf(), and vendor.

bofm_dummy_update()

int bofm_dummy_update ( struct bofm_device *bofm __unused, unsigned int mport, const uint8_t * mac )

static

Update Ethernet MAC for BOFM.

Parameters

bofm	BOFM device
mport	Multi-port index
mac	MAC to fill in

Return values

rc	Return status code

Definition at line 174 of file bofm_test.c.

                                                                        {
 
        printf ( "BOFMTEST mport %d asked to update MAC to %s\n",
                 mport, eth_ntoa ( mac ) );
        return 0;
}

References __unused, bofm(), eth_ntoa(), mac, and printf().

bofm_dummy_probe()

int bofm_dummy_probe ( struct pci_device * pci )

static

Probe dummy BOFM device.

Parameters

pci	PCI device
id	PCI ID

Return values

rc	Return status code

Definition at line 198 of file bofm_test.c.

                                                       {
        int rc;
 
        /* Ignore probe for any other devices */
        if ( pci->busdevfn != bofm_dummy.pci->busdevfn )
                return 0;
 
        /* Register BOFM device */
        if ( ( rc = bofm_register ( &bofm_dummy ) ) != 0 )
                return rc;
 
        printf ( "BOFMTEST using dummy BOFM driver\n" );
        return 0;
}

References bofm_dummy, bofm_register(), pci_device::busdevfn, bofm_device::pci, printf(), and rc.

bofm_dummy_remove()

void bofm_dummy_remove ( struct pci_device * pci )

static

Remove dummy BOFM device.

Parameters

pci	PCI device

Definition at line 218 of file bofm_test.c.

                                                         {
 
        /* Ignore removal for any other devices */
        if ( pci->busdevfn != bofm_dummy.pci->busdevfn )
                return;
 
        /* Unregister BOFM device */
        bofm_unregister ( &bofm_dummy );
}

References bofm_dummy, bofm_unregister(), pci_device::busdevfn, and bofm_device::pci.

bofm_test_init()

void bofm_test_init ( void )

static

Perform BOFM test at initialisation time.

Definition at line 246 of file bofm_test.c.

                                    {
        struct pci_device pci;
        int busdevfn = -1;
        int rc;
 
        /* Uncomment the following line and specify the correct PCI
         * bus:dev.fn address in order to perform a BOFM test at
         * initialisation time.
         */
        // busdevfn = PCI_BUSDEVFN ( <segment>, <bus>, <dev>, <fn> );
 
        /* Skip test if no PCI bus:dev.fn is defined */
        if ( busdevfn < 0 )
                return;
 
        /* Initialise PCI device */
        memset ( &pci, 0, sizeof ( pci ) );
        pci_init ( &pci, busdevfn );
        if ( ( rc = pci_read_config ( &pci ) ) != 0 ) {
                printf ( "BOFMTEST could not create " PCI_FMT " device: %s\n",
                         PCI_ARGS ( &pci ), strerror ( rc ) );
                return;
        }
 
        /* Initialise dummy BOFM device */
        bofm_init ( &bofm_dummy, &pci, &bofm_dummy_operations );
        bofm_dummy_ids[0].vendor = pci.vendor;
        bofm_dummy_ids[0].device = pci.device;
 
        /* Perform test */
        bofm_test ( &pci );
}

References bofm_dummy, bofm_dummy_ids, bofm_dummy_operations, bofm_init(), bofm_test(), busdevfn, pci_device::device, memset(), PCI_ARGS, PCI_FMT, pci_init(), pci_read_config(), printf(), rc, strerror(), and pci_device::vendor.

Referenced by __init_fn().

__init_fn()

struct init_fn bofm_test_init_fn __init_fn

(

INIT_NORMAL

)

BOFM test initialisation function.

References __init_fn, bofm_test_init(), and INIT_NORMAL.

Variable Documentation

header

struct bofm_global_header header

Definition at line 43 of file bofm_test.c.

en_header

struct bofm_section_header en_header

Definition at line 44 of file bofm_test.c.

en

struct bofm_en en

Definition at line 45 of file bofm_test.c.

Referenced by bofm(), and bofm_en().

done

struct bofm_section_header done

Definition at line 46 of file bofm_test.c.

Referenced by aoecmd_rx(), arp_rx(), ath5k_eeprom_read_modes(), ath5k_get_chan_pcal_surrounding_piers(), ath5k_get_rate_pcal_data(), ath5k_hw_gainf_calibrate(), ath5k_hw_rf511x_calibrate(), ath5k_hw_rf_gainf_adjust(), ath5k_hw_update_tx_triglevel(), ath5k_init(), bnxt_service_cq(), bnxt_service_nq(), dhcp_tx(), dhcpv6_rx(), dm96xx_intr_complete(), dns_xfer_deliver(), execv(), fc_els_rx(), fc_ns_query(), fc_ns_query_deliver(), fc_xchg_rx(), fc_xchg_tx(), fcoe_deliver(), fcoe_fip_rx(), fcoe_rx(), fcpcmd_recv_rddata(), fcpcmd_recv_rsp(), fcpcmd_recv_xfer_rdy(), gve_poll_rx(), heap_alloc_block(), hub_complete(), icmpv6_rx(), ipv4_add_miniroutes(), isapnpbus_probe(), iscsi_socket_deliver(), nfs_deliver(), nfs_mount_deliver(), nfs_pm_deliver(), parse_uri(), peerblk_raw_close(), peerblk_retrieval_close(), readline_history(), rtl818x_handle_rx(), sec80211_detect_ie(), sky2_tx_complete(), smscusb_intr_complete(), stp_rx(), tftp_rx(), tftp_rx_data(), tftp_rx_oack(), tg3_phy_autoneg_cfg(), tls_cipherstream_deliver(), tls_plainstream_deliver(), udp_rx(), undinet_poll(), undinet_transmit(), and xferbuf_deliver().

[struct]

struct { ... } bofmtab_harvest

Initial value:

= {
        .header = {
                .magic = BOFM_IOAA_MAGIC,
                .action = BOFM_ACTION_HVST,
                .version = 0x01,
                .level = 0x01,
                .length = sizeof ( bofmtab_harvest ),
                .profile = "Harvest test profile",
        },
        .en_header = {
                .magic = BOFM_EN_MAGIC,
                .length = sizeof ( bofmtab_harvest.en ),
        },
        .en = {
                .options = ( BOFM_EN_MAP_PFA | BOFM_EN_USAGE_HARVEST |
                             BOFM_EN_RQ_HVST_ACTIVE ),
                .mport = 1,
        },
        .done = {
                .magic = BOFM_DONE_MAGIC,
        },
}

Harvest test table.

Referenced by bofm_test().

[struct]

struct { ... } bofmtab_update

Initial value:

= {
        .header = {
                .magic = BOFM_IOAA_MAGIC,
                .action = BOFM_ACTION_UPDT,
                .version = 0x01,
                .level = 0x01,
                .length = sizeof ( bofmtab_update ),
                .profile = "Update test profile",
        },
        .en_header = {
                .magic = BOFM_EN_MAGIC,
                .length = sizeof ( bofmtab_update.en ),
        },
        .en = {
                .options = ( BOFM_EN_MAP_PFA | BOFM_EN_EN_A |
                             BOFM_EN_USAGE_ENTRY ),
                .mport = 1,
                .mac_a = { 0x02, 0x00, 0x69, 0x50, 0x58, 0x45 },
        },
        .done = {
                .magic = BOFM_DONE_MAGIC,
        },
}

Update test table.

Referenced by bofm_test().

bofm_dummy_operations

struct bofm_operations bofm_dummy_operations

static

Initial value:

= {
        .harvest = bofm_dummy_harvest,
        .update = bofm_dummy_update,
}

Dummy BOFM operations.

Definition at line 183 of file bofm_test.c.

                                                      {
        .harvest = bofm_dummy_harvest,
        .update = bofm_dummy_update,
};

Referenced by bofm_test_init().

bofm_dummy

struct bofm_device bofm_dummy

static

Dummy BOFM device.

Definition at line 189 of file bofm_test.c.

Referenced by bofm_dummy_probe(), bofm_dummy_remove(), and bofm_test_init().

bofm_dummy_ids

struct pci_device_id bofm_dummy_ids[1]

static

Initial value:

= {
        { .name = "dummy" },
}

Dummy BOFM driver PCI IDs.

Definition at line 229 of file bofm_test.c.

                                                {
        { .name = "dummy" },
};

Referenced by bofm_test_init().

__bofm_test_driver

struct pci_driver bofm_dummy_driver __bofm_test_driver

Initial value:

= {
        .ids = bofm_dummy_ids,
        .id_count = ( sizeof ( bofm_dummy_ids ) /
                      sizeof ( bofm_dummy_ids[0] ) ),
        .probe = bofm_dummy_probe,
        .remove = bofm_dummy_remove,
}

Dummy BOFM driver.

Definition at line 234 of file bofm_test.c.

                                                         {
        .ids = bofm_dummy_ids,
        .id_count = ( sizeof ( bofm_dummy_ids ) /
                      sizeof ( bofm_dummy_ids[0] ) ),
        .probe = bofm_dummy_probe,
        .remove = bofm_dummy_remove,
};