Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
tt_open(library	call)					 tt_open(library call)

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

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  multiple  procids.
       To  open	 another session, the process must make	the following calls in
       the order specified:

       tt_default_session_set
       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 ser-
		 vice 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 an-
       other session.  To switch to another  procid,  the  application	should
       call tt_default_procid_set.

SEE ALSO
       Tt/tt_c.h  - Tttt_c(5), tt_fd(3), tt_default_procid(3), tt_default_pro-
       cid_set(3),	tt_default_session(3),	    tt_default_session_set(3),
       tt_ptr_error(3),	tt_free(3).

							 tt_open(library call)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | RETURN VALUE | APPLICATION USAGE | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=tt_open&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help