[openib-general] [PATCH 0/6] Tranport Neutral Verbs Proposal.

Krishna Kumar krkumar2 at in.ibm.com
Thu Jul 27 21:50:01 PDT 2006


This patchset is a proposal to create new API's and data structures with
transport neutral names. The idea is to remove the old API once all
libraries/applications/examples are gradually converted to use the new API.

Patch 1/6 - Changes to libibverbs configuration file to build the libibverbs
	    with the new API.
Patch 2/6 - Additions to include files in libibverbs for the new API.
Patch 3/6 - Source files in libibverbs defining the new API.
Patch 4/6 - Convert librdmacm examples to use the new API.
Patch 5/6 - Convert librdmacm include files to use the new libibverbs API.
Patch 6/6 - Convert librdmacm source files to use the new libibverbs API.

Information notes found during the changes :
--------------------------------------------

- Added LIBRDMAVERBS_DRIVER_PATH and also use old OPENIB_DRIVER_PATH_ENV for
  backwards compatibility, but have not set user_path to include
  OPENIB_DRIVER_PATH_ENV results.

- Currently ibv_driver_init is implemented in all drivers. But the function
  returns a "struct ibv_driver *", while we expect "struct rdma_driver *". In
  reality this is fine as they are both pointers pointing to identical objects.
  Otherwise each driver has to be changed now. Once all drivers are changed to
  use rdma_* API's, this will not be an issue.

- IB specific routines are also converted to use RDMA generic API's for sake
  of uniformness (knowing that transport dependent names will be removed
  once all apps are converted).

- Passing different pointer to verbs, though the end result is the same (no
  warnings generated though as this is a link-time trick). Eg :

	int rdma_query_device(struct rdma_context *context,
			      struct rdma_device_attr *device_attr)
	{
		return context->ops.query_device(context, device_attr);
	}
  However this will not be an issue once the drivers are changed to use the
  new API. Eg : 
  	int mthca_query_device(struct rdma_context *context,
			       struct rdma_device_attr *attr)

Signed-off-by: Krishna Kumar <krkumar2 at in.ibm.com>





More information about the general mailing list