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.