Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Thursday, June 13, 2019
 
 

tt_file_quit (3)

Name

tt_file_quit - register lack of interest in messages that involve a file

Synopsis

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

Description

tt_file_quit(3)               ToolTalk Functions               tt_file_quit(3)



NAME
       tt_file_quit  -  register  lack  of interest in messages that involve a
       file

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

DESCRIPTION
       The tt_file_quit() function  informs  the  ToolTalk  service  that  the
       process  is no longer interested in messages that involve the specified
       file.

       The ToolTalk service removes this file value from any currently  regis-
       tered patterns and sets the default file to NULL.

       The  filepath  argument is the name of the file in which the process is
       no longer interested.

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

          TT_OK   The operation completed successfully.

          TT_ERR_DBAVAIL
                  The  ToolTalk service could not access the ToolTalk database
                  needed for this operation.

          TT_ERR_DBEXIST
                  The ToolTalk service could not access the specified ToolTalk
                  database in the expected place.

          TT_ERR_PATH
                  The specified pathname included an unsearchable directory.

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_default_file(3).




ToolTalk 1.3                     1 March 1996                  tt_file_quit(3)