Query: dtmsglogopenfile
OS: hpux
Section: 3
Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar
DtMsgLogOpenFile(library call) DtMsgLogOpenFile(library call)NAMEDtMsgLogOpenFile -- opens a log fileSYNOPSIS#include <Dt/MsgLog.h> FILE* DtMsgLogOpenFile( const char* type, char** filename_return);DESCRIPTIONThe DtMsgLogOpenFile function calls fopen to open a log file with type open mode. If fopen opens a log file successfully and returns a non- NULL filename_return, DtMsgLogOpenFile calls malloc to allocate space for filename_return. DtMsgLogOpenFile then copies the log file name to filename_return. The caller must use the free function to release the space allocated for filename_return, if it is not NULL. The caller must also close the file pointer returned by DtMsgLogOpenFile. Use caution in doing this because stderr may be returned. For a description of the algorithm used to determine the log file to open, see DtMsgLogMessage(3). Note that if a log file cannot be opened, filename_return will be set to NULL.ARGUMENTStype Specifies the file open flag. See fopen(3) for more information. filename_return Specifies the variable to receive the returned log file name.ENVIRONMENT VARIABLESNone.RESOURCESNone.ACTIONS/MESSAGES None.ERRORS/WARNINGS None.EXAMPLESThe following code fragment opens the log file, logs the log file name, closes the file, and frees the space allocated for the file name. char * log_file; FILE * fp = DtMsgLogOpenFile ("a+", &log_file); if (log_file) { DtMsgLogMessage (argv[0], DtMsgLogInformation, "The log file name is: %s", log_file); free (log_file); } if (fp && fp != stderr) fclose (fp);RETURN VALUEIf DtMsgLogMessage completes successfully, it returns a pointer to the opened log file. If it cannot open a log file, it returns stderr.FILESNone.SEE ALSODtMsgLogMessage(3), DtMsgLogSetHandler(3) DtMsgLogOpenFile(library call)
Related Man Pages |
---|
myisamlog(1) - linux |
freopen(3ucb) - opensolaris |
fopen(3ucb) - opensolaris |
sd_journal_stream_fd(3) - centos |
net::server::log::sys::syslog(3) - mojave |
Similar Topics in the Unix Linux Community |
---|
Mac OS X - open() and fopen() with French filename |
how to write stderr in a subroutine log file?.. |
help with sed |
Unable to open files in VI editor |
unable to open a .log(4MB) file in vi |