/********************************************************************* * Copyright 2010, UCAR/Unidata * See netcdf/COPYRIGHT file for copying and redistribution conditions. * $Header$ *********************************************************************/ #include "config.h" #ifdef _MSC_VER #include #endif #include #include #include #include #ifdef HAVE_FCNTL_H #include #endif #include "nclog.h" #define PREFIXLEN 8 #define MAXTAGS 256 #define NCTAGDFALT "Log"; static int nclogginginitialized = 0; static int nclogging = 0; static int ncsystemfile = 0; /* 1 => we are logging to file we did not open */ static char* nclogfile = NULL; static FILE* nclogstream = NULL; static int nctagsize = 0; static char** nctagset = NULL; static char* nctagdfalt = NULL; static char* nctagsetdfalt[] = {"Warning","Error","Note","Debug"}; static char* nctagname(int tag); /*!\defgroup NClog NClog Management @{*/ /*!\internal */ void ncloginit(void) { const char* file; if(nclogginginitialized) return; nclogginginitialized = 1; ncsetlogging(0); nclogfile = NULL; nclogstream = NULL; /* Use environment variables to preset nclogging state*/ /* I hope this is portable*/ file = getenv(NCENVFLAG); if(file != NULL && strlen(file) > 0) { if(nclogopen(file)) { ncsetlogging(1); } } nctagdfalt = NCTAGDFALT; nctagset = nctagsetdfalt; } /*! Enable/Disable logging. \param[in] tf If 1, then turn on logging, if 0, then turn off logging. \return The previous value of the logging flag. */ int ncsetlogging(int tf) { int was; if(!nclogginginitialized) ncloginit(); was = nclogging; nclogging = tf; return was; } /*! Specify a file into which to place logging output. \param[in] file The name of the file into which to place logging output. If the file has the value NULL, then send logging output to stderr. \return zero if the open failed, one otherwise. */ int nclogopen(const char* file) { if(!nclogginginitialized) ncloginit(); nclogclose(); if(file == NULL || strlen(file) == 0) { /* use stderr*/ nclogstream = stderr; nclogfile = NULL; ncsystemfile = 1; } else if(strcmp(file,"stdout") == 0) { /* use stdout*/ nclogstream = stdout; nclogfile = NULL; ncsystemfile = 1; } else if(strcmp(file,"stderr") == 0) { /* use stderr*/ nclogstream = stderr; nclogfile = NULL; ncsystemfile = 1; } else { int fd; nclogfile = strdup(file); nclogstream = NULL; /* We need to deal with this file carefully to avoid unauthorized access*/ fd = open(nclogfile,O_WRONLY|O_APPEND|O_CREAT,0600); if(fd >= 0) { nclogstream = fdopen(fd,"a"); } else { free(nclogfile); nclogfile = NULL; nclogstream = NULL; ncsetlogging(0); return 0; } ncsystemfile = 0; } return 1; } void nclogclose(void) { if(!nclogginginitialized) ncloginit(); if(nclogstream != NULL && !ncsystemfile) { fclose(nclogstream); } if(nclogfile != NULL) free(nclogfile); nclogstream = NULL; nclogfile = NULL; ncsystemfile = 0; } /*! Send logging messages. This uses a variable number of arguments and operates like the stdio printf function. \param[in] tag Indicate the kind of this log message. \param[in] format Format specification as with printf. */ void nclog(int tag, const char* fmt, ...) { va_list args; char* prefix; if(!nclogginginitialized) ncloginit(); if(!nclogging || nclogstream == NULL) return; prefix = nctagname(tag); fprintf(nclogstream,"%s:",prefix); if(fmt != NULL) { va_start(args, fmt); vfprintf(nclogstream, fmt, args); va_end( args ); } fprintf(nclogstream, "\n" ); fflush(nclogstream); } void nclogtext(int tag, const char* text) { nclogtextn(tag,text,strlen(text)); } /*! Send arbitrarily long text as a logging message. Each line will be sent using nclog with the specified tag. \param[in] tag Indicate the kind of this log message. \param[in] text Arbitrary text to send as a logging message. */ void nclogtextn(int tag, const char* text, size_t count) { if(!nclogging || nclogstream == NULL) return; fwrite(text,1,count,nclogstream); fflush(nclogstream); } /* The tagset is null terminated */ void nclogsettags(char** tagset, char* dfalt) { nctagdfalt = dfalt; if(tagset == NULL) { nctagsize = 0; } else { int i; /* Find end of the tagset */ for(i=0;i= nctagsize) { return nctagdfalt; } else { return nctagset[tag]; } } /**@}*/