[ofa-general] multiple threads posting to the same QP

[Or Gerlitz]

Roland Dreier wrote:
>  > Looking on libibverbs sources and man pages, I can't figure out if
>  > posting to the same QP by multiple threads is supported (or if it
>  > should be supported by the low level libraries):
> 
> The low-level driver libraries are expected to be fully thread-safe.
> Basically the same rules as in Documentation/infiniband/core-locking.txt
> for the kernel level.  However I agree that this expectation is not
> written down anywhere.  I guess libibverbs needs some documentation
> for low-level driver authors.  Not sure where to put it (I don't think
> a man page is really appropriate, is it?).

I believe libibverbs/threading need to be documented both for app 
developers and for low-level driver libraries developers. A man page 
provided by libibverbs-devel surely fits the first case, as for the 
second case, libibverbs-devel can provide a document under 
/usr/share/doc as done by other packages (eg zlib-devel).

The man pages for app writers should provide a general description, 
address the thread safety properties of libibverbs, point to the other 
man pages etc. As I have pointed to Dotan, librdmacm-devel provides a 
nice man page rdma_cm(7) which can be used as an example.

Sean - I guess it would be nice to update also rdma_cm(7) to document 
the thread related assumptions etc of librdmacm...

Or.