vipcreateptag.c File Reference

#include "vipl_priv.h"

Go to the source code of this file.

Functions
VIP_ENTRY_POINT VIP_RETURN	VipCreatePtag (VIP_NIC_HANDLE NicHandle, VIP_PROTECTION_HANDLE *ProtectionTag)

---

Detailed Description

The VI-GM function VipCreatePtag implementation.

Definition in file vipcreateptag.c.

---

Function Documentation

VIP_ENTRY_POINT VIP_RETURN VipCreatePtag (  VIP_NIC_HANDLE  NicHandle, VIP_PROTECTION_HANDLE *  ProtectionTag )

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. Return values: 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. Parameters: NicHandle  (IN) The NIC handle associated with the protection tag. ProtectionTag  (OUT) The new protection tag. See also: VipDestroyPtag VIP_PTAG Author: Patrick Geoffray Version: 1.0 Definition at line 47 of file vipcreateptag.c. References VIP_PTAG::id, vip_allocate_handle(), VIP_DEBUG, VIP_DEBUG_LABEL, VIP_ERROR_RESOURCE, VIP_INVALID_NIC_HANDLE, VIP_INVALID_PARAMETER, VIP_MUTEX_LOCK, VIP_MUTEX_UNLOCK, and VIP_SUCCESS.