Error Handling

Display Error messages. More...

Functions
void	abend (int ec, char *s)
	Abnormal program termination.
bool	action_disposition (char *title, char *action_str)
	Display a simple action disposition message window or print to stderr.
int	answer_yn (char *em0, char *em1, char *em2, char *em3)
	Accept a single letter answer.
int	display_error (char *em0, char *em1, char *em2, char *em3)
	Display an error message window or print to stderr.
int	nf_error (int ec, char *s)
	Display error message and wait for key press.
int	Perror (char *emsg_str)
	Display a simple error message window or print to stderr.
int	wait_continue (WINDOW *wait_win, Chyron *chyron, int remaining)
	Update the waiting message with remaining time and check for user input.
bool	wait_destroy (Chyron *chyron)
	Destroy the waiting message window and chyron.
Chyron *	wait_mk_chyron ()
	Create a Chyron struct for the waiting message.
WINDOW *	wait_mk_win (Chyron *chyron, char *title)
	Display a popup waiting message.
bool	waitpid_with_timeout (pid_t pid, int timeout)
	Wait for a process to finish with a timeout and optional user cancellation.

Detailed Description

Display Error messages.

Function Documentation

abend()

void abend	(	int	ec,
		char *	s )

Abnormal program termination.

abend

Parameters

ec	Exit code
s	Error message

Definition at line 1588 of file dwin.c.

                            {
    destroy_curses();
    restore_shell_tioctl();
    sig_dfl_mode();
    fprintf(stderr, "\n\nABEND: %s (code: %d)\n", s, ec);
    exit(EXIT_FAILURE);
}

References destroy_curses(), restore_shell_tioctl(), and sig_dfl_mode().

Referenced by answer_yn(), box2_new(), box_new(), display_error(), form_parse_desc(), init_menu_files(), init_pick(), init_view_full_screen(), mapp_initialization(), new_chyron(), new_form(), new_init(), new_menu(), new_pick(), new_view(), open_curses(), parse_menu_description(), Perror(), sig_prog_mode(), signal_handler(), view_init_input(), and wait_mk_win().

Here is the call graph for this function:

Here is the caller graph for this function:

action_disposition()

bool action_disposition	(	char *	title,
		char *	action_str )

Display a simple action disposition message window or print to stderr.

action_disposition

Parameters

title	Window title
action_str	Action description string

Returns

true if successful

Definition at line 1286 of file dwin.c.

                                                       {
    int len;
    int line, col;
    WINDOW *action_disposition_win;
 
    if (!f_curses_open) {
        fprintf(stderr, "\n%s\n", title);
        fprintf(stderr, "%s\n", action_str);
        return true;
    }
    Chyron *chyron = new_chyron();
    set_chyron_key(chyron, 10, "F10 Continue", KEY_F(10));
    compile_chyron(chyron);
    len = max(strlen(title), strlen(action_str));
    col = (COLS - len - 4) / 2;
    line = (LINES - 4) / 2;
    if (box_new(2, len + 2, line, col, title, true)) {
        ssnprintf(em0, MAXLEN - 1, "box_new(%d, %d, %d, %d, %s) failed", 4,
                  line, line, col, title);
        Perror(em0);
    }
    action_disposition_win = win_win[win_ptr];
    mvwaddstr(action_disposition_win, 0, 1, action_str);
    display_chyron(action_disposition_win, chyron, 1, 0);
    wmove(action_disposition_win, 1, chyron->l);
    cmd_key = xwgetch(action_disposition_win, chyron, 1);
    win_del();
    destroy_chyron(chyron);
    return true;
}

References box_new(), cmd_key, compile_chyron(), destroy_chyron(), display_chyron(), em0, f_curses_open, Chyron::l, new_chyron(), Perror(), set_chyron_key(), ssnprintf(), win_del(), win_ptr, win_win, and xwgetch().

Here is the call graph for this function:

answer_yn()

int answer_yn	(	char *	em0,
		char *	em1,
		char *	em2,
		char *	em3 )

Accept a single letter answer.

answer_yn

Parameters

em0	First error message line
em1	Second error message line
em2	Third error message line
em3	Fourth error message line

Returns

Key code of user command

Definition at line 1041 of file dwin.c.

                                                          {
    char title[MAXLEN];
    int line, pos, em_l, em0_l, em1_l, em2_l, em3_l;
    WINDOW *error_win;
 
    if (!f_curses_open) {
        fprintf(stderr, "\n\n%s\n%s\n%s\n%s\n\n", em0, em1, em2, em3);
        return 1;
    }
 
    Chyron *chyron = new_chyron();
    set_chyron_key(chyron, 1, "F1 Help", KEY_F(1));
    set_chyron_key(chyron, 2, "N - No", 'n');
    set_chyron_key(chyron, 3, "Y - Yes", 'y');
    compile_chyron(chyron);
 
    em0_l = strnz(em0, COLS - 4);
    em1_l = strnz(em1, COLS - 4);
    em2_l = strnz(em2, COLS - 4);
    em3_l = strnz(em1, COLS - 4);
    em_l = max(em0_l, em1_l);
    em_l = max(em_l, em2_l);
    em_l = max(em_l, em3_l);
    em_l = max(em_l, chyron->l);
    em_l = min(em_l, COLS - 4);
 
    pos = ((COLS - em_l) - 4) / 2;
    line = (LINES - 6) / 2;
    strnz__cpy(title, "Notification", MAXLEN - 1);
    if (box_new(5, em_l + 2, line, pos, title, true)) {
        ssnprintf(title, MAXLEN - 1, "box_new(%d, %d, %d, %d, %s) failed", 5,
                  em_l + 2, line, pos, title);
        destroy_chyron(chyron);
        abend(-1, title);
    }
    error_win = win_win[win_ptr];
    mvwaddstr(error_win, 0, 1, em0);
    mvwaddstr(error_win, 1, 1, em1);
    mvwaddstr(error_win, 2, 1, em2);
    mvwaddstr(error_win, 3, 1, em3);
    display_chyron(error_win, chyron, 4, chyron->l + 1);
    do {
        curs_set(1);
        cmd_key = xwgetch(error_win, chyron, -1);
        curs_set(0);
        if (cmd_key == KEY_F(1) || cmd_key == 'N' || cmd_key == 'n' ||
            cmd_key == 'Y' || cmd_key == 'y')
            break;
    } while (1);
    win_del();
    destroy_chyron(chyron);
    return (cmd_key);
}

References abend(), box_new(), cmd_key, compile_chyron(), destroy_chyron(), display_chyron(), f_curses_open, Chyron::l, new_chyron(), set_chyron_key(), ssnprintf(), strnz(), strnz__cpy(), win_del(), win_ptr, win_win, and xwgetch().

Referenced by write_view_buffer().

Here is the call graph for this function:

Here is the caller graph for this function:

display_error()

int display_error	(	char *	em0,
		char *	em1,
		char *	em2,
		char *	em3 )

Display an error message window or print to stderr.

display_error

Parameters

em0	First error message line
em1	Second error message line
em2	Third error message line
em3	Fourth error message line

Returns

Key code of user command

Definition at line 1102 of file dwin.c.

                                                              {
    char title[MAXLEN];
    int line, pos, em_l, em0_l, em1_l, em2_l, em3_l;
    WINDOW *error_win;
 
    if (!f_curses_open) {
        fprintf(stderr, "\n\n%s\n", em0);
        fprintf(stderr, "%s\n", em1);
        fprintf(stderr, "%s\n", em2);
        fprintf(stderr, "%s\n\n", em3);
        return 1;
    }
 
    Chyron *chyron = new_chyron();
    set_chyron_key(chyron, 1, "F1 Help", KEY_F(1));
    set_chyron_key(chyron, 9, "F9 Cancel", KEY_F(9));
    set_chyron_key(chyron, 10, "F10 Continue", KEY_F(10));
    compile_chyron(chyron);
 
    em0_l = strnz(em0, COLS - 4);
    em1_l = strnz(em1, COLS - 4);
    em2_l = strnz(em2, COLS - 4);
    em3_l = strnz(em1, COLS - 4);
    em_l = max(em0_l, em1_l);
    em_l = max(em_l, em2_l);
    em_l = max(em_l, em3_l);
    em_l = max(em_l, chyron->l);
    em_l = min(em_l, COLS - 4);
 
    pos = ((COLS - em_l) - 4) / 2;
    line = (LINES - 6) / 2;
    strnz__cpy(title, "Notification", MAXLEN - 1);
    if (box_new(5, em_l + 2, line, pos, title, true)) {
        ssnprintf(title, MAXLEN - 1, "box_new(%d, %d, %d, %d, %s) failed", 5,
                  em_l + 2, line, pos, title);
        destroy_chyron(chyron);
        abend(-1, title);
    }
    error_win = win_win[win_ptr];
    mvwaddstr(error_win, 0, 1, em0);
    mvwaddstr(error_win, 1, 1, em1);
    mvwaddstr(error_win, 2, 1, em2);
    mvwaddstr(error_win, 3, 1, em3);
    display_chyron(error_win, chyron, 4, chyron->l + 1);
    do {
        cmd_key = xwgetch(error_win, chyron, -1);
        if (cmd_key == KEY_F(9) || cmd_key == KEY_F(10) || cmd_key == 'q' ||
            cmd_key == 'Q')
            break;
    } while (1);
    win_del();
    destroy_chyron(chyron);
    return (cmd_key);
}

References abend(), box_new(), cmd_key, compile_chyron(), destroy_chyron(), display_chyron(), f_curses_open, Chyron::l, new_chyron(), set_chyron_key(), ssnprintf(), strnz(), strnz__cpy(), win_del(), win_ptr, win_win, and xwgetch().

Referenced by dxwgetch(), enter_file_spec(), form_desc_error(), form_parse_desc(), form_process(), form_read_data(), form_write(), get_clr_pair(), init_view_boxwin(), init_view_full_screen(), mk_dir(), new_init(), new_pick(), new_view(), parse_menu_description(), popup_ckeys(), verify_dir(), verify_file(), view_cmd_processor(), view_init_input(), write_view_buffer(), and xwgetch().

Here is the call graph for this function:

Here is the caller graph for this function:

nf_error()

int nf_error	(	int	ec,
		char *	s )

Display error message and wait for key press.

nf_error

Parameters

ec	Error code
s	Error message

Definition at line 1576 of file dwin.c.

                              {
    fprintf(stderr, "ERROR: %s code: %d\n", s, ec);
    fprintf(stderr, "Press a key to continue");
    di_getch();
    fprintf(stderr, "\n");
    return ec;
}

References di_getch().

Here is the call graph for this function:

Perror()

int Perror

(

char *

emsg_str

)

Display a simple error message window or print to stderr.

Perror

Parameters

emsg_str

Error message string

Returns

Key code of user command

Definition at line 1162 of file dwin.c.

                           {
    char emsg[80];
    int emsg_max_len = 80;
    unsigned cmd_key;
    WINDOW *error_win;
    int len, line, pos;
    char title[MAXLEN];
    bool f_xwgetch = true;
    if (emsg_str[0] == '␛' && emsg_str[1] == 'w') {
        emsg_str += 2;
        f_xwgetch = false;
    }
    strnz__cpy(emsg, emsg_str, emsg_max_len - 1);
    if (!f_curses_open) {
        fprintf(stderr, "\n%s\n", emsg);
        return 1;
    }
    Chyron *chyron = new_chyron();
    set_chyron_key(chyron, 1, "F1 Help", KEY_F(1));
    set_chyron_key(chyron, 9, "F9 Cancel", KEY_F(9));
    set_chyron_key(chyron, 10, "F10 Continue", KEY_F(10));
    compile_chyron(chyron);
    len = max(strlen(title), strlen(emsg));
    len = max(len, chyron->l);
    len = max(len, 40);
    pos = (COLS - len - 4) / 2;
    line = (LINES - 4) / 2;
    strnz__cpy(title, "Notification", MAXLEN - 1);
    if (box_new(2, len + 2, line, pos, title, true)) {
        ssnprintf(title, MAXLEN - 1, "box_new(%d, %d, %d, %d, %s, %b) failed",
                  4, line, line, pos, title);
        destroy_chyron(chyron);
        abend(-1, title);
    }
    error_win = win_win[win_ptr];
    mvwaddstr(error_win, 0, 1, emsg);
    display_chyron(error_win, chyron, 1, chyron->l + 1);
    if (f_xwgetch) {
        curs_set(1);
        cmd_key = xwgetch(error_win, chyron, -1);
        curs_set(0);
        win_del();
    } else {
        cmd_key = KEY_F(10);
    }
    destroy_chyron(chyron);
    return (cmd_key);
}

References abend(), box_new(), compile_chyron(), destroy_chyron(), display_chyron(), f_curses_open, Chyron::l, new_chyron(), set_chyron_key(), ssnprintf(), strnz__cpy(), win_del(), win_ptr, win_win, and xwgetch().

Referenced by action_disposition(), display_form(), exec_objects(), field_editor(), fork_exec(), form_engine(), form_exec_receiver(), form_fmt_field(), form_process(), form_validate_field(), go_to_mark(), go_to_percent(), increment_ln(), init_form(), init_pick(), initialize_line_table(), menu_engine(), new_init(), new_pick(), open_pick_win(), pad_refresh(), parse_menu_description(), popup_ckeys(), search(), view_cmd_processor(), view_init_input(), and write_config().

Here is the call graph for this function:

Here is the caller graph for this function:

wait_continue()

int wait_continue	(	WINDOW *	wait_win,
		Chyron *	chyron,
		int	remaining )

Update the waiting message with remaining time and check for user input.

wait_continue

Parameters

chyron	Pointer to Chyron struct for displaying key options
wait_win	Pointer to the waiting message window
remaining	Time remaining for the wait in seconds

Returns

true if the wait should continue, false if it should be cancelled

Definition at line 1271 of file dwin.c.

                                                                   {
    char time_str[10];
    ssnprintf(time_str, 9, "%-4d", remaining);
    mvwaddstr(wait_win, 0, 21, time_str);
    display_chyron(wait_win, chyron, 1, 0);
    wmove(wait_win, 1, chyron->l);
    cmd_key = xwgetch(wait_win, chyron, 1);
    return cmd_key;
}

References cmd_key, display_chyron(), Chyron::l, ssnprintf(), and xwgetch().

Referenced by init_pick(), view_init_input(), and waitpid_with_timeout().

Here is the call graph for this function:

Here is the caller graph for this function:

wait_destroy()

bool wait_destroy

(

Chyron *

chyron

)

Destroy the waiting message window and chyron.

wait_destroy

Parameters

chyron

Pointer to Chyron struct for displaying key options

Returns

true if successful

Definition at line 1258 of file dwin.c.

                                  {
    win_del();
    destroy_chyron(chyron);
    return true;
}

References destroy_chyron(), and win_del().

Referenced by init_pick(), view_init_input(), and waitpid_with_timeout().

Here is the call graph for this function:

Here is the caller graph for this function:

wait_mk_chyron()

Chyron * wait_mk_chyron

(

)

Create a Chyron struct for the waiting message.

wait_mk_chyron

Returns

Pointer to the chyron struct

Definition at line 1214 of file dwin.c.

                         {
    Chyron *chyron = new_chyron();
    set_chyron_key(chyron, 9, "F9 Cancel", KEY_F(9));
    compile_chyron(chyron);
    return chyron;
}

References compile_chyron(), new_chyron(), and set_chyron_key().

Referenced by init_pick(), view_init_input(), and waitpid_with_timeout().

Here is the call graph for this function:

Here is the caller graph for this function:

wait_mk_win()

WINDOW * wait_mk_win	(	Chyron *	chyron,
		char *	title )

Display a popup waiting message.

wait_mk_win

Parameters

chyron	Pointer to Chyron struct for displaying key options
title	window title

Returns

WINDOW * struct

Definition at line 1226 of file dwin.c.

                                                 {
    char wm1[] = "Seconds remaining:";
    int len;
    int line, col;
    WINDOW *wait_win;
 
    if (!f_curses_open) {
        fprintf(stderr, "\n%s\n", title);
        fprintf(stderr, "%s\n", wm1);
        return NULL;
    }
    len = max(strlen(title), strlen(wm1));
    len = max(len, chyron->l);
    len = max(len, 40);
    col = (COLS - len - 4) / 2;
    line = (LINES - 4) / 2;
    if (box_new(2, len + 2, line, col, title, true)) {
        ssnprintf(title, MAXLEN - 1, "box_new(%d, %d, %d, %d, %s) failed", 4,
                  line, line, col, title);
        abend(-1, title);
    }
    wait_win = win_win[win_ptr];
    mvwaddstr(wait_win, 0, 1, wm1);
    display_chyron(wait_win, chyron, 1, 0);
    wmove(wait_win, 1, chyron->l);
    return wait_win;
}

References abend(), box_new(), display_chyron(), f_curses_open, Chyron::l, ssnprintf(), win_ptr, and win_win.

Referenced by init_pick(), view_init_input(), and waitpid_with_timeout().

Here is the call graph for this function:

Here is the caller graph for this function:

waitpid_with_timeout()

bool waitpid_with_timeout	(	pid_t	pid,
		int	timeout )

Wait for a process to finish with a timeout and optional user cancellation.

waitpid_with_timeout

Parameters

pid	Process ID to wait for
timeout	Time in seconds to wait before timing out

Returns

true if the process finished, false if it timed out or was cancelled

Definition at line 1603 of file dwin.c.

                                                  {
    int status;
    Chyron *wait_chyron;
    WINDOW *wait_win;
    int remaining = timeout;
 
    waitpid(pid, &status, WNOHANG);
    if (WIFEXITED(status) || WIFSIGNALED(status))
        return true;
    usleep(100000); // Sleep for 200ms */
    wait_chyron = wait_mk_chyron();
    ssnprintf(em0, MAXLEN - 1, "Waiting for process %d to finish...", pid);
    wait_win = wait_mk_win(wait_chyron, em0);
    cmd_key = 0;
    while (remaining > 0 && cmd_key != KEY_F(9)) {
        cmd_key = wait_continue(wait_win, wait_chyron, remaining);
        if (cmd_key == KEY_F(9))
            break;
        remaining--;
        waitpid(pid, &status, WNOHANG);
        if (WIFEXITED(status) || WIFSIGNALED(status)) {
            wait_destroy(wait_chyron);
            return true;
        }
    }
    wait_destroy(wait_chyron);
    return false;
}

References cmd_key, em0, ssnprintf(), wait_continue(), wait_destroy(), wait_mk_chyron(), and wait_mk_win().

Referenced by form_process(), init_pick(), and view_init_input().

Here is the call graph for this function:

Here is the caller graph for this function: