iSCSI boot firmware table More...

#include <stdint.h>
#include <stdlib.h>
#include <stdio.h>
#include <string.h>
#include <errno.h>
#include <byteswap.h>
#include <ipxe/pci.h>
#include <ipxe/acpi.h>
#include <ipxe/in.h>
#include <ipxe/netdevice.h>
#include <ipxe/ethernet.h>
#include <ipxe/vlan.h>
#include <ipxe/tcpip.h>
#include <ipxe/dhcp.h>
#include <ipxe/iscsi.h>
#include <ipxe/ibft.h>

Data Structures
struct	ibft_strings
	iSCSI string buffer More...

Functions
	FILE_LICENCE (BSD2)

static size_t	ibft_align (size_t len)
	Align structure within iBFT. More...

static void	ibft_set_ipaddr (struct ibft_ipaddr *ipaddr, struct in_addr in)
	Fill in an IP address field within iBFT. More...

static void	ibft_set_ipaddr_setting (struct settings settings, struct ibft_ipaddr ipaddr, const struct setting *setting, unsigned int count)
	Fill in an IP address within iBFT from configuration setting. More...

static const char *	ibft_ipaddr (struct ibft_ipaddr *ipaddr)
	Read IP address from iBFT (for debugging) More...

static char *	ibft_alloc_string (struct ibft_strings strings, struct ibft_string string, size_t len)
	Allocate a string within iBFT. More...

static int	ibft_set_string (struct ibft_strings strings, struct ibft_string string, const char *data)
	Fill in a string field within iBFT. More...

static int	ibft_set_string_setting (struct settings settings, struct ibft_strings strings, struct ibft_string string, const struct setting setting)
	Fill in a string field within iBFT from configuration setting. More...

static const char *	ibft_string (struct ibft_strings strings, struct ibft_string string)
	Read string from iBFT (for debugging) More...

static int	ibft_netdev_is_required (struct net_device *netdev)
	Check if network device is required for the iBFT. More...

static int	ibft_fill_nic (struct ibft_nic nic, struct ibft_strings strings, struct net_device *netdev)
	Fill in NIC portion of iBFT. More...

static int	ibft_fill_initiator (struct ibft_initiator initiator, struct ibft_strings strings, const char *initiator_iqn)
	Fill in Initiator portion of iBFT. More...

static int	ibft_fill_target_nic_association (struct ibft_target target, struct iscsi_session iscsi)
	Fill in Target NIC association. More...

static int	ibft_fill_target_chap (struct ibft_target target, struct ibft_strings strings, struct iscsi_session *iscsi)
	Fill in Target CHAP portion of iBFT. More...

static int	ibft_fill_target_reverse_chap (struct ibft_target target, struct ibft_strings strings, struct iscsi_session *iscsi)
	Fill in Target Reverse CHAP portion of iBFT. More...

static int	ibft_fill_target (struct ibft_target target, struct ibft_strings strings, struct iscsi_session *iscsi)
	Fill in Target portion of iBFT. More...

static int	ibft_complete (struct acpi_descriptor *desc)
	Check if iBFT descriptor is complete. More...

static int	ibft_install (int(install)(struct acpi_header acpi))
	Install iBFT. More...

Variables
struct acpi_model ibft_model	__acpi_model
	iBFT model More...

Detailed Description

iSCSI boot firmware table

The information in this file is originally derived from the document "iSCSI Boot Firmware Table (iBFT)" as published by IBM at:

ftp://ftp.software.ibm.com/systems/support/system_x_pdf/ibm_iscsi_boot_firmware_table_v1.02.pdf

That file is no longer available, but a more recent version is available:

ftp://ftp.software.ibm.com/systems/support/bladecenter/iscsi_boot_firmware_table_v1.03.pdf

Definition in file ibft.c.

Function Documentation

◆ FILE_LICENCE()

FILE_LICENCE ( BSD2 )

◆ ibft_align()

static size_t ibft_align ( size_t len )

inlinestatic

Align structure within iBFT.

Parameters

len	Unaligned length (or offset)

Return values

len	Aligned length (or offset)

Definition at line 83 of file ibft.c.

                                                {
 
         return ( ( len + IBFT_ALIGN - 1 ) & ~( IBFT_ALIGN - 1 ) );
 }

References IBFT_ALIGN, and len.

Referenced by ibft_install().

◆ ibft_set_ipaddr()

static void ibft_set_ipaddr	(	struct ibft_ipaddr *	ipaddr,
		struct in_addr	in
	)

static

Fill in an IP address field within iBFT.

Parameters

ipaddr	IP address field
in	IPv4 address

Definition at line 94 of file ibft.c.

                                                                               {
         memset ( ipaddr, 0, sizeof ( *ipaddr ) );
         if ( in.s_addr ) {
                 ipaddr->in = in;
                 ipaddr->ones = 0xffff;
         }
 }

References in, ibft_ipaddr::in, memset(), and ibft_ipaddr::ones.

Referenced by ibft_fill_target(), and ibft_set_ipaddr_setting().

◆ ibft_set_ipaddr_setting()

static void ibft_set_ipaddr_setting	(	struct settings *	settings,
		struct ibft_ipaddr *	ipaddr,
		const struct setting *	setting,
		unsigned int	count
	)

static

Fill in an IP address within iBFT from configuration setting.

Parameters

settings	Parent settings block, or NULL
ipaddr	IP address field
setting	Configuration setting
count	Maximum number of IP addresses

Definition at line 110 of file ibft.c.

                                                            {
         struct in_addr in[count];
         unsigned int i;
 
         fetch_ipv4_array_setting ( settings, setting, in, count );
         for ( i = 0 ; i < count ; i++ ) {
                 ibft_set_ipaddr ( &ipaddr[i], in[i] );
         }
 }

References count, fetch_ipv4_array_setting(), ibft_set_ipaddr(), and in.

Referenced by ibft_fill_nic().

◆ ibft_ipaddr()

static const char* ibft_ipaddr ( struct ibft_ipaddr * ipaddr )

static

Read IP address from iBFT (for debugging)

Parameters

strings	iBFT string block descriptor
string	String field

Return values

ipaddr IP address string

Definition at line 130 of file ibft.c.

                                                                {
         return inet_ntoa ( ipaddr->in );
 }

References ibft_ipaddr::in, and inet_ntoa().

◆ ibft_alloc_string()

static char* ibft_alloc_string	(	struct ibft_strings *	strings,
		struct ibft_string *	string,
		size_t	len
	)

static

Allocate a string within iBFT.

Parameters

strings	iBFT string block descriptor
string	String field to fill in
len	Length of string to allocate (excluding NUL)

Return values

dest	String destination, or NULL

Definition at line 142 of file ibft.c.

                                                                            {
         size_t new_len;
         char *new_data;
         char *dest;
 
         /* Extend string data buffer */
         new_len = ( strings->len + len + 1 /* NUL */ );
         new_data = realloc ( strings->data, new_len );
         if ( ! new_data )
                 return NULL;
         strings->data = new_data;
 
         /* Fill in string field */
         string->offset = cpu_to_le16 ( strings->start + strings->len );
         string->len = cpu_to_le16 ( len );
 
         /* Zero string */
         dest = ( strings->data + strings->len );
         memset ( dest, 0, ( len + 1 /* NUL */ ) );
 
         /* Update allocated length */
         strings->len = new_len;
 
         return dest;
 }

References cpu_to_le16, ibft_strings::data, dest, len, ibft_strings::len, memset(), NULL, realloc(), and ibft_strings::start.

Referenced by ibft_set_string(), and ibft_set_string_setting().

◆ ibft_set_string()

static int ibft_set_string	(	struct ibft_strings *	strings,
		struct ibft_string *	string,
		const char *	data
	)

static

Fill in a string field within iBFT.

Parameters

strings	iBFT string block descriptor
string	String field
data	String to fill in, or NULL

Return values

rc	Return status code

Definition at line 177 of file ibft.c.

                                                                             {
         char *dest;
 
         if ( ! data )
                 return 0;
 
         dest = ibft_alloc_string ( strings, string, strlen ( data ) );
         if ( ! dest )
                 return -ENOBUFS;
         strcpy ( dest, data );
 
         return 0;
 }

References data, dest, ENOBUFS, ibft_alloc_string(), strcpy(), and strlen().

Referenced by ibft_fill_initiator(), ibft_fill_target(), ibft_fill_target_chap(), and ibft_fill_target_reverse_chap().

◆ ibft_set_string_setting()

static int ibft_set_string_setting	(	struct settings *	settings,
		struct ibft_strings *	strings,
		struct ibft_string *	string,
		const struct setting *	setting
	)

static

Fill in a string field within iBFT from configuration setting.

Parameters

settings	Parent settings block, or NULL
strings	iBFT string block descriptor
string	String field
setting	Configuration setting

Return values

rc	Return status code

Definition at line 201 of file ibft.c.

                                                                      {
         struct settings *origin;
         struct setting fetched;
         int len;
         char *dest;
 
         len = fetch_setting ( settings, setting, &origin, &fetched, NULL, 0 );
         if ( len < 0 ) {
                 string->offset = 0;
                 string->len = 0;
                 return 0;
         }
 
         dest = ibft_alloc_string ( strings, string, len );
         if ( ! dest )
                 return -ENOBUFS;
         fetch_string_setting ( origin, &fetched, dest, ( len + 1 ));
 
         return 0;
 }

References dest, ENOBUFS, fetch_setting(), fetch_string_setting(), ibft_alloc_string(), len, NULL, and origin.

Referenced by ibft_fill_nic().

◆ ibft_string()

static const char* ibft_string	(	struct ibft_strings *	strings,
		struct ibft_string *	string
	)

static

Read string from iBFT (for debugging)

Parameters

strings	iBFT string block descriptor
string	String field

Return values

data	String content (or "<empty>")

Definition at line 232 of file ibft.c.

                                                                {
         size_t offset = le16_to_cpu ( string->offset );
 
         return ( offset ? ( strings->data + offset - strings->start ) : NULL );
 }

References ibft_strings::data, le16_to_cpu, NULL, offset, ibft_strings::start, and string.

◆ ibft_netdev_is_required()

static int ibft_netdev_is_required ( struct net_device * netdev )

static

Check if network device is required for the iBFT.

Parameters

netdev Network device

Return values

is_required Network device is required

Definition at line 245 of file ibft.c.

                                                                  {
         struct iscsi_session *iscsi;
         struct sockaddr_tcpip *st_target;
 
         list_for_each_entry ( iscsi, &ibft_model.descs, desc.list ) {
                 st_target = ( struct sockaddr_tcpip * ) &iscsi->target_sockaddr;
                 if ( tcpip_netdev ( st_target ) == netdev )
                         return 1;
         }
 
         return 0;
 }

References desc, if(), list_for_each_entry, netdev, iscsi_session::target_sockaddr, and tcpip_netdev().

Referenced by ibft_fill_target_nic_association(), and ibft_install().

◆ ibft_fill_nic()

static int ibft_fill_nic	(	struct ibft_nic *	nic,
		struct ibft_strings *	strings,
		struct net_device *	netdev
	)

static

Fill in NIC portion of iBFT.

Parameters

nic	NIC portion of iBFT
strings	iBFT string block descriptor
netdev	Network device

Return values

rc	Return status code

Definition at line 266 of file ibft.c.

                                                        {
         struct ll_protocol *ll_protocol = netdev->ll_protocol;
         struct in_addr netmask_addr = { 0 };
         unsigned int netmask_count = 0;
         struct settings *parent = netdev_settings ( netdev );
         struct settings *origin;
         int rc;
 
         /* Fill in common header */
         nic->header.structure_id = IBFT_STRUCTURE_ID_NIC;
         nic->header.version = 1;
         nic->header.length = cpu_to_le16 ( sizeof ( *nic ) );
         nic->header.flags = ( IBFT_FL_NIC_BLOCK_VALID |
                               IBFT_FL_NIC_FIRMWARE_BOOT_SELECTED );
         DBG ( "iBFT NIC %d is %s\n", nic->header.index, netdev->name );
 
         /* Determine origin of IP address */
         fetch_setting ( parent, &ip_setting, &origin, NULL, NULL, 0 );
         nic->origin = ( ( origin == parent ) ?
                         IBFT_NIC_ORIGIN_MANUAL : IBFT_NIC_ORIGIN_DHCP );
         DBG ( "iBFT NIC %d origin = %d\n", nic->header.index, nic->origin );
 
         /* Extract values from configuration settings */
         ibft_set_ipaddr_setting ( parent, &nic->ip_address, &ip_setting, 1 );
         DBG ( "iBFT NIC %d IP = %s\n",
               nic->header.index, ibft_ipaddr ( &nic->ip_address ) );
         ibft_set_ipaddr_setting ( parent, &nic->gateway, &gateway_setting, 1 );
         DBG ( "iBFT NIC %d gateway = %s\n",
               nic->header.index, ibft_ipaddr ( &nic->gateway ) );
         ibft_set_ipaddr_setting ( NULL, &nic->dns[0], &dns_setting,
                                   ( sizeof ( nic->dns ) /
                                     sizeof ( nic->dns[0] ) ) );
         ibft_set_ipaddr_setting ( parent, &nic->dhcp, &dhcp_server_setting, 1 );
         DBG ( "iBFT NIC %d DNS = %s",
               nic->header.index, ibft_ipaddr ( &nic->dns[0] ) );
         DBG ( ", %s\n", ibft_ipaddr ( &nic->dns[1] ) );
         if ( ( rc = ibft_set_string_setting ( NULL, strings, &nic->hostname,
                                               &hostname_setting ) ) != 0 )
                 return rc;
         DBG ( "iBFT NIC %d hostname = %s\n",
               nic->header.index, ibft_string ( strings, &nic->hostname ) );
 
         /* Derive subnet mask prefix from subnet mask */
         fetch_ipv4_setting ( parent, &netmask_setting, &netmask_addr );
         while ( netmask_addr.s_addr ) {
                 if ( netmask_addr.s_addr & 0x1 )
                         netmask_count++;
                 netmask_addr.s_addr >>= 1;
         }
         nic->subnet_mask_prefix = netmask_count;
         DBG ( "iBFT NIC %d subnet = /%d\n",
               nic->header.index, nic->subnet_mask_prefix );
 
         /* Extract values from net-device configuration */
         nic->vlan = cpu_to_le16 ( vlan_tag ( netdev ) );
         DBG ( "iBFT NIC %d VLAN = %02x\n",
               nic->header.index, le16_to_cpu ( nic->vlan ) );
         if ( ( rc = ll_protocol->eth_addr ( netdev->ll_addr,
                                             nic->mac_address ) ) != 0 ) {
                 DBG ( "Could not determine %s MAC: %s\n",
                       netdev->name, strerror ( rc ) );
                 return rc;
         }
         DBG ( "iBFT NIC %d MAC = %s\n",
               nic->header.index, eth_ntoa ( nic->mac_address ) );
         nic->pci_bus_dev_func = cpu_to_le16 ( netdev->dev->desc.location );
         DBG ( "iBFT NIC %d PCI = %04x\n",
               nic->header.index, le16_to_cpu ( nic->pci_bus_dev_func ) );
 
         return 0;
 }

References cpu_to_le16, DBG, device::desc, net_device::dev, ll_protocol::eth_addr, eth_ntoa(), fetch_ipv4_setting(), fetch_setting(), nic::flags, IBFT_FL_NIC_BLOCK_VALID, IBFT_FL_NIC_FIRMWARE_BOOT_SELECTED, IBFT_NIC_ORIGIN_DHCP, IBFT_NIC_ORIGIN_MANUAL, ibft_set_ipaddr_setting(), ibft_set_string_setting(), IBFT_STRUCTURE_ID_NIC, le16_to_cpu, net_device::ll_addr, net_device::ll_protocol, device_description::location, net_device::name, netdev, netdev_settings(), NULL, origin, settings::parent, rc, in_addr::s_addr, strerror(), and vlan_tag().

Referenced by ibft_install().

◆ ibft_fill_initiator()

static int ibft_fill_initiator	(	struct ibft_initiator *	initiator,
		struct ibft_strings *	strings,
		const char *	initiator_iqn
	)

static

Fill in Initiator portion of iBFT.

Parameters

initiator	Initiator portion of iBFT
strings	iBFT string block descriptor
initiator_iqn	Initiator IQN

Return values

rc	Return status code

Definition at line 348 of file ibft.c.

                                                              {
         int rc;
 
         /* Fill in common header */
         initiator->header.structure_id = IBFT_STRUCTURE_ID_INITIATOR;
         initiator->header.version = 1;
         initiator->header.length = cpu_to_le16 ( sizeof ( *initiator ) );
         initiator->header.flags = ( IBFT_FL_INITIATOR_BLOCK_VALID |
                                     IBFT_FL_INITIATOR_FIRMWARE_BOOT_SELECTED );
 
         /* Fill in initiator name */
         if ( ( rc = ibft_set_string ( strings, &initiator->initiator_name,
                                       initiator_iqn ) ) != 0 )
                 return rc;
         DBG ( "iBFT initiator name = %s\n",
               ibft_string ( strings, &initiator->initiator_name ) );
 
         return 0;
 }

References cpu_to_le16, DBG, ibft_header::flags, ibft_initiator::header, IBFT_FL_INITIATOR_BLOCK_VALID, IBFT_FL_INITIATOR_FIRMWARE_BOOT_SELECTED, ibft_set_string(), IBFT_STRUCTURE_ID_INITIATOR, ibft_initiator::initiator_name, ibft_header::length, rc, ibft_header::structure_id, and ibft_header::version.

Referenced by ibft_install().

◆ ibft_fill_target_nic_association()

static int ibft_fill_target_nic_association	(	struct ibft_target *	target,
		struct iscsi_session *	iscsi
	)

static

Fill in Target NIC association.

Parameters

target	Target portion of iBFT
iscsi	iSCSI session

Return values

rc	Return status code

Definition at line 377 of file ibft.c.

                                                                             {
         struct sockaddr_tcpip *st_target =
                 ( struct sockaddr_tcpip * ) &iscsi->target_sockaddr;
         struct net_device *associated;
         struct net_device *netdev;
 
         /* Find network device used to reach target */
         associated = tcpip_netdev ( st_target );
         if ( ! associated ) {
                 DBG ( "iBFT target %d has no net device\n",
                       target->header.index );
                 return -EHOSTUNREACH;
         }
 
         /* Calculate association */
         for_each_netdev ( netdev ) {
                 if ( netdev == associated ) {
                         DBG ( "iBFT target %d uses NIC %d (%s)\n",
                               target->header.index, target->nic_association,
                               netdev->name );
                         return 0;
                 }
                 if ( ! ibft_netdev_is_required ( netdev ) )
                         continue;
                 target->nic_association++;
         }
 
         DBG ( "iBFT target %d has impossible NIC %s\n",
               target->header.index, netdev->name );
         return -EINVAL;
 }

References DBG, EHOSTUNREACH, EINVAL, for_each_netdev, ibft_target::header, ibft_netdev_is_required(), ibft_header::index, net_device::name, netdev, ibft_target::nic_association, iscsi_session::target_sockaddr, and tcpip_netdev().

Referenced by ibft_fill_target().

◆ ibft_fill_target_chap()

static int ibft_fill_target_chap	(	struct ibft_target *	target,
		struct ibft_strings *	strings,
		struct iscsi_session *	iscsi
	)

static

Fill in Target CHAP portion of iBFT.

Parameters

target	Target portion of iBFT
strings	iBFT string block descriptor
iscsi	iSCSI session

Return values

rc	Return status code

Definition at line 418 of file ibft.c.

                                                                  {
         int rc;
 
         if ( ! ( iscsi->status & ISCSI_STATUS_AUTH_FORWARD_REQUIRED ) )
                 return 0;
 
         assert ( iscsi->initiator_username );
         assert ( iscsi->initiator_password );
 
         target->chap_type = IBFT_CHAP_ONE_WAY;
         if ( ( rc = ibft_set_string ( strings, &target->chap_name,
                                       iscsi->initiator_username ) ) != 0 )
                 return rc;
         DBG ( "iBFT target %d username = %s\n", target->header.index,
               ibft_string ( strings, &target->chap_name ) );
         if ( ( rc = ibft_set_string ( strings, &target->chap_secret,
                                       iscsi->initiator_password ) ) != 0 )
                 return rc;
         DBG ( "iBFT target %d password = <redacted>\n", target->header.index );
 
         return 0;
 }

References assert(), ibft_target::chap_name, ibft_target::chap_secret, ibft_target::chap_type, DBG, ibft_target::header, IBFT_CHAP_ONE_WAY, ibft_set_string(), ibft_header::index, iscsi_session::initiator_password, iscsi_session::initiator_username, ISCSI_STATUS_AUTH_FORWARD_REQUIRED, rc, and iscsi_session::status.

Referenced by ibft_fill_target().

◆ ibft_fill_target_reverse_chap()

static int ibft_fill_target_reverse_chap	(	struct ibft_target *	target,
		struct ibft_strings *	strings,
		struct iscsi_session *	iscsi
	)

static

Fill in Target Reverse CHAP portion of iBFT.

Parameters

target	Target portion of iBFT
strings	iBFT string block descriptor
iscsi	iSCSI session

Return values

rc	Return status code

Definition at line 451 of file ibft.c.

                                                                          {
         int rc;
 
         if ( ! ( iscsi->status & ISCSI_STATUS_AUTH_REVERSE_REQUIRED ) )
                 return 0;
 
         assert ( iscsi->initiator_username );
         assert ( iscsi->initiator_password );
         assert ( iscsi->target_username );
         assert ( iscsi->target_password );
 
         target->chap_type = IBFT_CHAP_MUTUAL;
         if ( ( rc = ibft_set_string ( strings, &target->reverse_chap_name,
                                       iscsi->target_username ) ) != 0 )
                 return rc;
         DBG ( "iBFT target %d reverse username = %s\n", target->header.index,
               ibft_string ( strings, &target->chap_name ) );
         if ( ( rc = ibft_set_string ( strings, &target->reverse_chap_secret,
                                       iscsi->target_password ) ) != 0 )
                 return rc;
         DBG ( "iBFT target %d reverse password = <redacted>\n",
               target->header.index );
 
         return 0;
 }

References assert(), ibft_target::chap_name, ibft_target::chap_type, DBG, ibft_target::header, IBFT_CHAP_MUTUAL, ibft_set_string(), ibft_header::index, iscsi_session::initiator_password, iscsi_session::initiator_username, ISCSI_STATUS_AUTH_REVERSE_REQUIRED, rc, ibft_target::reverse_chap_name, ibft_target::reverse_chap_secret, iscsi_session::status, iscsi_session::target_password, and iscsi_session::target_username.

Referenced by ibft_fill_target().

◆ ibft_fill_target()

static int ibft_fill_target	(	struct ibft_target *	target,
		struct ibft_strings *	strings,
		struct iscsi_session *	iscsi
	)

static

Fill in Target portion of iBFT.

Parameters

target	Target portion of iBFT
strings	iBFT string block descriptor
iscsi	iSCSI session

Return values

rc	Return status code

Definition at line 487 of file ibft.c.

                                                             {
         struct sockaddr_tcpip *st_target =
                 ( struct sockaddr_tcpip * ) &iscsi->target_sockaddr;
         struct sockaddr_in *sin_target =
                 ( struct sockaddr_in * ) &iscsi->target_sockaddr;
         int rc;
 
         /* Fill in common header */
         target->header.structure_id = IBFT_STRUCTURE_ID_TARGET;
         target->header.version = 1;
         target->header.length = cpu_to_le16 ( sizeof ( *target ) );
         target->header.flags = ( IBFT_FL_TARGET_BLOCK_VALID |
                                  IBFT_FL_TARGET_FIRMWARE_BOOT_SELECTED );
 
         /* Fill in Target values */
         ibft_set_ipaddr ( &target->ip_address, sin_target->sin_addr );
         DBG ( "iBFT target %d IP = %s\n",
               target->header.index, ibft_ipaddr ( &target->ip_address ) );
         target->socket = cpu_to_le16 ( ntohs ( st_target->st_port ) );
         DBG ( "iBFT target %d port = %d\n",
               target->header.index, target->socket );
         memcpy ( &target->boot_lun, &iscsi->lun, sizeof ( target->boot_lun ) );
         DBG ( "iBFT target %d boot LUN = " SCSI_LUN_FORMAT "\n",
               target->header.index, SCSI_LUN_DATA ( target->boot_lun ) );
         if ( ( rc = ibft_set_string ( strings, &target->target_name,
                                       iscsi->target_iqn ) ) != 0 )
                 return rc;
         DBG ( "iBFT target %d name = %s\n", target->header.index,
               ibft_string ( strings, &target->target_name ) );
         if ( ( rc = ibft_fill_target_nic_association ( target, iscsi ) ) != 0 )
                 return rc;
         if ( ( rc = ibft_fill_target_chap ( target, strings, iscsi ) ) != 0 )
                 return rc;
         if ( ( rc = ibft_fill_target_reverse_chap ( target, strings,
                                                     iscsi ) ) != 0 )
                 return rc;
 
         return 0;
 }

References ibft_target::boot_lun, cpu_to_le16, DBG, ibft_header::flags, ibft_target::header, ibft_fill_target_chap(), ibft_fill_target_nic_association(), ibft_fill_target_reverse_chap(), IBFT_FL_TARGET_BLOCK_VALID, IBFT_FL_TARGET_FIRMWARE_BOOT_SELECTED, ibft_set_ipaddr(), ibft_set_string(), IBFT_STRUCTURE_ID_TARGET, ibft_header::index, ibft_target::ip_address, ibft_header::length, iscsi_session::lun, memcpy(), ntohs, rc, SCSI_LUN_DATA, SCSI_LUN_FORMAT, ibft_target::socket, sockaddr_tcpip::st_port, ibft_header::structure_id, iscsi_session::target_iqn, ibft_target::target_name, iscsi_session::target_sockaddr, and ibft_header::version.

Referenced by ibft_install().

◆ ibft_complete()

static int ibft_complete ( struct acpi_descriptor * desc )

static

Check if iBFT descriptor is complete.

Parameters

desc	ACPI descriptor

Return values

rc	Return status code

Definition at line 535 of file ibft.c.

                                                           {
         struct iscsi_session *iscsi =
                 container_of ( desc, struct iscsi_session, desc );
 
         /* Fail if we do not yet have the target address */
         if ( ! iscsi->target_sockaddr.sa_family )
                 return -EAGAIN;
 
         return 0;
 }

References container_of, desc, EAGAIN, sockaddr::sa_family, and iscsi_session::target_sockaddr.

◆ ibft_install()

static int ibft_install ( int(*)(struct acpi_header *acpi) install )

static

Install iBFT.

Parameters

install Installation method

Return values

rc	Return status code

Definition at line 552 of file ibft.c.

                                                                            {
         struct net_device *netdev;
         struct iscsi_session *iscsi;
         struct ibft_table *table;
         struct ibft_initiator *initiator;
         struct ibft_nic *nic;
         struct ibft_target *target;
         struct ibft_strings strings;
         struct acpi_header *acpi;
         void *data;
         unsigned int targets = 0;
         unsigned int pairs = 0;
         size_t offset = 0;
         size_t table_len;
         size_t control_len;
         size_t initiator_offset;
         size_t nic_offset;
         size_t target_offset;
         size_t strings_offset;
         size_t len;
         unsigned int i;
         int rc;
 
         /* Calculate table sizes and offsets */
         list_for_each_entry ( iscsi, &ibft_model.descs, desc.list )
                 targets++;
         pairs = ( sizeof ( table->control.pair ) /
                   sizeof ( table->control.pair[0] ) );
         if ( pairs < targets )
                 pairs = targets;
         offset = offsetof ( typeof ( *table ), control.pair );
         offset += ( pairs * sizeof ( table->control.pair[0] ) );
         table_len = offset;
         control_len = ( table_len - offsetof ( typeof ( *table ), control ) );
         offset = ibft_align ( offset );
         initiator_offset = offset;
         offset += ibft_align ( sizeof ( *initiator ) );
         nic_offset = offset;
         offset += ( pairs * ibft_align ( sizeof ( *nic ) ) );
         target_offset = offset;
         offset += ( pairs * ibft_align ( sizeof ( *target ) ) );
         strings_offset = offset;
         strings.data = NULL;
         strings.start = strings_offset;
         strings.len = 0;
         len = offset;
 
         /* Do nothing if no targets exist */
         if ( ! targets ) {
                 rc = 0;
                 goto no_targets;
         }
 
         /* Allocate table */
         data = zalloc ( len );
         if ( ! data ) {
                 rc = -ENOMEM;
                 goto err_alloc;
         }
 
         /* Fill in Control block */
         table = data;
         table->control.header.structure_id = IBFT_STRUCTURE_ID_CONTROL;
         table->control.header.version = 1;
         table->control.header.length = cpu_to_le16 ( control_len );
 
         /* Fill in Initiator block */
         initiator = ( data + initiator_offset );
         table->control.initiator = cpu_to_le16 ( initiator_offset );
         iscsi = list_first_entry ( &ibft_model.descs, struct iscsi_session,
                                    desc.list );
         if ( ( rc = ibft_fill_initiator ( initiator, &strings,
                                           iscsi->initiator_iqn ) ) != 0 )
                 goto err_initiator;
 
         /* Fill in NIC blocks */
         i = 0;
         for_each_netdev ( netdev ) {
                 if ( ! ibft_netdev_is_required ( netdev ) )
                         continue;
                 assert ( i < pairs );
                 table->control.pair[i].nic = nic_offset;
                 nic = ( data + nic_offset );
                 nic->header.index = i;
                 if ( ( rc = ibft_fill_nic ( nic, &strings, netdev ) ) != 0 )
                         goto err_nic;
                 i++;
                 nic_offset += ibft_align ( sizeof ( *nic ) );
         }
 
         /* Fill in Target blocks */
         i = 0;
         list_for_each_entry ( iscsi, &ibft_model.descs, desc.list ) {
                 assert ( i < pairs );
                 table->control.pair[i].target = target_offset;
                 target = ( data + target_offset );
                 target->header.index = i;
                 if ( ( rc = ibft_fill_target ( target, &strings, iscsi ) ) != 0)
                         goto err_target;
                 i++;
                 target_offset += ibft_align ( sizeof ( *target ) );
         }
 
         /* Reallocate table to include space for strings */
         len += strings.len;
         acpi = realloc ( data, len );
         if ( ! acpi )
                 goto err_realloc;
         data = NULL;
 
         /* Fill in ACPI header */
         acpi->signature = cpu_to_le32 ( IBFT_SIG );
         acpi->length = cpu_to_le32 ( len );
         acpi->revision = 1;
 
         /* Append strings */
         memcpy ( ( ( ( void * ) acpi ) + strings_offset ), strings.data,
                  strings.len );
 
         /* Install ACPI table */
         if ( ( rc = install ( acpi ) ) != 0 ) {
                 DBG ( "iBFT could not install: %s\n", strerror ( rc ) );
                 goto err_install;
         }
 
  err_install:
         free ( acpi );
  err_realloc:
  err_target:
  err_nic:
  err_initiator:
         free ( data );
  err_alloc:
  no_targets:
         free ( strings.data );
         return rc;
 }

References acpi, assert(), control, ibft_table::control, cpu_to_le16, cpu_to_le32, data, ibft_strings::data, DBG, desc, ENOMEM, for_each_netdev, free, ibft_control::header, ibft_target::header, ibft_align(), ibft_fill_initiator(), ibft_fill_nic(), ibft_fill_target(), ibft_netdev_is_required(), IBFT_SIG, IBFT_STRUCTURE_ID_CONTROL, ibft_header::index, ibft_control::initiator, iscsi_session::initiator_iqn, len, ibft_strings::len, ibft_header::length, list_first_entry, list_for_each_entry, memcpy(), netdev, nic, ibft_offset_pair::nic, NULL, offset, offsetof, ibft_control::pair, rc, realloc(), ibft_strings::start, strerror(), ibft_header::structure_id, ibft_offset_pair::target, typeof(), ibft_header::version, and zalloc().

Variable Documentation

◆ __acpi_model

struct acpi_model ibft_model __acpi_model

Initial value:

= {
        .descs = LIST_HEAD_INIT ( ibft_model.descs ),
        .complete = ibft_complete,
        .install = ibft_install,
}

iBFT model

aBFT model

Definition at line 691 of file ibft.c.

Data Structures

Functions

Variables

Detailed Description

Function Documentation

◆ FILE_LICENCE()

◆ ibft_align()

◆ ibft_set_ipaddr()

◆ ibft_set_ipaddr_setting()

◆ ibft_ipaddr()

◆ ibft_alloc_string()

◆ ibft_set_string()

◆ ibft_set_string_setting()

◆ ibft_string()

◆ ibft_netdev_is_required()

◆ ibft_fill_nic()

◆ ibft_fill_initiator()

◆ ibft_fill_target_nic_association()

◆ ibft_fill_target_chap()

◆ ibft_fill_target_reverse_chap()

◆ ibft_fill_target()

◆ ibft_complete()

◆ ibft_install()

Variable Documentation

◆ __acpi_model