PMGETSENDBUFFER(3)

PM Programmer's Manual

PMGETSENDBUFFER(3)

NAME

pmGetSendBuffer - allocate a buffer to send a message

SYNOPSIS

int pmGetSendBuffer(pmContext *pmc, int dest, caddr_t *bufp, size_t len);

ARGUMENTS

pmContext *	pmc	IN	pmContext object
int	dest	IN	Destination node number
caddr_t *	bufp	OUT	Buffer address
size_t	len	IN	Buffer length

IMPLEMENTATION LEVEL

BASE

DESCRIPTION

pmGetSendBuffer() allocates a buffer to send a len bytes of a message, if available. If pmc is of type PM_COMPOSITE and a buffer is allocated, the context is locked until pmSend() is called.

NOTES

Returned buffer addresses can be cast to any type.
Minimum value of len is 1.

RETURN VALUES

PM_SUCCESS	Success
ENOBUFS	No buffer is available
EINVAL	Invalid destination node number
	Invalid length (len < minimum length or len > MTU)

---