rapi_reserve parameters

Sid

This parameter is the session ID for the session initiated by a successful rapi_session() call.

Flags

No flags are currently defined for this call.

RHost

This parameter is used to define the interface address on which data will be received for multicast flows. It is useful for a multihomed host. If it is NULL or the host address is INADDR_ANY, the default interface will be chosen.

StyleId

This parameter specifies the reservation style ID (see Flowspec_list, FlowspecNo).

Style_Ext

This parameter must be NULL.

Rcvr_Policy

This parameter must be NULL.

FilterSpec_list, FilterSpecNo

The FilterSpec_list parameter is a pointer to an area containing a sequential vector of RAPI filter spec objects. The number of objects in this vector is specified in FilterSpecNo. If FilterSpecNo is 0, the FilterSpec_list parameter is ignored and can be NULL.

Flowspec_list, FlowspecNo

The Flowspec_list parameter is a pointer to an area containing a sequential vector of RAPI flow spec objects. The number of objects in this vector is specified in FlowspecNo. If FlowspecNo is 0, the Flowspec_list parameter is ignored and can be NULL.

If FlowspecNo is 0, the call will remove the current reservations for the specified session, and FilterSpec_list and Flowspec_list will be ignored. Otherwise, the parameters depend upon the style, as follows:

Wildcard Filter (WF): Use StyleId = RAPI_RSTYLE_WILDCARD. The Flowspec_list parameter can be NULL (to delete the reservation) or else point to a single flowspec. The FilterSpec_list parameter should be empty.
Fixed Filter (FF): Use StyleId = RAPI_RSTYLE_FIXED. FilterSpecNo must equal FlowspecNo. Entries in Flowspec_list and FilterSpec_list parameters will correspond in pairs.
Shared Explicit (SE): Use StyleId = RAPI_RSTYLE_SE. The Flowspec_list parameter should point to a single flowspec. The FilterSpec_list parameter can point to a list of any length.