termcap(3x)                DG/UX 4.30                 termcap(3x)



     NAME
          tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs - terminal
          independent operation routines

     SYNOPSIS
          char PC;
          char *BC;
          char *UP;
          short ospeed;

          tgetent(bp, name)
          char *bp, *name;

          tgetnum(id)
          char *id;

          tgetflag(id)
          char *id;

          char *
          tgetstr(id, area)
          char *id, **area;

          char *
          tgoto(cm, destcol, destline)
          char *cm;
          int destcol, destline;

          tputs(cp, affcnt, outc)
          register char *cp;
          int affcnt;
          int (*outc)();

     DESCRIPTION
          These functions extract and use routines from the terminal
          capability data base termcap(5).  These are obsolete low
          level routines; see terminfo(4) for an equivalent but more
          modern package, and curses(3X) for a higher level package.

          Tgetent extracts the entry for terminal name into the buffer
          at bp. Bp should be a character buffer of size 1024 and must
          be retained through all subsequent calls to tgetnum,
          tgetflag, and tgetstr. Tgetent returns -1 if it cannot open
          the termcap file, 0 if the terminal name given does not have
          an entry, and 1 if all goes well.

          Tgetent looks in the environment for a TERMCAP variable.  If
          it is found, and its value does not begin with a slash, and
          the terminal type name is the same as the environment string
          TERM, the TERMCAP string is used instead of reading the
          termcap file.  If it does begin with a slash, the string is
          used as a path name rather than /etc/termcap. This can speed



     Licensed material--property of copyright holder(s)         Page 1

     termcap(3x)                DG/UX 4.30                 termcap(3x)



          up entry into programs that call tgetent; it will also help
          you debug new terminal descriptions or to make one for your
          terminal if you can't write the file /etc/termcap.

          Tgetnum gets the numeric value of capability id, returning
          -1 if is not given for the terminal.  Tgetflag returns 1 if
          the specified capability is present in the terminal's entry,
          0 if it is not.  Tgetstr gets the string value of capability
          id, placing it in the buffer at *area, and advancing the
          area pointer.  It decodes the abbreviations for this field
          described in termcap(5), except for cursor addressing and
          padding information.

          Tgoto returns a cursor addressing string decoded from cm to
          go to column destcol in line destline. It uses the external
          variables UP (from the up capability) and BC (if bc is given
          rather than bs) if necessary to avoid placing \n, \r, ^D,
          ^H, or ^@ in the returned string.

          Programs which call tgoto should be sure to turn off tab
          expansion into spaces in the terminal driver since tgoto may
          now output a tab.  Note that programs using termcap should
          turn off tab expansion anyway since some terminals use the
          tab character (^I) for other functions.  If a % sequence is
          given which is not understood, then tgoto returns "OOPS".

          Tputs decodes the leading padding information of the string
          cp; affcnt is the number of lines affected by the operation,
          or 1 if this is not applicable.  Outc is a routine that is
          called with each character in turn.  The external variable
          ospeed should contain the output speed of the terminal as
          encoded by ioctl (2) The external variable PC should contain
          a pad character to be used (from the pc capability) if a
          null (^@) is inappropriate.

     FILES
          /lib/libtermcap.a      -ltermcap library
          /etc/termcap           terminal information data base

     SEE ALSO
          curses(3x), terminfo (4), termcap (5).
          captoinfo(1M), infocmp (1M) in the System Manager's
          Reference for the DG/UX System.












     Licensed material--property of copyright holder(s)         Page 2