#include "gm_internal.h"
#include "_gm_modsend.h"
Functions | |
GM_ENTRY_POINT void | gm_drop_sends (struct gm_port *port, unsigned int priority, unsigned int target_node_id, unsigned int target_port_id, gm_send_completion_callback_t callback, void *context) |
This file contains the GM API function gm_drop_sends().
|
gm_drop_sends() drops all enqueued sends for port of priority priority destined for target_port_id of target_node_id to be dropped, and reenable packet transmission on that connection. This function should only be called after an error is reported to a send completion callback routine. The first four parameters must match those of the failed send. It should be called only once per reported error. This function requires a send token, which will be returned to the client in the callback function. The dropped sends will then be returned to the client with a status of GM_SEND_DROPPED. gm_drop_sends() and gm_resume_sending(), as most gm requests, require a send token, and the callback you give to them is just meant to return this token. These gm_requests always succeed (if called in a valid manner), so the callback will always be called with GM_SUCCESS (which here does not mean at all that something was sent successfully, just that the request has been taken into account, and the token used for that request was recycled).
|