Testing for completion

Do we need coll_ids here?

• test( [in]coll_id, [in]id, [out]count, [out]vtag, [out]user_ptr, [out]state ): Tests for completion of a storage interface operation. The count field indicates how many operations completed (in this case either 1 or 0). If an operation completes, then the final status of the operation should be checked using the state parameter. Note the vtag output argument here; it is used to provide vtags for operations that did not complete immediately.

• testsome( [in]coll_id, [in/out]id_array, [in/out]count, [out]vtag_array, [out]user_ptr_array, [out]state_array ): Tests for completion of one or more trove operations. The id_array lists operations to test on. A value of TROVE_OP_ID_NULL will be ignored. Count is set to the number of completed items on return.

  TODO: fix up semantics for testsome; look at MPI functions for ideas.

  wait function for testing purposes if nothing else?

Note: need to discuss completion queue, internal or external?

Phil: See pvfs2-internal email at
http://beowulf-underground.org/pipermail/pvfs2-internal/2001-October/000010.html for my thoughts on this topic.