tt_open(3)

tt_open(3)	       C LIBRARY FUNCTIONS	       tt_open(3)

NAME
     tt_open - return the process identifier for the calling pro-
     cess

SYNOPSIS
     #include <Tt/tt_c.h>

     char *tt_open(void);

DESCRIPTION
     The tt_open() function returns the	 process  identifier  for
     the calling process.

RETURN VALUE
     The tt_open() function also  sets	this  identifier  as  the
     default  procid for the process.  The tt_open(3) function is
     typically the first ToolTalk function called by a process.

     The application must call tt_open(3) before other tt_  calls
     are    made.     However,	  there	  are	two   exceptions:
     tt_default_session_set(3) and tt_X_session(3) can be  called
     before tt_open().

     A process can call	tt_open() more than once to obtain multi-
     ple procids.  To open another session, the	process	must make
     the following calls in the	order specified:

	  tt_default_session_set(3)
	  tt_open()

RETURN VALUE
     Upon successful completion, the tt_open()	function  returns
     the  character  value  that uniquely identifies the process.
     The application can use tt_ptr_error(3) to	 extract  one  of
     the following Tt_status values from the returned pointer:

	TT_OK	The operation completed	successfully.

	TT_ERR_NOMP
		The ttsession(1) process is not	running	 and  the
		ToolTalk service cannot	restart	it.

APPLICATION USAGE
     The application should  use  tt_free(3)  to  free	any  data
     stored in the address returned by the ToolTalk API.

     Each procid has its own associated	file descriptor, and  can
     join  another  session.   To  switch  to another procid, the
     application should	call tt_default_procid_set().

SEE ALSO
     Tttt_c(5),	tt_fd(3), tt_default_procid(3),
     tt_default_procid_set(3), tt_default_session(3),

Unix System LaboratorLast change: 11 May 1994			1

tt_open(3)	       C LIBRARY FUNCTIONS	       tt_open(3)

     tt_default_session_set(3),	tt_ptr_error(3), tt_free(3).

Unix System LaboratorLast change: 11 May 1994			2