iPXE
Data Structures | Macros | Enumerations | Functions | Variables
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/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  ipxe_ib_sbft
 An IB SRP sBFT created by iPXE. More...
 
struct  ib_srp_device
 An Infiniband SRP device. More...
 
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. More...
 

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. More...
 
static void ib_srp_close (struct ib_srp_device *ib_srp, int rc)
 Close IB SRP device. More...
 
static struct acpi_descriptorib_srp_describe (struct ib_srp_device *ib_srp)
 Get IB SRP ACPI descriptor. More...
 
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. More...
 
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. More...
 
static int ib_srp_parse_integer (const char *rp_comp, int default_value)
 Parse IB SRP root path integer value. More...
 
static int ib_srp_parse_sgid (const char *rp_comp, struct ib_srp_root_path *rp)
 Parse IB SRP root path source GID. More...
 
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. More...
 
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. More...
 
static int ib_srp_parse_dgid (const char *rp_comp, struct ib_srp_root_path *rp)
 Parse IB SRP root path destination GID. More...
 
static int ib_srp_parse_pkey (const char *rp_comp, struct ib_srp_root_path *rp)
 Parse IB SRP root path partition key. More...
 
static int ib_srp_parse_service_id (const char *rp_comp, struct ib_srp_root_path *rp)
 Parse IB SRP root path service ID. More...
 
static int ib_srp_parse_lun (const char *rp_comp, struct ib_srp_root_path *rp)
 Parse IB SRP root path LUN. More...
 
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. More...
 
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. More...
 
static int ib_srp_parse_root_path (const char *rp_string, struct ib_srp_root_path *rp)
 Parse IB SRP root path. More...
 
static int ib_srp_open_uri (struct interface *parent, struct uri *uri)
 Open IB SRP URI. More...
 
static int ib_sbft_complete (struct acpi_descriptor *desc __unused)
 Check if IB SRP boot firmware table descriptor is complete. More...
 
static int ib_sbft_install (int(*install)(struct acpi_header *acpi))
 Install IB SRP boot firmware table(s) More...
 

Variables

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

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 53 of file ib_srp.c.

◆ EINFO_EINVAL_BYTE_STRING_LEN

#define EINFO_EINVAL_BYTE_STRING_LEN
Value:
( EINFO_EINVAL, 0x01, "Invalid byte string length" )
#define EINFO_EINVAL
Definition: errno.h:429
#define __einfo_uniqify(einfo_base, uniq, desc)
Declare disambiguated error.
Definition: errno.h:180

Definition at line 54 of file ib_srp.c.

◆ EINVAL_INTEGER

#define EINVAL_INTEGER   __einfo_error ( EINFO_EINVAL_INTEGER )

Definition at line 56 of file ib_srp.c.

◆ EINFO_EINVAL_INTEGER

#define EINFO_EINVAL_INTEGER
Value:
( EINFO_EINVAL, 0x03, "Invalid integer" )
#define EINFO_EINVAL
Definition: errno.h:429
#define __einfo_uniqify(einfo_base, uniq, desc)
Declare disambiguated error.
Definition: errno.h:180

Definition at line 57 of file ib_srp.c.

◆ EINVAL_RP_TOO_SHORT

#define EINVAL_RP_TOO_SHORT   __einfo_error ( EINFO_EINVAL_RP_TOO_SHORT )

Definition at line 59 of file ib_srp.c.

◆ EINFO_EINVAL_RP_TOO_SHORT

#define EINFO_EINVAL_RP_TOO_SHORT
Value:
( EINFO_EINVAL, 0x04, "Root path too short" )
#define EINFO_EINVAL
Definition: errno.h:429
#define __einfo_uniqify(einfo_base, uniq, desc)
Declare disambiguated error.
Definition: errno.h:180

Definition at line 60 of file ib_srp.c.

◆ 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 488 of file ib_srp.c.

Enumeration Type Documentation

◆ 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 242 of file ib_srp.c.

Function Documentation

◆ FILE_LICENCE()

FILE_LICENCE ( BSD2  )

◆ ib_srp_free()

static void ib_srp_free ( struct refcnt refcnt)
static

Free IB SRP device.

Parameters
refcntReference count

Definition at line 110 of file ib_srp.c.

110  {
111  struct ib_srp_device *ib_srp =
113 
114  ibdev_put ( ib_srp->ibdev );
115  free ( ib_srp );
116 }
A reference counter.
Definition: refcnt.h:26
#define container_of(ptr, type, field)
Get containing structure.
Definition: stddef.h:35
static __always_inline void ibdev_put(struct ib_device *ibdev)
Drop reference to Infiniband device.
Definition: infiniband.h:597
static void(* free)(struct refcnt *refcnt))
Definition: refcnt.h:54
An Infiniband SRP device.
Definition: ib_srp.c:87
struct ib_device * ibdev
Infiniband device.
Definition: ib_srp.c:97

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

Referenced by ib_srp_open().

◆ ib_srp_close()

static void ib_srp_close ( struct ib_srp_device ib_srp,
int  rc 
)
static

Close IB SRP device.

Parameters
ib_srpIB SRP device
rcReason for close

Definition at line 124 of file ib_srp.c.

124  {
125 
126  /* Shut down interfaces */
127  intf_shutdown ( &ib_srp->cmrc, rc );
128  intf_shutdown ( &ib_srp->srp, rc );
129 }
struct arbelprm_rc_send_wqe rc
Definition: arbel.h:14
void intf_shutdown(struct interface *intf, int rc)
Shut down an object interface.
Definition: interface.c:273
struct interface cmrc
CMRC interface.
Definition: ib_srp.c:94
struct interface srp
SRP transport interface.
Definition: ib_srp.c:92

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

Referenced by ib_srp_open().

◆ ib_srp_describe()

static struct acpi_descriptor* ib_srp_describe ( struct ib_srp_device ib_srp)
static

Get IB SRP ACPI descriptor.

Parameters
ib_srpIB SRP device
Return values
descACPI descriptor

Definition at line 138 of file ib_srp.c.

138  {
139 
140  return &ib_srp->desc;
141 }
struct acpi_descriptor desc
ACPI descriptor.
Definition: ib_srp.c:100

References ib_srp_device::desc.

◆ ib_srp_open()

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 
)
static

Open IB SRP device.

Parameters
blockBlock control interface
ibdevInfiniband device
dgidDestination GID
service_idService ID
initiatorInitiator port ID
targetTarget port ID
lunSCSI LUN
Return values
rcReturn status code

Definition at line 174 of file ib_srp.c.

177  {
178  struct ib_srp_device *ib_srp;
179  struct ipxe_ib_sbft *sbft;
180  int rc;
181 
182  /* Allocate and initialise structure */
183  ib_srp = zalloc ( sizeof ( *ib_srp ) );
184  if ( ! ib_srp ) {
185  rc = -ENOMEM;
186  goto err_zalloc;
187  }
188  ref_init ( &ib_srp->refcnt, ib_srp_free );
189  intf_init ( &ib_srp->srp, &ib_srp_srp_desc, &ib_srp->refcnt );
190  intf_init ( &ib_srp->cmrc, &ib_srp_cmrc_desc, &ib_srp->refcnt );
191  ib_srp->ibdev = ibdev_get ( ibdev );
192  acpi_init ( &ib_srp->desc, &ib_sbft_model, &ib_srp->refcnt );
193  DBGC ( ib_srp, "IBSRP %p for " IB_GID_FMT " " IB_GUID_FMT "\n",
194  ib_srp, IB_GID_ARGS ( dgid ), IB_GUID_ARGS ( service_id ) );
195 
196  /* Preserve parameters required for boot firmware table */
197  sbft = &ib_srp->sbft;
198  memcpy ( &sbft->scsi.lun, lun, sizeof ( sbft->scsi.lun ) );
199  memcpy ( &sbft->srp.initiator, initiator,
200  sizeof ( sbft->srp.initiator ) );
201  memcpy ( &sbft->srp.target, target, sizeof ( sbft->srp.target ) );
202  memcpy ( &sbft->ib.dgid, dgid, sizeof ( sbft->ib.dgid ) );
203  memcpy ( &sbft->ib.service_id, service_id,
204  sizeof ( sbft->ib.service_id ) );
205 
206  /* Open CMRC socket */
207  if ( ( rc = ib_cmrc_open ( &ib_srp->cmrc, ibdev, dgid,
208  service_id, "SRP" ) ) != 0 ) {
209  DBGC ( ib_srp, "IBSRP %p could not open CMRC socket: %s\n",
210  ib_srp, strerror ( rc ) );
211  goto err_cmrc_open;
212  }
213 
214  /* Attach SRP device to parent interface */
215  if ( ( rc = srp_open ( block, &ib_srp->srp, initiator, target,
216  ibdev->rdma_key, lun ) ) != 0 ) {
217  DBGC ( ib_srp, "IBSRP %p could not create SRP device: %s\n",
218  ib_srp, strerror ( rc ) );
219  goto err_srp_open;
220  }
221 
222  /* Mortalise self and return */
223  ref_put ( &ib_srp->refcnt );
224  return 0;
225 
226  err_srp_open:
227  err_cmrc_open:
228  ib_srp_close ( ib_srp, rc );
229  ref_put ( &ib_srp->refcnt );
230  err_zalloc:
231  return rc;
232 }
struct arbelprm_rc_send_wqe rc
Definition: arbel.h:14
int ib_cmrc_open(struct interface *xfer, struct ib_device *ibdev, union ib_gid *dgid, union ib_guid *service_id, const char *name)
Open CMRC connection.
Definition: ib_cmrc.c:397
int srp_open(struct interface *block, struct interface *socket, union srp_port_id *initiator, union srp_port_id *target, uint32_t memory_handle, struct scsi_lun *lun)
Open SRP device.
Definition: srp.c:713
struct ipxe_ib_sbft sbft
Boot firmware table parameters.
Definition: ib_srp.c:102
union srp_port_id initiator
Initiator port identifier.
Definition: srp.h:817
#define ref_init(refcnt, free)
Initialise a reference counter.
Definition: refcnt.h:64
uint16_t block
Definition: tftp.h:12
struct interface cmrc
CMRC interface.
Definition: ib_srp.c:94
struct interface srp
SRP transport interface.
Definition: ib_srp.c:92
#define DBGC(...)
Definition: compiler.h:505
#define IB_GUID_ARGS(guid)
Infiniband Globally Unique Identifier debug message arguments.
Definition: ib_packet.h:29
union srp_port_id target
Target port identifier.
Definition: srp.h:819
union ib_gid dgid
Destination GID.
Definition: ib_srp.h:49
static struct interface_descriptor ib_srp_srp_desc
IB SRP SRP interface descriptor.
Definition: ib_srp.c:159
static __always_inline struct ib_device * ibdev_get(struct ib_device *ibdev)
Get reference to Infiniband device.
Definition: infiniband.h:586
#define ENOMEM
Not enough space.
Definition: errno.h:534
struct refcnt refcnt
Reference count.
Definition: ib_srp.c:89
void * memcpy(void *dest, const void *src, size_t len) __nonnull
#define IB_GUID_FMT
Infiniband Globally Unique Identifier debug message format.
Definition: ib_packet.h:26
struct sbft_srp_subtable srp
The SRP subtable.
Definition: ib_srp.c:81
An IB SRP sBFT created by iPXE.
Definition: ib_srp.c:75
uint8_t lun
Logical Unit Number.
Definition: edd.h:32
union ib_guid service_id
Service ID.
Definition: ib_srp.h:51
#define IB_GID_ARGS(gid)
Infiniband Global Identifier debug message arguments.
Definition: ib_packet.h:48
uint32_t rdma_key
RDMA key.
Definition: infiniband.h:454
char * strerror(int errno)
Retrieve string representation of error number.
Definition: strerror.c:78
void * zalloc(size_t size)
Allocate cleared memory.
Definition: malloc.c:624
struct sbft_scsi_subtable scsi
The SCSI subtable.
Definition: ib_srp.c:79
struct scsi_lun lun
LUN.
Definition: srp.h:809
An Infiniband SRP device.
Definition: ib_srp.c:87
static void ib_srp_close(struct ib_srp_device *ib_srp, int rc)
Close IB SRP device.
Definition: ib_srp.c:124
union ib_gid dgid
Definition: ib_mad.h:12
struct ib_device * ibdev
Infiniband device.
Definition: ib_srp.c:97
static void ib_srp_free(struct refcnt *refcnt)
Free IB SRP device.
Definition: ib_srp.c:110
#define IB_GID_FMT
Infiniband Global Identifier debug message format.
Definition: ib_packet.h:45
struct sbft_ib_subtable ib
The Infiniband subtable.
Definition: ib_srp.c:83
static struct interface_descriptor ib_srp_cmrc_desc
IB SRP CMRC interface descriptor.
Definition: ib_srp.c:149
union ib_guid service_id
Service ID.
Definition: ib_mad.h:16
static void intf_init(struct interface *intf, struct interface_descriptor *desc, struct refcnt *refcnt)
Initialise an object interface.
Definition: interface.h:173
#define ref_put(refcnt)
Drop reference to object.
Definition: refcnt.h:106
static void acpi_init(struct acpi_descriptor *desc, struct acpi_model *model, struct refcnt *refcnt)
Initialise ACPI descriptor.
Definition: acpi.h:160
struct acpi_descriptor desc
ACPI descriptor.
Definition: ib_srp.c:100

References acpi_init(), block, ib_srp_device::cmrc, DBGC, ib_srp_device::desc, sbft_ib_subtable::dgid, 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, ipxe_ib_sbft::srp, ib_srp_device::srp, srp_open(), strerror(), sbft_srp_subtable::target, and zalloc().

Referenced by ib_srp_open_uri().

◆ ib_srp_parse_byte_string()

static 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_compRoot path component string
default_valueDefault value to use if component string is empty
Return values
valueValue

Definition at line 273 of file ib_srp.c.

274  {
275  size_t size = ( size_flags & ~IB_SRP_PARSE_FLAG_MASK );
276  size_t rp_comp_len = strlen ( rp_comp );
277  int decoded_size;
278 
279  /* Allow optional components to be empty */
280  if ( ( rp_comp_len == 0 ) &&
281  ( size_flags & IB_SRP_PARSE_OPTIONAL ) )
282  return 0;
283 
284  /* Check string length */
285  if ( rp_comp_len != ( 2 * size ) )
286  return -EINVAL_BYTE_STRING_LEN;
287 
288  /* Parse byte string */
289  decoded_size = base16_decode ( rp_comp, bytes, size );
290  if ( decoded_size < 0 )
291  return decoded_size;
292 
293  return 0;
294 }
#define EINVAL_BYTE_STRING_LEN
Definition: ib_srp.c:53
size_t strlen(const char *src)
Get length of string.
Definition: string.c:213
uint8_t size
Entry size (in 32-bit words)
Definition: ena.h:16
uint8_t bytes[64]
Definition: ib_mad.h:16

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()

static int ib_srp_parse_integer ( const char *  rp_comp,
int  default_value 
)
static

Parse IB SRP root path integer value.

Parameters
rp_compRoot path component string
default_valueDefault value to use if component string is empty
Return values
valueValue

Definition at line 303 of file ib_srp.c.

303  {
304  int value;
305  char *end;
306 
307  value = strtoul ( rp_comp, &end, 16 );
308  if ( *end )
309  return -EINVAL_INTEGER;
310 
311  if ( end == rp_comp )
312  return default_value;
313 
314  return value;
315 }
unsigned long strtoul(const char *string, char **endp, int base)
Convert string to numeric value.
Definition: string.c:441
#define EINVAL_INTEGER
Definition: ib_srp.c:56
pseudo_bit_t value[0x00020]
Definition: arbel.h:13
uint32_t end
Ending offset.
Definition: netvsc.h:18

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

Referenced by ib_srp_parse_pkey().

◆ ib_srp_parse_sgid()

static 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_compRoot path component string
rpIB SRP root path
Return values
rcReturn status code

Definition at line 324 of file ib_srp.c.

325  {
326  struct ib_device *ibdev;
327 
328  /* Default to the GID of the last opened Infiniband device */
329  if ( ( ibdev = last_opened_ibdev() ) != NULL )
330  memcpy ( &rp->sgid, &ibdev->gid, sizeof ( rp->sgid ) );
331 
332  return ib_srp_parse_byte_string ( rp_comp, rp->sgid.bytes,
333  ( sizeof ( rp->sgid ) |
335 }
union ib_gid gid
Port GID (comprising GID prefix and port GUID)
Definition: infiniband.h:439
struct ib_device * last_opened_ibdev(void)
Get most recently opened Infiniband device.
Definition: infiniband.c:1043
An Infiniband device.
Definition: infiniband.h:398
uint8_t bytes[16]
Definition: ib_packet.h:34
void * memcpy(void *dest, const void *src, size_t len) __nonnull
union ib_gid sgid
Source GID.
Definition: ib_srp.c:251
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.
Definition: ib_srp.c:273
#define NULL
NULL pointer (VOID *)
Definition: Base.h:362

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()

static 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_compRoot path component string
rpIB SRP root path
Return values
rcReturn status code

Definition at line 344 of file ib_srp.c.

345  {
346  union ib_srp_initiator_port_id *port_id = &rp->initiator;
347 
348  return ib_srp_parse_byte_string ( rp_comp, port_id->ib.id_ext.bytes,
349  ( sizeof ( port_id->ib.id_ext ) |
351 }
union ib_srp_initiator_port_id initiator
Initiator port ID.
Definition: ib_srp.c:253
struct ib_srp_initiator_port_id::@537 ib
Infiniband version of port identifier.
SRP initiator port identifier for Infiniband.
Definition: ib_srp.h:17
uint8_t bytes[8]
Definition: ib_packet.h:19
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.
Definition: ib_srp.c:273
union ib_guid id_ext
Identifier extension.
Definition: ib_srp.h:23

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()

static 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_compRoot path component string
rpIB SRP root path
Return values
rcReturn status code

Definition at line 360 of file ib_srp.c.

361  {
362  union ib_srp_initiator_port_id *port_id = &rp->initiator;
363 
364  /* Default to the GUID portion of the source GID */
365  memcpy ( &port_id->ib.hca_guid, &rp->sgid.s.guid,
366  sizeof ( port_id->ib.hca_guid ) );
367 
368  return ib_srp_parse_byte_string ( rp_comp, port_id->ib.hca_guid.bytes,
369  ( sizeof ( port_id->ib.hca_guid ) |
371 }
union ib_guid guid
Definition: ib_packet.h:40
union ib_srp_initiator_port_id initiator
Initiator port ID.
Definition: ib_srp.c:253
struct ib_srp_initiator_port_id::@537 ib
Infiniband version of port identifier.
void * memcpy(void *dest, const void *src, size_t len) __nonnull
SRP initiator port identifier for Infiniband.
Definition: ib_srp.h:17
union ib_guid hca_guid
IB channel adapter GUID.
Definition: ib_srp.h:25
union ib_gid sgid
Source GID.
Definition: ib_srp.c:251
uint8_t bytes[8]
Definition: ib_packet.h:19
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.
Definition: ib_srp.c:273
struct ib_gid::@532 s

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()

static 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_compRoot path component string
rpIB SRP root path
Return values
rcReturn status code

Definition at line 380 of file ib_srp.c.

381  {
382  return ib_srp_parse_byte_string ( rp_comp, rp->dgid.bytes,
383  ( sizeof ( rp->dgid ) |
385 }
uint8_t bytes[16]
Definition: ib_packet.h:34
union ib_gid dgid
Destination GID.
Definition: ib_srp.c:255
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.
Definition: ib_srp.c:273

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

◆ ib_srp_parse_pkey()

static 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_compRoot path component string
rpIB SRP root path
Return values
rcReturn status code

Definition at line 394 of file ib_srp.c.

395  {
396  int pkey;
397 
398  if ( ( pkey = ib_srp_parse_integer ( rp_comp, IB_PKEY_DEFAULT ) ) < 0 )
399  return pkey;
400  rp->pkey = pkey;
401  return 0;
402 }
#define IB_PKEY_DEFAULT
Default Infiniband partition key.
Definition: infiniband.h:39
uint16_t pkey
Partition key.
Definition: ib_srp.c:257
uint16_t pkey[32]
Partition key.
Definition: ib_mad.h:11
static int ib_srp_parse_integer(const char *rp_comp, int default_value)
Parse IB SRP root path integer value.
Definition: ib_srp.c:303

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

◆ ib_srp_parse_service_id()

static 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_compRoot path component string
rpIB SRP root path
Return values
rcReturn status code

Definition at line 411 of file ib_srp.c.

412  {
413  return ib_srp_parse_byte_string ( rp_comp, rp->service_id.bytes,
414  ( sizeof ( rp->service_id ) |
416 }
union ib_guid service_id
Service ID.
Definition: ib_srp.c:259
uint8_t bytes[8]
Definition: ib_packet.h:19
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.
Definition: ib_srp.c:273

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

◆ ib_srp_parse_lun()

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

Parse IB SRP root path LUN.

Parameters
rp_compRoot path component string
rpIB SRP root path
Return values
rcReturn status code

Definition at line 425 of file ib_srp.c.

426  {
427  return scsi_parse_lun ( rp_comp, &rp->lun );
428 }
int scsi_parse_lun(const char *lun_string, struct scsi_lun *lun)
Parse SCSI LUN.
Definition: scsi.c:117
struct scsi_lun lun
SCSI LUN.
Definition: ib_srp.c:261

References ib_srp_root_path::lun, and scsi_parse_lun().

◆ ib_srp_parse_target_id_ext()

static 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_compRoot path component string
rpIB SRP root path
Return values
rcReturn status code

Definition at line 437 of file ib_srp.c.

438  {
439  union ib_srp_target_port_id *port_id = &rp->target;
440 
441  return ib_srp_parse_byte_string ( rp_comp, port_id->ib.id_ext.bytes,
442  ( sizeof ( port_id->ib.id_ext ) |
444 }
struct ib_srp_target_port_id::@538 ib
Infiniband version of port identifier.
SRP target port identifier for Infiniband.
Definition: ib_srp.h:30
uint8_t bytes[8]
Definition: ib_packet.h:19
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.
Definition: ib_srp.c:273
union ib_srp_target_port_id target
Target port ID.
Definition: ib_srp.c:263
union ib_guid id_ext
Identifier extension.
Definition: ib_srp.h:36

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()

static 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_compRoot path component string
rpIB SRP root path
Return values
rcReturn status code

Definition at line 453 of file ib_srp.c.

454  {
455  union ib_srp_target_port_id *port_id = &rp->target;
456 
457  return ib_srp_parse_byte_string ( rp_comp, port_id->ib.ioc_guid.bytes,
458  ( sizeof ( port_id->ib.ioc_guid ) |
460 }
struct ib_srp_target_port_id::@538 ib
Infiniband version of port identifier.
SRP target port identifier for Infiniband.
Definition: ib_srp.h:30
union ib_guid ioc_guid
I/O controller GUID.
Definition: ib_srp.h:38
uint8_t bytes[8]
Definition: ib_packet.h:19
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.
Definition: ib_srp.c:273
union ib_srp_target_port_id target
Target port ID.
Definition: ib_srp.c:263

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()

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

Parse IB SRP root path.

Parameters
rp_stringRoot path string
rpIB SRP root path
Return values
rcReturn status code

Definition at line 498 of file ib_srp.c.

499  {
500  struct ib_srp_root_path_parser *parser;
501  char *rp_comp[IB_SRP_NUM_RP_COMPONENTS];
502  char *rp_string_copy;
503  char *rp_string_tmp;
504  unsigned int i = 0;
505  int rc;
506 
507  /* Create modifiable copy of root path */
508  rp_string_copy = strdup ( rp_string );
509  if ( ! rp_string_copy ) {
510  rc = -ENOMEM;
511  goto err_strdup;
512  }
513  rp_string_tmp = rp_string_copy;
514 
515  /* Split root path into component parts */
516  while ( 1 ) {
517  rp_comp[i++] = rp_string_tmp;
518  if ( i == IB_SRP_NUM_RP_COMPONENTS )
519  break;
520  for ( ; *rp_string_tmp != ':' ; rp_string_tmp++ ) {
521  if ( ! *rp_string_tmp ) {
522  DBG ( "IBSRP root path \"%s\" too short\n",
523  rp_string );
525  goto err_split;
526  }
527  }
528  *(rp_string_tmp++) = '\0';
529  }
530 
531  /* Parse root path components */
532  for ( i = 0 ; i < IB_SRP_NUM_RP_COMPONENTS ; i++ ) {
533  parser = &ib_srp_rp_parser[i];
534  if ( ( rc = parser->parse ( rp_comp[i], rp ) ) != 0 ) {
535  DBG ( "IBSRP could not parse \"%s\" in root path "
536  "\"%s\": %s\n", rp_comp[i], rp_string,
537  strerror ( rc ) );
538  goto err_parse;
539  }
540  }
541 
542  err_parse:
543  err_split:
544  free ( rp_string_copy );
545  err_strdup:
546  return rc;
547 }
struct arbelprm_rc_send_wqe rc
Definition: arbel.h:14
static struct ib_srp_root_path_parser ib_srp_rp_parser[]
IB SRP root path components.
Definition: ib_srp.c:475
int(* parse)(const char *rp_comp, struct ib_srp_root_path *rp)
Parse IB SRP root path component.
Definition: ib_srp.c:471
IB SRP root path component parser.
Definition: ib_srp.c:463
#define ENOMEM
Not enough space.
Definition: errno.h:534
#define EINVAL_RP_TOO_SHORT
Definition: ib_srp.c:59
char * strerror(int errno)
Retrieve string representation of error number.
Definition: strerror.c:78
static void(* free)(struct refcnt *refcnt))
Definition: refcnt.h:54
#define IB_SRP_NUM_RP_COMPONENTS
Number of IB SRP root path components.
Definition: ib_srp.c:488
char * strdup(const char *src)
Duplicate string.
Definition: string.c:350
#define DBG(...)
Print a debugging message.
Definition: compiler.h:498

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()

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

Open IB SRP URI.

Parameters
parentParent interface
uriURI
Return values
rcReturn status code

Definition at line 556 of file ib_srp.c.

556  {
557  struct ib_srp_root_path rp;
558  struct ib_device *ibdev;
559  int rc;
560 
561  /* Parse URI */
562  if ( ! uri->opaque )
563  return -EINVAL;
564  memset ( &rp, 0, sizeof ( rp ) );
565  if ( ( rc = ib_srp_parse_root_path ( uri->opaque, &rp ) ) != 0 )
566  return rc;
567 
568  /* Identify Infiniband device */
569  ibdev = find_ibdev ( &rp.sgid );
570  if ( ! ibdev ) {
571  DBG ( "IBSRP could not identify Infiniband device\n" );
572  return -ENODEV;
573  }
574 
575  /* Open IB SRP device */
576  if ( ( rc = ib_srp_open ( parent, ibdev, &rp.dgid, &rp.service_id,
577  &rp.initiator.srp, &rp.target.srp,
578  &rp.lun ) ) != 0 )
579  return rc;
580 
581  return 0;
582 }
#define EINVAL
Invalid argument.
Definition: errno.h:428
struct arbelprm_rc_send_wqe rc
Definition: arbel.h:14
An Infiniband device.
Definition: infiniband.h:398
static int ib_srp_parse_root_path(const char *rp_string, struct ib_srp_root_path *rp)
Parse IB SRP root path.
Definition: ib_srp.c:498
IB SRP root path parameters.
Definition: ib_srp.c:249
struct ib_device * find_ibdev(union ib_gid *gid)
Find Infiniband device by GID.
Definition: infiniband.c:1028
#define ENODEV
No such device.
Definition: errno.h:509
const char * opaque
Opaque part.
Definition: uri.h:56
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.
Definition: ib_srp.c:174
A Uniform Resource Identifier.
Definition: uri.h:50
#define DBG(...)
Print a debugging message.
Definition: compiler.h:498
void * memset(void *dest, int character, size_t len) __nonnull

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_target_port_id::srp, ib_srp_initiator_port_id::srp, and ib_srp_root_path::target.

◆ ib_sbft_complete()

static int ib_sbft_complete ( struct acpi_descriptor *desc  __unused)
static

Check if IB SRP boot firmware table descriptor is complete.

Parameters
descACPI descriptor
Return values
rcReturn status code

Definition at line 603 of file ib_srp.c.

603  {
604  return 0;
605 }

◆ ib_sbft_install()

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

Install IB SRP boot firmware table(s)

Parameters
installInstallation method
Return values
rcReturn status code

Definition at line 613 of file ib_srp.c.

613  {
614  struct ib_srp_device *ib_srp;
615  struct ipxe_ib_sbft *sbft;
616  struct ib_device *ibdev;
617  int rc;
618 
619  list_for_each_entry ( ib_srp, &ib_sbft_model.descs, desc.list ) {
620 
621  /* Complete table */
622  sbft = &ib_srp->sbft;
623  ibdev = ib_srp->ibdev;
625  sbft->table.acpi.length = cpu_to_le32 ( sizeof ( *sbft ) );
626  sbft->table.acpi.revision = 1;
627  sbft->table.scsi_offset =
628  cpu_to_le16 ( offsetof ( typeof ( *sbft ), scsi ) );
629  sbft->table.srp_offset =
630  cpu_to_le16 ( offsetof ( typeof ( *sbft ), srp ) );
631  sbft->table.ib_offset =
632  cpu_to_le16 ( offsetof ( typeof ( *sbft ), ib ) );
633  memcpy ( &sbft->ib.sgid, &ibdev->gid, sizeof ( sbft->ib.sgid ));
634  sbft->ib.pkey = cpu_to_le16 ( ibdev->pkey );
635 
636  /* Install table */
637  if ( ( rc = install ( &sbft->table.acpi ) ) != 0 ) {
638  DBGC ( ib_srp, "IBSRP %p could not install sBFT: %s\n",
639  ib_srp, strerror ( rc ) );
640  return rc;
641  }
642  }
643 
644  return 0;
645 }
struct arbelprm_rc_send_wqe rc
Definition: arbel.h:14
union ib_gid gid
Port GID (comprising GID prefix and port GUID)
Definition: infiniband.h:439
struct ipxe_ib_sbft sbft
Boot firmware table parameters.
Definition: ib_srp.c:102
uint32_t signature
ACPI signature (4 ASCII characters)
Definition: acpi.h:30
#define DBGC(...)
Definition: compiler.h:505
#define offsetof(type, field)
Get offset of a field within a structure.
Definition: stddef.h:24
#define SBFT_SIG
SRP Boot Firmware Table signature.
Definition: srp.h:783
An Infiniband device.
Definition: infiniband.h:398
void * memcpy(void *dest, const void *src, size_t len) __nonnull
struct acpi_header acpi
ACPI header.
Definition: srp.h:793
struct sbft_table table
The table header.
Definition: ib_srp.c:77
uint32_t length
Length of table, in bytes, including header.
Definition: acpi.h:32
#define list_for_each_entry(pos, head, member)
Iterate over entries in a list.
Definition: list.h:420
An IB SRP sBFT created by iPXE.
Definition: ib_srp.c:75
union ib_gid sgid
Source GID.
Definition: ib_srp.h:47
#define cpu_to_le32(value)
Definition: byteswap.h:107
char * strerror(int errno)
Retrieve string representation of error number.
Definition: strerror.c:78
An Infiniband SRP device.
Definition: ib_srp.c:87
sbft_off_t ib_offset
Offset to IB subtable, if present.
Definition: srp.h:799
sbft_off_t scsi_offset
Offset to SCSI subtable.
Definition: srp.h:795
struct ib_device * ibdev
Infiniband device.
Definition: ib_srp.c:97
#define cpu_to_le16(value)
Definition: byteswap.h:106
struct sbft_ib_subtable ib
The Infiniband subtable.
Definition: ib_srp.c:83
uint16_t pkey
Partition key.
Definition: infiniband.h:447
uint8_t revision
ACPI Specification minor version number.
Definition: acpi.h:34
uint16_t pkey
Partition key.
Definition: ib_srp.h:53
sbft_off_t srp_offset
Offset to SRP subtable.
Definition: srp.h:797

References sbft_table::acpi, cpu_to_le16, cpu_to_le32, DBGC, ib_device::gid, ipxe_ib_sbft::ib, sbft_table::ib_offset, ib_srp_device::ibdev, acpi_header::length, list_for_each_entry, memcpy(), offsetof, sbft_ib_subtable::pkey, ib_device::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(), and ipxe_ib_sbft::table.

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,
}
static int ib_sbft_complete(struct acpi_descriptor *desc __unused)
Check if IB SRP boot firmware table descriptor is complete.
Definition: ib_srp.c:603
static int ib_sbft_install(int(*install)(struct acpi_header *acpi))
Install IB SRP boot firmware table(s)
Definition: ib_srp.c:613
#define LIST_HEAD_INIT(list)
Initialise a static list head.
Definition: list.h:30

IB sBFT model.

aBFT model

Definition at line 63 of file ib_srp.c.

◆ ib_srp_cmrc_op

struct interface_operation ib_srp_cmrc_op[]
static
Initial value:
= {
}
void intf_close(struct interface *intf, int rc)
Close an object interface.
Definition: interface.c:244
#define INTF_OP(op_type, object_type, op_func)
Define an object interface operation.
Definition: interface.h:32
An Infiniband SRP device.
Definition: ib_srp.c:87
static void ib_srp_close(struct ib_srp_device *ib_srp, int rc)
Close IB SRP device.
Definition: ib_srp.c:124

IB SRP CMRC interface operations.

Definition at line 144 of file ib_srp.c.

◆ ib_srp_cmrc_desc

struct interface_descriptor ib_srp_cmrc_desc
static
Initial value:
=
An Infiniband SRP device.
Definition: ib_srp.c:87
#define INTF_DESC_PASSTHRU(object_type, intf, operations, passthru)
Define an object interface descriptor with pass-through interface.
Definition: interface.h:82
static struct interface_operation ib_srp_cmrc_op[]
IB SRP CMRC interface operations.
Definition: ib_srp.c:144

IB SRP CMRC interface descriptor.

Definition at line 149 of file ib_srp.c.

Referenced by ib_srp_open().

◆ ib_srp_srp_op

struct interface_operation ib_srp_srp_op[]
static
Initial value:
= {
}
void intf_close(struct interface *intf, int rc)
Close an object interface.
Definition: interface.c:244
static struct acpi_descriptor * ib_srp_describe(struct ib_srp_device *ib_srp)
Get IB SRP ACPI descriptor.
Definition: ib_srp.c:138
#define INTF_OP(op_type, object_type, op_func)
Define an object interface operation.
Definition: interface.h:32
An Infiniband SRP device.
Definition: ib_srp.c:87
struct acpi_descriptor * acpi_describe(struct interface *intf)
Get object's ACPI descriptor.
Definition: acpi.c:334
static void ib_srp_close(struct ib_srp_device *ib_srp, int rc)
Close IB SRP device.
Definition: ib_srp.c:124

IB SRP SRP interface operations.

Definition at line 153 of file ib_srp.c.

◆ ib_srp_srp_desc

struct interface_descriptor ib_srp_srp_desc
static
Initial value:
=
static struct interface_operation ib_srp_srp_op[]
IB SRP SRP interface operations.
Definition: ib_srp.c:153
An Infiniband SRP device.
Definition: ib_srp.c:87
#define INTF_DESC_PASSTHRU(object_type, intf, operations, passthru)
Define an object interface descriptor with pass-through interface.
Definition: interface.h:82

IB SRP SRP interface descriptor.

Definition at line 159 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:
= {
}
static int ib_srp_parse_dgid(const char *rp_comp, struct ib_srp_root_path *rp)
Parse IB SRP root path destination GID.
Definition: ib_srp.c:380
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.
Definition: ib_srp.c:360
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.
Definition: ib_srp.c:344
static int ib_srp_parse_sgid(const char *rp_comp, struct ib_srp_root_path *rp)
Parse IB SRP root path source GID.
Definition: ib_srp.c:324
static int ib_srp_parse_service_id(const char *rp_comp, struct ib_srp_root_path *rp)
Parse IB SRP root path service ID.
Definition: ib_srp.c:411
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.
Definition: ib_srp.c:453
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.
Definition: ib_srp.c:437
static int ib_srp_parse_lun(const char *rp_comp, struct ib_srp_root_path *rp)
Parse IB SRP root path LUN.
Definition: ib_srp.c:425
static int ib_srp_parse_pkey(const char *rp_comp, struct ib_srp_root_path *rp)
Parse IB SRP root path partition key.
Definition: ib_srp.c:394

IB SRP root path components.

Definition at line 475 of file ib_srp.c.

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,
}
static int ib_srp_open_uri(struct interface *parent, struct uri *uri)
Open IB SRP URI.
Definition: ib_srp.c:556

IB SRP URI opener.

Definition at line 585 of file ib_srp.c.