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

FreeBSD Manual Pages

  
 
  

home | help
tt_thread_session_set(library call)	   tt_thread_session_set(library call)

NAME
       tt_thread_session_set  --  set  the  default session identifier for the
       current thread

SYNOPSIS
       #include	<Tt/tt_c.h>
       Tt_status tt_thread_session_set(
       const char *sessid);

DESCRIPTION
       The tt_thread_session_set function sets the default session  identifier
       for  the	currently active thread. The ToolTalk service uses the initial
       user session as the default session and supports	one session  per  pro-
       cid.  The  application  can  make  this call before it calls tt_open to
       specify which session it	wants to connect to in the active thread.

       To change to another opened session, the	application  must  use	either
       tt_thread_procid_set or tt_default_procid_set.

       To  join	 other	sessions, the procid must first	set the	new session as
       the default session, and	then initialize	and register with the ToolTalk
       service.	  The	calls	required  must	be  in	the  following	order:
       tt_thread_session_set or	tt_default_session_set and then	tt_open.

       The tt_open call	may create another ToolTalk procid, the	connection  to
       which  is identified by a procid.  Only one ToolTalk session per	procid
       is allowed. (However, multiple procids are allowed in a client.)

       There are no API	calls to determine the session to which	 a  procid  is
       connected.  If  it is important for the application to know the session
       to which	it is connected, it must make the following calls in the indi-
       cated order: tt_open and	then tt_thread_session.

ARGUMENTS
       sessid	 Specifies  a  pointer to the unique identifier	string for the
		 session that is to be the default  session  for  the  current
		 thread.

RETURN VALUE
       Upon  successful	completion, the	tt_thread_session_set function returns
       the status of the operation as one of the following Tt_status values:

       TT_OK	 The operation completed successfully.

       TT_ERR_NOMP
		 The ttsession process is not running and the ToolTalk service
		 cannot	start it.

       TT_ERR_PROCID
		 The  current default process identifier is out	of date	or in-
		 valid.

       TT_ERR_SESSION
		 The specified ToolTalk	session	is out of date or invalid.

       TT_ERR_UNIMP
		 The ToolTalk implementation does not support multithreading.

       TT_ERR_TOOLATE
		 The multithreading feature has	not been enabled.

APPLICATION USAGE
       Some ToolTalk API calls implicitly depend on the	current	 default  ses-
       sion. Setting the default session for the specific thread prevents race
       conditions caused by other threads changing the global default session.

SEE ALSO
       Tt/tt_c.h  -  Tttt_c(5),	 tt_default_procid(3),	tt_default_session(3),
       tt_feature_required(3), tt_thread_procid(3), tt_thread_session(3)

					   tt_thread_session_set(library call)

NAME | SYNOPSIS | DESCRIPTION | ARGUMENTS | 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_thread_session_set&sektion=3&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help