ib_srp.c File Reference

SCSI RDMA Protocol over Infiniband. More...

#include <stdlib.h>
#include <errno.h>
#include <ipxe/interface.h>
#include <ipxe/uri.h>
#include <ipxe/open.h>
#include <ipxe/base16.h>
#include <ipxe/acpi.h>
#include <ipxe/efi/efi_path.h>
#include <ipxe/srp.h>
#include <ipxe/infiniband.h>
#include <ipxe/ib_cmrc.h>
#include <ipxe/ib_srp.h>

Go to the source code of this file.

Data Structures
struct	ib_srp_root_path
	IB SRP root path parameters. More...
struct	ib_srp_root_path_parser
	IB SRP root path component parser. More...

Macros
#define	EINVAL_BYTE_STRING_LEN   __einfo_error ( EINFO_EINVAL_BYTE_STRING_LEN )
#define	EINFO_EINVAL_BYTE_STRING_LEN
#define	EINVAL_INTEGER   __einfo_error ( EINFO_EINVAL_INTEGER )
#define	EINFO_EINVAL_INTEGER
#define	EINVAL_RP_TOO_SHORT   __einfo_error ( EINFO_EINVAL_RP_TOO_SHORT )
#define	EINFO_EINVAL_RP_TOO_SHORT
#define	IB_SRP_NUM_RP_COMPONENTS    ( sizeof ( ib_srp_rp_parser ) / sizeof ( ib_srp_rp_parser[0] ) )
	Number of IB SRP root path components.

Enumerations
enum	ib_srp_parse_flags { IB_SRP_PARSE_REQUIRED = 0x0000 , IB_SRP_PARSE_OPTIONAL = 0x8000 , IB_SRP_PARSE_FLAG_MASK = 0xf000 }
	IB SRP parse flags. More...

Functions
	FILE_LICENCE (BSD2)
static void	ib_srp_free (struct refcnt *refcnt)
	Free IB SRP device.
static void	ib_srp_close (struct ib_srp_device *ib_srp, int rc)
	Close IB SRP device.
static struct acpi_descriptor *	ib_srp_describe (struct ib_srp_device *ib_srp)
	Get IB SRP ACPI descriptor.
static int	ib_srp_open (struct interface *block, struct ib_device *ibdev, union ib_gid *dgid, union ib_guid *service_id, union srp_port_id *initiator, union srp_port_id *target, struct scsi_lun *lun)
	Open IB SRP device.
static int	ib_srp_parse_byte_string (const char *rp_comp, uint8_t *bytes, unsigned int size_flags)
	Parse IB SRP root path byte-string value.
static int	ib_srp_parse_integer (const char *rp_comp, int default_value)
	Parse IB SRP root path integer value.
static int	ib_srp_parse_sgid (const char *rp_comp, struct ib_srp_root_path *rp)
	Parse IB SRP root path source GID.
static int	ib_srp_parse_initiator_id_ext (const char *rp_comp, struct ib_srp_root_path *rp)
	Parse IB SRP root path initiator identifier extension.
static int	ib_srp_parse_initiator_hca_guid (const char *rp_comp, struct ib_srp_root_path *rp)
	Parse IB SRP root path initiator HCA GUID.
static int	ib_srp_parse_dgid (const char *rp_comp, struct ib_srp_root_path *rp)
	Parse IB SRP root path destination GID.
static int	ib_srp_parse_pkey (const char *rp_comp, struct ib_srp_root_path *rp)
	Parse IB SRP root path partition key.
static int	ib_srp_parse_service_id (const char *rp_comp, struct ib_srp_root_path *rp)
	Parse IB SRP root path service ID.
static int	ib_srp_parse_lun (const char *rp_comp, struct ib_srp_root_path *rp)
	Parse IB SRP root path LUN.
static int	ib_srp_parse_target_id_ext (const char *rp_comp, struct ib_srp_root_path *rp)
	Parse IB SRP root path target identifier extension.
static int	ib_srp_parse_target_ioc_guid (const char *rp_comp, struct ib_srp_root_path *rp)
	Parse IB SRP root path target I/O controller GUID.
static int	ib_srp_parse_root_path (const char *rp_string, struct ib_srp_root_path *rp)
	Parse IB SRP root path.
static int	ib_srp_open_uri (struct interface *parent, struct uri *uri)
	Open IB SRP URI.
static int	ib_sbft_complete (struct acpi_descriptor *desc __unused)
	Check if IB SRP boot firmware table descriptor is complete.
static int	ib_sbft_install (int(*install)(struct acpi_header *acpi))
	Install IB SRP boot firmware table(s)

Variables
struct acpi_model ib_sbft_model	__acpi_model
	IB sBFT model.
static struct interface_operation	ib_srp_cmrc_op []
	IB SRP CMRC interface operations.
static struct interface_descriptor	ib_srp_cmrc_desc
	IB SRP CMRC interface descriptor.
static struct interface_operation	ib_srp_srp_op []
	IB SRP SRP interface operations.
static struct interface_descriptor	ib_srp_srp_desc
	IB SRP SRP interface descriptor.
static struct ib_srp_root_path_parser	ib_srp_rp_parser []
	IB SRP root path components.
struct uri_opener ib_srp_uri_opener	__uri_opener
	IB SRP URI opener.

Detailed Description

SCSI RDMA Protocol over Infiniband.

Definition in file ib_srp.c.

Macro Definition Documentation

EINVAL_BYTE_STRING_LEN

#define EINVAL_BYTE_STRING_LEN   __einfo_error ( EINFO_EINVAL_BYTE_STRING_LEN )

Definition at line 54 of file ib_srp.c.

Referenced by ib_srp_parse_byte_string().

EINFO_EINVAL_BYTE_STRING_LEN

#define EINFO_EINVAL_BYTE_STRING_LEN

Value:

        __einfo_uniqify \
        ( EINFO_EINVAL, 0x01, "Invalid byte string length" )

Definition at line 55 of file ib_srp.c.

#define EINFO_EINVAL_BYTE_STRING_LEN __einfo_uniqify \
        ( EINFO_EINVAL, 0x01, "Invalid byte string length" )

EINVAL_INTEGER

#define EINVAL_INTEGER   __einfo_error ( EINFO_EINVAL_INTEGER )

Definition at line 57 of file ib_srp.c.

EINFO_EINVAL_INTEGER

#define EINFO_EINVAL_INTEGER

Value:

        __einfo_uniqify \
        ( EINFO_EINVAL, 0x03, "Invalid integer" )

Definition at line 58 of file ib_srp.c.

#define EINFO_EINVAL_INTEGER __einfo_uniqify \
        ( EINFO_EINVAL, 0x03, "Invalid integer" )

EINVAL_RP_TOO_SHORT

#define EINVAL_RP_TOO_SHORT   __einfo_error ( EINFO_EINVAL_RP_TOO_SHORT )

Definition at line 60 of file ib_srp.c.

Referenced by ib_srp_parse_root_path().

EINFO_EINVAL_RP_TOO_SHORT

#define EINFO_EINVAL_RP_TOO_SHORT

Value:

        __einfo_uniqify \
        ( EINFO_EINVAL, 0x04, "Root path too short" )

Definition at line 61 of file ib_srp.c.

#define EINFO_EINVAL_RP_TOO_SHORT __einfo_uniqify \
        ( EINFO_EINVAL, 0x04, "Root path too short" )

IB_SRP_NUM_RP_COMPONENTS

#define IB_SRP_NUM_RP_COMPONENTS    ( sizeof ( ib_srp_rp_parser ) / sizeof ( ib_srp_rp_parser[0] ) )

Number of IB SRP root path components.

Definition at line 457 of file ib_srp.c.

#define IB_SRP_NUM_RP_COMPONENTS \
        ( sizeof ( ib_srp_rp_parser ) / sizeof ( ib_srp_rp_parser[0] ) )

Referenced by ib_srp_parse_root_path().

Enumeration Type Documentation

ib_srp_parse_flags

enum ib_srp_parse_flags

IB SRP parse flags.

Enumerator
IB_SRP_PARSE_REQUIRED
IB_SRP_PARSE_OPTIONAL
IB_SRP_PARSE_FLAG_MASK

Definition at line 211 of file ib_srp.c.

                        {
        IB_SRP_PARSE_REQUIRED = 0x0000,
        IB_SRP_PARSE_OPTIONAL = 0x8000,
        IB_SRP_PARSE_FLAG_MASK = 0xf000,
};

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

BSD2

)

ib_srp_free()

void ib_srp_free ( struct refcnt * refcnt )

static

Free IB SRP device.

Parameters

refcnt

Reference count

Definition at line 78 of file ib_srp.c.

                                                  {
        struct ib_srp_device *ib_srp =
                container_of ( refcnt, struct ib_srp_device, refcnt );
 
        ibdev_put ( ib_srp->ibdev );
        free ( ib_srp );
}

References container_of, free, ib_srp_device::ibdev, and ibdev_put().

Referenced by ib_srp_open().

ib_srp_close()

void ib_srp_close ( struct ib_srp_device * ib_srp, int rc )

static

Close IB SRP device.

Parameters

ib_srp	IB SRP device
rc	Reason for close

Definition at line 92 of file ib_srp.c.

                                                                  {
 
        /* Shut down interfaces */
        intf_shutdown ( &ib_srp->cmrc, rc );
        intf_shutdown ( &ib_srp->srp, rc );
}

References ib_srp_device::cmrc, intf_shutdown(), rc, and ib_srp_device::srp.

Referenced by ib_srp_open().

ib_srp_describe()

struct acpi_descriptor * ib_srp_describe ( struct ib_srp_device * ib_srp )

static

Get IB SRP ACPI descriptor.

Parameters

ib_srp

IB SRP device

Return values

desc	ACPI descriptor

Definition at line 106 of file ib_srp.c.

                                                 {
 
        return &ib_srp->desc;
}

References ib_srp_device::desc.

ib_srp_open()

int ib_srp_open ( struct interface * block, struct ib_device * ibdev, union ib_gid * dgid, union ib_guid * service_id, union srp_port_id * initiator, union srp_port_id * target, struct scsi_lun * lun )

static

Open IB SRP device.

Parameters

block	Block control interface
ibdev	Infiniband device
dgid	Destination GID
service_id	Service ID
initiator	Initiator port ID
target	Target port ID
lun	SCSI LUN

Return values

rc	Return status code

Definition at line 143 of file ib_srp.c.

                                                                           {
        struct ib_srp_device *ib_srp;
        struct ipxe_ib_sbft *sbft;
        int rc;
 
        /* Allocate and initialise structure */
        ib_srp = zalloc ( sizeof ( *ib_srp ) );
        if ( ! ib_srp ) {
                rc = -ENOMEM;
                goto err_zalloc;
        }
        ref_init ( &ib_srp->refcnt, ib_srp_free );
        intf_init ( &ib_srp->srp, &ib_srp_srp_desc, &ib_srp->refcnt );
        intf_init ( &ib_srp->cmrc, &ib_srp_cmrc_desc, &ib_srp->refcnt );
        ib_srp->ibdev = ibdev_get ( ibdev );
        acpi_init ( &ib_srp->desc, &ib_sbft_model, &ib_srp->refcnt );
        DBGC ( ib_srp, "IBSRP %p for " IB_GID_FMT " " IB_GUID_FMT "\n",
               ib_srp, IB_GID_ARGS ( dgid ), IB_GUID_ARGS ( service_id ) );
 
        /* Preserve parameters required for boot firmware table */
        sbft = &ib_srp->sbft;
        memcpy ( &sbft->scsi.lun, lun, sizeof ( sbft->scsi.lun ) );
        memcpy ( &sbft->srp.initiator, initiator,
                 sizeof ( sbft->srp.initiator ) );
        memcpy ( &sbft->srp.target, target, sizeof ( sbft->srp.target ) );
        memcpy ( &sbft->ib.dgid, dgid, sizeof ( sbft->ib.dgid ) );
        memcpy ( &sbft->ib.service_id, service_id,
                 sizeof ( sbft->ib.service_id ) );
 
        /* Open CMRC socket */
        if ( ( rc = ib_cmrc_open ( &ib_srp->cmrc, ibdev, dgid,
                                   service_id, "SRP" ) ) != 0 ) {
                DBGC ( ib_srp, "IBSRP %p could not open CMRC socket: %s\n",
                       ib_srp, strerror ( rc ) );
                goto err_cmrc_open;
        }
 
        /* Attach SRP device to parent interface */
        if ( ( rc = srp_open ( block, &ib_srp->srp, initiator, target,
                               ibdev->rdma_key, lun ) ) != 0 ) {
                DBGC ( ib_srp, "IBSRP %p could not create SRP device: %s\n",
                       ib_srp, strerror ( rc ) );
                goto err_srp_open;
        }
 
        /* Mortalise self and return */
        ref_put ( &ib_srp->refcnt );
        return 0;
 
 err_srp_open:
 err_cmrc_open:
        ib_srp_close ( ib_srp, rc );
        ref_put ( &ib_srp->refcnt );
 err_zalloc:
        return rc;
}

References acpi_init(), block, ib_srp_device::cmrc, DBGC, ib_srp_device::desc, dgid, sbft_ib_subtable::dgid, ENOMEM, ipxe_ib_sbft::ib, ib_cmrc_open(), IB_GID_ARGS, IB_GID_FMT, IB_GUID_ARGS, IB_GUID_FMT, ib_srp_close(), ib_srp_cmrc_desc, ib_srp_free(), ib_srp_srp_desc, ib_srp_device::ibdev, ibdev_get(), sbft_srp_subtable::initiator, intf_init(), lun, sbft_scsi_subtable::lun, memcpy(), rc, ib_device::rdma_key, ref_init, ref_put, ib_srp_device::refcnt, ib_srp_device::sbft, ipxe_ib_sbft::scsi, sbft_ib_subtable::service_id, service_id, ib_srp_device::srp, ipxe_ib_sbft::srp, srp_open(), strerror(), sbft_srp_subtable::target, and zalloc().

Referenced by ib_srp_open_uri().

ib_srp_parse_byte_string()

int ib_srp_parse_byte_string ( const char * rp_comp, uint8_t * bytes, unsigned int size_flags )

static

Parse IB SRP root path byte-string value.

Parameters

rp_comp	Root path component string
default_value	Default value to use if component string is empty

Return values

value

Value

Definition at line 242 of file ib_srp.c.

                                                                {
        size_t size = ( size_flags & ~IB_SRP_PARSE_FLAG_MASK );
        size_t rp_comp_len = strlen ( rp_comp );
        int decoded_size;
 
        /* Allow optional components to be empty */
        if ( ( rp_comp_len == 0 ) &&
             ( size_flags & IB_SRP_PARSE_OPTIONAL ) )
                return 0;
 
        /* Check string length */
        if ( rp_comp_len != ( 2 * size ) )
                return -EINVAL_BYTE_STRING_LEN;
 
        /* Parse byte string */
        decoded_size = base16_decode ( rp_comp, bytes, size );
        if ( decoded_size < 0 )
                return decoded_size;
 
        return 0;
}

References bytes, EINVAL_BYTE_STRING_LEN, IB_SRP_PARSE_FLAG_MASK, IB_SRP_PARSE_OPTIONAL, size, and strlen().

Referenced by ib_srp_parse_dgid(), ib_srp_parse_initiator_hca_guid(), ib_srp_parse_initiator_id_ext(), ib_srp_parse_service_id(), ib_srp_parse_sgid(), ib_srp_parse_target_id_ext(), and ib_srp_parse_target_ioc_guid().

ib_srp_parse_integer()

int ib_srp_parse_integer ( const char * rp_comp, int default_value )

static

Parse IB SRP root path integer value.

Parameters

rp_comp	Root path component string
default_value	Default value to use if component string is empty

Return values

value

Value

Definition at line 272 of file ib_srp.c.

                                                                           {
        int value;
        char *end;
 
        value = strtoul ( rp_comp, &end, 16 );
        if ( *end )
                return -EINVAL_INTEGER;
 
        if ( end == rp_comp )
                return default_value;
 
        return value;
}

References EINVAL_INTEGER, end, strtoul(), and value.

Referenced by ib_srp_parse_pkey().

ib_srp_parse_sgid()

int ib_srp_parse_sgid ( const char * rp_comp, struct ib_srp_root_path * rp )

static

Parse IB SRP root path source GID.

Parameters

rp_comp	Root path component string
rp	IB SRP root path

Return values

rc	Return status code

Definition at line 293 of file ib_srp.c.

                                                             {
        struct ib_device *ibdev;
 
        /* Default to the GID of the last opened Infiniband device */
        if ( ( ibdev = last_opened_ibdev() ) != NULL )
                memcpy ( &rp->sgid, &ibdev->gid, sizeof ( rp->sgid ) );
 
        return ib_srp_parse_byte_string ( rp_comp, rp->sgid.bytes,
                                          ( sizeof ( rp->sgid ) |
                                            IB_SRP_PARSE_OPTIONAL ) );
}

References ib_gid::bytes, ib_device::gid, ib_srp_parse_byte_string(), IB_SRP_PARSE_OPTIONAL, last_opened_ibdev(), memcpy(), NULL, and ib_srp_root_path::sgid.

ib_srp_parse_initiator_id_ext()

int ib_srp_parse_initiator_id_ext ( const char * rp_comp, struct ib_srp_root_path * rp )

static

Parse IB SRP root path initiator identifier extension.

Parameters

rp_comp	Root path component string
rp	IB SRP root path

Return values

rc	Return status code

Definition at line 313 of file ib_srp.c.

                                                                         {
        union ib_srp_initiator_port_id *port_id = &rp->initiator;
 
        return ib_srp_parse_byte_string ( rp_comp, port_id->ib.id_ext.bytes,
                                          ( sizeof ( port_id->ib.id_ext ) |
                                            IB_SRP_PARSE_OPTIONAL ) );
}

References ib_guid::bytes, ib_srp_initiator_port_id::ib, ib_srp_parse_byte_string(), IB_SRP_PARSE_OPTIONAL, ib_srp_initiator_port_id::id_ext, and ib_srp_root_path::initiator.

ib_srp_parse_initiator_hca_guid()

int ib_srp_parse_initiator_hca_guid ( const char * rp_comp, struct ib_srp_root_path * rp )

static

Parse IB SRP root path initiator HCA GUID.

Parameters

rp_comp	Root path component string
rp	IB SRP root path

Return values

rc	Return status code

Definition at line 329 of file ib_srp.c.

                                                                           {
        union ib_srp_initiator_port_id *port_id = &rp->initiator;
 
        /* Default to the GUID portion of the source GID */
        memcpy ( &port_id->ib.hca_guid, &rp->sgid.s.guid,
                 sizeof ( port_id->ib.hca_guid ) );
 
        return ib_srp_parse_byte_string ( rp_comp, port_id->ib.hca_guid.bytes,
                                          ( sizeof ( port_id->ib.hca_guid ) |
                                            IB_SRP_PARSE_OPTIONAL ) );
}

References ib_guid::bytes, ib_gid::guid, ib_srp_initiator_port_id::hca_guid, ib_srp_initiator_port_id::ib, ib_srp_parse_byte_string(), IB_SRP_PARSE_OPTIONAL, ib_srp_root_path::initiator, memcpy(), ib_gid::s, and ib_srp_root_path::sgid.

ib_srp_parse_dgid()

int ib_srp_parse_dgid ( const char * rp_comp, struct ib_srp_root_path * rp )

static

Parse IB SRP root path destination GID.

Parameters

rp_comp	Root path component string
rp	IB SRP root path

Return values

rc	Return status code

Definition at line 349 of file ib_srp.c.

                                                             {
        return ib_srp_parse_byte_string ( rp_comp, rp->dgid.bytes,
                                          ( sizeof ( rp->dgid ) |
                                            IB_SRP_PARSE_REQUIRED ) );
}

References ib_gid::bytes, ib_srp_root_path::dgid, ib_srp_parse_byte_string(), and IB_SRP_PARSE_REQUIRED.

ib_srp_parse_pkey()

int ib_srp_parse_pkey ( const char * rp_comp, struct ib_srp_root_path * rp )

static

Parse IB SRP root path partition key.

Parameters

rp_comp	Root path component string
rp	IB SRP root path

Return values

rc	Return status code

Definition at line 363 of file ib_srp.c.

                                                             {
        int pkey;
 
        if ( ( pkey = ib_srp_parse_integer ( rp_comp, IB_PKEY_DEFAULT ) ) < 0 )
                return pkey;
        rp->pkey = pkey;
        return 0;
}

References IB_PKEY_DEFAULT, ib_srp_parse_integer(), ib_srp_root_path::pkey, and pkey.

ib_srp_parse_service_id()

int ib_srp_parse_service_id ( const char * rp_comp, struct ib_srp_root_path * rp )

static

Parse IB SRP root path service ID.

Parameters

rp_comp	Root path component string
rp	IB SRP root path

Return values

rc	Return status code

Definition at line 380 of file ib_srp.c.

                                                                   {
        return ib_srp_parse_byte_string ( rp_comp, rp->service_id.bytes,
                                          ( sizeof ( rp->service_id ) |
                                            IB_SRP_PARSE_REQUIRED ) );
}

References ib_guid::bytes, ib_srp_parse_byte_string(), IB_SRP_PARSE_REQUIRED, and ib_srp_root_path::service_id.

ib_srp_parse_lun()

int ib_srp_parse_lun ( const char * rp_comp, struct ib_srp_root_path * rp )

static

Parse IB SRP root path LUN.

Parameters

rp_comp	Root path component string
rp	IB SRP root path

Return values

rc	Return status code

Definition at line 394 of file ib_srp.c.

                                                            {
        return scsi_parse_lun ( rp_comp, &rp->lun );
}

References ib_srp_root_path::lun, and scsi_parse_lun().

ib_srp_parse_target_id_ext()

int ib_srp_parse_target_id_ext ( const char * rp_comp, struct ib_srp_root_path * rp )

static

Parse IB SRP root path target identifier extension.

Parameters

rp_comp	Root path component string
rp	IB SRP root path

Return values

rc	Return status code

Definition at line 406 of file ib_srp.c.

                                                                      {
        union ib_srp_target_port_id *port_id = &rp->target;
 
        return ib_srp_parse_byte_string ( rp_comp, port_id->ib.id_ext.bytes,
                                          ( sizeof ( port_id->ib.id_ext ) |
                                            IB_SRP_PARSE_REQUIRED ) );
}

References ib_guid::bytes, ib_srp_target_port_id::ib, ib_srp_parse_byte_string(), IB_SRP_PARSE_REQUIRED, ib_srp_target_port_id::id_ext, and ib_srp_root_path::target.

ib_srp_parse_target_ioc_guid()

int ib_srp_parse_target_ioc_guid ( const char * rp_comp, struct ib_srp_root_path * rp )

static

Parse IB SRP root path target I/O controller GUID.

Parameters

rp_comp	Root path component string
rp	IB SRP root path

Return values

rc	Return status code

Definition at line 422 of file ib_srp.c.

                                                                        {
        union ib_srp_target_port_id *port_id = &rp->target;
 
        return ib_srp_parse_byte_string ( rp_comp, port_id->ib.ioc_guid.bytes,
                                          ( sizeof ( port_id->ib.ioc_guid ) |
                                            IB_SRP_PARSE_REQUIRED ) );
}

References ib_guid::bytes, ib_srp_target_port_id::ib, ib_srp_parse_byte_string(), IB_SRP_PARSE_REQUIRED, ib_srp_target_port_id::ioc_guid, and ib_srp_root_path::target.

ib_srp_parse_root_path()

int ib_srp_parse_root_path ( const char * rp_string, struct ib_srp_root_path * rp )

static

Parse IB SRP root path.

Parameters

rp_string	Root path string
rp	IB SRP root path

Return values

rc	Return status code

Definition at line 467 of file ib_srp.c.

                                                                  {
        struct ib_srp_root_path_parser *parser;
        char *rp_comp[IB_SRP_NUM_RP_COMPONENTS];
        char *rp_string_copy;
        char *rp_string_tmp;
        unsigned int i = 0;
        int rc;
 
        /* Create modifiable copy of root path */
        rp_string_copy = strdup ( rp_string );
        if ( ! rp_string_copy ) {
                rc = -ENOMEM;
                goto err_strdup;
        }
        rp_string_tmp = rp_string_copy;
 
        /* Split root path into component parts */
        while ( 1 ) {
                rp_comp[i++] = rp_string_tmp;
                if ( i == IB_SRP_NUM_RP_COMPONENTS )
                        break;
                for ( ; *rp_string_tmp != ':' ; rp_string_tmp++ ) {
                        if ( ! *rp_string_tmp ) {
                                DBG ( "IBSRP root path \"%s\" too short\n",
                                      rp_string );
                                rc = -EINVAL_RP_TOO_SHORT;
                                goto err_split;
                        }
                }
                *(rp_string_tmp++) = '\0';
        }
 
        /* Parse root path components */
        for ( i = 0 ; i < IB_SRP_NUM_RP_COMPONENTS ; i++ ) {
                parser = &ib_srp_rp_parser[i];
                if ( ( rc = parser->parse ( rp_comp[i], rp ) ) != 0 ) {
                        DBG ( "IBSRP could not parse \"%s\" in root path "
                              "\"%s\": %s\n", rp_comp[i], rp_string,
                              strerror ( rc ) );
                        goto err_parse;
                }
        }
 
 err_parse:
 err_split:
        free ( rp_string_copy );
 err_strdup:
        return rc;
}

References DBG, EINVAL_RP_TOO_SHORT, ENOMEM, free, IB_SRP_NUM_RP_COMPONENTS, ib_srp_rp_parser, ib_srp_root_path_parser::parse, rc, strdup(), and strerror().

Referenced by ib_srp_open_uri().

ib_srp_open_uri()

int ib_srp_open_uri ( struct interface * parent, struct uri * uri )

static

Open IB SRP URI.

Parameters

parent	Parent interface
uri	URI

Return values

rc	Return status code

Definition at line 525 of file ib_srp.c.

                                                                         {
        struct ib_srp_root_path rp;
        struct ib_device *ibdev;
        int rc;
 
        /* Parse URI */
        if ( ! uri->opaque )
                return -EINVAL;
        memset ( &rp, 0, sizeof ( rp ) );
        if ( ( rc = ib_srp_parse_root_path ( uri->opaque, &rp ) ) != 0 )
                return rc;
 
        /* Identify Infiniband device */
        ibdev = find_ibdev ( &rp.sgid );
        if ( ! ibdev ) {
                DBG ( "IBSRP could not identify Infiniband device\n" );
                return -ENODEV;
        }
 
        /* Open IB SRP device */
        if ( ( rc = ib_srp_open ( parent, ibdev, &rp.dgid, &rp.service_id,
                                  &rp.initiator.srp, &rp.target.srp,
                                  &rp.lun ) ) != 0 )
                return rc;
 
        return 0;
}

References DBG, ib_srp_root_path::dgid, EINVAL, ENODEV, find_ibdev(), ib_srp_open(), ib_srp_parse_root_path(), ib_srp_root_path::initiator, ib_srp_root_path::lun, memset(), uri::opaque, rc, ib_srp_root_path::service_id, ib_srp_root_path::sgid, ib_srp_initiator_port_id::srp, ib_srp_target_port_id::srp, and ib_srp_root_path::target.

ib_sbft_complete()

int ib_sbft_complete ( struct acpi_descriptor *desc __unused )

static

Check if IB SRP boot firmware table descriptor is complete.

Parameters

desc	ACPI descriptor

Return values

rc	Return status code

Definition at line 572 of file ib_srp.c.

                                                                      {
        return 0;
}

References __unused, and desc.

ib_sbft_install()

int ib_sbft_install ( int(* install )(struct acpi_header *acpi) )

static

Install IB SRP boot firmware table(s)

Parameters

install

Installation method

Return values

rc	Return status code

Definition at line 582 of file ib_srp.c.

                                                                              {
        struct ib_srp_device *ib_srp;
        struct ipxe_ib_sbft *sbft;
        struct ib_device *ibdev;
        int rc;
 
        list_for_each_entry ( ib_srp, &ib_sbft_model.descs, desc.list ) {
 
                /* Complete table */
                sbft = &ib_srp->sbft;
                ibdev = ib_srp->ibdev;
                sbft->table.acpi.signature = cpu_to_le32 ( SBFT_SIG );
                sbft->table.acpi.length = cpu_to_le32 ( sizeof ( *sbft ) );
                sbft->table.acpi.revision = 1;
                sbft->table.scsi_offset =
                        cpu_to_le16 ( offsetof ( typeof ( *sbft ), scsi ) );
                sbft->table.srp_offset =
                        cpu_to_le16 ( offsetof ( typeof ( *sbft ), srp ) );
                sbft->table.ib_offset =
                        cpu_to_le16 ( offsetof ( typeof ( *sbft ), ib ) );
                memcpy ( &sbft->ib.sgid, &ibdev->gid, sizeof ( sbft->ib.sgid ));
                sbft->ib.pkey = cpu_to_le16 ( ibdev->pkey );
 
                /* Install table */
                if ( ( rc = install ( &sbft->table.acpi ) ) != 0 ) {
                        DBGC ( ib_srp, "IBSRP %p could not install sBFT: %s\n",
                               ib_srp, strerror ( rc ) );
                        return rc;
                }
        }
 
        return 0;
}

References acpi, sbft_table::acpi, cpu_to_le16, cpu_to_le32, DBGC, desc, ib_device::gid, ipxe_ib_sbft::ib, sbft_table::ib_offset, ib_srp_device::ibdev, acpi_header::length, list_for_each_entry, memcpy(), offsetof, ib_device::pkey, sbft_ib_subtable::pkey, rc, acpi_header::revision, ib_srp_device::sbft, SBFT_SIG, sbft_table::scsi_offset, sbft_ib_subtable::sgid, acpi_header::signature, sbft_table::srp_offset, strerror(), ipxe_ib_sbft::table, and typeof().

Variable Documentation

__acpi_model

struct acpi_model ib_sbft_model __acpi_model

Initial value:

= {
        .descs = LIST_HEAD_INIT ( ib_sbft_model.descs ),
        .complete = ib_sbft_complete,
        .install = ib_sbft_install,
}

IB sBFT model.

aBFT model

Definition at line 64 of file ib_srp.c.

ib_srp_cmrc_op

struct interface_operation ib_srp_cmrc_op[]

static

Initial value:

= {
        INTF_OP ( intf_close, struct ib_srp_device *, ib_srp_close ),
}

IB SRP CMRC interface operations.

Definition at line 112 of file ib_srp.c.

                                                     {
        INTF_OP ( intf_close, struct ib_srp_device *, ib_srp_close ),
};

ib_srp_cmrc_desc

struct interface_descriptor ib_srp_cmrc_desc

static

Initial value:

=
        INTF_DESC_PASSTHRU ( struct ib_srp_device, cmrc, ib_srp_cmrc_op, srp )

IB SRP CMRC interface descriptor.

Definition at line 117 of file ib_srp.c.

Referenced by ib_srp_open().

ib_srp_srp_op

struct interface_operation ib_srp_srp_op[]

static

Initial value:

= {
        INTF_OP ( acpi_describe, struct ib_srp_device *, ib_srp_describe ),
        INTF_OP ( intf_close, struct ib_srp_device *, ib_srp_close ),
        EFI_INTF_OP ( efi_describe, struct ib_srp_device *, efi_ib_srp_path ),
}

IB SRP SRP interface operations.

Definition at line 121 of file ib_srp.c.

                                                    {
        INTF_OP ( acpi_describe, struct ib_srp_device *, ib_srp_describe ),
        INTF_OP ( intf_close, struct ib_srp_device *, ib_srp_close ),
        EFI_INTF_OP ( efi_describe, struct ib_srp_device *, efi_ib_srp_path ),
};

ib_srp_srp_desc

struct interface_descriptor ib_srp_srp_desc

static

Initial value:

=
        INTF_DESC_PASSTHRU ( struct ib_srp_device, srp, ib_srp_srp_op, cmrc )

IB SRP SRP interface descriptor.

Definition at line 128 of file ib_srp.c.

Referenced by ib_srp_open().

ib_srp_rp_parser

struct ib_srp_root_path_parser ib_srp_rp_parser[]

static

Initial value:

= {
        { ib_srp_parse_sgid },
        { ib_srp_parse_initiator_id_ext },
        { ib_srp_parse_initiator_hca_guid },
        { ib_srp_parse_dgid },
        { ib_srp_parse_pkey },
        { ib_srp_parse_service_id },
        { ib_srp_parse_lun },
        { ib_srp_parse_target_id_ext },
        { ib_srp_parse_target_ioc_guid },
}

IB SRP root path components.

Definition at line 444 of file ib_srp.c.

                                                           {
        { ib_srp_parse_sgid },
        { ib_srp_parse_initiator_id_ext },
        { ib_srp_parse_initiator_hca_guid },
        { ib_srp_parse_dgid },
        { ib_srp_parse_pkey },
        { ib_srp_parse_service_id },
        { ib_srp_parse_lun },
        { ib_srp_parse_target_id_ext },
        { ib_srp_parse_target_ioc_guid },
};

Referenced by ib_srp_parse_root_path().

__uri_opener

struct uri_opener ib_srp_uri_opener __uri_opener

Initial value:

= {
        .scheme = "ib_srp",
        .open = ib_srp_open_uri,
}

IB SRP URI opener.

Definition at line 554 of file ib_srp.c.

                                                   {
        .scheme = "ib_srp",
        .open = ib_srp_open_uri,
};