The Virtual Interface Architecture
Providing guidance for both developers and users of large clustered systems, this book explains how VI provides a new interface between applications and switched interconnect hardware.
TABLE OF CONTENTS The Virtual Interface Architecture
Memory Protection and Registration
VipCreatePtag
Synopsis
VIP_RETURN VipCreatePtag( IN VIP_NIC_HANDLE NicHandle, OUT VIP_PROTECTION_HANDLE *Ptag )
Parameters
| NicHandle : | The NIC handle associated with the protection tag. |
| Ptag : | The new protection tag. |
Description
The VipCreatePtag function creates a new protection tag for the calling process. The protection tag is subsequently associated with VI endpoints via the VipCreateVi function, as well as memory regions via the VipRegisterMem function. A process may request multiple protection tags. For all memory references by the VI Provider, including Descriptors and message buffers, the protection tag of the VI instance, and the memory region, must match in order to pass the memory protection check.
The Protection Tag is an element in the VI attributes data structure and the Memory Region Attributes data structure. The protection tag of a memory region and/or a VI can be changed by changing their attributes.
Returns
VIP_SUCCESS The memory protection tag was successfully created.
VIP_ERROR_RESOURCE The operation failed due to insufficient resources.
VIP_INVALID_PARAMETER One of the parameters was invalid.
VipDestroyPtag
Synopsis
VIP_RETURN VipDestroyPtag( IN VIP_NIC_HANDLE NicHandle, IN VIP_PROTECTION_HANDLE Ptag )
Parameters
Copyright Intel Corporation 2002 under license agreement with Books24x7
