1toe(1M)                                                                toe(1M)
2
3
4

NAME

6       toe - table of (terminfo) entries
7

SYNOPSIS

9       toe [-v[n]] [-ahsuUV] file...
10

DESCRIPTION

12       With no options, toe lists all available terminal types by primary name
13       with descriptions.   File  arguments  specify  the  directories  to  be
14       scanned;  if  no such arguments are given, your default terminfo direc‐
15       tory is scanned.  If you also specify the -h option, a directory header
16       will be issued as each directory is entered.
17
18       There are other options intended for use by terminfo file maintainers:
19
20       -a     report  on  all  of  the  terminal databases which ncurses would
21              search, rather than only the first one that it finds.
22
23              If the -s is also given, toe adds a column to the report,  show‐
24              ing  (like  conflict(1))  which  entries which belong to a given
25              terminal database.  An "*" marks entries which differ,  and  "+"
26              marks equivalent entries.
27
28              Without  the -s option, toe does not attempt to merge duplicates
29              in its report
30
31       -s     sort the output by the entry names.
32
33       -u file
34              says to write a report to the standard output, listing dependen‐
35              cies in the given terminfo/termcap source file.  The report con‐
36              denses the “use” relation: each line  consists  of  the  primary
37              name  of  a  terminal  that  has use capabilities, followed by a
38              colon, followed by the whitespace-separated primary names of all
39              terminals  which  occur in those use capabilities, followed by a
40              newline
41
42       -U file
43              says to write a report to the standard output,  listing  reverse
44              dependencies in the given terminfo/termcap source file.  The re‐
45              port reverses the “use” relation: each line consists of the pri‐
46              mary  name  of  a terminal that occurs in use capabilities, fol‐
47              lowed by a colon, followed by the  whitespace-separated  primary
48              names  of  all  terminals which depend on it, followed by a new‐
49              line.
50
51       -vn    specifies that (verbose) output be written  to  standard  error,
52              showing toe's progress.
53
54              The  optional  parameter n is a number from 1 to 10, interpreted
55              as for tic(1M).  If ncurses is built  without  tracing  support,
56              the optional parameter is ignored.
57
58       -V     reports  the  version of ncurses which was used in this program,
59              and exits.
60

EXAMPLES

62       Without sorting, the -a option reports all of the names found in all of
63       the terminal databases found by the TERMINFO and TERMINFO_DIRS environ‐
64       ment variables:
65
66           MtxOrb162      16x2 Matrix Orbital LCD display
67           MtxOrb204      20x4 Matrix Orbital LCD display
68           MtxOrb         Generic Matrix Orbital LCD display
69           qvt101+        qume qvt 101 PLUS product
70           qvt119+-25     QVT 119 PLUS with 25 data lines
71           qansi-g        QNX ANSI
72           qvt103         qume qvt 103
73           qnxw           QNX4 windows
74           qansi-w        QNX ansi for windows
75           qnxm           QNX4 with mouse events
76           qvt203-25-w    QVT 203 PLUS with 25 by 132 columns
77           qansi-t        QNX ansi without console writes
78           . . .
79
80       Use the -a and -s options together to show where each terminal descrip‐
81       tion was found:
82
83           --> /usr/local/ncurses/share/terminfo
84           ----> /usr/share/terminfo
85           *-+-:     9term          Plan9 terminal emulator for X
86           *---:     Eterm          Eterm with xterm-style color support (X Window System)
87           *-*-:     Eterm-256color Eterm with xterm 256-colors
88           *-*-:     Eterm-88color  Eterm with 88 colors
89           *-+-:     MtxOrb         Generic Matrix Orbital LCD display
90           *-+-:     MtxOrb162      16x2 Matrix Orbital LCD display
91           *-+-:     MtxOrb204      20x4 Matrix Orbital LCD display
92           *-*-:     NCR260VT300WPP NCR 2900_260 vt300 wide mode pc+  kybd
93           *-+-:     aaa            ann arbor ambassador/30 lines
94           *-+-:     aaa+dec        ann arbor ambassador in dec vt100 mode
95           *-+-:     aaa+rv         ann arbor ambassador in reverse video
96           . . .
97

FILES

99       /usr/share/terminfo/?/*
100            Compiled terminal description database.
101

HISTORY

103       This  utility  is  not  provided by other implementations.  There is no
104       relevant X/Open or POSIX standard for toe.
105
106       The program name refers to a developer's pun:
107
108       •   tic,
109
110       •   tac (now tack),
111
112       •   toe.
113
114       It replaced a -T option which was briefly supported by the ncurses  in‐
115       focmp utility in 1995.
116
117       The  -a  and -s options were added to toe several years later (2006 and
118       2011, respectively).
119

SEE ALSO

121       captoinfo(1M), infocmp(1M), infotocap(1M),  tic(1M),  curses(3X),  ter‐
122       minfo(5).
123
124       This describes ncurses version 6.3 (patch 20220501).
125
126
127
128                                                                       toe(1M)