PMMLOCK(3)

PM Programmer's Manual

PMMLOCK(3)

NAME

pmMLock - pin down a specified region and return a locked address handle

SYNOPSIS

int pmMLock(pmContext *pmc, int rmt_node, caddr_t addr, size_t len, pmAddrHandle *hndlp);

ARGUMENTS

pmContext *	pmc	IN	pmContext object
int	rmt_node	IN	Remote node number
caddr_t	addr	IN	Start address of region to be locked
size_t	len	IN	Length of region
pmAddrHandle *	hndlp	OUT	Locked address handle

IMPLEMENTATION LEVEL

OPTIONAL (REMOTE_WRITE/REMOTE_READ)

DESCRIPTION

pmMLock() pins down a specified region and returns a locked address handle.

NOTES

For a composite context rmt_node can be specified as PM_NODE_ANY to pin-down a region for all remote nodes.
Alignment of addr and len is system dependent.
Minimum value of len is system dependent.

RETURN VALUES

PM_SUCCESS	Success
EINVAL	Invalid remote node number
	Invalid length
ENOSPC	No enough resources to lock a region
ENOSYS	Operation not supported

---