rapi_dispatch(3) [osf1 man page]

rapi_dispatch(3)					     Library Functions Manual						  rapi_dispatch(3)

NAME

       rapi_dispatch - Dispatch an Resource ReSerVation Protocol (RSVP) API event

LIBRARY

       RAPI Library (librsvp.so, librsvp.a)

SYNOPSIS

       #include <rapi.h>

       int rapi_dispatch();

DESCRIPTION

       An application calls the rapi_dispatch() routine whenever a read event is signaled on the file descriptor returned by the rapi_getfd() rou-
       tine.  You can call the rapi_dispatch() routine at any time, but it has no effect unless there is a pending event associated with the  UNIX
       pipe.

NOTES

       When  an  application calls this routine, the application might receive one or more upcalls from any of the open API sessions known to this
       instance of the library.

RETURN VALUES

       Upon successful completion, the rapi_dispatch() routine returns a value of 0 (zero). Upon failure, it returns an RAPI error code.

RELATED INFORMATION

       Functions:  rapi_event_rtn_t(3),  rapi_getfd(3),  rapi_release(3),  rapi_reserve(3),  rapi_sender(3),  rapi_session(3),	 rapi_strerror(3),
       rapi_version(3).

       Network: RSVP(7).  delim off

																  rapi_dispatch(3)

rapi_getfd(3)						     Library Functions Manual						     rapi_getfd(3)

NAME

       rapi_getfd - Get the file descriptor for the Resource ReSerVation Protocol (RSVP) daemon's socket

LIBRARY

       RAPI Library (librsvp.so, librsvp.a)

SYNOPSIS

       #include <rapi.h>

       int rapi_getfd(	    rapi_sid_t Sid);

PARAMETERS

       Specifies the session handle that was returned by a successful call to the rapi_session routine.

DESCRIPTION

       The  rapi_getfd()  routine obtains the file descriptor associated with the UNIX socket connected to the RSVP daemon, rsvpd.  An application
       typically calls this routine after a call to the rapi_session() routine has completed successfully and before a call  to  the  rapi_release
       routine.  When a socket read event is signaled on this file descriptor, the application should call the rapi_dispatch() routine.

       A call to the rapi_getfd() routine for different RAPI sessions might return the same file descriptor.

RETURN VALUES

       Upon  successful  completion, the rapi_getfd() routine returns the file descriptor. If the session handle is illegal or undefined, the rou-
       tine returns a value of -1.

RELATED INFORMATION

       Functions: rapi_dispatch(3), rapi_event_rtn_t(3),  rapi_release(3),  rapi_reserve(3),  rapi_sender(3),  rapi_session(3),  rapi_strerror(3),
       rapi_version(3).

       Network: RSVP(7).  delim off

																     rapi_getfd(3)