PtAppSetFdMode()

Change the mode that's of interest to an FD handler

Synopsis:

int PtAppSetFdMode( PtAppContext_t app,
                    int fd,
                    unsigned mode );

Description:

This function changes the mode that's of intereset to the handler for the given file descriptor, fd.

The app argument is the address of the application context, a structure that manages all the data associated with this application. For Photon 1.1x, this must be specified as NULL, so that the default context is used.

The mode argument defines what kind of conditions the application is interested in:

Pt_FD_READ: Data available for reading.
Pt_FD_WRITE: Buffer space available for writing.
Pt_FD_OBAND: Out-of-band data available.

These values correspond to conditions defined for the ionotify() or select() functions. You can OR the values together.

Returns:

0: Success.
-1: An error occurred; errno is set.

Errors:

EINVAL: The fd or mode argument is invalid.
ESRCH: There's no handler registered for the file descriptor.

Classification:

Photon

Safety:
Interrupt handler	No
Signal handler	No
Thread	No