/*
*-----------------------------------------------------------------------------
*
- * VMCIQPair_Alloc() --
+ * VMCIQPair_Alloc --
*
* This is the client interface for allocating the memory for a
* VMCIQPair structure and then attaching to the underlying
*/
int
-VMCIQPair_Alloc(VMCIQPair **qpair, // OUT:
- VMCIHandle *handle, // OUT:
- uint64 produceQSize, // IN:
- uint64 consumeQSize, // IN:
- VMCIId peer, // IN:
- uint32 flags, // IN:
- VMCIPrivilegeFlags privFlags) // IN:
+VMCIQPair_Alloc(VMCIQPair **qpair, // OUT
+ VMCIHandle *handle, // OUT
+ uint64 produceQSize, // IN
+ uint64 consumeQSize, // IN
+ VMCIId peer, // IN
+ uint32 flags, // IN
+ VMCIPrivilegeFlags privFlags) // IN
{
VMCIQPair *myQPair;
int retval;
/*
*-----------------------------------------------------------------------------
*
- * VMCIQPair_Detach() --
+ * VMCIQPair_Detach --
*
* This is the client interface for detaching from a VMCIQPair.
* Note that this routine will free the memory allocated for the
*/
void
-VMCIQPair_Detach(VMCIQPair **qpair) // IN/OUT:
+VMCIQPair_Detach(VMCIQPair **qpair) // IN/OUT
{
VMCIQPair *oldQPair = *qpair;
/*
*-----------------------------------------------------------------------------
*
- * VMCIQPair_Lock() --
+ * VMCIQPair_Lock --
*
* Helper routine that will lock the QPair before subsequent operations.
*
*/
static INLINE void
-VMCIQPairLock(const VMCIQPair *qpair) // IN:
+VMCIQPairLock(const VMCIQPair *qpair) // IN
{
#if !defined VMX86_TOOLS && !defined VMX86_VMX
VMCIHost_AcquireQueueMutex(qpair->produceQ);
/*
*-----------------------------------------------------------------------------
*
- * VMCIQPair_Unlock() --
+ * VMCIQPair_Unlock --
*
* Helper routine that will unlock the QPair after various operations.
*
*/
static INLINE void
-VMCIQPairUnlock(const VMCIQPair *qpair) // IN:
+VMCIQPairUnlock(const VMCIQPair *qpair) // IN
{
#if !defined VMX86_TOOLS && !defined VMX86_VMX
VMCIHost_ReleaseQueueMutex(qpair->produceQ);
/*
*-----------------------------------------------------------------------------
*
- * VMCIQPair_Init() --
+ * VMCIQPair_Init --
*
* This is the client interface for initializing the producer's
* pointers.
/*
*-----------------------------------------------------------------------------
*
- * VMCIQPair_GetProduceIndexes() --
+ * VMCIQPair_GetProduceIndexes --
*
* This is the client interface for getting the current indexes of the
* QPair from the point of the view of the caller as the producer.
*/
void
-VMCIQPair_GetProduceIndexes(const VMCIQPair *qpair, // IN:
- uint64 *producerTail, // OUT:
- uint64 *consumerHead) // OUT:
+VMCIQPair_GetProduceIndexes(const VMCIQPair *qpair, // IN
+ uint64 *producerTail, // OUT
+ uint64 *consumerHead) // OUT
{
VMCIQPairLock(qpair);
/*
*-----------------------------------------------------------------------------
*
- * VMCIQPair_GetConsumeIndexes() --
+ * VMCIQPair_GetConsumeIndexes --
*
* This is the client interface for getting the current indexes of the
* QPair from the point of the view of the caller as the consumer.
*/
void
-VMCIQPair_GetConsumeIndexes(const VMCIQPair *qpair, // IN:
- uint64 *consumerTail, // OUT:
- uint64 *producerHead) // OUT:
+VMCIQPair_GetConsumeIndexes(const VMCIQPair *qpair, // IN
+ uint64 *consumerTail, // OUT
+ uint64 *producerHead) // OUT
{
VMCIQPairLock(qpair);
/*
*-----------------------------------------------------------------------------
*
- * VMCIQPair_ProduceFreeSpace() --
+ * VMCIQPair_ProduceFreeSpace --
*
* This is the client interface for getting the amount of free
* space in the QPair from the point of the view of the caller as
*/
int64
-VMCIQPair_ProduceFreeSpace(const VMCIQPair *qpair) // IN:
+VMCIQPair_ProduceFreeSpace(const VMCIQPair *qpair) // IN
{
int64 result;
/*
*-----------------------------------------------------------------------------
*
- * VMCIQPair_ConsumeFreeSpace() --
+ * VMCIQPair_ConsumeFreeSpace --
*
* This is the client interface for getting the amount of free
* space in the QPair from the point of the view of the caller as
*/
int64
-VMCIQPair_ConsumeFreeSpace(const VMCIQPair *qpair) // IN:
+VMCIQPair_ConsumeFreeSpace(const VMCIQPair *qpair) // IN
{
int64 result;
/*
*-----------------------------------------------------------------------------
*
- * VMCIQPair_ProduceBufReady() --
+ * VMCIQPair_ProduceBufReady --
*
* This is the client interface for getting the amount of
* enqueued data in the QPair from the point of the view of the
*/
int64
-VMCIQPair_ProduceBufReady(const VMCIQPair *qpair) // IN:
+VMCIQPair_ProduceBufReady(const VMCIQPair *qpair) // IN
{
int64 result;
/*
*-----------------------------------------------------------------------------
*
- * VMCIQPair_ConsumeBufReady() --
+ * VMCIQPair_ConsumeBufReady --
*
* This is the client interface for getting the amount of
* enqueued data in the QPair from the point of the view of the
*/
int64
-VMCIQPair_ConsumeBufReady(const VMCIQPair *qpair) // IN:
+VMCIQPair_ConsumeBufReady(const VMCIQPair *qpair) // IN
{
int64 result;
*/
static INLINE ssize_t
-EnqueueLocked(VMCIQueue *produceQ, // IN:
- const VMCIQueue *consumeQ, // IN:
- const uint64 produceQSize, // IN:
- const void *buf, // IN:
- size_t bufSize, // IN:
- int bufType, // IN:
- VMCIMemcpyToQueueFunc memcpyToQueue) // IN:
+EnqueueLocked(VMCIQueue *produceQ, // IN
+ const VMCIQueue *consumeQ, // IN
+ const uint64 produceQSize, // IN
+ const void *buf, // IN
+ size_t bufSize, // IN
+ int bufType, // IN
+ VMCIMemcpyToQueueFunc memcpyToQueue) // IN
{
int64 freeSpace;
uint64 tail;
/*
*-----------------------------------------------------------------------------
*
- * DequeueLocked() --
+ * DequeueLocked --
*
* Dequeues data (if available) from the given consume queue. Writes data
* to the user provided buffer using the provided function.
*/
static INLINE ssize_t
-DequeueLocked(VMCIQueue *produceQ, // IN:
- const VMCIQueue *consumeQ, // IN:
- const uint64 consumeQSize, // IN:
- void *buf, // IN:
- size_t bufSize, // IN:
- int bufType, // IN:
- VMCIMemcpyFromQueueFunc memcpyFromQueue, // IN:
- Bool updateConsumer) // IN:
+DequeueLocked(VMCIQueue *produceQ, // IN
+ const VMCIQueue *consumeQ, // IN
+ const uint64 consumeQSize, // IN
+ void *buf, // IN
+ size_t bufSize, // IN
+ int bufType, // IN
+ VMCIMemcpyFromQueueFunc memcpyFromQueue, // IN
+ Bool updateConsumer) // IN
{
int64 bufReady;
uint64 head;
/*
*-----------------------------------------------------------------------------
*
- * VMCIQPair_Enqueue() --
+ * VMCIQPair_Enqueue --
*
* This is the client interface for enqueueing data into the queue.
*
*/
ssize_t
-VMCIQPair_Enqueue(VMCIQPair *qpair, // IN:
- const void *buf, // IN:
- size_t bufSize, // IN:
- int bufType) // IN:
+VMCIQPair_Enqueue(VMCIQPair *qpair, // IN
+ const void *buf, // IN
+ size_t bufSize, // IN
+ int bufType) // IN
{
ssize_t result;
/*
*-----------------------------------------------------------------------------
*
- * VMCIQPair_Dequeue() --
+ * VMCIQPair_Dequeue --
*
* This is the client interface for dequeueing data from the queue.
*
*/
ssize_t
-VMCIQPair_Dequeue(VMCIQPair *qpair, // IN:
- void *buf, // IN:
- size_t bufSize, // IN:
- int bufType) // IN:
+VMCIQPair_Dequeue(VMCIQPair *qpair, // IN
+ void *buf, // IN
+ size_t bufSize, // IN
+ int bufType) // IN
{
ssize_t result;
/*
*-----------------------------------------------------------------------------
*
- * VMCIQPair_Peek() --
+ * VMCIQPair_Peek --
*
* This is the client interface for peeking into a queue. (I.e.,
* copy data from the queue without updating the head pointer.)
*/
ssize_t
-VMCIQPair_Peek(VMCIQPair *qpair, // IN:
- void *buf, // IN:
- size_t bufSize, // IN:
- int bufType) // IN:
+VMCIQPair_Peek(VMCIQPair *qpair, // IN
+ void *buf, // IN
+ size_t bufSize, // IN
+ int bufType) // IN
{
ssize_t result;
/*
*-----------------------------------------------------------------------------
*
- * VMCIQPair_EnqueueV() --
+ * VMCIQPair_EnqueueV --
*
* This is the client interface for enqueueing data into the queue.
*
*/
ssize_t
-VMCIQPair_EnqueueV(VMCIQPair *qpair, // IN:
- void *iov, // IN:
- size_t iovSize, // IN:
- int bufType) // IN:
+VMCIQPair_EnqueueV(VMCIQPair *qpair, // IN
+ void *iov, // IN
+ size_t iovSize, // IN
+ int bufType) // IN
{
int64 result;
/*
*-----------------------------------------------------------------------------
*
- * VMCIQPair_DequeueV() --
+ * VMCIQPair_DequeueV --
*
* This is the client interface for dequeueing data from the queue.
*
*/
ssize_t
-VMCIQPair_DequeueV(VMCIQPair *qpair, // IN:
- void *iov, // IN:
- size_t iovSize, // IN:
- int bufType) // IN:
+VMCIQPair_DequeueV(VMCIQPair *qpair, // IN
+ void *iov, // IN
+ size_t iovSize, // IN
+ int bufType) // IN
{
int64 result;
/*
*-----------------------------------------------------------------------------
*
- * VMCIQPair_PeekV() --
+ * VMCIQPair_PeekV --
*
* This is the client interface for peeking into a queue. (I.e.,
* copy data from the queue without updating the head pointer.)
*/
ssize_t
-VMCIQPair_PeekV(VMCIQPair *qpair, // IN:
- void *iov, // IN:
- size_t iovSize, // IN:
- int bufType) // IN:
+VMCIQPair_PeekV(VMCIQPair *qpair, // IN
+ void *iov, // IN
+ size_t iovSize, // IN
+ int bufType) // IN
{
int64 result;