]> ncurses.scripts.mit.edu Git - ncurses.git/blobdiff - ncurses/trace/lib_trace.c
ncurses 6.2 - patch 20210807
[ncurses.git] / ncurses / trace / lib_trace.c
index 7aefe9dc1c91f599791c08944d919800ea86122b..9acbd4716575116e833e3ff54fa9039ad392aee0 100644 (file)
@@ -1,5 +1,6 @@
 /****************************************************************************
- * Copyright (c) 1998-2010,2011 Free Software Foundation, Inc.              *
+ * Copyright 2018-2020,2021 Thomas E. Dickey                                *
+ * Copyright 1998-2016,2017 Free Software Foundation, Inc.                  *
  *                                                                          *
  * Permission is hereby granted, free of charge, to any person obtaining a  *
  * copy of this software and associated documentation files (the            *
@@ -36,7 +37,7 @@
 /*
  *     lib_trace.c - Tracing/Debugging routines
  *
- * The _tracef() function is originally from pcurses (by Pavel Curtis) in 1982. 
+ * The _tracef() function is originally from pcurses (by Pavel Curtis) in 1982.
  * pcurses allowed one to enable/disable tracing using traceon() and traceoff()
  * functions.  ncurses provides a trace() function which allows one to
  * selectively enable or disable several tracing features.
@@ -47,7 +48,7 @@
 
 #include <ctype.h>
 
-MODULE_ID("$Id: lib_trace.c,v 1.78 2011/12/17 18:41:48 tom Exp $")
+MODULE_ID("$Id: lib_trace.c,v 1.99 2021/06/26 20:44:59 tom Exp $")
 
 NCURSES_EXPORT_VAR(unsigned) _nc_tracing = 0; /* always define this */
 
@@ -85,60 +86,84 @@ NCURSES_EXPORT_VAR(const char *) _nc_tputs_trace = "";
 NCURSES_EXPORT_VAR(long) _nc_outchars = 0;
 #endif
 
-#define TraceFP                _nc_globals.trace_fp
-#define TracePath      _nc_globals.trace_fname
-#define TraceLevel     _nc_globals.trace_level
+#define MyFP           _nc_globals.trace_fp
+#define MyFD           _nc_globals.trace_fd
+#define MyInit         _nc_globals.trace_opened
+#define MyPath         _nc_globals.trace_fname
+#define MyLevel                _nc_globals.trace_level
+#define MyNested       _nc_globals.nested_tracef
+#endif /* TRACE */
 
-NCURSES_EXPORT(void)
-trace(const unsigned int tracelevel)
+NCURSES_EXPORT(unsigned)
+curses_trace(unsigned tracelevel)
 {
-    if ((TraceFP == 0) && tracelevel) {
-       const char *mode = _nc_globals.init_trace ? "ab" : "wb";
-
-       if (TracePath[0] == '\0') {
-           size_t size = sizeof(TracePath) - 12;
-           if (getcwd(TracePath, size) == 0) {
-               perror("curses: Can't get working directory");
-               exit(EXIT_FAILURE);
+    unsigned result;
+#if defined(TRACE)
+    result = _nc_tracing;
+    if ((MyFP == 0) && tracelevel) {
+       MyInit = TRUE;
+       if (MyFD >= 0) {
+           MyFP = fdopen(MyFD, BIN_W);
+       } else {
+           if (MyPath[0] == '\0') {
+               size_t size = sizeof(MyPath) - 12;
+               if (getcwd(MyPath, size) == 0) {
+                   perror("curses: Can't get working directory");
+                   exit(EXIT_FAILURE);
+               }
+               MyPath[size] = '\0';
+               assert(strlen(MyPath) <= size);
+               _nc_STRCAT(MyPath, "/trace", sizeof(MyPath));
+               if (_nc_is_dir_path(MyPath)) {
+                   _nc_STRCAT(MyPath, ".log", sizeof(MyPath));
+               }
            }
-           TracePath[size] = '\0';
-           assert(strlen(TracePath) <= size);
-           strcat(TracePath, "/trace");
-           if (_nc_is_dir_path(TracePath)) {
-               strcat(TracePath, ".log");
+#define SAFE_MODE (O_CREAT | O_EXCL | O_RDWR)
+           if (_nc_access(MyPath, W_OK) < 0
+               || (MyFD = safe_open3(MyPath, SAFE_MODE, 0600)) < 0
+               || (MyFP = fdopen(MyFD, BIN_W)) == 0) {
+               ;               /* EMPTY */
            }
        }
-
-       _nc_globals.init_trace = TRUE;
        _nc_tracing = tracelevel;
-       if (_nc_access(TracePath, W_OK) < 0
-           || (TraceFP = fopen(TracePath, mode)) == 0) {
-           perror("curses: Can't open 'trace' file");
-           exit(EXIT_FAILURE);
-       }
        /* Try to set line-buffered mode, or (failing that) unbuffered,
         * so that the trace-output gets flushed automatically at the
-        * end of each line.  This is useful in case the program dies. 
+        * end of each line.  This is useful in case the program dies.
         */
+       if (MyFP != 0) {
 #if HAVE_SETVBUF               /* ANSI */
-       (void) setvbuf(TraceFP, (char *) 0, _IOLBF, (size_t) 0);
+           (void) setvbuf(MyFP, (char *) 0, _IOLBF, (size_t) 0);
 #elif HAVE_SETBUF /* POSIX */
-       (void) setbuffer(TraceFP, (char *) 0);
+           (void) setbuffer(MyFP, (char *) 0);
 #endif
+       }
        _tracef("TRACING NCURSES version %s.%d (tracelevel=%#x)",
                NCURSES_VERSION,
                NCURSES_VERSION_PATCH,
                tracelevel);
     } else if (tracelevel == 0) {
-       if (TraceFP != 0) {
-           fclose(TraceFP);
-           TraceFP = 0;
+       if (MyFP != 0) {
+           MyFD = dup(MyFD);   /* allow reopen of same file */
+           fclose(MyFP);
+           MyFP = 0;
        }
        _nc_tracing = tracelevel;
     } else if (_nc_tracing != tracelevel) {
        _nc_tracing = tracelevel;
        _tracef("tracelevel=%#x", tracelevel);
     }
+#else
+    (void) tracelevel;
+    result = 0;
+#endif
+    return result;
+}
+
+#if defined(TRACE)
+NCURSES_EXPORT(void)
+trace(const unsigned int tracelevel)
+{
+    curses_trace(tracelevel);
 }
 
 static void
@@ -151,16 +176,23 @@ _nc_va_tracef(const char *fmt, va_list ap)
     bool after = FALSE;
     unsigned doit = _nc_tracing;
     int save_err = errno;
+    FILE *fp = MyFP;
+
+#ifdef TRACE
+    /* verbose-trace in the command-line utilities relies on this */
+    if (fp == 0 && !MyInit && _nc_tracing >= DEBUG_LEVEL(1))
+       fp = stderr;
+#endif
 
     if (strlen(fmt) >= sizeof(Called) - 1) {
        if (!strncmp(fmt, Called, sizeof(Called) - 1)) {
            before = TRUE;
-           TraceLevel++;
+           MyLevel++;
        } else if (!strncmp(fmt, Return, sizeof(Return) - 1)) {
            after = TRUE;
        }
        if (before || after) {
-           if ((TraceLevel <= 1)
+           if ((MyLevel <= 1)
                || (doit & TRACE_ICALLS) != 0)
                doit &= (TRACE_CALLS | TRACE_CCALLS);
            else
@@ -168,9 +200,7 @@ _nc_va_tracef(const char *fmt, va_list ap)
        }
     }
 
-    if (doit != 0) {
-       if (TraceFP == 0)
-           TraceFP = stderr;
+    if (doit != 0 && fp != 0) {
 #ifdef USE_PTHREADS
        /*
         * TRACE_ICALLS is "really" needed to show normal use with threaded
@@ -184,30 +214,30 @@ _nc_va_tracef(const char *fmt, va_list ap)
 # if USE_WEAK_SYMBOLS
        if ((pthread_self))
 # endif
-#ifdef __MINGW32__
-           fprintf(TraceFP, "%#lx:", (long) (intptr_t) pthread_self().p);
+#ifdef _NC_WINDOWS
+           fprintf(fp, "%#lx:", (long) (intptr_t) pthread_self().p);
 #else
-           fprintf(TraceFP, "%#lx:", (long) (intptr_t) pthread_self());
+           fprintf(fp, "%#lx:", (long) (intptr_t) pthread_self());
 #endif
 #endif
        if (before || after) {
            int n;
-           for (n = 1; n < TraceLevel; n++)
-               fputs("+ ", TraceFP);
+           for (n = 1; n < MyLevel; n++)
+               fputs("+ ", fp);
        }
-       vfprintf(TraceFP, fmt, ap);
-       fputc('\n', TraceFP);
-       fflush(TraceFP);
+       vfprintf(fp, fmt, ap);
+       fputc('\n', fp);
+       fflush(fp);
     }
 
-    if (after && TraceLevel)
-       TraceLevel--;
+    if (after && MyLevel)
+       MyLevel--;
 
     errno = save_err;
 }
 
 NCURSES_EXPORT(void)
-_tracef(const char *fmt,...)
+_tracef(const char *fmt, ...)
 {
     va_list ap;
 
@@ -229,7 +259,7 @@ NCURSES_EXPORT(char)
 _nc_retrace_char(int code)
 {
     T((T_RETURN("%c"), code));
-    return code;
+    return (char) code;
 }
 
 /* Trace 'int' return-values */
@@ -296,6 +326,39 @@ _nc_retrace_win(WINDOW *code)
     return code;
 }
 
+NCURSES_EXPORT(char *)
+_nc_fmt_funcptr(char *target, const char *source, size_t size)
+{
+    size_t n;
+    char *dst = target;
+    bool leading = TRUE;
+
+    union {
+       int value;
+       char bytes[sizeof(int)];
+    } byteorder;
+
+    byteorder.value = 0x1234;
+
+    *dst++ = '0';
+    *dst++ = 'x';
+
+    for (n = 0; n < size; ++n) {
+       unsigned ch = ((byteorder.bytes[0] == 0x34)
+                      ? UChar(source[size - n - 1])
+                      : UChar(source[n]));
+       if (ch != 0 || (n + 1) >= size)
+           leading = FALSE;
+       if (!leading) {
+           _nc_SPRINTF(dst, _nc_SLIMIT(TR_FUNC_LEN - (size_t) (dst - target))
+                       "%02x", ch & 0xff);
+           dst += 2;
+       }
+    }
+    *dst = '\0';
+    return target;
+}
+
 #if USE_REENTRANT
 /*
  * Check if the given trace-mask is enabled.
@@ -310,13 +373,13 @@ _nc_use_tracef(unsigned mask)
     bool result = FALSE;
 
     _nc_lock_global(tst_tracef);
-    if (!_nc_globals.nested_tracef++) {
+    if (!MyNested++) {
        if ((result = (_nc_tracing & (mask))) != 0
            && _nc_try_global(tracef) == 0) {
            /* we will call _nc_locked_tracef(), no nesting so far */
        } else {
            /* we will not call _nc_locked_tracef() */
-           _nc_globals.nested_tracef = 0;
+           MyNested = 0;
        }
     } else {
        /* we may call _nc_locked_tracef(), but with nested_tracef > 0 */
@@ -331,7 +394,7 @@ _nc_use_tracef(unsigned mask)
  * the tracef mutex.
  */
 NCURSES_EXPORT(void)
-_nc_locked_tracef(const char *fmt,...)
+_nc_locked_tracef(const char *fmt, ...)
 {
     va_list ap;
 
@@ -339,8 +402,9 @@ _nc_locked_tracef(const char *fmt,...)
     _nc_va_tracef(fmt, ap);
     va_end(ap);
 
-    if (--(_nc_globals.nested_tracef) == 0)
+    if (--(MyNested) == 0) {
        _nc_unlock_global(tracef);
+    }
 }
 #endif /* USE_REENTRANT */