PMRECEIVE(3)

PM Programmer's Manual

PMRECEIVE(3)

NAME

pmReceive - return an address and length of a message

SYNOPSIS

int pmReceive(pmContext *pmc, caddr_t *bufp, size_t *lenp);

ARGUMENTS

pmContext *	pmc	IN	pmContext object
caddr_t *	bufp	OUT	Address of message
size_t *	lenp	OUT	Length of message

IMPLEMENTATION LEVEL

BASE

DESCRIPTION

pmReceive() polls for message arrival and returns an address and a length of the message if available. If pmc is of type PM_COMPOSITE and a message is received, the context is locked until pmReleaseReceiveBuffer() is called.

NOTES

Returned buffer address can be cast to any type.

RETURN VALUES

PM_SUCCESS	Message is received
ENOBUFS	No message is received
EIO	Data link level error (CRC error for Myrinet)
EPIPE	Network reset occurred for Myrinet
EBUSY	Context is already locked

---

CREDIT

This document is a part of the SCore cluster system software developed at PC Cluster Consortium, Japan. Copyright (C) 2003 PC Cluster Consortium.