CDE

NAME

Signal − send a (POSIX-style) signal to a tool

SYNOPSIS

Signal(in string theSignal);

DESCRIPTION

The Signal request asks the handling procid to send itself the indicated POSIX signal. 

The theSignal argument is the signal to send. 

APPLICATION USAGE

The ttdt_session_join(3), function can be used to register for, and transparently process, the Signal request. 

EXAMPLES

The Signal request can be sent as in the following example:

Tt_message msg = tttk_message_create(0, TT_REQUEST, TT_SESSION,
the_recipient_procid, TTDT_SIGNAL,
my_callback);
tt_message_arg_add(msg, TT_IN, Tttk_string, "SIGHUP");
tt_message_send(msg);

WARNINGS

Signal can also be sent as a multicast notice, as an edict to all tools in the scope of the message.  The consequences of doing so can be severe and unexpected. 

SEE ALSO

sigaction(2) tt_message_arg_add(3), tt_message_send(3), ttdt_session_join(3).