Index for Section 4

Alphabetical listing for S

Bottom of page

Set_Environment(4)
CDE
NAME
  Set_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 environment
  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);

WARNINGS
  Set_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 ALSO
  tt_message_arg_add(3), tt_message_send(3), ttdt_session_join(3);
  Get_Environment request

Index for Section 4

Alphabetical listing for S

Top of page