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

gm_datagram_send.c File Reference

#include "gm_call_trace.h"
#include "gm_debug.h"
#include "gm_enable_fast_small_send.h"
#include "gm_enable_trace.h"
#include "gm_internal.h"
#include "gm_send_queue.h"

Functions

GM_ENTRY_POINT void gm_datagram_send (gm_port_t *p, void *message, unsigned int size, gm_size_t len, unsigned int 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_datagram_send().


Function Documentation

GM_ENTRY_POINT void gm_datagram_send gm_port_t *    p,
void *    message,
unsigned int    size,
gm_size_t    len,
unsigned int    priority,
unsigned int    target_node_id,
unsigned int    target_port_id,
gm_send_completion_callback_t    callback,
void *    context
 

gm_datagram_send() queues message of length length to be sent unreliably to a buffer of size size at target_port_id on target_node_id. length must be no larger than GM_MTU. If any network error is encountered while sending the packet, the packet is silently and immediately dropped. After the packet has been DMA'ed from host memory, callback(port,context,status) is called inside a user invocation of gm_unknown(), reporting the status of the attempted send.

Parameters:
p  (IN) The GM port on the source/sender GM node from which the communication is being sent.
message  (IN) The pointer to the data to be communicated.
size  (IN) The size of the buffer.
len  (IN) The length in bytes of the array.
priority  (IN) The priority of the message being communicated.
target_node_id  (IN) The GM node to which the message 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:25 2003 for GM by doxygen1.2.15