Provided by: atfs-dev_1.4pl6-11_amd64 bug

NAME

       stTmpFile,   stRegisterFile,   stUnRegisterFile,  stRmRegisteredFiles  -  temporary  files
       handling

SYNOPSIS

       #include <config.h>
       #include <sttk.h>

       char*stTmpFile (char *path);

       voidstRegisterFile (char *fileName);

       voidstUnRegisterFile (char *fileName);

       voidstRmRegisteredFiles (void);

DESCRIPTION

       stTmpFile creates a unique filename for a temporary file, registers it (see stRegisterFile
       below), and returns it.  The return value resides in static memory and will be overwritten
       on the next call of stTmpFile. The temporary file is located in the /tmp directory.

       stRegisterFile adds the given fileName to an internal static list of file names. This list
       helps to keep track of the names of all temporary files to be deleted until the end of the
       program execution. On abnormal program termination (signal), the termination  handler  may
       call stRmRegisteredFiles to delete all registered files. This avoids bogus temporary files
       to survive abnormal program termination.

       stUnRegisterFile removes fileName from the internal list  of  file  names.  It  should  be
       called when the corresponding file was removed due to the regular control flow.

       stRmRegisteredFiles  removes  all files named in the internal list set up by stTmpFile and
       stRegisterFile  and  clears  the  list.  Bogus  entries  in  the  list  (names  without  a
       correponding  file) are ignored.  Invoking stCatchSigs(3) causes stRmRegisteredFiles to be
       called on occurence  of  the  signals  SIGQUIT,  SIGFPE,  SIGBUS,  SIGSEGV,  and  SIGTERM.
       stCleanup(3) also calls stRmRegisteredFiles.

SEE ALSO

       stCatchSigs(3), stCleanup(3)

LIMITS

       The maximum number of temporary files to be registered is 16.