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

gm_put.c File Reference

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

Functions

GM_ENTRY_POINT void gm_put (gm_port_t *p, void *source_buffer, gm_remote_ptr_t target_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_put().


Function Documentation

GM_ENTRY_POINT void gm_put gm_port_t *    p,
void *    source_buffer,
gm_remote_ptr_t    target_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_put() transfers the len bytes at source_buffer to target_port_id on target_node_id with priority priority and stores the data at the remote virtual memory address target_buffer. Call callback(port,context,status) when the send completes or fails, with status indicating the status of the send. The order of the transfer is preserved relative to messages of the same priority sent using gm _send() or gm_send_to_peer().

Parameters:
p  (IN) The GM port on the source/sender GM node from which the communication is being sent.
source_buffer  (IN) Address of the send buffer.
target_buffer  (OUT) Address of the receive buffer.
len  (IN) The length in bytes of the buffer to be sent.
priority  (IN) The priority of the data being sent.
target_node_id  (IN) The GM node to which the data is being sent.
target_port_id  (IN) The GM port on the destination GM node to which the message is being sent.
callback  (IN) The function called when the send 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:26 2003 for GM by doxygen1.2.15