vipsetmemattributes.c

Go to the documentation of this file.

/********************************************************
 * Myricom VI-GM  networking software and documentation *
 * Copyright (c) 2001 by Myricom, Inc.                  *
 * All rights reserved.                                 *
 * See the file `COPYING' for copyright notice.         *
 ********************************************************/

#include "vipl_priv.h"


VIP_ENTRY_POINT VIP_RETURN
VipSetMemAttributes (VIP_NIC_HANDLE NicHandle,
                     VIP_PVOID Address,
                     VIP_MEM_HANDLE MemHandle,
                     VIP_MEM_ATTRIBUTES * MemAttribs)
{
  VIP_MEM *vip_mem_ptr;
  VIP_NIC *vip_nic_ptr;
  VIP_PTAG *new_vip_ptag_ptr;
  VIP_DEBUG_LABEL (("VipSetMemAttributes"));

  if (Address == NULL)
    {
      VIP_DEBUG (("Address is null"));
      return VIP_INVALID_PARAMETER;
    }

  if ((MemHandle == 0) || (MemHandle > VI_GM_MAX_REGISTER_REGIONS))
    {
      VIP_DEBUG (("MemHandle is invalid"));
      return VIP_INVALID_PARAMETER;
    }

  if (MemAttribs == NULL)
    {
      VIP_DEBUG (("MemAttribs is null"));
      return VIP_INVALID_PARAMETER;
    }

  if (MemAttribs->EnableRdmaRead != VI_GM_ENABLE_RDMAREAD)
    {
      VIP_DEBUG (("Invalid EnableRdmaRead in MemAttribs"));
      return VIP_INVALID_RDMAREAD;
    }

  if ((MemAttribs->EnableRdmaWrite != VIP_TRUE)
      && (MemAttribs->EnableRdmaWrite != VIP_FALSE))
    {
      VIP_DEBUG (("Invalid EnableRdmaWrite in MemAttribs"));
      return VIP_INVALID_PARAMETER;
    }

  /* check nic handle */
  vip_nic_ptr = (VIP_NIC *) NicHandle;
  if (VIP_INVALID_NIC_HANDLE (vip_nic_ptr))
    {
      VIP_DEBUG (("Invalid NIC handle"));
      return VIP_INVALID_PARAMETER;
    }
  VIP_MUTEX_LOCK (&(vip_nic_ptr->lock));

  /* check regmem handle */
  vip_mem_ptr = (VIP_MEM *) (vip_nic_ptr->vip_mem_handle_ptrs[MemHandle]);
  if (VIP_INVALID_MEM_HANDLE (vip_mem_ptr))
    {
      VIP_DEBUG (("Invalid MEM handle"));
      VIP_MUTEX_UNLOCK (&(vip_nic_ptr->lock));
      return VIP_INVALID_PARAMETER;
    }

  /* check virtual address consistency */
  if (vip_mem_ptr->address != Address)
    {
      VIP_DEBUG (("Inconsistent virtual address"));
      VIP_MUTEX_UNLOCK (&(vip_nic_ptr->lock));
      return VIP_INVALID_PARAMETER;
    }

  /* check new ptag */
  new_vip_ptag_ptr = MemAttribs->Ptag;
  if (VIP_INVALID_PTAG_HANDLE (new_vip_ptag_ptr))
    {
      VIP_DEBUG (("Invalid new PTAG handle"));
      VIP_MUTEX_UNLOCK (&(vip_nic_ptr->lock));
      return VIP_INVALID_PTAG;
    }

  /* check new ptag's NIC */
  if (new_vip_ptag_ptr->handle.vip_nic_ptr != vip_nic_ptr)
    {
      VIP_DEBUG (("PTAG handle's NIC inconsistency"));
      VIP_MUTEX_UNLOCK (&(vip_nic_ptr->lock));
      return VIP_INVALID_PTAG;
    }

  /* update the ptag */
  if (vip_mem_ptr->vip_ptag_ptr != new_vip_ptag_ptr)
    {
      VIP_ASSERT (vip_mem_ptr->vip_ptag_ptr->handle.ref_count > 0);
      vip_mem_ptr->vip_ptag_ptr->handle.ref_count--;
      new_vip_ptag_ptr->handle.ref_count++;
    }

  vip_mem_ptr->vip_ptag_ptr = new_vip_ptag_ptr;
  vip_mem_ptr->rdma_write = MemAttribs->EnableRdmaWrite;

  VIP_DEBUG (("Success"));
  VIP_MUTEX_UNLOCK (&(vip_nic_ptr->lock));
  return VIP_SUCCESS;
}