Main Page | Modules | Directories | File List | Globals | Related Pages

gm_directed_send.c File Reference

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

Functions

GM_ENTRY_POINT void gm_directed_send_with_callback (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_directed_send_with_callback().

Function Documentation

GM_ENTRY_POINT void gm_directed_send_with_callback 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_directed_send_with_callback() 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 Sat May 20 19:20:41 2006 for GM by  doxygen 1.4.4