Main Page   Modules   Data Structures   File List   Data Fields   Globals   Related Pages  

gm_get.c File Reference

#include "gm_call_trace.h"
#include "gm_debug.h"
#include "gm_enable_get.h"
#include "gm_internal.h"
#include "gm_send_queue.h"

Functions

GM_ENTRY_POINT void gm_get (gm_port_t *p, gm_remote_ptr_t remote_buffer, void *local_buffer, gm_size_t len, enum gm_priority priority, unsigned int target_node_id, unsigned int target_port_id, gm_send_completion_callback_t callback, void *context)

Detailed Description

This file contains the GM API function gm_get().


Function Documentation

GM_ENTRY_POINT void gm_get gm_port_t *    p,
gm_remote_ptr_t    remote_buffer,
void *    local_buffer,
gm_size_t    len,
enum gm_priority    priority,
unsigned int    target_node_id,
unsigned int    target_port_id,
gm_send_completion_callback_t    callback,
void *    context
 

gm_get() performs an RDMA Read operation.

gm_get() transfers the len bytes at remote_buffer to target_port_id on target_node_id with priority priority and stores the data at the local virtual memory address local_buffer. Call callback(port,context,status) when the receive completes or fails, with status indicating the status of the receive.

Parameters:
p  (IN) The GM port on the destination GM node to which the communication is being received.
remote__buffer  (IN) Address of the remote buffer.
local_buffer  (OUT) Address of the local buffer.
len  (IN) The length in bytes of the buffer to be received.
priority  (IN) The priority of the data being received.
target_node_id  (IN) The GM node to which the data is being received.
target_port_id  (IN) The GM port on the destination GM node to which the message is being received.
callback  (IN) The function called when the receive is complete.
context  (IN) Pointer to an integer or to a structure that is passed to the callback function.
Author:
Glenn Brown
Version:
GM_API_VERSION (as defined in gm.h)


Generated on Mon Nov 3 15:39:25 2003 for GM by doxygen1.2.15