NAME

rapi_getfd - get file descriptor

SYNOPSIS

#include <rapi.h>

int rapi_getfd(rapi_sid_t Sid)

DESCRIPTION

After a rapi_session() call has completed successfully and before rapi_release() has been called, the application may call rapi_getfd() to obtain the file descriptor associated with that session. When a read event is signalled on this file descriptor, the application should call rapi_dispatch().

Note:

Calls to rapi_getfd() for different RAPI sessions may return the same file descriptor.

PARAMETERS

Sid

This parameter must be a session ID returned by a successful rapi_session() call.

RESULT

If Sid is illegal or undefined, this call returns -1; otherwise, it returns the file descriptor.