]> ncurses.scripts.mit.edu Git - ncurses.git/blobdiff - ncurses/tinfo/lib_setup.c
ncurses 6.4 - patch 20240414
[ncurses.git] / ncurses / tinfo / lib_setup.c
index 6a69493bea5bd18738c5bc182972ce8fce4c68f8..f1e6c1a2be100c69a4b1619f6db2e44126b7d5cb 100644 (file)
@@ -1,5 +1,6 @@
 /****************************************************************************
- * Copyright (c) 1998-2001,2002 Free Software Foundation, Inc.              *
+ * Copyright 2018-2023,2024 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            *
 /****************************************************************************
  *  Author: Zeyd M. Ben-Halim <zmbenhal@netcom.com> 1992,1995               *
  *     and: Eric S. Raymond <esr@snark.thyrsus.com>                         *
+ *     and: Thomas E. Dickey                        1996-on                 *
+ *     and: Juergen Pfeifer                         2009                    *
  ****************************************************************************/
 
 /*
  * Terminal setup routines common to termcap and terminfo:
  *
  *             use_env(bool)
+ *             use_tioctl(bool)
  *             setupterm(char *, int, int *)
  */
 
 #include <curses.priv.h>
 #include <tic.h>               /* for MAX_NAME_SIZE */
-#include <term_entry.h>
 
-#if SVR4_TERMIO && !defined(_POSIX_SOURCE)
-#define _POSIX_SOURCE
+#if HAVE_LOCALE_H
+#include <locale.h>
 #endif
 
-#include <term.h>              /* lines, columns, cur_term */
-
-MODULE_ID("$Id: lib_setup.c,v 1.70 2002/10/12 21:50:18 tom Exp $")
+MODULE_ID("$Id: lib_setup.c,v 1.239 2024/04/14 17:03:40 tom Exp $")
 
 /****************************************************************************
  *
@@ -65,13 +66,17 @@ MODULE_ID("$Id: lib_setup.c,v 1.70 2002/10/12 21:50:18 tom Exp $")
 #endif
 
 #if NEED_PTEM_H
- /* On SCO, they neglected to define struct winsize in termios.h -- it's only
+ /* On SCO, they neglected to define struct winsize in termios.h -- it is only
   * in termio.h and ptem.h (the former conflicts with other definitions).
   */
 # include <sys/stream.h>
 # include <sys/ptem.h>
 #endif
 
+#if HAVE_LANGINFO_CODESET
+#include <langinfo.h>
+#endif
+
 /*
  * SCO defines TIOCGSIZE and the corresponding struct.  Other systems (SunOS,
  * Solaris, IRIX) define TIOCGWINSZ and struct winsize.
@@ -90,183 +95,583 @@ MODULE_ID("$Id: lib_setup.c,v 1.70 2002/10/12 21:50:18 tom Exp $")
 # endif
 #endif
 
-static int _use_env = TRUE;
+/*
+ * Reduce explicit use of "cur_term" global variable.
+ */
+#undef CUR
+#define CUR TerminalType(termp).
+
+/*
+ * Wrap global variables in this module.
+ */
+#if USE_REENTRANT
+
+NCURSES_EXPORT(char *)
+NCURSES_PUBLIC_VAR(ttytype) (void)
+{
+    static char empty[] = "";
+    char *result = empty;
+
+#if NCURSES_SP_FUNCS
+    if (CURRENT_SCREEN) {
+       TERMINAL *termp = TerminalOf(CURRENT_SCREEN);
+       if (termp != 0) {
+           result = TerminalType(termp).term_names;
+       }
+    }
+#else
+    if (cur_term != 0) {
+       result = TerminalType(cur_term).term_names;
+    }
+#endif
+    return result;
+}
+
+NCURSES_EXPORT(int *)
+_nc_ptr_Lines(SCREEN *sp)
+{
+    return ptrLines(sp);
+}
+
+NCURSES_EXPORT(int)
+NCURSES_PUBLIC_VAR(LINES) (void)
+{
+    return *_nc_ptr_Lines(CURRENT_SCREEN);
+}
+
+NCURSES_EXPORT(int *)
+_nc_ptr_Cols(SCREEN *sp)
+{
+    return ptrCols(sp);
+}
+
+NCURSES_EXPORT(int)
+NCURSES_PUBLIC_VAR(COLS) (void)
+{
+    return *_nc_ptr_Cols(CURRENT_SCREEN);
+}
+
+NCURSES_EXPORT(int *)
+_nc_ptr_Tabsize(SCREEN *sp)
+{
+    return ptrTabsize(sp);
+}
+
+NCURSES_EXPORT(int)
+NCURSES_PUBLIC_VAR(TABSIZE) (void)
+{
+    return *_nc_ptr_Tabsize(CURRENT_SCREEN);
+}
+#else
+NCURSES_EXPORT_VAR(char) ttytype[NAMESIZE] = "";
+NCURSES_EXPORT_VAR(int) LINES = 0;
+NCURSES_EXPORT_VAR(int) COLS = 0;
+NCURSES_EXPORT_VAR(int) TABSIZE = 8;
+#endif
+
+#if NCURSES_EXT_FUNCS
+NCURSES_EXPORT(int)
+NCURSES_SP_NAME(set_tabsize) (NCURSES_SP_DCLx int value)
+{
+    int code = OK;
+    if (value <= 0) {
+       code = ERR;
+    } else {
+#if USE_REENTRANT
+       if (SP_PARM) {
+           SP_PARM->_TABSIZE = value;
+       } else {
+           code = ERR;
+       }
+#else
+       (void) SP_PARM;
+       TABSIZE = value;
+#endif
+    }
+    return code;
+}
+
+#if NCURSES_SP_FUNCS
+NCURSES_EXPORT(int)
+set_tabsize(int value)
+{
+    return NCURSES_SP_NAME(set_tabsize) (CURRENT_SCREEN, value);
+}
+#endif
+#endif /* NCURSES_EXT_FUNCS */
+
+#if USE_SIGWINCH
+/*
+ * If we have a pending SIGWINCH, set the flag in each screen.
+ */
+NCURSES_EXPORT(int)
+_nc_handle_sigwinch(SCREEN *sp)
+{
+    SCREEN *scan;
+
+    if (_nc_globals.have_sigwinch) {
+       _nc_globals.have_sigwinch = 0;
+
+       for (each_screen(scan)) {
+           scan->_sig_winch = TRUE;
+       }
+    }
+
+    return (sp ? sp->_sig_winch : 0);
+}
+
+#endif
+
+NCURSES_EXPORT(void)
+NCURSES_SP_NAME(use_env) (NCURSES_SP_DCLx bool f)
+{
+    START_TRACE();
+    T((T_CALLED("use_env(%p,%d)"), (void *) SP_PARM, (int) f));
+#if NCURSES_SP_FUNCS
+    if (IsPreScreen(SP_PARM)) {
+       SP_PARM->_use_env = f;
+    }
+#else
+    _nc_prescreen.use_env = f;
+#endif
+    returnVoid;
+}
 
-static void do_prototype(void);
+NCURSES_EXPORT(void)
+NCURSES_SP_NAME(use_tioctl) (NCURSES_SP_DCLx bool f)
+{
+    START_TRACE();
+    T((T_CALLED("use_tioctl(%p,%d)"), (void *) SP_PARM, (int) f));
+#if NCURSES_SP_FUNCS
+    if (IsPreScreen(SP_PARM)) {
+       SP_PARM->use_tioctl = f;
+    }
+#else
+    _nc_prescreen.use_tioctl = f;
+#endif
+    returnVoid;
+}
 
+#if NCURSES_SP_FUNCS
 NCURSES_EXPORT(void)
 use_env(bool f)
 {
-    T((T_CALLED("use_env()")));
-    _use_env = f;
+    START_TRACE();
+    T((T_CALLED("use_env(%d)"), (int) f));
+    _nc_prescreen.use_env = f;
     returnVoid;
 }
 
-NCURSES_EXPORT_VAR(int) LINES = 0;
-NCURSES_EXPORT_VAR(int) COLS = 0;
-NCURSES_EXPORT_VAR(int) TABSIZE = 0;
+NCURSES_EXPORT(void)
+use_tioctl(bool f)
+{
+    START_TRACE();
+    T((T_CALLED("use_tioctl(%d)"), (int) f));
+    _nc_prescreen.use_tioctl = f;
+    returnVoid;
+}
+#endif
 
+#if !(defined(USE_TERM_DRIVER) || defined(EXP_WIN32_DRIVER))
 static void
-_nc_get_screensize(int *linep, int *colp)
-/* Obtain lines/columns values from the environment and/or terminfo entry */
+_nc_default_screensize(TERMINAL *termp, int *linep, int *colp)
 {
-    /* figure out the size of the screen */
-    T(("screen size: terminfo lines = %d columns = %d", lines, columns));
-
-    if (!_use_env) {
+    /* if we can't get dynamic info about the size, use static */
+    if (*linep <= 0) {
        *linep = (int) lines;
+    }
+    if (*colp <= 0) {
        *colp = (int) columns;
-    } else {                   /* usually want to query LINES and COLUMNS from environment */
-       int value;
+    }
+
+    /* the ultimate fallback, assume fixed 24x80 size */
+    if (*linep <= 0) {
+       *linep = 24;
+    }
+    if (*colp <= 0) {
+       *colp = 80;
+    }
+}
+
+#if defined(USE_CHECK_SIZE) && defined(user6) && defined(user7)
+static const char *
+skip_csi(const char *value)
+{
+    if (UChar(*value) == CSI_CHR) {
+       ++value;
+    } else if (*value == ESC_CHR && value[1] == L_BLOCK) {
+       value += 2;
+    }
+    return value;
+}
+
+static bool
+is_expected(const char *value, const char *expected)
+{
+    bool result = FALSE;
+    if (VALID_STRING(value)) {
+       const char *skipped = skip_csi(value);
+       if (skipped != value) {
+           if (!strcmp(skipped, expected))
+               result = TRUE;
+       }
+    }
+    return result;
+}
 
-       *linep = *colp = 0;
+static bool
+get_position(TERMINAL *termp, int fd, int *row, int *col)
+{
+    bool result = FALSE;
+    size_t need = strlen(user7);
+    int have;
+
+    have = (int) write(fd, user7, need);
+
+    if (have == (int) need) {
+       int y, x;
+       char buf[20];
+       char *s;
+       char cc;
+       const char *skipped;
+       int scanned;
 
-       /* first, look for environment variables */
-       if ((value = _nc_getenv_num("LINES")) > 0) {
-           *linep = value;
+       s = memset(buf, '\0', sizeof(buf));
+       do {
+           size_t ask = (sizeof(buf) - 1 - (size_t) (s - buf));
+           int got = (int) read(fd, s, ask);
+           if (got == 0)
+               break;
+           s += got;
+           *s = '\0';
+       } while (strchr(buf, 'R') == NULL && (size_t) (s + 1 - buf) < sizeof(buf));
+       T(("CPR response %s", _nc_visbuf(buf)));
+       skipped = skip_csi(buf);
+       cc = '\0';
+       if (skipped != buf
+           && *skipped != '\0'
+           && (scanned = sscanf(skip_csi(buf), "%d;%d%c", &y, &x, &cc)) == 3
+           && (cc == 'R')) {
+           *row = y;
+           *col = x;
+           result = TRUE;
        }
-       if ((value = _nc_getenv_num("COLUMNS")) > 0) {
-           *colp = value;
+    }
+    T(("get_position %s %d,%d", result ? "OK" : "ERR", *row, *col));
+    return result;
+}
+
+static bool
+set_position(NCURSES_SP_DCLx TERMINAL *termp, int row, int col)
+{
+    bool result;
+    char *actual = TIPARM_2(cursor_address, row, col);
+    T((T_CALLED("set_position %d,%d)"), row, col));
+#if NCURSES_SP_FUNCS
+    result = (NCURSES_SP_NAME(_nc_putp) (NCURSES_SP_ARGx "set_position",
+                                        actual) == OK);
+    NCURSES_SP_NAME(_nc_flush) (NCURSES_SP_ARG);
+#else
+    /* This does not support padding because without sp-funcs, we have only
+     * the interface using stdio, but we are not guaranteed that Filedes
+     * is the same as fileno(stdout).
+     */
+    result = FALSE;
+    if (actual != NULL) {
+       size_t want = strlen(actual);
+       int have = (int) write(termp->Filedes, actual, want);
+       result = ((int) want == have);
+    }
+#endif
+    returnBool(result);
+}
+
+/*
+ * This is a little more complicated than one might expect, because we do this
+ * before setting up the terminal modes, etc., and cannot use the timeout or
+ * buffering functions.
+ *
+ * We check if the terminal description has the ECMA-48 CPR (cursor position
+ * report) in u7 and the response in u6.  The two variations of is_expected()
+ * cover the termcap style and terminfo style, and are equivalent as far as we
+ * are concerned.  For analyzing the response, we wait (a short time) for 'R'
+ * to be echoed, and then check if we received two integers in the response.
+ *
+ * In principle, this could run on "any" ECMA-48 terminal, but in practice,
+ * there is a scenario using GNU screen where it uses ncurses with a partially
+ * configured pseudo-terminal, and the CPR response goes to the wrong place.
+ * So we do a simple check to exclude pseudo-terminals.
+ */
+static void
+_nc_check_screensize(SCREEN *sp, TERMINAL *termp, int *linep, int *colp)
+{
+    int fd = termp->Filedes;
+    TTY saved;
+    const char *name = NULL;
+
+    if (IsRealTty(fd, name)
+       && VALID_STRING(cursor_address)
+       && is_expected(user7, "6n")
+       && (is_expected(user6, "%i%d;%dR") ||
+           is_expected(user6, "%i%p1%d;%p2%dR"))
+       && GET_TTY(fd, &saved) == OK) {
+       int current_y = -1, current_x = -1;
+       int updated_y = -1, updated_x = -1;
+       TTY alter = saved;
+
+#if NCURSES_SP_FUNCS
+       if (sp == NULL) {
+           sp = new_prescr();
+           sp->_term = termp;
+           NCURSES_SP_NAME(baudrate) (NCURSES_SP_ARG);
        }
-       T(("screen size: environment LINES = %d COLUMNS = %d", *linep, *colp));
+#else
+       (void) sp;
+#endif
 
+       T(("trying CPR (u7/u6) with %s", name));
+       alter.c_lflag &= (unsigned) ~(ECHO | ICANON | ISIG | IEXTEN);
+       alter.c_iflag &= (unsigned) ~(IXON | BRKINT | PARMRK);
+       alter.c_cc[VMIN] = 0;
+       alter.c_cc[VTIME] = 1;
+       SET_TTY(fd, &alter);
+
+       if (get_position(termp, fd, &current_y, &current_x)
+           && set_position(NCURSES_SP_ARGx termp, 9999, 9999)
+           && get_position(termp, fd, &updated_y, &updated_x)) {
+           *linep = updated_y;
+           *colp = updated_x;
+           set_position(NCURSES_SP_ARGx termp, current_y, current_x);
+       }
+       /* restore tty modes */
+       SET_TTY(fd, &saved);
+    } else {
+       T(("NOT trying CPR with fd %d (%s): %s",
+          fd, NonNull(name), NC_ISATTY(fd) ? "tty" : "not a tty"));
+    }
+
+    _nc_default_screensize(termp, linep, colp);
+}
+#else /* !USE_CHECK_SIZE */
+#define _nc_check_screensize(sp, termp, linep, colp)   /* nothing */
+#endif
+#endif /* !(defined(USE_TERM_DRIVER) || defined(EXP_WIN32_DRIVER)) */
+
+NCURSES_EXPORT(void)
+_nc_get_screensize(SCREEN *sp,
+#ifdef USE_TERM_DRIVER
+                  TERMINAL *termp,
+#endif
+                  int *linep, int *colp)
+/* Obtain lines/columns values from the environment and/or terminfo entry */
+{
+#ifdef USE_TERM_DRIVER
+    TERMINAL_CONTROL_BLOCK *TCB;
+    int my_tabsize;
+
+    assert(termp != 0 && linep != 0 && colp != 0);
+    TCB = (TERMINAL_CONTROL_BLOCK *) termp;
+
+    my_tabsize = TCB->info.tabsize;
+    TCB->drv->td_size(TCB, linep, colp);
+
+#if USE_REENTRANT
+    if (sp != 0) {
+       sp->_TABSIZE = my_tabsize;
+    }
+#else
+    (void) sp;
+    TABSIZE = my_tabsize;
+#endif
+    T(("TABSIZE = %d", my_tabsize));
+#else /* !USE_TERM_DRIVER */
+    TERMINAL *termp = cur_term;
+    int my_tabsize;
+    bool useEnv = _nc_prescreen.use_env;
+    bool useTioctl = _nc_prescreen.use_tioctl;
+
+    T((T_CALLED("_nc_get_screensize (%p)"), sp));
+#ifdef EXP_WIN32_DRIVER
+    /* If we are here, then Windows console is used in terminfo mode.
+       We need to figure out the size using the console API
+     */
+    _nc_console_size(linep, colp);
+    T(("screen size: winconsole lines = %d columns = %d", *linep, *colp));
+#else
+    /* figure out the size of the screen */
+    T(("screen size: terminfo lines = %d columns = %d", lines, columns));
+
+    *linep = (int) lines;
+    *colp = (int) columns;
+#endif
+
+#if NCURSES_SP_FUNCS
+    if (sp) {
+       useEnv = sp->_use_env;
+       useTioctl = sp->use_tioctl;
+    }
+#endif
+
+    T(("useEnv:%d useTioctl:%d", useEnv, useTioctl));
+    if (useEnv || useTioctl) {
 #ifdef __EMX__
-       if (*linep <= 0 || *colp <= 0) {
+       {
            int screendata[2];
            _scrsize(screendata);
            *colp = screendata[0];
-           *linep = screendata[1];
+           *linep = ((sp != 0 && sp->_filtered)
+                     ? 1
+                     : screendata[1]);
            T(("EMX screen size: environment LINES = %d COLUMNS = %d",
               *linep, *colp));
        }
 #endif
 #if HAVE_SIZECHANGE
-       /* if that didn't work, maybe we can try asking the OS */
-       if (*linep <= 0 || *colp <= 0) {
-           if (isatty(cur_term->Filedes)) {
-               STRUCT_WINSIZE size;
-
-               errno = 0;
-               do {
-                   if (ioctl(cur_term->Filedes, IOCTL_WINSIZE, &size) < 0
-                       && errno != EINTR)
-                       goto failure;
-               } while
-                   (errno == EINTR);
+       /* try asking the OS */
+       if (NC_ISATTY(cur_term->Filedes)) {
+           STRUCT_WINSIZE size;
 
-               /*
-                * Solaris lets users override either dimension with an
-                * environment variable.
-                */
-               if (*linep <= 0)
-                   *linep = WINSIZE_ROWS(size);
-               if (*colp <= 0)
+           errno = 0;
+           do {
+               if (ioctl(cur_term->Filedes, IOCTL_WINSIZE, &size) >= 0) {
+                   *linep = ((sp != 0 && sp->_filtered)
+                             ? 1
+                             : WINSIZE_ROWS(size));
                    *colp = WINSIZE_COLS(size);
-           }
-           /* FALLTHRU */
-         failure:;
+                   T(("SYS screen size: environment LINES = %d COLUMNS = %d",
+                      *linep, *colp));
+                   break;
+               }
+           } while
+               (errno == EINTR);
        }
 #endif /* HAVE_SIZECHANGE */
 
-       /* if we can't get dynamic info about the size, use static */
-       if (*linep <= 0) {
-           *linep = (int) lines;
-       }
-       if (*colp <= 0) {
-           *colp = (int) columns;
-       }
+       if (useEnv) {
+           int value;
 
-       /* the ultimate fallback, assume fixed 24x80 size */
-       if (*linep <= 0) {
-           *linep = 24;
-       }
-       if (*colp <= 0) {
-           *colp = 80;
+           if (useTioctl) {
+               /*
+                * If environment variables are used, update them.
+                */
+               if ((sp == 0 || !sp->_filtered) && _nc_getenv_num("LINES") > 0) {
+                   _nc_setenv_num("LINES", *linep);
+               }
+               if (_nc_getenv_num("COLUMNS") > 0) {
+                   _nc_setenv_num("COLUMNS", *colp);
+               }
+           }
+
+           /*
+            * Finally, look for environment variables.
+            *
+            * Solaris lets users override either dimension with an environment
+            * variable.
+            */
+           if ((value = _nc_getenv_num("LINES")) > 0) {
+               *linep = value;
+               T(("screen size: environment LINES = %d", *linep));
+           }
+           if ((value = _nc_getenv_num("COLUMNS")) > 0) {
+               *colp = value;
+               T(("screen size: environment COLUMNS = %d", *colp));
+           }
+
+           _nc_default_screensize(termp, linep, colp);
+       } else {
+           _nc_check_screensize(sp, termp, linep, colp);
        }
 
        /*
         * Put the derived values back in the screen-size caps, so
         * tigetnum() and tgetnum() will do the right thing.
         */
-       lines = (short) (*linep);
-       columns = (short) (*colp);
+       lines = (NCURSES_INT2) (*linep);
+       columns = (NCURSES_INT2) (*colp);
+#if NCURSES_EXT_NUMBERS
+#define OldNumber(termp,name) \
+       (termp)->type.Numbers[(&name - (termp)->type2.Numbers)]
+       OldNumber(termp, lines) = (short) (*linep);
+       OldNumber(termp, columns) = (short) (*colp);
+#endif
+    } else {
+       _nc_check_screensize(sp, termp, linep, colp);
     }
 
     T(("screen size is %dx%d", *linep, *colp));
 
     if (VALID_NUMERIC(init_tabs))
-       TABSIZE = (int) init_tabs;
+       my_tabsize = (int) init_tabs;
     else
-       TABSIZE = 8;
-    T(("TABSIZE = %d", TABSIZE));
+       my_tabsize = 8;
 
+#if USE_REENTRANT
+    if (sp != 0)
+       sp->_TABSIZE = my_tabsize;
+#else
+    TABSIZE = my_tabsize;
+#endif
+    T(("TABSIZE = %d", TABSIZE));
+    returnVoid;
+#endif /* USE_TERM_DRIVER */
 }
 
 #if USE_SIZECHANGE
 NCURSES_EXPORT(void)
-_nc_update_screensize(void)
+_nc_update_screensize(SCREEN *sp)
 {
-    int my_lines, my_cols;
+    int new_lines;
+    int new_cols;
 
-    _nc_get_screensize(&my_lines, &my_cols);
-    if (SP != 0 && SP->_resize != 0)
-       SP->_resize(my_lines, my_cols);
-}
+#ifdef USE_TERM_DRIVER
+    int old_lines;
+    int old_cols;
+
+    assert(sp != 0);
+
+    CallDriver_2(sp, td_getsize, &old_lines, &old_cols);
+
+#else
+    TERMINAL *termp = cur_term;
+    int old_lines = lines;
+    int old_cols = columns;
 #endif
 
+    if (sp != 0) {
+       TINFO_GET_SIZE(sp, sp->_term, &new_lines, &new_cols);
+       /*
+        * See is_term_resized() and resizeterm().
+        * We're doing it this way because those functions belong to the upper
+        * ncurses library, while this resides in the lower terminfo library.
+        */
+       if (sp->_resize != 0) {
+           if ((new_lines != old_lines) || (new_cols != old_cols)) {
+               sp->_resize(NCURSES_SP_ARGx new_lines, new_cols);
+           } else if (sp->_sig_winch && (sp->_ungetch != 0)) {
+               sp->_ungetch(SP_PARM, KEY_RESIZE);      /* so application can know this */
+           }
+           sp->_sig_winch = FALSE;
+       }
+    }
+}
+#endif /* USE_SIZECHANGE */
+
 /****************************************************************************
  *
  * Terminal setup
  *
  ****************************************************************************/
 
-#define ret_error(code, fmt, arg)      if (errret) {\
-                                           *errret = code;\
-                                           returnCode(ERR);\
-                                       } else {\
-                                           fprintf(stderr, fmt, arg);\
-                                           exit(EXIT_FAILURE);\
-                                       }
-
-#define ret_error0(code, msg)          if (errret) {\
-                                           *errret = code;\
-                                           returnCode(ERR);\
-                                       } else {\
-                                           fprintf(stderr, msg);\
-                                           exit(EXIT_FAILURE);\
-                                       }
-
-#if USE_DATABASE || USE_TERMCAP
-static int
-grab_entry(const char *const tn, TERMTYPE * const tp)
-/* return 1 if entry found, 0 if not found, -1 if database not accessible */
+#if NCURSES_USE_DATABASE || NCURSES_USE_TERMCAP
+/*
+ * Return 1 if entry found, 0 if not found, -1 if database not accessible,
+ * just like tgetent().
+ */
+int
+_nc_setup_tinfo(const char *const tn, TERMTYPE2 *const tp)
 {
     char filename[PATH_MAX];
-    int status;
-
-    /*
-     * $TERM shouldn't contain pathname delimiters.
-     */
-    if (strchr(tn, '/'))
-       return 0;
-
-#if USE_DATABASE
-    if ((status = _nc_read_entry(tn, filename, tp)) != 1) {
-
-#if !PURE_TERMINFO
-       /*
-        * Try falling back on the termcap file.
-        * Note:  allowing this call links the entire terminfo/termcap
-        * compiler into the startup code.  It's preferable to build a
-        * real terminfo database and use that.
-        */
-       status = _nc_read_termcap_entry(tn, tp);
-#endif /* PURE_TERMINFO */
-
-    }
-#else
-    status = _nc_read_termcap_entry(tn, tp);
-#endif
+    int status = _nc_read_entry2(tn, filename, tp);
 
     /*
      * If we have an entry, force all of the cancelled strings to null
@@ -274,8 +679,9 @@ grab_entry(const char *const tn, TERMTYPE * const tp)
      * (The terminfo compiler bypasses this logic, since it must know if
      * a string is cancelled, for merging entries).
      */
-    if (status == 1) {
-       int n;
+    if (status == TGETENT_YES) {
+       unsigned n;
+       T(("_nc_setup_tinfo - resetting invalid booleans/strings"));
        for_each_boolean(n, tp) {
            if (!VALID_BOOLEAN(tp->Booleans[n]))
                tp->Booleans[n] = FALSE;
@@ -289,149 +695,517 @@ grab_entry(const char *const tn, TERMTYPE * const tp)
 }
 #endif
 
-NCURSES_EXPORT_VAR(char) ttytype[NAMESIZE] = "";
-
 /*
- *     setupterm(termname, Filedes, errret)
- *
- *     Find and read the appropriate object file for the terminal
- *     Make cur_term point to the structure.
- *
+ * Take the real command character out of the CC environment variable
+ * and substitute it in for the prototype given in 'command_character'.
  */
-
-NCURSES_EXPORT(int)
-setupterm(NCURSES_CONST char *tname, int Filedes, int *errret)
+void
+_nc_tinfo_cmdch(TERMINAL *termp, int proto)
 {
-    struct term *term_ptr;
-    int status;
+    char *tmp;
 
-    START_TRACE();
-    T((T_CALLED("setupterm(%s,%d,%p)"), _nc_visbuf(tname), Filedes, errret));
+    /*
+     * Only use the character if the string is a single character,
+     * since it is fairly common for developers to set the C compiler
+     * name as an environment variable - using the same symbol.
+     */
+    if ((tmp = getenv("CC")) != 0 && strlen(tmp) == 1) {
+       unsigned i;
+       char CC = *tmp;
 
-    if (tname == 0) {
-       tname = getenv("TERM");
-       if (tname == 0 || *tname == '\0') {
-           ret_error0(-1, "TERM environment variable not set.\n");
+       for_each_string(i, &(termp->type)) {
+           tmp = termp->type.Strings[i];
+           if (VALID_STRING(tmp)) {
+               for (; *tmp; ++tmp) {
+                   if (UChar(*tmp) == proto)
+                       *tmp = CC;
+               }
+           }
        }
     }
-    if (strlen(tname) > MAX_NAME_SIZE) {
-       ret_error(-1, "TERM environment must be <= %d characters.\n",
-                 MAX_NAME_SIZE);
-    }
+}
 
-    T(("your terminal name is %s", tname));
+/*
+ * Find the locale which is in effect.
+ */
+NCURSES_EXPORT(char *)
+_nc_get_locale(void)
+{
+    char *env;
+#if HAVE_LOCALE_H
+    /*
+     * This is preferable to using getenv() since it ensures that we are using
+     * the locale which was actually initialized by the application.
+     */
+    env = setlocale(LC_CTYPE, 0);
+#else
+    if (((env = getenv("LANG")) != 0 && *env != '\0')
+       || ((env = getenv("LC_CTYPE")) != 0 && *env != '\0')
+       || ((env = getenv("LC_ALL")) != 0 && *env != '\0')) {
+       ;
+    }
+#endif
+    T(("_nc_get_locale %s", _nc_visbuf(env)));
+    return env;
+}
 
-    term_ptr = typeCalloc(TERMINAL, 1);
+/*
+ * Check if we are running in a UTF-8 locale.
+ */
+NCURSES_EXPORT(int)
+_nc_unicode_locale(void)
+{
+    static bool initialized = FALSE;
+    static int result = 0;
 
-    if (term_ptr == 0) {
-       ret_error0(-1, "Not enough memory to create terminal structure.\n");
-    }
-#if USE_DATABASE || USE_TERMCAP
-    status = grab_entry(tname, &term_ptr->type);
+    if (!initialized) {
+#if defined(_NC_WINDOWS) && USE_WIDEC_SUPPORT
+       result = 1;
+#elif HAVE_LANGINFO_CODESET
+       char *env = nl_langinfo(CODESET);
+       result = !strcmp(env, "UTF-8");
+       T(("_nc_unicode_locale(%s) ->%d", env, result));
 #else
-    status = 0;
+       char *env = _nc_get_locale();
+       if (env != 0) {
+           if (strstr(env, ".UTF-8") != 0) {
+               result = 1;
+               T(("_nc_unicode_locale(%s) ->%d", env, result));
+           }
+       }
 #endif
+       initialized = TRUE;
+    }
+    return result;
+}
 
-    /* try fallback list if entry on disk */
-    if (status != 1) {
-       const TERMTYPE *fallback = _nc_fallback(tname);
+#define CONTROL_N(s) ((s) != 0 && strstr(s, "\016") != 0)
+#define CONTROL_O(s) ((s) != 0 && strstr(s, "\017") != 0)
 
-       if (fallback) {
-           term_ptr->type = *fallback;
-           status = 1;
+/*
+ * Check for known broken cases where a UTF-8 locale breaks the alternate
+ * character set.
+ */
+NCURSES_EXPORT(int)
+_nc_locale_breaks_acs(TERMINAL *termp)
+{
+    const char *env_name = "NCURSES_NO_UTF8_ACS";
+    const char *env;
+    int value;
+    int result = 0;
+
+    T((T_CALLED("_nc_locale_breaks_acs:%d"), result));
+    if (getenv(env_name) != 0) {
+       result = _nc_getenv_num(env_name);
+    } else if ((value = tigetnum("U8")) >= 0) {
+       result = value;         /* use extension feature */
+    } else if ((env = getenv("TERM")) != 0) {
+       if (strstr(env, "linux")) {
+           result = 1;         /* always broken */
+       } else if (strstr(env, "screen") != 0
+                  && ((env = getenv("TERMCAP")) != 0
+                      && strstr(env, "screen") != 0)
+                  && strstr(env, "hhII00") != 0) {
+           if (CONTROL_N(enter_alt_charset_mode) ||
+               CONTROL_O(enter_alt_charset_mode) ||
+               CONTROL_N(set_attributes) ||
+               CONTROL_O(set_attributes)) {
+               result = 1;
+           }
        }
     }
+    returnCode(result);
+}
 
-    if (status == -1) {
-       ret_error0(-1, "terminals database is inaccessible\n");
-    } else if (status == 0) {
-       ret_error(0, "'%s': unknown terminal type.\n", tname);
-    }
+NCURSES_EXPORT(int)
+TINFO_SETUP_TERM(TERMINAL **tp,
+                const char *tname,
+                int Filedes,
+                int *errret,
+                int reuse)
+{
+#ifdef USE_TERM_DRIVER
+    TERMINAL_CONTROL_BLOCK *TCB = 0;
+#endif
+    TERMINAL *termp;
+    SCREEN *sp = 0;
+    char *myname;
+    int code = ERR;
 
-    /*
-     * Improve on SVr4 curses.  If an application mixes curses and termcap
-     * calls, it may call both initscr and tgetent.  This is not really a
-     * good thing to do, but can happen if someone tries using ncurses with
-     * the readline library.  The problem we are fixing is that when
-     * tgetent calls setupterm, the resulting Ottyb struct in cur_term is
-     * zeroed.  A subsequent call to endwin uses the zeroed terminal
-     * settings rather than the ones saved in initscr.  So we check if
-     * cur_term appears to contain terminal settings for the same output
-     * file as our current call - and copy those terminal settings.  (SVr4
-     * curses does not do this, however applications that are working
-     * around the problem will still work properly with this feature).
-     */
-    if (cur_term != 0) {
-       if (cur_term->Filedes == Filedes)
-           term_ptr->Ottyb = cur_term->Ottyb;
-    }
+    START_TRACE();
 
-    set_curterm(term_ptr);
+#ifdef USE_TERM_DRIVER
+    T((T_CALLED("_nc_setupterm_ex(%p,%s,%d,%p)"),
+       (void *) tp, _nc_visbuf(tname), Filedes, (void *) errret));
 
-    if (command_character && getenv("CC"))
-       do_prototype();
+    if (tp == 0) {
+       ret_error0(TGETENT_ERR,
+                  "Invalid parameter, internal error.\n");
+    } else
+       termp = *tp;
+#else
+    termp = cur_term;
+    T((T_CALLED("setupterm(%s,%d,%p)"), _nc_visbuf(tname), Filedes, (void *) errret));
+#endif
 
-    strncpy(ttytype, cur_term->type.term_names, NAMESIZE - 1);
-    ttytype[NAMESIZE - 1] = '\0';
+    if (tname == 0) {
+       tname = getenv("TERM");
+#if defined(EXP_WIN32_DRIVER)
+       if (!VALID_TERM_ENV(tname, NO_TERMINAL)) {
+           T(("Failure with TERM=%s", NonNull(tname)));
+           ret_error0(TGETENT_ERR, "TERM environment variable not set.\n");
+       }
+#elif defined(USE_TERM_DRIVER)
+       if (!NonEmpty(tname))
+           tname = "unknown";
+#else
+       if (!NonEmpty(tname)) {
+           T(("Failure with TERM=%s", NonNull(tname)));
+           ret_error0(TGETENT_ERR, "TERM environment variable not set.\n");
+       }
+#endif
+    }
+    myname = strdup(tname);
+    if (myname == NULL || strlen(myname) > MAX_NAME_SIZE) {
+       ret_error(TGETENT_ERR,
+                 "TERM environment must be 1..%d characters.\n",
+                 MAX_NAME_SIZE,
+                 free(myname));
+    }
+
+    T(("your terminal name is %s", myname));
 
     /*
      * Allow output redirection.  This is what SVr3 does.  If stdout is
      * directed to a file, screen updates go to standard error.
      */
-    if (Filedes == STDOUT_FILENO && !isatty(Filedes))
+    if (Filedes == STDOUT_FILENO && !NC_ISATTY(Filedes))
        Filedes = STDERR_FILENO;
-    cur_term->Filedes = Filedes;
+#if defined(EXP_WIN32_DRIVER)
+    if (Filedes != STDERR_FILENO && NC_ISATTY(Filedes))
+       _setmode(Filedes, _O_BINARY);
+#endif
 
     /*
-     * If an application calls setupterm() rather than initscr() or newterm(),
-     * we will not have the def_prog_mode() call in _nc_setupscreen().  Do it
-     * now anyway, so we can initialize the baudrate.
+     * Check if we have already initialized to use this terminal.  If so, we
+     * do not need to re-read the terminfo entry, or obtain TTY settings.
+     *
+     * This is an improvement on SVr4 curses.  If an application mixes curses
+     * and termcap calls, it may call both initscr and tgetent.  This is not
+     * really a good thing to do, but can happen if someone tries using ncurses
+     * with the readline library.  The problem we are fixing is that when
+     * tgetent calls setupterm, the resulting Ottyb struct in cur_term is
+     * zeroed.  A subsequent call to endwin uses the zeroed terminal settings
+     * rather than the ones saved in initscr.  So we check if cur_term appears
+     * to contain terminal settings for the same output file as our current
+     * call - and copy those terminal settings.  (SVr4 curses does not do this,
+     * however applications that are working around the problem will still work
+     * properly with this feature).
      */
-    if (isatty(Filedes)) {
-       def_prog_mode();
-       baudrate();
+    if (reuse
+       && (termp != 0)
+       && termp->Filedes == Filedes
+       && termp->_termname != 0
+       && !strcmp(termp->_termname, myname)
+       && _nc_name_match(TerminalType(termp).term_names, myname, "|")) {
+       T(("reusing existing terminal information and mode-settings"));
+       code = OK;
+#ifdef USE_TERM_DRIVER
+       TCB = (TERMINAL_CONTROL_BLOCK *) termp;
+#endif
+    } else {
+#ifdef USE_TERM_DRIVER
+       TERMINAL_CONTROL_BLOCK *my_tcb;
+       termp = 0;
+       if ((my_tcb = typeCalloc(TERMINAL_CONTROL_BLOCK, 1)) != 0)
+           termp = &(my_tcb->term);
+#else
+       int status;
+
+       termp = typeCalloc(TERMINAL, 1);
+#endif
+       if (termp == 0) {
+           ret_error1(TGETENT_ERR,
+                      "Not enough memory to create terminal structure.\n",
+                      myname, free(myname));
+       }
+       ++_nc_globals.terminal_count;
+#if HAVE_SYSCONF
+       {
+           long limit;
+#ifdef LINE_MAX
+           limit = LINE_MAX;
+#else
+           limit = _nc_globals.getstr_limit;
+#endif
+#ifdef _SC_LINE_MAX
+           if (limit < sysconf(_SC_LINE_MAX))
+               limit = sysconf(_SC_LINE_MAX);
+#endif
+           if (_nc_globals.getstr_limit < (int) limit)
+               _nc_globals.getstr_limit = (int) limit;
+       }
+#endif /* HAVE_SYSCONF */
+       T(("using %d for getstr limit", _nc_globals.getstr_limit));
+
+#ifdef USE_TERM_DRIVER
+       INIT_TERM_DRIVER();
+       /*
+        * _nc_get_driver() will call td_CanHandle() for each driver, and win_driver
+        * needs file descriptor to do the test, so set it before calling.
+        */
+       termp->Filedes = (short) Filedes;
+       TCB = (TERMINAL_CONTROL_BLOCK *) termp;
+       code = _nc_globals.term_driver(TCB, myname, errret);
+       if (code == OK) {
+           termp->_termname = strdup(myname);
+       } else {
+           ret_error1(errret ? *errret : TGETENT_ERR,
+                      "Could not find any driver to handle terminal.\n",
+                      myname, free(myname));
+       }
+#else
+#if NCURSES_USE_DATABASE || NCURSES_USE_TERMCAP
+       status = _nc_setup_tinfo(myname, &TerminalType(termp));
+       T(("_nc_setup_tinfo returns %d", status));
+#else
+       T(("no database available"));
+       status = TGETENT_NO;
+#endif
+
+       /* try fallback list if entry on disk */
+       if (status != TGETENT_YES) {
+           const TERMTYPE2 *fallback = _nc_fallback2(myname);
+
+           if (fallback) {
+               T(("found fallback entry"));
+               _nc_copy_termtype2(&(TerminalType(termp)), fallback);
+               status = TGETENT_YES;
+           }
+       }
+
+       if (status != TGETENT_YES) {
+           del_curterm(termp);
+           if (status == TGETENT_ERR) {
+               free(myname);
+               ret_error0(status, "terminals database is inaccessible\n");
+           } else if (status == TGETENT_NO) {
+               ret_error1(status, "unknown terminal type.\n",
+                          myname, free(myname));
+           } else {
+               free(myname);
+               ret_error0(status, "unexpected return-code\n");
+           }
+       }
+#if NCURSES_EXT_NUMBERS
+       _nc_export_termtype2(&termp->type, &TerminalType(termp));
+#endif
+#if !USE_REENTRANT
+       save_ttytype(termp);
+#endif
+
+       termp->Filedes = (short) Filedes;
+       termp->_termname = strdup(myname);
+
+       set_curterm(termp);
+
+       if (VALID_STRING(command_character))
+           _nc_tinfo_cmdch(termp, UChar(*command_character));
+
+       /*
+        * If an application calls setupterm() rather than initscr() or
+        * newterm(), we will not have the def_prog_mode() call in
+        * _nc_setupscreen().  Do it now anyway, so we can initialize the
+        * baudrate.  Also get the shell-mode so that erasechar() works.
+        */
+       if (NC_ISATTY(Filedes)) {
+           NCURSES_SP_NAME(def_shell_mode) (NCURSES_SP_ARG);
+           NCURSES_SP_NAME(def_prog_mode) (NCURSES_SP_ARG);
+           NCURSES_SP_NAME(baudrate) (NCURSES_SP_ARG);
+       }
+       code = OK;
+#endif
     }
 
-    _nc_get_screensize(&LINES, &COLS);
+#ifdef USE_TERM_DRIVER
+    *tp = termp;
+    NCURSES_SP_NAME(set_curterm) (sp, termp);
+    TCB->drv->td_init(TCB);
+#else
+    sp = SP;
+#endif
 
-    if (errret)
-       *errret = 1;
+    /*
+     * We should always check the screensize, just in case.
+     */
+    TINFO_GET_SIZE(sp, termp, ptrLines(sp), ptrCols(sp));
 
-    T((T_CREATE("screen %s %dx%d"), tname, LINES, COLS));
+    if (errret)
+       *errret = TGETENT_YES;
 
+#ifndef USE_TERM_DRIVER
     if (generic_type) {
-       ret_error(0, "'%s': I need something more specific.\n", tname);
+       /*
+        * BSD 4.3's termcap contains mis-typed "gn" for wy99.  Do a sanity
+        * check before giving up.
+        */
+       if ((VALID_STRING(cursor_address)
+            || (VALID_STRING(cursor_down) && VALID_STRING(cursor_home)))
+           && VALID_STRING(clear_screen)) {
+           ret_error1(TGETENT_YES, "terminal is not really generic.\n",
+                      myname, free(myname));
+       } else {
+           del_curterm(termp);
+           ret_error1(TGETENT_NO, "I need something more specific.\n",
+                      myname, free(myname));
+       }
+    } else if (hard_copy) {
+       ret_error1(TGETENT_YES, "I can't handle hardcopy terminals.\n",
+                  myname, free(myname));
     }
-    if (hard_copy) {
-       ret_error(1, "'%s': I can't handle hardcopy terminals.\n", tname);
+#endif
+    free(myname);
+    returnCode(code);
+}
+
+#ifdef USE_PTHREADS
+/*
+ * Returns a non-null pointer unless a new screen should be allocated because
+ * no match was found in the pre-screen cache.
+ */
+NCURSES_EXPORT(SCREEN *)
+_nc_find_prescr(void)
+{
+    SCREEN *result = 0;
+    PRESCREEN_LIST *p;
+    pthread_t id = GetThreadID();
+    for (p = _nc_prescreen.allocated; p != 0; p = p->next) {
+       if (p->id == id) {
+           result = p->sp;
+           break;
+       }
     }
-    returnCode(OK);
+    return result;
 }
 
 /*
-**     do_prototype()
-**
-**     Take the real command character out of the CC environment variable
-**     and substitute it in for the prototype given in 'command_character'.
-**
-*/
+ * Tells ncurses to forget that this thread was associated with the pre-screen
+ * cache.  It does not modify the pre-screen cache itself, since that is used
+ * for creating new screens.
+ */
+NCURSES_EXPORT(void)
+_nc_forget_prescr(void)
+{
+    PRESCREEN_LIST *p, *q;
+    pthread_t id = GetThreadID();
+    _nc_lock_global(screen);
+    for (p = _nc_prescreen.allocated, q = 0; p != 0; q = p, p = p->next) {
+       if (p->id == id) {
+           if (q) {
+               q->next = p->next;
+           } else {
+               _nc_prescreen.allocated = p->next;
+           }
+           free(p);
+           break;
+       }
+    }
+    _nc_unlock_global(screen);
+}
+#endif /* USE_PTHREADS */
 
-static void
-do_prototype(void)
+#if NCURSES_SP_FUNCS
+/*
+ * In case of handling multiple screens, we need to have a screen before
+ * initialization in _nc_setupscreen takes place.  This is to extend the
+ * substitute for some of the stuff in _nc_prescreen, especially for slk and
+ * ripoff handling which should be done per screen.
+ */
+NCURSES_EXPORT(SCREEN *)
+new_prescr(void)
 {
-    int i;
-    char CC;
-    char proto;
-    char *tmp;
+    SCREEN *sp;
 
-    tmp = getenv("CC");
-    CC = *tmp;
-    proto = *command_character;
+    START_TRACE();
+    T((T_CALLED("new_prescr()")));
 
-    for_each_string(i, &(cur_term->type)) {
-       for (tmp = cur_term->type.Strings[i]; *tmp; tmp++) {
-           if (*tmp == proto)
-               *tmp = CC;
+    _nc_lock_global(screen);
+    if ((sp = _nc_find_prescr()) == 0) {
+       sp = _nc_alloc_screen_sp();
+       T(("_nc_alloc_screen_sp %p", (void *) sp));
+       if (sp != 0) {
+#ifdef USE_PTHREADS
+           PRESCREEN_LIST *p = typeCalloc(PRESCREEN_LIST, 1);
+           if (p != 0) {
+               p->id = GetThreadID();
+               p->sp = sp;
+               p->next = _nc_prescreen.allocated;
+               _nc_prescreen.allocated = p;
+           }
+#else
+           _nc_prescreen.allocated = sp;
+#endif
+           sp->rsp = sp->rippedoff;
+           sp->_filtered = _nc_prescreen.filter_mode;
+           sp->_use_env = _nc_prescreen.use_env;
+#if NCURSES_NO_PADDING
+           sp->_no_padding = _nc_prescreen._no_padding;
+#endif
+           sp->slk_format = 0;
+           sp->_slk = 0;
+           sp->_prescreen = TRUE;
+           SP_PRE_INIT(sp);
+#if USE_REENTRANT
+           sp->_TABSIZE = _nc_prescreen._TABSIZE;
+           sp->_ESCDELAY = _nc_prescreen._ESCDELAY;
+#endif
        }
+    } else {
+       T(("_nc_alloc_screen_sp %p (reuse)", (void *) sp));
     }
+    _nc_unlock_global(screen);
+    returnSP(sp);
+}
+#endif
+
+#ifdef USE_TERM_DRIVER
+/*
+ * This entrypoint is called from tgetent() to allow a special case of reusing
+ * the same TERMINAL data (see comment).
+ */
+NCURSES_EXPORT(int)
+_nc_setupterm(const char *tname,
+             int Filedes,
+             int *errret,
+             int reuse)
+{
+    int rc = ERR;
+    TERMINAL *termp = 0;
+
+    _nc_init_pthreads();
+    _nc_lock_global(prescreen);
+    START_TRACE();
+    if (TINFO_SETUP_TERM(&termp, tname, Filedes, errret, reuse) == OK) {
+       _nc_forget_prescr();
+       if (NCURSES_SP_NAME(set_curterm) (CURRENT_SCREEN_PRE, termp) != 0) {
+           rc = OK;
+       }
+    }
+    _nc_unlock_global(prescreen);
+
+    return rc;
+}
+#endif
+
+/*
+ *     setupterm(termname, Filedes, errret)
+ *
+ *     Find and read the appropriate object file for the terminal
+ *     Make cur_term point to the structure.
+ */
+NCURSES_EXPORT(int)
+setupterm(const char *tname, int Filedes, int *errret)
+{
+    START_TRACE();
+    return _nc_setupterm(tname, Filedes, errret, FALSE);
 }