Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Thursday, June 13, 2019
 
 

tt_default_session_set (3)

Name

tt_default_session_set - set the current default session identifier

Synopsis

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

Description

tt_default_session_set(3)     ToolTalk Functions     tt_default_session_set(3)



NAME
       tt_default_session_set - set the current default session identifier

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

DESCRIPTION
       The  tt_default_session_set() function sets the current default session
       identifier.

       The ToolTalk service uses the initial user session as the default  ses-
       sion  and  supports  one  session per procid.  The application can make
       this call before it calls tt_open(3) to specify the session to which it
       wants to connect.

       The  sessid argument is a pointer to the unique identifier for the ses-
       sion in which the procid is interested.

RETURN VALUE
       Upon  successful  completion,  the  tt_default_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(1) process is not  running  and  the  ToolTalk
                  service cannot restart it.

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

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

APPLICATION USAGE
       To change to another opened  session,  the  application  must  use  the
       tt_default_procid_set() function.

       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_default_session_set()
            tt_open(3)

       The  tt_open(3)  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 to which session a particular  pro-
       cid  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 indicated order:

            tt_open(3)
            tt_default_session(3)

       The  application  can  then store the information by indexing it by the
       procid returned by the tt_open(3) call.


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_open(3), tt_default_procid(3), tt_default_session(3).




ToolTalk 1.3                     1 March 1996        tt_default_session_set(3)