PMGETMULTICASTBUFFER(3)

PM Programmer's Manual

PMGETMULTICASTBUFFER(3)

NAME

pmGetMulticastBuffer - allocate a buffer for multicasting to nodes

SYNOPSIS

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

ARGUMENTS

pmContext *	pmc	IN	pmContext object
int *	dest	IN	Destination node numbers
int	ndest	IN	Number of destination numbers
caddr_t *	bufp	OUT	Buffer address
size_t	len	IN	Buffer length

IMPLEMENTATION LEVEL

BASE

DESCRIPTION

pmGetMulticastBuffer() allocates a message buffer of len bytes for multicasting to nodes described in dest. 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)
EBUSY	Context is already locked
ENOSYS	Operation not supported

---

CREDIT

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