1 /* $NetBSD: cl_screen.c,v 1.3 2013/11/25 22:43:46 christos Exp $ */
3 * Copyright (c) 1993, 1994
4 * The Regents of the University of California. All rights reserved.
5 * Copyright (c) 1993, 1994, 1995, 1996
6 * Keith Bostic. All rights reserved.
8 * See the LICENSE file for redistribution information.
14 static const char sccsid
[] = "Id: cl_screen.c,v 10.56 2002/05/03 19:59:44 skimo Exp (Berkeley) Date: 2002/05/03 19:59:44 ";
17 #include <sys/types.h>
18 #include <sys/queue.h>
20 #include <bitstring.h>
29 #include "../common/common.h"
32 static int cl_ex_end
__P((GS
*));
33 static int cl_ex_init
__P((SCR
*));
34 static void cl_freecap
__P((CL_PRIVATE
*));
35 static int cl_vi_end
__P((GS
*));
36 static int cl_vi_init
__P((SCR
*));
37 static int cl_putenv
__P((SCR
*, const char *, const char *, u_long
));
41 * Switch screen types.
43 * PUBLIC: int cl_screen __P((SCR *, u_int32_t));
46 cl_screen(SCR
*sp
, u_int32_t flags
)
54 win
= CLSP(sp
) ? CLSP(sp
) : stdscr
;
56 /* See if the current information is incorrect. */
57 if (F_ISSET(gp
, G_SRESTART
)) {
60 sp
->cl_private
= NULL
;
64 F_CLR(gp
, G_SRESTART
);
67 /* See if we're already in the right mode. */
68 if ((LF_ISSET(SC_EX
) && F_ISSET(sp
, SC_SCR_EX
)) ||
69 (LF_ISSET(SC_VI
) && F_ISSET(sp
, SC_SCR_VI
)))
73 * Fake leaving ex mode.
75 * We don't actually exit ex or vi mode unless forced (e.g. by a window
76 * size change). This is because many curses implementations can't be
77 * called twice in a single program. Plus, it's faster. If the editor
78 * "leaves" vi to enter ex, when it exits ex we'll just fall back into
81 if (F_ISSET(sp
, SC_SCR_EX
))
85 * Fake leaving vi mode.
87 * Clear out the rest of the screen if we're in the middle of a split
88 * screen. Move to the last line in the current screen -- this makes
89 * terminal scrolling happen naturally. Note: *don't* move past the
90 * end of the screen, as there are ex commands (e.g., :read ! cat file)
91 * that don't want to. Don't clear the info line, its contents may be
92 * valid, e.g. :file|append.
94 if (F_ISSET(sp
, SC_SCR_VI
)) {
97 if (TAILQ_NEXT(sp
, q
) != NULL
) {
98 (void)wmove(win
, RLNO(sp
, sp
->rows
), 0);
101 (void)wmove(win
, RLNO(sp
, sp
->rows
) - 1, 0);
105 /* Enter the requested mode. */
106 if (LF_ISSET(SC_EX
)) {
109 F_SET(clp
, CL_IN_EX
| CL_SCR_EX_INIT
);
112 * If doing an ex screen for ex mode, move to the last line
115 if (F_ISSET(sp
, SC_EX
) && clp
->cup
!= NULL
)
116 tputs(tgoto(clp
->cup
,
117 0, O_VAL(sp
, O_LINES
) - 1), 1, cl_putchar
);
121 F_CLR(clp
, CL_IN_EX
);
122 F_SET(clp
, CL_SCR_VI_INIT
);
129 * Shutdown the screens.
131 * PUBLIC: int cl_quit __P((GS *));
143 * If we weren't really running, ignore it. This happens if the
144 * screen changes size before we've called curses.
146 if (!F_ISSET(clp
, CL_SCR_EX_INIT
| CL_SCR_VI_INIT
))
149 /* Clean up the terminal mappings. */
153 /* Really leave vi mode. */
154 if (F_ISSET(clp
, CL_STDIN_TTY
) &&
155 F_ISSET(clp
, CL_SCR_VI_INIT
) && cl_vi_end(gp
))
158 /* Really leave ex mode. */
159 if (F_ISSET(clp
, CL_STDIN_TTY
) &&
160 F_ISSET(clp
, CL_SCR_EX_INIT
) && cl_ex_end(gp
))
164 * If we were running ex when we quit, or we're using an implementation
165 * of curses where endwin() doesn't get this right, restore the original
169 * We always do this because it's too hard to figure out what curses
170 * implementations get it wrong. It may discard type-ahead characters
171 * from the tty queue.
173 (void)tcsetattr(STDIN_FILENO
, TCSADRAIN
| TCSASOFT
, &clp
->orig
);
175 F_CLR(clp
, CL_SCR_EX_INIT
| CL_SCR_VI_INIT
);
181 * Initialize the curses vi screen.
187 char *o_cols
, *o_lines
, *o_term
;
192 /* If already initialized, just set the terminal modes. */
193 if (F_ISSET(clp
, CL_SCR_VI_INIT
))
196 /* Curses vi always reads from (and writes to) a terminal. */
197 if (!F_ISSET(clp
, CL_STDIN_TTY
) || !isatty(STDOUT_FILENO
)) {
199 "016|Vi's standard input and output must be a terminal");
203 /* We'll need a terminal type. */
204 if (opts_empty(sp
, O_TERM
, 0))
206 ttype
= O_STR(sp
, O_TERM
);
210 * Changing the row/column and terminal values is done by putting them
211 * into the environment, which is then read by curses. What this loses
212 * in ugliness, it makes up for in stupidity. We can't simply put the
213 * values into the environment ourselves, because in the presence of a
214 * kernel mechanism for returning the window size, entering values into
215 * the environment will screw up future screen resizing events, e.g. if
216 * the user enters a :shell command and then resizes their window. So,
217 * if they weren't already in the environment, we make sure to delete
218 * them immediately after setting them.
221 * Putting the TERM variable into the environment is necessary, even
222 * though we're using newterm() here. We may be using initscr() as
223 * the underlying function.
225 o_term
= getenv("TERM");
226 cl_putenv(sp
, "TERM", ttype
, 0);
227 o_lines
= getenv("LINES");
228 cl_putenv(sp
, "LINES", NULL
, (u_long
)O_VAL(sp
, O_LINES
));
229 o_cols
= getenv("COLUMNS");
230 cl_putenv(sp
, "COLUMNS", NULL
, (u_long
)O_VAL(sp
, O_COLUMNS
));
233 * We don't care about the SCREEN reference returned by newterm, we
234 * never have more than one SCREEN at a time.
237 * The SunOS initscr() can't be called twice. Don't even think about
238 * using it. It fails in subtle ways (e.g. select(2) on fileno(stdin)
239 * stops working). (The SVID notes that applications should only call
243 * The HP/UX newterm doesn't support the NULL first argument, so we
244 * have to specify the terminal type.
247 if (newterm(__UNCONST(ttype
), stdout
, stdin
) == NULL
) {
249 msgq(sp
, M_SYSERR
, "%s", ttype
);
251 msgq(sp
, M_ERR
, "%s: unknown terminal type", ttype
);
256 cl_unsetenv(sp
, "TERM");
258 cl_unsetenv(sp
, "LINES");
260 cl_unsetenv(sp
, "COLUMNS");
264 * Someone got let out alone without adult supervision -- the SunOS
265 * newterm resets the signal handlers. There's a race, but it's not
268 (void)sig_init(sp
->gp
, sp
);
271 * We use raw mode. What we want is 8-bit clean, however, signals
272 * and flow control should continue to work. Admittedly, it sounds
273 * like cbreak, but it isn't. Using cbreak() can get you additional
274 * things like IEXTEN, which turns on flags like DISCARD and LNEXT.
277 * If raw isn't turning off echo and newlines, something's wrong.
278 * However, it shouldn't hurt.
280 noecho(); /* No character echo. */
281 nonl(); /* No CR/NL translation. */
282 raw(); /* 8-bit clean. */
283 idlok(stdscr
, 1); /* Use hardware insert/delete line. */
285 /* Put the cursor keys into application mode. */
286 (void)keypad(stdscr
, TRUE
);
290 * The screen TI sequence just got sent. See the comment in
291 * cl_funcs.c:cl_attr().
293 clp
->ti_te
= TI_SENT
;
297 * Historic implementations of curses handled SIGTSTP signals
298 * in one of three ways. They either:
300 * 1: Set their own handler, regardless.
301 * 2: Did not set a handler if a handler was already installed.
302 * 3: Set their own handler, but then called any previously set
303 * handler after completing their own cleanup.
305 * We don't try and figure out which behavior is in place, we force
306 * it to SIG_DFL after initializing the curses interface, which means
307 * that curses isn't going to take the signal. Since curses isn't
308 * reentrant (i.e., the whole curses SIGTSTP interface is a fantasy),
309 * we're doing The Right Thing.
311 (void)signal(SIGTSTP
, SIG_DFL
);
314 * If flow control was on, turn it back on. Turn signals on. ISIG
315 * turns on VINTR, VQUIT, VDSUSP and VSUSP. The main curses code
316 * already installed a handler for VINTR. We're going to disable the
320 * We want to use ^Y as a vi scrolling command. If the user has the
321 * DSUSP character set to ^Y (common practice) clean it up. As it's
322 * equally possible that the user has VDSUSP set to 'a', we disable
323 * it regardless. It doesn't make much sense to suspend vi at read,
324 * so I don't think anyone will care. Alternatively, we could look
325 * it up in the table of legal command characters and turn it off if
326 * it matches one. VDSUSP wasn't in POSIX 1003.1-1990, so we test for
330 * We don't check to see if the user had signals enabled originally.
331 * If they didn't, it's unclear what we're supposed to do here, but
332 * it's also pretty unlikely.
334 if (tcgetattr(STDIN_FILENO
, &clp
->vi_enter
)) {
335 msgq(sp
, M_SYSERR
, "tcgetattr");
338 if (clp
->orig
.c_iflag
& IXON
)
339 clp
->vi_enter
.c_iflag
|= IXON
;
340 if (clp
->orig
.c_iflag
& IXOFF
)
341 clp
->vi_enter
.c_iflag
|= IXOFF
;
343 clp
->vi_enter
.c_lflag
|= ISIG
;
345 clp
->vi_enter
.c_cc
[VDSUSP
] = _POSIX_VDISABLE
;
347 clp
->vi_enter
.c_cc
[VQUIT
] = _POSIX_VDISABLE
;
348 clp
->vi_enter
.c_cc
[VSUSP
] = _POSIX_VDISABLE
;
352 * OSF/1 doesn't turn off the <discard>, <literal-next> or <status>
353 * characters when curses switches into raw mode. It should be OK
354 * to do it explicitly for everyone.
357 clp
->vi_enter
.c_cc
[VDISCARD
] = _POSIX_VDISABLE
;
360 clp
->vi_enter
.c_cc
[VLNEXT
] = _POSIX_VDISABLE
;
363 clp
->vi_enter
.c_cc
[VSTATUS
] = _POSIX_VDISABLE
;
366 /* Initialize terminal based information. */
367 if (cl_term_init(sp
))
370 fast
: /* Set the terminal modes. */
371 if (tcsetattr(STDIN_FILENO
, TCSASOFT
| TCSADRAIN
, &clp
->vi_enter
)) {
374 msgq(sp
, M_SYSERR
, "tcsetattr");
375 err
: (void)cl_vi_end(sp
->gp
);
383 * Shutdown the vi screen.
392 /* Restore the cursor keys to normal mode. */
393 (void)keypad(stdscr
, FALSE
);
396 * If we were running vi when we quit, scroll the screen up a single
397 * line so we don't lose any information.
399 * Move to the bottom of the window (some endwin implementations don't
402 if (!F_ISSET(clp
, CL_IN_EX
)) {
405 (void)move(LINES
- 1, 0);
411 /* End curses window. */
416 * The screen TE sequence just got sent. See the comment in
417 * cl_funcs.c:cl_attr().
419 clp
->ti_te
= TE_SENT
;
426 * Initialize the ex screen.
435 /* If already initialized, just set the terminal modes. */
436 if (F_ISSET(clp
, CL_SCR_EX_INIT
))
439 /* If not reading from a file, we're done. */
440 if (!F_ISSET(clp
, CL_STDIN_TTY
))
443 /* Get the ex termcap/terminfo strings. */
444 (void)cl_getcap(sp
, "cup", &clp
->cup
);
445 (void)cl_getcap(sp
, "smso", &clp
->smso
);
446 (void)cl_getcap(sp
, "rmso", &clp
->rmso
);
447 (void)cl_getcap(sp
, "el", &clp
->el
);
448 (void)cl_getcap(sp
, "cuu1", &clp
->cuu1
);
450 /* Enter_standout_mode and exit_standout_mode are paired. */
451 if (clp
->smso
== NULL
|| clp
->rmso
== NULL
) {
452 if (clp
->smso
!= NULL
) {
456 if (clp
->rmso
!= NULL
) {
463 * Turn on canonical mode, with normal input and output processing.
464 * Start with the original terminal settings as the user probably
465 * had them (including any local extensions) set correctly for the
469 * We can't get everything that we need portably; for example, ONLCR,
470 * mapping <newline> to <carriage-return> on output isn't required
471 * by POSIX 1003.1b-1993. If this turns out to be a problem, then
472 * we'll either have to play some games on the mapping, or we'll have
473 * to make all ex printf's output \r\n instead of \n.
475 clp
->ex_enter
= clp
->orig
;
476 clp
->ex_enter
.c_lflag
|= ECHO
| ECHOE
| ECHOK
| ICANON
| IEXTEN
| ISIG
;
478 clp
->ex_enter
.c_lflag
|= ECHOCTL
;
481 clp
->ex_enter
.c_lflag
|= ECHOKE
;
483 clp
->ex_enter
.c_iflag
|= ICRNL
;
484 clp
->ex_enter
.c_oflag
|= OPOST
;
486 clp
->ex_enter
.c_oflag
|= ONLCR
;
489 fast
: if (tcsetattr(STDIN_FILENO
, TCSADRAIN
| TCSASOFT
, &clp
->ex_enter
)) {
492 msgq(sp
, M_SYSERR
, "tcsetattr");
500 * Shutdown the ex screen.
516 * Retrieve termcap/terminfo strings.
518 * PUBLIC: int cl_getcap __P((SCR *, const char *, char **));
521 cl_getcap(SCR
*sp
, const char *name
, char **elementp
)
526 if ((t
= tigetstr(name
)) != NULL
&&
527 t
!= (char *)-1 && (len
= strlen(t
)) != 0) {
528 MALLOC_RET(sp
, *elementp
, char *, len
+ 1);
529 memmove(*elementp
, t
, len
+ 1);
536 * Free any allocated termcap/terminfo strings.
539 cl_freecap(CL_PRIVATE
*clp
)
541 if (clp
->el
!= NULL
) {
545 if (clp
->cup
!= NULL
) {
549 if (clp
->cuu1
!= NULL
) {
553 if (clp
->rmso
!= NULL
) {
557 if (clp
->smso
!= NULL
) {
565 * Put a value into the environment.
568 cl_putenv(SCR
*sp
, const char *name
, const char *str
, u_long value
)
573 (void)snprintf(buf
, sizeof(buf
), "%lu", value
);
574 return (cl_setenv(sp
, name
, buf
));
576 return (cl_setenv(sp
, name
, str
));