rapi_sender()

The rapi_sender() call provides information required to become a sender.

Syntax

       #include <rsvprapi.h>

int  rapi_sender(
       rapi_sid_t          sid,
       int                 flags,
       struct sockaddr    *plocal,
       rapi_filter_t      *pfilter,
       rapi_tspec_t       *ptraffic,
       rapi_adspec_t      *padvert,
       rapi_policy_t      *ppolicy,
       int                 ttl);

Parameters

sid

Session identifier.

No flags are supported; specify 0.

Local host (src addr, port). This argument points to a structure that specifies the interface that will be used to send the data. For this implementation, this should be a sockaddr_in structure. If the IP source address is INADDR_ANY, the default IP address of the host will be used. If plocal is NULL, the program is withdrawing its registration as a sender for the session and the other arguments will be ignored.

Sender template. This parameter is not supported. Specify NULL.

Sender tspec. This parameter is a pointer to the traffic specification for the data flow that this sender will send.

Sender adspec. This parameter is not supported; specify NULL.

Sender policy data. This parameter is not supported; specify NULL.

Time to live of the multicast data. If sending data to a multicast group, specify the TTL used to send to that group, as specified with setsockopt() option IP_MULTICAST_TTL.

Description

The rapi_sender() call establishes the program as a sender for the specified session. After checking the arguments for validity, this call sends an appropriate message to the destination.

After successfully calling rapi_sender(), the application callback function may receive RAPI_RESV_EVENT or RAPI_PATH_ERROR events.

Return Values and Descriptions

RAPI_ERR_BADSID

The session identifier is not valid, or the session is not open.

An argument is not valid.

The RSVP daemon in not running.

No traffic spec (tspec) was specified.

The call succeeded.

Related Calls

rapi_reserve()