Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Thursday, June 13, 2019
 
 

tt_procid_session (3)

Name

tt_procid_session - identify the session in which the indicated procid was opened

Synopsis

#include <Tt/tt_c.h>
char *tt_procid_session ( char *procid );

Description

tt_procid_session(3)          ToolTalk Functions          tt_procid_session(3)



NAME
       tt_procid_session  - identify the session in which the indicated procid
       was opened

SYNOPSIS
       #include <Tt/tt_c.h>
       char *tt_procid_session ( char *procid );

DESCRIPTION
       The tt_procid_session() function retrieves the  session  in  which  the
       given procid was opened.

       The  procid  argument  is  a  pointer  to the unique identifier for the
       ToolTalk process in which the caller is interested.

RETURN VALUE
       Upon successful completion, the  tt_procid_session()  function  returns
       the  pointer to a character string that uniquely identifies the session
       which was the default session at  the  time  the  procid  argument  was
       returned  by a tt_open(3) or ttdt_open(3) call. 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
       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_ptr_error(3), tt_free(3)





ToolTalk 1.3                     1 March 1996             tt_procid_session(3)