Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Thursday, June 13, 2019
 
 

tt_thread_session (3)

Name

tt_thread_session - retrieve the default session identifier for the currently active thread

Synopsis

#include <Tt/tt_c.h>
char *tt_thread_session ( void );

Description

tt_thread_session(3)          ToolTalk Functions          tt_thread_session(3)



NAME
       tt_thread_session  -  retrieve  the  default session identifier for the
       currently active thread

SYNOPSIS
       #include <Tt/tt_c.h>
       char *tt_thread_session ( void );

DESCRIPTION
       The tt_thread_session() function retrieves the default session  identi-
       fier for the currently active thread.

       If  there  is  no  default session set for the currently-active thread,
       then the process default session identifier is returned.

RETURN VALUE
       Upon successful completion, the  tt_thread_session()  function  returns
       the  pointer  to  the unique identifier for the active thread's current
       default session. If the pointer is NULL, no default session is set. 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.

       TT_ERR_PROCID
               The  current  default  process  identifier  is  out  of date or
               invalid.

APPLICATION USAGE
       A session can have more than one session identifier.  This  means  that
       the   application cannot compare the result of tt_thread_session() with
       the result of tt_message_session(3) to verify that the message was sent
       in the default session.

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


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | library/tooltalk |
       +---------------+------------------+
       |Stability      | Committed        |
       +---------------+------------------+
SEE ALSO
       tt_c(5), tt_prt_error(3), tt_free(3)




ToolTalk 1.3                     1 March 1996             tt_thread_session(3)