Screen IO Support

Provides Terminal Settings for C-MENU Applications and Restores Terminal State on Exit. More...

Functions
bool	capture_curses_tioctl ()
	capture_curses_tioctl() - capture curses terminal settings
bool	capture_shell_tioctl ()
	capture_shell_tioctl() - capture shell terminal settings
char	di_getch ()
	get single character from terminal in raw mode
bool	mk_raw_tioctl (struct termios *t_p)
	mk_raw_tioctl() - set terminal to raw mode
bool	restore_curses_tioctl ()
	restore_curses_tioctl() - restore curses terminal settings
bool	restore_shell_tioctl ()
	restore_shell_tioctl() - restore shell terminal settings
bool	set_sane_tioctl (struct termios *t_p)
	set_sane_tioctl() - set terminal to sane settings for C-MENU

Detailed Description

Provides Terminal Settings for C-MENU Applications and Restores Terminal State on Exit.

Terminal Handling

Function Documentation

capture_curses_tioctl()

bool capture_curses_tioctl

(

)

capture_curses_tioctl() - capture curses terminal settings

Returns

- true on success

• captures terminal settings for stdin, stdout, and stderr

Definition at line 70 of file scriou.c.

                             {
    if (f_have_curses_tioctl)
        return true;
    fflush(NULL);
    tcgetattr(0, &curses_in_tioctl);
    tcgetattr(1, &curses_out_tioctl);
    tcgetattr(2, &curses_err_tioctl);
    f_have_curses_tioctl = true;
    return true;
}

References curses_err_tioctl, curses_in_tioctl, curses_out_tioctl, and f_have_curses_tioctl.

Referenced by fork_exec(), and main().

Here is the caller graph for this function:

capture_shell_tioctl()

bool capture_shell_tioctl

(

)

capture_shell_tioctl() - capture shell terminal settings

Returns

- true on success

• captures terminal settings for stdin, stdout, and stderr

Definition at line 43 of file scriou.c.

                            {
    if (f_have_shell_tioctl)
        return true;
    fflush(NULL);
    tcgetattr(0, &shell_in_tioctl);
    tcgetattr(1, &shell_out_tioctl);
    tcgetattr(2, &shell_err_tioctl);
    f_have_shell_tioctl = true;
    return true;
}

References f_have_shell_tioctl.

Referenced by main().

Here is the caller graph for this function:

di_getch()

char di_getch

(

)

get single character from terminal in raw mode

Returns

- the character read from terminal

intended to be used when curses is not active

Note

restores terminal settings before returning

Definition at line 158 of file scriou.c.

                {
    struct termios org_tioctl, new_tioctl;
    char buf;
 
    fflush(NULL);
    if (tcgetattr(2, &org_tioctl) == -1) {
        fprintf(stderr, "\ndi_getch: tcgetattr failed\n");
        return (0);
    }
    new_tioctl = org_tioctl;
    new_tioctl.c_lflag &= ~(ECHO | ICANON);
    new_tioctl.c_cc[VMIN] = 1;
    new_tioctl.c_cc[VTIME] = 0;
    fflush(NULL);
    tcsetattr(2, TCSAFLUSH, &new_tioctl);
    read(2, &buf, 1);
    fflush(NULL);
    tcsetattr(2, TCSAFLUSH, &org_tioctl);
    return (buf);
}

mk_raw_tioctl()

bool mk_raw_tioctl

(

struct termios *

t_p

)

mk_raw_tioctl() - set terminal to raw mode

Parameters

t_p	- pointer to termios structure to modify

Returns

- true on success

• unlike cfmakeraw(), this leaves ISIG enabled. cfmakeraw() disables ISIG, which prevents C-MENU from handling signals like Ctrl-C. Instead of using cfmakeraw(), we manually set the terminal to raw mode while leaving ISIG enabled. The following code is equivalent to cfmakeraw() but with ISIG left enabled:

  t_p->c_iflag &= ~(IGNBRK | BRKINT | PARMRK | INPCK | ISTRIP | INLCR |
                 IGNCR | ICRNL | IXON | IXOFF);
  t_p->c_lflag &= ~(ECHO | ECHONL | ICANON | IEXTEN);
  t_p->c_cflag &= ~(CSIZE | PARENB);
  t_p->c_cflag |= CS8 | CLOCAL;

Definition at line 132 of file scriou.c.

                                        {
    fflush(NULL);
    tcgetattr(0, t_p);
    t_p->c_lflag |= ISIG;
    t_p->c_lflag &= ~(ECHO | ICANON);
    t_p->c_cc[VMIN] = 1;
    t_p->c_cc[VTIME] = 0;
    fflush(NULL);
    tcsetattr(0, TCSAFLUSH, t_p);
    fflush(NULL);
    tcgetattr(2, t_p);
    t_p->c_lflag |= ISIG;
    t_p->c_lflag &= ~(ECHO | ICANON);
    t_p->c_cc[VMIN] = 1;
    t_p->c_cc[VTIME] = 0;
    fflush(NULL);
    tcsetattr(2, TCSAFLUSH, t_p);
    return true;
}

Referenced by main().

Here is the caller graph for this function:

restore_curses_tioctl()

bool restore_curses_tioctl

(

)

restore_curses_tioctl() - restore curses terminal settings

Returns

- true on success

• restores terminal settings for stdin, stdout, and stderr

Definition at line 84 of file scriou.c.

                             {
    if (!f_have_curses_tioctl)
        return false;
    fflush(NULL);
    tcsetattr(0, TCSANOW, &curses_in_tioctl);
    tcsetattr(1, TCSANOW, &curses_out_tioctl);
    tcsetattr(2, TCSANOW, &curses_err_tioctl);
 
    return true;
}

References curses_err_tioctl, curses_in_tioctl, curses_out_tioctl, and f_have_curses_tioctl.

restore_shell_tioctl()

bool restore_shell_tioctl

(

)

restore_shell_tioctl() - restore shell terminal settings

Returns

- true on success

• restores terminal settings for stdin, stdout, and stderr

Definition at line 57 of file scriou.c.

                            {
    if (!f_have_shell_tioctl)
        return false;
    fflush(NULL);
    tcsetattr(0, TCSANOW, &shell_in_tioctl);
    tcsetattr(1, TCSANOW, &shell_out_tioctl);
    tcsetattr(2, TCSANOW, &shell_err_tioctl);
    return true;
}

References f_have_shell_tioctl.

Referenced by abend(), destroy_curses(), fork_exec(), handle_signal(), and main().

Here is the caller graph for this function:

set_sane_tioctl()

bool set_sane_tioctl

(

struct termios *

t_p

)

set_sane_tioctl() - set terminal to sane settings for C-MENU

Parameters

t_p	- pointer to termios structure to modify

Returns

- true on success

• sets terminal to sane settings for C-MENU applications

Definition at line 99 of file scriou.c.

                                          {
    fflush(NULL);
    tcgetattr(0, t_p);
    t_p->c_iflag &= ~(IGNBRK | BRKINT | PARMRK | INPCK | ISTRIP | INLCR |
                      IGNCR | ICRNL | IXON | IXOFF);
    t_p->c_iflag |= IUTF8;
    t_p->c_oflag |= OPOST | ONLCR;
    t_p->c_lflag &= ~(ECHO | ECHONL | ICANON | IEXTEN);
    t_p->c_lflag |= (ISIG | ICANON | IEXTEN | ECHO | ECHOE | ECHOK);
    t_p->c_cflag &= ~(CSIZE | PARENB);
    t_p->c_cflag |= CS8 | CLOCAL | CREAD;
    fflush(NULL);
    tcsetattr(0, TCSANOW, t_p);
    return true;
}

Referenced by signal_handler().

Here is the caller graph for this function: