ncurses/tinfo/lib_setup.c

   1 /****************************************************************************
   2  * Copyright 2018-2022,2023 Thomas E. Dickey                                *
   3  * Copyright 1998-2016,2017 Free Software Foundation, Inc.                  *
   4  *                                                                          *
   5  * Permission is hereby granted, free of charge, to any person obtaining a  *
   6  * copy of this software and associated documentation files (the            *
   7  * "Software"), to deal in the Software without restriction, including      *
   8  * without limitation the rights to use, copy, modify, merge, publish,      *
   9  * distribute, distribute with modifications, sublicense, and/or sell       *
  10  * copies of the Software, and to permit persons to whom the Software is    *
  11  * furnished to do so, subject to the following conditions:                 *
  12  *                                                                          *
  13  * The above copyright notice and this permission notice shall be included  *
  14  * in all copies or substantial portions of the Software.                   *
  15  *                                                                          *
  16  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS  *
  17  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF               *
  18  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.   *
  19  * IN NO EVENT SHALL THE ABOVE COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,   *
  20  * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR    *
  21  * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR    *
  22  * THE USE OR OTHER DEALINGS IN THE SOFTWARE.                               *
  23  *                                                                          *
  24  * Except as contained in this notice, the name(s) of the above copyright   *
  25  * holders shall not be used in advertising or otherwise to promote the     *
  26  * sale, use or other dealings in this Software without prior written       *
  27  * authorization.                                                           *
  28  ****************************************************************************/
  29
  30 /****************************************************************************
  31  *  Author: Zeyd M. Ben-Halim <zmbenhal@netcom.com> 1992,1995               *
  32  *     and: Eric S. Raymond <esr@snark.thyrsus.com>                         *
  33  *     and: Thomas E. Dickey                        1996-on                 *
  34  *     and: Juergen Pfeifer                         2009                    *
  35  ****************************************************************************/
  36
  37 /*
  38  * Terminal setup routines common to termcap and terminfo:
  39  *
  40  *              use_env(bool)
  41  *              use_tioctl(bool)
  42  *              setupterm(char *, int, int *)
  43  */
  44
  45 #include <curses.priv.h>
  46 #include <tic.h>                /* for MAX_NAME_SIZE */
  47
  48 #if HAVE_LOCALE_H
  49 #include <locale.h>
  50 #endif
  51
  52 MODULE_ID("$Id: lib_setup.c,v 1.222 2023/09/16 12:29:28 tom Exp $")
  53
  54 /****************************************************************************
  55  *
  56  * Terminal size computation
  57  *
  58  ****************************************************************************/
  59
  60 #if HAVE_SIZECHANGE
  61 # if !defined(sun) || !TERMIOS
  62 #  if HAVE_SYS_IOCTL_H
  63 #   include <sys/ioctl.h>
  64 #  endif
  65 # endif
  66 #endif
  67
  68 #if NEED_PTEM_H
  69  /* On SCO, they neglected to define struct winsize in termios.h -- it is only
  70   * in termio.h and ptem.h (the former conflicts with other definitions).
  71   */
  72 # include <sys/stream.h>
  73 # include <sys/ptem.h>
  74 #endif
  75
  76 #if HAVE_LANGINFO_CODESET
  77 #include <langinfo.h>
  78 #endif
  79
  80 /*
  81  * SCO defines TIOCGSIZE and the corresponding struct.  Other systems (SunOS,
  82  * Solaris, IRIX) define TIOCGWINSZ and struct winsize.
  83  */
  84 #ifdef TIOCGSIZE
  85 # define IOCTL_WINSIZE TIOCGSIZE
  86 # define STRUCT_WINSIZE struct ttysize
  87 # define WINSIZE_ROWS(n) (int)n.ts_lines
  88 # define WINSIZE_COLS(n) (int)n.ts_cols
  89 #else
  90 # ifdef TIOCGWINSZ
  91 #  define IOCTL_WINSIZE TIOCGWINSZ
  92 #  define STRUCT_WINSIZE struct winsize
  93 #  define WINSIZE_ROWS(n) (int)n.ws_row
  94 #  define WINSIZE_COLS(n) (int)n.ws_col
  95 # endif
  96 #endif
  97
  98 /*
  99  * Reduce explicit use of "cur_term" global variable.
 100  */
 101 #undef CUR
 102 #define CUR TerminalType(termp).
 103
 104 /*
 105  * Wrap global variables in this module.
 106  */
 107 #if USE_REENTRANT
 108
 109 NCURSES_EXPORT(char *)
 110 NCURSES_PUBLIC_VAR(ttytype) (void)
 111 {
 112     static char empty[] = "";
 113     char *result = empty;
 114
 115 #if NCURSES_SP_FUNCS
 116     if (CURRENT_SCREEN) {
 117         TERMINAL *termp = TerminalOf(CURRENT_SCREEN);
 118         if (termp != 0) {
 119             result = TerminalType(termp).term_names;
 120         }
 121     }
 122 #else
 123     if (cur_term != 0) {
 124         result = TerminalType(cur_term).term_names;
 125     }
 126 #endif
 127     return result;
 128 }
 129
 130 NCURSES_EXPORT(int *)
 131 _nc_ptr_Lines(SCREEN *sp)
 132 {
 133     return ptrLines(sp);
 134 }
 135
 136 NCURSES_EXPORT(int)
 137 NCURSES_PUBLIC_VAR(LINES) (void)
 138 {
 139     return *_nc_ptr_Lines(CURRENT_SCREEN);
 140 }
 141
 142 NCURSES_EXPORT(int *)
 143 _nc_ptr_Cols(SCREEN *sp)
 144 {
 145     return ptrCols(sp);
 146 }
 147
 148 NCURSES_EXPORT(int)
 149 NCURSES_PUBLIC_VAR(COLS) (void)
 150 {
 151     return *_nc_ptr_Cols(CURRENT_SCREEN);
 152 }
 153
 154 NCURSES_EXPORT(int *)
 155 _nc_ptr_Tabsize(SCREEN *sp)
 156 {
 157     return ptrTabsize(sp);
 158 }
 159
 160 NCURSES_EXPORT(int)
 161 NCURSES_PUBLIC_VAR(TABSIZE) (void)
 162 {
 163     return *_nc_ptr_Tabsize(CURRENT_SCREEN);
 164 }
 165 #else
 166 NCURSES_EXPORT_VAR(char) ttytype[NAMESIZE] = "";
 167 NCURSES_EXPORT_VAR(int) LINES = 0;
 168 NCURSES_EXPORT_VAR(int) COLS = 0;
 169 NCURSES_EXPORT_VAR(int) TABSIZE = 8;
 170 #endif
 171
 172 #if NCURSES_EXT_FUNCS
 173 NCURSES_EXPORT(int)
 174 NCURSES_SP_NAME(set_tabsize) (NCURSES_SP_DCLx int value)
 175 {
 176     int code = OK;
 177     if (value <= 0) {
 178         code = ERR;
 179     } else {
 180 #if USE_REENTRANT
 181         if (SP_PARM) {
 182             SP_PARM->_TABSIZE = value;
 183         } else {
 184             code = ERR;
 185         }
 186 #else
 187         (void) SP_PARM;
 188         TABSIZE = value;
 189 #endif
 190     }
 191     return code;
 192 }
 193
 194 #if NCURSES_SP_FUNCS
 195 NCURSES_EXPORT(int)
 196 set_tabsize(int value)
 197 {
 198     return NCURSES_SP_NAME(set_tabsize) (CURRENT_SCREEN, value);
 199 }
 200 #endif
 201 #endif /* NCURSES_EXT_FUNCS */
 202
 203 #if USE_SIGWINCH
 204 /*
 205  * If we have a pending SIGWINCH, set the flag in each screen.
 206  */
 207 NCURSES_EXPORT(int)
 208 _nc_handle_sigwinch(SCREEN *sp)
 209 {
 210     SCREEN *scan;
 211
 212     if (_nc_globals.have_sigwinch) {
 213         _nc_globals.have_sigwinch = 0;
 214
 215         for (each_screen(scan)) {
 216             scan->_sig_winch = TRUE;
 217         }
 218     }
 219
 220     return (sp ? sp->_sig_winch : 0);
 221 }
 222
 223 #endif
 224
 225 NCURSES_EXPORT(void)
 226 NCURSES_SP_NAME(use_env) (NCURSES_SP_DCLx bool f)
 227 {
 228     START_TRACE();
 229     T((T_CALLED("use_env(%p,%d)"), (void *) SP_PARM, (int) f));
 230 #if NCURSES_SP_FUNCS
 231     if (IsPreScreen(SP_PARM)) {
 232         SP_PARM->_use_env = f;
 233     }
 234 #else
 235     _nc_prescreen.use_env = f;
 236 #endif
 237     returnVoid;
 238 }
 239
 240 NCURSES_EXPORT(void)
 241 NCURSES_SP_NAME(use_tioctl) (NCURSES_SP_DCLx bool f)
 242 {
 243     START_TRACE();
 244     T((T_CALLED("use_tioctl(%p,%d)"), (void *) SP_PARM, (int) f));
 245 #if NCURSES_SP_FUNCS
 246     if (IsPreScreen(SP_PARM)) {
 247         SP_PARM->use_tioctl = f;
 248     }
 249 #else
 250     _nc_prescreen.use_tioctl = f;
 251 #endif
 252     returnVoid;
 253 }
 254
 255 #if NCURSES_SP_FUNCS
 256 NCURSES_EXPORT(void)
 257 use_env(bool f)
 258 {
 259     START_TRACE();
 260     T((T_CALLED("use_env(%d)"), (int) f));
 261     _nc_prescreen.use_env = f;
 262     returnVoid;
 263 }
 264
 265 NCURSES_EXPORT(void)
 266 use_tioctl(bool f)
 267 {
 268     START_TRACE();
 269     T((T_CALLED("use_tioctl(%d)"), (int) f));
 270     _nc_prescreen.use_tioctl = f;
 271     returnVoid;
 272 }
 273 #endif
 274
 275 NCURSES_EXPORT(void)
 276 _nc_get_screensize(SCREEN *sp,
 277 #ifdef USE_TERM_DRIVER
 278                    TERMINAL *termp,
 279 #endif
 280                    int *linep, int *colp)
 281 /* Obtain lines/columns values from the environment and/or terminfo entry */
 282 {
 283 #ifdef USE_TERM_DRIVER
 284     TERMINAL_CONTROL_BLOCK *TCB;
 285     int my_tabsize;
 286
 287     assert(termp != 0 && linep != 0 && colp != 0);
 288     TCB = (TERMINAL_CONTROL_BLOCK *) termp;
 289
 290     my_tabsize = TCB->info.tabsize;
 291     TCB->drv->td_size(TCB, linep, colp);
 292
 293 #if USE_REENTRANT
 294     if (sp != 0) {
 295         sp->_TABSIZE = my_tabsize;
 296     }
 297 #else
 298     (void) sp;
 299     TABSIZE = my_tabsize;
 300 #endif
 301     T(("TABSIZE = %d", my_tabsize));
 302 #else /* !USE_TERM_DRIVER */
 303     TERMINAL *termp = cur_term;
 304     int my_tabsize;
 305     bool useEnv = _nc_prescreen.use_env;
 306     bool useTioctl = _nc_prescreen.use_tioctl;
 307
 308 #ifdef EXP_WIN32_DRIVER
 309     /* If we are here, then Windows console is used in terminfo mode.
 310        We need to figure out the size using the console API
 311      */
 312     _nc_console_size(linep, colp);
 313     T(("screen size: winconsole lines = %d columns = %d", *linep, *colp));
 314 #else
 315     /* figure out the size of the screen */
 316     T(("screen size: terminfo lines = %d columns = %d", lines, columns));
 317
 318     *linep = (int) lines;
 319     *colp = (int) columns;
 320 #endif
 321
 322 #if NCURSES_SP_FUNCS
 323     if (sp) {
 324         useEnv = sp->_use_env;
 325         useTioctl = sp->use_tioctl;
 326     }
 327 #endif
 328
 329     if (useEnv || useTioctl) {
 330 #ifdef __EMX__
 331         {
 332             int screendata[2];
 333             _scrsize(screendata);
 334             *colp = screendata[0];
 335             *linep = ((sp != 0 && sp->_filtered)
 336                       ? 1
 337                       : screendata[1]);
 338             T(("EMX screen size: environment LINES = %d COLUMNS = %d",
 339                *linep, *colp));
 340         }
 341 #endif
 342 #if HAVE_SIZECHANGE
 343         /* try asking the OS */
 344         if (NC_ISATTY(cur_term->Filedes)) {
 345             STRUCT_WINSIZE size;
 346
 347             errno = 0;
 348             do {
 349                 if (ioctl(cur_term->Filedes, IOCTL_WINSIZE, &size) >= 0) {
 350                     *linep = ((sp != 0 && sp->_filtered)
 351                               ? 1
 352                               : WINSIZE_ROWS(size));
 353                     *colp = WINSIZE_COLS(size);
 354                     T(("SYS screen size: environment LINES = %d COLUMNS = %d",
 355                        *linep, *colp));
 356                     break;
 357                 }
 358             } while
 359                 (errno == EINTR);
 360         }
 361 #endif /* HAVE_SIZECHANGE */
 362
 363         if (useEnv) {
 364             int value;
 365
 366             if (useTioctl) {
 367                 /*
 368                  * If environment variables are used, update them.
 369                  */
 370                 if ((sp == 0 || !sp->_filtered) && _nc_getenv_num("LINES") > 0) {
 371                     _nc_setenv_num("LINES", *linep);
 372                 }
 373                 if (_nc_getenv_num("COLUMNS") > 0) {
 374                     _nc_setenv_num("COLUMNS", *colp);
 375                 }
 376             }
 377
 378             /*
 379              * Finally, look for environment variables.
 380              *
 381              * Solaris lets users override either dimension with an environment
 382              * variable.
 383              */
 384             if ((value = _nc_getenv_num("LINES")) > 0) {
 385                 *linep = value;
 386                 T(("screen size: environment LINES = %d", *linep));
 387             }
 388             if ((value = _nc_getenv_num("COLUMNS")) > 0) {
 389                 *colp = value;
 390                 T(("screen size: environment COLUMNS = %d", *colp));
 391             }
 392         }
 393
 394         /* if we can't get dynamic info about the size, use static */
 395         if (*linep <= 0) {
 396             *linep = (int) lines;
 397         }
 398         if (*colp <= 0) {
 399             *colp = (int) columns;
 400         }
 401
 402         /* the ultimate fallback, assume fixed 24x80 size */
 403         if (*linep <= 0) {
 404             *linep = 24;
 405         }
 406         if (*colp <= 0) {
 407             *colp = 80;
 408         }
 409
 410         /*
 411          * Put the derived values back in the screen-size caps, so
 412          * tigetnum() and tgetnum() will do the right thing.
 413          */
 414         lines = (NCURSES_INT2) (*linep);
 415         columns = (NCURSES_INT2) (*colp);
 416 #if NCURSES_EXT_NUMBERS
 417 #define OldNumber(termp,name) \
 418         (termp)->type.Numbers[(&name - (termp)->type2.Numbers)]
 419         OldNumber(termp, lines) = (short) (*linep);
 420         OldNumber(termp, columns) = (short) (*colp);
 421 #endif
 422     }
 423
 424     T(("screen size is %dx%d", *linep, *colp));
 425
 426     if (VALID_NUMERIC(init_tabs))
 427         my_tabsize = (int) init_tabs;
 428     else
 429         my_tabsize = 8;
 430
 431 #if USE_REENTRANT
 432     if (sp != 0)
 433         sp->_TABSIZE = my_tabsize;
 434 #else
 435     TABSIZE = my_tabsize;
 436 #endif
 437     T(("TABSIZE = %d", TABSIZE));
 438 #endif /* USE_TERM_DRIVER */
 439 }
 440
 441 #if USE_SIZECHANGE
 442 NCURSES_EXPORT(void)
 443 _nc_update_screensize(SCREEN *sp)
 444 {
 445     int new_lines;
 446     int new_cols;
 447
 448 #ifdef USE_TERM_DRIVER
 449     int old_lines;
 450     int old_cols;
 451
 452     assert(sp != 0);
 453
 454     CallDriver_2(sp, td_getsize, &old_lines, &old_cols);
 455
 456 #else
 457     TERMINAL *termp = cur_term;
 458     int old_lines = lines;
 459     int old_cols = columns;
 460 #endif
 461
 462     if (sp != 0) {
 463         TINFO_GET_SIZE(sp, sp->_term, &new_lines, &new_cols);
 464         /*
 465          * See is_term_resized() and resizeterm().
 466          * We're doing it this way because those functions belong to the upper
 467          * ncurses library, while this resides in the lower terminfo library.
 468          */
 469         if (sp->_resize != 0) {
 470             if ((new_lines != old_lines) || (new_cols != old_cols)) {
 471                 sp->_resize(NCURSES_SP_ARGx new_lines, new_cols);
 472             } else if (sp->_sig_winch && (sp->_ungetch != 0)) {
 473                 sp->_ungetch(SP_PARM, KEY_RESIZE);      /* so application can know this */
 474             }
 475             sp->_sig_winch = FALSE;
 476         }
 477     }
 478 }
 479 #endif /* USE_SIZECHANGE */
 480
 481 /****************************************************************************
 482  *
 483  * Terminal setup
 484  *
 485  ****************************************************************************/
 486
 487 #if NCURSES_USE_DATABASE || NCURSES_USE_TERMCAP
 488 /*
 489  * Return 1 if entry found, 0 if not found, -1 if database not accessible,
 490  * just like tgetent().
 491  */
 492 int
 493 _nc_setup_tinfo(const char *const tn, TERMTYPE2 *const tp)
 494 {
 495     char filename[PATH_MAX];
 496     int status = _nc_read_entry2(tn, filename, tp);
 497
 498     /*
 499      * If we have an entry, force all of the cancelled strings to null
 500      * pointers so we don't have to test them in the rest of the library.
 501      * (The terminfo compiler bypasses this logic, since it must know if
 502      * a string is cancelled, for merging entries).
 503      */
 504     if (status == TGETENT_YES) {
 505         unsigned n;
 506         T(("_nc_setup_tinfo - resetting invalid booleans/strings"));
 507         for_each_boolean(n, tp) {
 508             if (!VALID_BOOLEAN(tp->Booleans[n]))
 509                 tp->Booleans[n] = FALSE;
 510         }
 511         for_each_string(n, tp) {
 512             if (tp->Strings[n] == CANCELLED_STRING)
 513                 tp->Strings[n] = ABSENT_STRING;
 514         }
 515     }
 516     return (status);
 517 }
 518 #endif
 519
 520 /*
 521  * Take the real command character out of the CC environment variable
 522  * and substitute it in for the prototype given in 'command_character'.
 523  */
 524 void
 525 _nc_tinfo_cmdch(TERMINAL *termp, int proto)
 526 {
 527     char *tmp;
 528
 529     /*
 530      * Only use the character if the string is a single character,
 531      * since it is fairly common for developers to set the C compiler
 532      * name as an environment variable - using the same symbol.
 533      */
 534     if ((tmp = getenv("CC")) != 0 && strlen(tmp) == 1) {
 535         unsigned i;
 536         char CC = *tmp;
 537
 538         for_each_string(i, &(termp->type)) {
 539             tmp = termp->type.Strings[i];
 540             if (VALID_STRING(tmp)) {
 541                 for (; *tmp; ++tmp) {
 542                     if (UChar(*tmp) == proto)
 543                         *tmp = CC;
 544                 }
 545             }
 546         }
 547     }
 548 }
 549
 550 /*
 551  * Find the locale which is in effect.
 552  */
 553 NCURSES_EXPORT(char *)
 554 _nc_get_locale(void)
 555 {
 556     char *env;
 557 #if HAVE_LOCALE_H
 558     /*
 559      * This is preferable to using getenv() since it ensures that we are using
 560      * the locale which was actually initialized by the application.
 561      */
 562     env = setlocale(LC_CTYPE, 0);
 563 #else
 564     if (((env = getenv("LANG")) != 0 && *env != '\0')
 565         || ((env = getenv("LC_CTYPE")) != 0 && *env != '\0')
 566         || ((env = getenv("LC_ALL")) != 0 && *env != '\0')) {
 567         ;
 568     }
 569 #endif
 570     T(("_nc_get_locale %s", _nc_visbuf(env)));
 571     return env;
 572 }
 573
 574 /*
 575  * Check if we are running in a UTF-8 locale.
 576  */
 577 NCURSES_EXPORT(int)
 578 _nc_unicode_locale(void)
 579 {
 580     int result = 0;
 581 #if defined(_NC_WINDOWS) && USE_WIDEC_SUPPORT
 582     result = 1;
 583 #elif HAVE_LANGINFO_CODESET
 584     char *env = nl_langinfo(CODESET);
 585     result = !strcmp(env, "UTF-8");
 586     T(("_nc_unicode_locale(%s) ->%d", env, result));
 587 #else
 588     char *env = _nc_get_locale();
 589     if (env != 0) {
 590         if (strstr(env, ".UTF-8") != 0) {
 591             result = 1;
 592             T(("_nc_unicode_locale(%s) ->%d", env, result));
 593         }
 594     }
 595 #endif
 596     return result;
 597 }
 598
 599 #define CONTROL_N(s) ((s) != 0 && strstr(s, "\016") != 0)
 600 #define CONTROL_O(s) ((s) != 0 && strstr(s, "\017") != 0)
 601
 602 /*
 603  * Check for known broken cases where a UTF-8 locale breaks the alternate
 604  * character set.
 605  */
 606 NCURSES_EXPORT(int)
 607 _nc_locale_breaks_acs(TERMINAL *termp)
 608 {
 609     const char *env_name = "NCURSES_NO_UTF8_ACS";
 610     const char *env;
 611     int value;
 612     int result = 0;
 613
 614     T((T_CALLED("_nc_locale_breaks_acs:%d"), result));
 615     if (getenv(env_name) != 0) {
 616         result = _nc_getenv_num(env_name);
 617     } else if ((value = tigetnum("U8")) >= 0) {
 618         result = value;         /* use extension feature */
 619     } else if ((env = getenv("TERM")) != 0) {
 620         if (strstr(env, "linux")) {
 621             result = 1;         /* always broken */
 622         } else if (strstr(env, "screen") != 0
 623                    && ((env = getenv("TERMCAP")) != 0
 624                        && strstr(env, "screen") != 0)
 625                    && strstr(env, "hhII00") != 0) {
 626             if (CONTROL_N(enter_alt_charset_mode) ||
 627                 CONTROL_O(enter_alt_charset_mode) ||
 628                 CONTROL_N(set_attributes) ||
 629                 CONTROL_O(set_attributes)) {
 630                 result = 1;
 631             }
 632         }
 633     }
 634     returnCode(result);
 635 }
 636
 637 NCURSES_EXPORT(int)
 638 TINFO_SETUP_TERM(TERMINAL **tp,
 639                  const char *tname,
 640                  int Filedes,
 641                  int *errret,
 642                  int reuse)
 643 {
 644 #ifdef USE_TERM_DRIVER
 645     TERMINAL_CONTROL_BLOCK *TCB = 0;
 646 #endif
 647     TERMINAL *termp;
 648     SCREEN *sp = 0;
 649     char *myname;
 650     int code = ERR;
 651
 652     START_TRACE();
 653
 654 #ifdef USE_TERM_DRIVER
 655     T((T_CALLED("_nc_setupterm_ex(%p,%s,%d,%p)"),
 656        (void *) tp, _nc_visbuf(tname), Filedes, (void *) errret));
 657
 658     if (tp == 0) {
 659         ret_error0(TGETENT_ERR,
 660                    "Invalid parameter, internal error.\n");
 661     } else
 662         termp = *tp;
 663 #else
 664     termp = cur_term;
 665     T((T_CALLED("setupterm(%s,%d,%p)"), _nc_visbuf(tname), Filedes, (void *) errret));
 666 #endif
 667
 668     if (tname == 0) {
 669         tname = getenv("TERM");
 670 #if defined(EXP_WIN32_DRIVER)
 671         if (!VALID_TERM_ENV(tname, NO_TERMINAL)) {
 672             T(("Failure with TERM=%s", NonNull(tname)));
 673             ret_error0(TGETENT_ERR, "TERM environment variable not set.\n");
 674         }
 675 #elif defined(USE_TERM_DRIVER)
 676         if (!NonEmpty(tname))
 677             tname = "unknown";
 678 #else
 679         if (!NonEmpty(tname)) {
 680             T(("Failure with TERM=%s", NonNull(tname)));
 681             ret_error0(TGETENT_ERR, "TERM environment variable not set.\n");
 682         }
 683 #endif
 684     }
 685     myname = strdup(tname);
 686     if (myname == NULL || strlen(myname) > MAX_NAME_SIZE) {
 687         ret_error(TGETENT_ERR,
 688                   "TERM environment must be 1..%d characters.\n",
 689                   MAX_NAME_SIZE,
 690                   free(myname));
 691     }
 692
 693     T(("your terminal name is %s", myname));
 694
 695     /*
 696      * Allow output redirection.  This is what SVr3 does.  If stdout is
 697      * directed to a file, screen updates go to standard error.
 698      */
 699     if (Filedes == STDOUT_FILENO && !NC_ISATTY(Filedes))
 700         Filedes = STDERR_FILENO;
 701 #if defined(EXP_WIN32_DRIVER)
 702     if (Filedes != STDERR_FILENO && NC_ISATTY(Filedes))
 703         _setmode(Filedes, _O_BINARY);
 704 #endif
 705
 706     /*
 707      * Check if we have already initialized to use this terminal.  If so, we
 708      * do not need to re-read the terminfo entry, or obtain TTY settings.
 709      *
 710      * This is an improvement on SVr4 curses.  If an application mixes curses
 711      * and termcap calls, it may call both initscr and tgetent.  This is not
 712      * really a good thing to do, but can happen if someone tries using ncurses
 713      * with the readline library.  The problem we are fixing is that when
 714      * tgetent calls setupterm, the resulting Ottyb struct in cur_term is
 715      * zeroed.  A subsequent call to endwin uses the zeroed terminal settings
 716      * rather than the ones saved in initscr.  So we check if cur_term appears
 717      * to contain terminal settings for the same output file as our current
 718      * call - and copy those terminal settings.  (SVr4 curses does not do this,
 719      * however applications that are working around the problem will still work
 720      * properly with this feature).
 721      */
 722     if (reuse
 723         && (termp != 0)
 724         && termp->Filedes == Filedes
 725         && termp->_termname != 0
 726         && !strcmp(termp->_termname, myname)
 727         && _nc_name_match(TerminalType(termp).term_names, myname, "|")) {
 728         T(("reusing existing terminal information and mode-settings"));
 729         code = OK;
 730 #ifdef USE_TERM_DRIVER
 731         TCB = (TERMINAL_CONTROL_BLOCK *) termp;
 732 #endif
 733     } else {
 734 #ifdef USE_TERM_DRIVER
 735         TERMINAL_CONTROL_BLOCK *my_tcb;
 736         termp = 0;
 737         if ((my_tcb = typeCalloc(TERMINAL_CONTROL_BLOCK, 1)) != 0)
 738             termp = &(my_tcb->term);
 739 #else
 740         int status;
 741
 742         termp = typeCalloc(TERMINAL, 1);
 743 #endif
 744         if (termp == 0) {
 745             ret_error1(TGETENT_ERR,
 746                        "Not enough memory to create terminal structure.\n",
 747                        myname, free(myname));
 748         }
 749         ++_nc_globals.terminal_count;
 750 #if HAVE_SYSCONF
 751         {
 752             long limit;
 753 #ifdef LINE_MAX
 754             limit = LINE_MAX;
 755 #else
 756             limit = _nc_globals.getstr_limit;
 757 #endif
 758 #ifdef _SC_LINE_MAX
 759             if (limit < sysconf(_SC_LINE_MAX))
 760                 limit = sysconf(_SC_LINE_MAX);
 761 #endif
 762             if (_nc_globals.getstr_limit < (int) limit)
 763                 _nc_globals.getstr_limit = (int) limit;
 764         }
 765 #endif /* HAVE_SYSCONF */
 766         T(("using %d for getstr limit", _nc_globals.getstr_limit));
 767
 768 #ifdef USE_TERM_DRIVER
 769         INIT_TERM_DRIVER();
 770         /*
 771          * _nc_get_driver() will call td_CanHandle() for each driver, and win_driver
 772          * needs file descriptor to do the test, so set it before calling.
 773          */
 774         termp->Filedes = (short) Filedes;
 775         TCB = (TERMINAL_CONTROL_BLOCK *) termp;
 776         code = _nc_globals.term_driver(TCB, myname, errret);
 777         if (code == OK) {
 778             termp->_termname = strdup(myname);
 779         } else {
 780             ret_error1(errret ? *errret : TGETENT_ERR,
 781                        "Could not find any driver to handle terminal.\n",
 782                        myname, free(myname));
 783         }
 784 #else
 785 #if NCURSES_USE_DATABASE || NCURSES_USE_TERMCAP
 786         status = _nc_setup_tinfo(myname, &TerminalType(termp));
 787         T(("_nc_setup_tinfo returns %d", status));
 788 #else
 789         T(("no database available"));
 790         status = TGETENT_NO;
 791 #endif
 792
 793         /* try fallback list if entry on disk */
 794         if (status != TGETENT_YES) {
 795             const TERMTYPE2 *fallback = _nc_fallback2(myname);
 796
 797             if (fallback) {
 798                 T(("found fallback entry"));
 799                 _nc_copy_termtype2(&(TerminalType(termp)), fallback);
 800                 status = TGETENT_YES;
 801             }
 802         }
 803
 804         if (status != TGETENT_YES) {
 805             del_curterm(termp);
 806             if (status == TGETENT_ERR) {
 807                 free(myname);
 808                 ret_error0(status, "terminals database is inaccessible\n");
 809             } else if (status == TGETENT_NO) {
 810                 ret_error1(status, "unknown terminal type.\n",
 811                            myname, free(myname));
 812             } else {
 813                 free(myname);
 814                 ret_error0(status, "unexpected return-code\n");
 815             }
 816         }
 817 #if NCURSES_EXT_NUMBERS
 818         _nc_export_termtype2(&termp->type, &TerminalType(termp));
 819 #endif
 820 #if !USE_REENTRANT
 821         save_ttytype(termp);
 822 #endif
 823
 824         termp->Filedes = (short) Filedes;
 825         termp->_termname = strdup(myname);
 826
 827         set_curterm(termp);
 828
 829         if (VALID_STRING(command_character))
 830             _nc_tinfo_cmdch(termp, UChar(*command_character));
 831
 832         /*
 833          * If an application calls setupterm() rather than initscr() or
 834          * newterm(), we will not have the def_prog_mode() call in
 835          * _nc_setupscreen().  Do it now anyway, so we can initialize the
 836          * baudrate.  Also get the shell-mode so that erasechar() works.
 837          */
 838         if (NC_ISATTY(Filedes)) {
 839             NCURSES_SP_NAME(def_shell_mode) (NCURSES_SP_ARG);
 840             NCURSES_SP_NAME(def_prog_mode) (NCURSES_SP_ARG);
 841             NCURSES_SP_NAME(baudrate) (NCURSES_SP_ARG);
 842         }
 843         code = OK;
 844 #endif
 845     }
 846
 847 #ifdef USE_TERM_DRIVER
 848     *tp = termp;
 849     NCURSES_SP_NAME(set_curterm) (sp, termp);
 850     TCB->drv->td_init(TCB);
 851 #else
 852     sp = SP;
 853 #endif
 854
 855     /*
 856      * We should always check the screensize, just in case.
 857      */
 858     TINFO_GET_SIZE(sp, termp, ptrLines(sp), ptrCols(sp));
 859
 860     if (errret)
 861         *errret = TGETENT_YES;
 862
 863 #ifndef USE_TERM_DRIVER
 864     if (generic_type) {
 865         /*
 866          * BSD 4.3's termcap contains mis-typed "gn" for wy99.  Do a sanity
 867          * check before giving up.
 868          */
 869         if ((VALID_STRING(cursor_address)
 870              || (VALID_STRING(cursor_down) && VALID_STRING(cursor_home)))
 871             && VALID_STRING(clear_screen)) {
 872             ret_error1(TGETENT_YES, "terminal is not really generic.\n",
 873                        myname, free(myname));
 874         } else {
 875             del_curterm(termp);
 876             ret_error1(TGETENT_NO, "I need something more specific.\n",
 877                        myname, free(myname));
 878         }
 879     } else if (hard_copy) {
 880         ret_error1(TGETENT_YES, "I can't handle hardcopy terminals.\n",
 881                    myname, free(myname));
 882     }
 883 #endif
 884     free(myname);
 885     returnCode(code);
 886 }
 887
 888 #ifdef USE_PTHREADS
 889 /*
 890  * Returns a non-null pointer unless a new screen should be allocated because
 891  * no match was found in the pre-screen cache.
 892  */
 893 NCURSES_EXPORT(SCREEN *)
 894 _nc_find_prescr(void)
 895 {
 896     SCREEN *result = 0;
 897     PRESCREEN_LIST *p;
 898     pthread_t id = GetThreadID();
 899     for (p = _nc_prescreen.allocated; p != 0; p = p->next) {
 900         if (p->id == id) {
 901             result = p->sp;
 902             break;
 903         }
 904     }
 905     return result;
 906 }
 907
 908 /*
 909  * Tells ncurses to forget that this thread was associated with the pre-screen
 910  * cache.  It does not modify the pre-screen cache itself, since that is used
 911  * for creating new screens.
 912  */
 913 NCURSES_EXPORT(void)
 914 _nc_forget_prescr(void)
 915 {
 916     PRESCREEN_LIST *p, *q;
 917     pthread_t id = GetThreadID();
 918     _nc_lock_global(screen);
 919     for (p = _nc_prescreen.allocated, q = 0; p != 0; q = p, p = p->next) {
 920         if (p->id == id) {
 921             if (q) {
 922                 q->next = p->next;
 923             } else {
 924                 _nc_prescreen.allocated = p->next;
 925             }
 926             free(p);
 927             break;
 928         }
 929     }
 930     _nc_unlock_global(screen);
 931 }
 932 #endif /* USE_PTHREADS */
 933
 934 #if NCURSES_SP_FUNCS
 935 /*
 936  * In case of handling multiple screens, we need to have a screen before
 937  * initialization in _nc_setupscreen takes place.  This is to extend the
 938  * substitute for some of the stuff in _nc_prescreen, especially for slk and
 939  * ripoff handling which should be done per screen.
 940  */
 941 NCURSES_EXPORT(SCREEN *)
 942 new_prescr(void)
 943 {
 944     SCREEN *sp;
 945
 946     START_TRACE();
 947     T((T_CALLED("new_prescr()")));
 948
 949     _nc_lock_global(screen);
 950     if ((sp = _nc_find_prescr()) == 0) {
 951         sp = _nc_alloc_screen_sp();
 952         T(("_nc_alloc_screen_sp %p", (void *) sp));
 953         if (sp != 0) {
 954 #ifdef USE_PTHREADS
 955             PRESCREEN_LIST *p = typeCalloc(PRESCREEN_LIST, 1);
 956             if (p != 0) {
 957                 p->id = GetThreadID();
 958                 p->sp = sp;
 959                 p->next = _nc_prescreen.allocated;
 960                 _nc_prescreen.allocated = p;
 961             }
 962 #else
 963             _nc_prescreen.allocated = sp;
 964 #endif
 965             sp->rsp = sp->rippedoff;
 966             sp->_filtered = _nc_prescreen.filter_mode;
 967             sp->_use_env = _nc_prescreen.use_env;
 968 #if NCURSES_NO_PADDING
 969             sp->_no_padding = _nc_prescreen._no_padding;
 970 #endif
 971             sp->slk_format = 0;
 972             sp->_slk = 0;
 973             sp->_prescreen = TRUE;
 974             SP_PRE_INIT(sp);
 975 #if USE_REENTRANT
 976             sp->_TABSIZE = _nc_prescreen._TABSIZE;
 977             sp->_ESCDELAY = _nc_prescreen._ESCDELAY;
 978 #endif
 979         }
 980     } else {
 981         T(("_nc_alloc_screen_sp %p (reuse)", (void *) sp));
 982     }
 983     _nc_unlock_global(screen);
 984     returnSP(sp);
 985 }
 986 #endif
 987
 988 #ifdef USE_TERM_DRIVER
 989 /*
 990  * This entrypoint is called from tgetent() to allow a special case of reusing
 991  * the same TERMINAL data (see comment).
 992  */
 993 NCURSES_EXPORT(int)
 994 _nc_setupterm(const char *tname,
 995               int Filedes,
 996               int *errret,
 997               int reuse)
 998 {
 999     int rc = ERR;
1000     TERMINAL *termp = 0;
1001
1002     _nc_init_pthreads();
1003     _nc_lock_global(prescreen);
1004     START_TRACE();
1005     if (TINFO_SETUP_TERM(&termp, tname, Filedes, errret, reuse) == OK) {
1006         _nc_forget_prescr();
1007         if (NCURSES_SP_NAME(set_curterm) (CURRENT_SCREEN_PRE, termp) != 0) {
1008             rc = OK;
1009         }
1010     }
1011     _nc_unlock_global(prescreen);
1012
1013     return rc;
1014 }
1015 #endif
1016
1017 /*
1018  *      setupterm(termname, Filedes, errret)
1019  *
1020  *      Find and read the appropriate object file for the terminal
1021  *      Make cur_term point to the structure.
1022  */
1023 NCURSES_EXPORT(int)
1024 setupterm(const char *tname, int Filedes, int *errret)
1025 {
1026     START_TRACE();
1027     return _nc_setupterm(tname, Filedes, errret, FALSE);
1028 }