Set_Environment(4) Desktop Services Message Sets Set_Environment(4)NAMESet_Environment - set a tool's environment
SYNOPSIS
Set_Environment(in string variable,
in string value
[...]);
DESCRIPTION
The Set_Environment request replaces the value of the indicated envi‐
ronment variable(s).
The variable argument is the name of the environment variable to set.
The value argument is the value of the environment variable. If this
argument is unset (in other words, has a value of (char *)0), then the
variable should be removed from the environment. It is not an error
for the variable not to have existed in the first place.
APPLICATION USAGE
The ttdt_session_join(3), function can be used to register for, and
transparently process, the Set_Environment request.
EXAMPLES
The Set_Environment request can be sent as in the following example:
Tt_message msg = tttk_message_create(0, TT_REQUEST, TT_SESSION,
the_recipient_procid, TTDT_SET_ENVIRONMENT,
my_callback);
tt_message_arg_add(msg, TT_IN, Tttk_string, "PATH");
tt_message_arg_add(msg, TT_IN, Tttk_string, "/bin:/usr/ucb");
tt_message_send(msg);
WARNINGSSet_Environment 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 ALSOtt_message_arg_add(3), tt_message_send(3), ttdt_session_join(3);
Get_Environment request.
ToolTalk 1.3 1 March 1996 Set_Environment(4)