PMREAD(3)

PM Programmer's Manual

PMREAD(3)

NAME

pmRead - copy data from a remote region to a local region

SYNOPSIS

int pmRead(pmContext *pmc, int rmt_node, pmAddrHandle rmt_hndl, pmAddrHandle local_hndl, size_t len);

ARGUMENTS

pmContext *	pmc	IN	pmContext object
int	rmt_node	IN	Remote node number
pmAddrHandle	rmt_hndl	IN	Remote address handle
pmAddrHandle	local_hndl	IN	Local address handle
size_t	len	IN	Bytes to read

IMPLEMENTATION LEVEL

OPTIONAL (REMOTE_READ)

DESCRIPTION

pmRead() copies data from a remote region to a local region.
Both regions must be locked by pmMLock().
Local and remote address handles are (locked address handle + offset).

NOTES

Alignment of rmt_hndl, local_hndl and len is system dependent.
Minimum value of len is system dependent.

RETURN VALUES

PM_SUCCESS	Success
EINVAL	Invalid remote node number
	Invalid length
ENOBUFS	No enough resources to read
ENOSYS	Operation not supported

---