Index Click this button to go to the index for this section.


tt_fd(3)

CDE

NAME

tt_fd - return a file descriptor

SYNOPSIS

#include <Tt/tt_c.h> int tt_fd(void);

DESCRIPTION

The tt_fd function returns a file descriptor. The returned file descriptor alerts the process that a message has arrived for the default procid in the default session. File descriptors are either active or inactive. When the file descriptor becomes active, the process must call tt_message_receive3 to receive the message.

RETURN VALUE

Upon successful completion, the tt_fd function returns the file descriptor for the current procid. The application can use tt_int_error3 to extract one of the following Tt_status values from the returned integer: The operation completed successfully. The ttsession1 process is not running and the ToolTalk service cannot restart it. The current default process identifier is out of date or invalid. The specified ToolTalk session is out of date or invalid.

APPLICATION USAGE

The application must have a separate file descriptor for each procid. To get an associated file descriptor, the application should use tt_fd each time it calls tt_open3.

SEE ALSO

Tt/tt_c.h5, tt_open3, tt_int_error3, tt_message_receive3.