vipquerymem.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
VipQueryMem (VIP_NIC_HANDLE NicHandle,
             VIP_PVOID Address,
             VIP_MEM_HANDLE MemHandle, VIP_MEM_ATTRIBUTES * MemAttribs)
{
  VIP_NIC *vip_nic_ptr;
  VIP_MEM *vip_mem_ptr;
  VIP_DEBUG_LABEL (("VipQueryMem"));


  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;
    }

  /* 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 consistency */
  if (vip_mem_ptr->address != Address)
    {
      VIP_DEBUG (("Inconsistent virtual address"));
      VIP_MUTEX_UNLOCK (&(vip_nic_ptr->lock));
      return VIP_INVALID_PARAMETER;
    }

  MemAttribs->Ptag = vip_mem_ptr->vip_ptag_ptr;
  MemAttribs->EnableRdmaWrite = vip_mem_ptr->rdma_write;
  MemAttribs->EnableRdmaRead = ((VI_GM_ENABLE_RDMAREAD == VIP_TRUE)
                                ? VIP_TRUE : VIP_FALSE);

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