Previous section.
Resource ReSerVation Protocol API (RAPI)
Copyright © 1998 The Open Group
Use with select() or poll()
When a system provides either
select()
or
poll()
(see the referenced XSH specification and the referenced XNS specification),
the RAPI implementation must provide two additional calls:
rapi_getfd()
and
rapi_dispatch().
The upcall routine is invoked indirectly (and synchronously) by
the application, using the following mechanism:
-
The application issues the RAPI library call
rapi_getfd()
to learn the file descriptor of the endpoint (for example,
socket) used by the API.
-
The application detects read events on this file descriptor,
either passing it directly in a select or poll call or passing it to
the notifier of another library (such as XLib, tk/tcl, RPC).
-
When a read event on the file descriptor is signaled, the
application should call
rapi_dispatch().
This causes the API to execute the upcall routine if appropriate.
The remainder of this Chapter presents the definitions for: