tt_message_send_on_exit - set up a message to send upon unexpected exit
#include <Tt/tt_c.h> Tt_status tt_message_send_on_exit(Tt_message m);
ToolTalk Functions tt_message_send_on_exit(3)
NAME
tt_message_send_on_exit - set up a message to send upon unexpected exit
SYNOPSIS
#include <Tt/tt_c.h>
Tt_status tt_message_send_on_exit(Tt_message m);
DESCRIPTION
The tt_message_send_on_exit() function requests that the ToolTalk ser-
vice send this message if the process exits unexpectedly. The message
is sent to the ToolTalk service, which queues the message internally
until either of two events occur:
1. The procid that sent the tt_message_send_on_exit() message to
the ToolTalk service calls tt_close(3). In this case, the
queued message is deleted.
2. The connection between the ttsession(1) server and the process
that sent the tt_message_send_on_exit() message to the ToolTalk
service is broken; for example, if the application has crashed.
In this case, the ToolTalk service matches the queued message to its
patterns and delivers it in the same manner as if the process had sent
the message normally before exiting.
If a process sends a normal termination message but exits without call-
ing tt_close(3), both the normal termination message and the on_exit
message are delivered.
The m argument is the opaque handle for the message involved in this
operation.
RETURN VALUE
Upon successful completion, the tt_message_send_on_exit() function
returns the status of the operation as one of the following Tt_status
values:
TT_OK The operation completed successfully.
TT_ERR_ADDRESS
The specified Tt_address is invalid.
TT_ERR_CLASS
The specified Tt_class is invalid.
TT_ERR_FILE
The specified file does not exist or it is inaccessible.
TT_ERR_NOMP
The ttsession(1) process is not running and the ToolTalk
service cannot restart it.
TT_ERR_OBJID
The objid passed to the ToolTalk service does not reference
an existing object spec.
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+------------------+
|Availability | library/tooltalk |
+---------------+------------------+
|Stability | Committed |
+---------------+------------------+
SEE ALSO
tt_c(5), tt_close(3).
ToolTalk 1.3 1 March 1996
tt_message_send_on_exit(3)