PtAppSetFdMode()

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

Synopsis:

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

Library:

ph

Description:

This function changes the mode that's of interest to the handler for the given file descriptor, fd. You'll use an FD function when using pipes in a Photon application.

The app argument is the address of the application context, a structure that manages all the data associated with this application. 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

See also:

PtAppAddFd(), PtAppAddFdPri(), PtAppRemoveFd()

"Other I/O mechanisms" in the Interprocess Communication chapter of the Photon Programmer's Guide