Memory Management

Create, populate, and destroy main data structures for C-Menu. More...

Functions
Form *	destroy_form (Init *init)
	Destroy Form structure.
Init *	destroy_init (Init *init)
	Destroy Init structure.
Menu *	destroy_menu (Init *init)
	Destroy Menu structure.
Pick *	destroy_pick (Init *init)
	Destroy Pick structure.
View *	destroy_view (Init *init)
	Destroy View structure.
bool	init_form_files (Init *init, int argc, char **argv)
	Initialize Form file specifications.
bool	init_menu_files (Init *init, int argc, char **argv)
	Initialize Menu file specifications.
bool	init_pick_files (Init *init, int argc, char **argv)
	Initialize Pick file specifications.
bool	init_view_files (Init *init)
	Initialize View file specifications.
Form *	new_form (Init *init, int argc, char **argv, uint begy, uint begx)
	Create and initialize Form structure.
Init *	new_init (int argc, char **argv)
	Create and initialize Init structure.
Menu *	new_menu (Init *init, int argc, char **argv, uint begy, uint begx)
	Create and initialize Menu structure.
Pick *	new_pick (Init *init, int argc, char **argv, uint begy, uint begx)
	Create and initialize Pick structure.
View *	new_view (Init *init)
	Create and initialize View structure.
bool	verify_spec_arg (char *spec, char *org_spec, char *dir, char *alt_dir, uint mode)
	Verify file specification argument.

Detailed Description

Create, populate, and destroy main data structures for C-Menu.

C-Menu main data structures
Init - main structure for initialization and global data
Menu - menu description, help, and state
Pick - pick description, help, and state
Form - form description, help, and state
View - view description, help, and state

Function Documentation

destroy_form()

Form * destroy_form

(

Init *

init

)

Destroy Form structure.

Parameters

init

structure

Returns

nullptr

Definition at line 275 of file mem.c.

                               {
    uint i;
 
    if (!init->form)
        return nullptr;
    for (i = 0; i < FIELD_MAXCNT; i++) {
        if (init->form->field[i])
            free(init->form->field[i]);
        init->form->field[i] = nullptr;
    }
    for (i = 0; i < FIELD_MAXCNT; i++) {
        if (init->form->text[i])
            free(init->form->text[i]);
        init->form->text[i] = nullptr;
    }
    free(init->form);
    init->form = nullptr;
    init->form_cnt--;
    return init->form;
}

References Form::field, Init::form, Init::form_cnt, and Form::text.

Referenced by destroy_init(), init_form(), and popup_form().

Here is the caller graph for this function:

destroy_init()

Init * destroy_init

(

Init *

init

)

Destroy Init structure.

Parameters

init

structure

Returns

nullptr

Definition at line 95 of file mem.c.

                               {
    if (!init)
        return nullptr;
    if (init->sio) {
        free(init->sio);
        init->sio = nullptr;
    }
    if (init->menu) {
        init->menu = destroy_menu(init);
        init->menu = nullptr;
    }
    if (init->form) {
        init->form = destroy_form(init);
        init->form = nullptr;
    }
    if (init->pick) {
        init->pick = destroy_pick(init);
        init->pick = nullptr;
    }
    init->argc = destroy_argv(init->argc, init->argv);
    if (init->argv != nullptr)
        free(init->argv);
    if (init != nullptr) {
        free(init);
        init = nullptr;
    }
    init_cnt--;
    return init;
}

References Init::argc, Init::argv, destroy_argv(), destroy_form(), destroy_menu(), destroy_pick(), Init::form, init_cnt, Init::menu, Init::pick, and Init::sio.

Referenced by main().

Here is the call graph for this function:

Here is the caller graph for this function:

destroy_menu()

Menu * destroy_menu

(

Init *

init

)

Destroy Menu structure.

Parameters

init

structure

Returns

nullptr

Definition at line 155 of file mem.c.

                               {
    menu = init->menu;
    for (menu->line_idx = 0; menu->line_idx < menu->item_count;
         menu->line_idx++) {
        if (menu->line[menu->line_idx]) {
            if (menu->line[menu->line_idx]->raw_text != nullptr)
                free(menu->line[menu->line_idx]->raw_text);
            if (menu->line[menu->line_idx]->command_str != nullptr)
                free(menu->line[menu->line_idx]->command_str);
            if (menu->line[menu->line_idx]->choice_text != nullptr)
                free(menu->line[menu->line_idx]->choice_text);
            free(menu->line[menu->line_idx]);
            menu->line[menu->line_idx] = nullptr;
        }
    }
    free(init->menu);
    init->menu = nullptr;
    menu = nullptr;
    init->menu_cnt--;
    return init->menu;
}

References Line::choice_text, Line::command_str, Menu::item_count, Menu::line, Menu::line_idx, Init::menu, menu, Init::menu_cnt, and Line::raw_text.

Referenced by destroy_init(), menu_engine(), and popup_menu().

Here is the caller graph for this function:

destroy_pick()

Pick * destroy_pick

(

Init *

init

)

Destroy Pick structure.

Parameters

init

structure

Returns

nullptr

Definition at line 225 of file mem.c.

                               {
    if (!init->pick)
        return nullptr;
 
    for (pick->m_idx = 0; pick->m_idx < OBJ_MAXCNT; pick->m_idx++) {
        if (pick->m_object[pick->m_idx] != nullptr)
            free(pick->m_object[pick->m_idx]);
        // if (pick->d_object[pick->d_idx] != nullptr)
        //    free(pick->d_object[pick->d_idx]);
    }
    free(pick->m_object);
    free(pick->d_object);
    free(pick);
    init->pick = nullptr;
    init->pick_cnt--;
    return init->pick;
}

References Pick::d_object, Pick::m_idx, Pick::m_object, Init::pick, pick, and Init::pick_cnt.

Referenced by destroy_init(), and popup_pick().

Here is the caller graph for this function:

destroy_view()

View * destroy_view

(

Init *

init

)

Destroy View structure.

Parameters

init

structure

Returns

nullptr

Definition at line 345 of file mem.c.

                               {
    view = init->view;
    if (!view)
        return nullptr;
    view->argc = destroy_argv(view->argc, view->argv);
    free(view->argv);
    free(view);
    init->view = nullptr;
    view = nullptr;
    init->view_cnt--;
    return init->view;
}

References View::argc, View::argv, destroy_argv(), Init::view, view, and Init::view_cnt.

Referenced by destroy_pick_view(), main(), and popup_view().

Here is the call graph for this function:

Here is the caller graph for this function:

init_form_files()

bool init_form_files	(	Init *	init,
		int	argc,
		char **	argv )

Initialize Form file specifications.

Parameters

init	pointer to init structure
argc	- number of arguments in argv
argv	- Arguments may have been provided by command line ~/.minitrc, environment variables, or calling program interal to C-Menu

Positional args: [pick desc], [in_file], [out_file], [help_file]

Definition at line 642 of file mem.c.

                                                        {
    char tmp_str[MAXLEN];
    int optind = 0;
    form->f_mapp_spec =
        verify_spec_arg(form->mapp_spec, init->mapp_spec, init->mapp_msrc,
                        "~/menuapp/msrc", R_OK);
    form->f_in_spec = verify_spec_arg(form->in_spec, init->in_spec,
                                      init->mapp_data, "~/menuapp/data", R_OK);
    form->f_out_spec =
        verify_spec_arg(form->out_spec, init->out_spec, init->mapp_data,
                        "~/menuapp/data", W_OK | S_QUIET);
    if (init->provider_cmd[0] != '\0') {
        form->f_provider_cmd =
            verify_spec_arg(form->provider_cmd, init->provider_cmd,
                            "~/menuapp/bin", "$PATH", X_OK | S_QUIET);
    }
    if (init->cmd[0] != '\0') {
        form->f_cmd = verify_spec_arg(form->cmd, init->cmd, "~/menuapp/bin",
                                      "$PATH", X_OK | S_QUIET);
    }
    if (init->receiver_cmd[0] != '\0') {
        form->f_receiver_cmd =
            verify_spec_arg(form->receiver_cmd, init->receiver_cmd,
                            "~/menuapp/bin", "$PATH", X_OK | S_QUIET);
    }
    form->f_help_spec =
        verify_spec_arg(form->help_spec, init->help_spec, init->mapp_help,
                        "~/menuapp/help", R_OK);
    if (optind < argc && !form->f_mapp_spec) {
        form->f_mapp_spec =
            verify_spec_arg(form->mapp_spec, argv[optind], init->mapp_msrc,
                            "~/menuapp/msrc", R_OK);
        if (form->f_mapp_spec)
            optind++;
    }
    if (optind < argc && !form->f_in_spec) {
        form->f_in_spec =
            verify_spec_arg(form->in_spec, argv[optind], init->mapp_data,
                            "~/menuapp/data", R_OK);
        if (form->f_in_spec)
            optind++;
    }
    if (optind < argc && !form->f_out_spec) {
        form->f_out_spec =
            verify_spec_arg(form->out_spec, argv[optind], init->mapp_data,
                            "~/menuapp/data", W_OK | S_QUIET);
        if (form->f_out_spec)
            optind++;
    }
    if (optind < argc && !form->f_provider_cmd) {
        if (argv[optind][0] != '\0') {
            form->f_provider_cmd =
                verify_spec_arg(form->provider_cmd, argv[optind],
                                "~/menuapp/bin", nullptr, X_OK | S_QUIET);
            if (!form->f_provider_cmd) {
                base_name(tmp_str, argv[optind]);
                form->f_provider_cmd =
                    locate_file_in_path(form->provider_cmd, tmp_str);
            }
        }
        optind++;
    }
    if (optind < argc && !form->f_cmd) {
        if (argv[optind][0] != '\0') {
            form->f_cmd =
                verify_spec_arg(form->cmd, argv[optind], "~/menuapp/bin",
                                nullptr, X_OK | S_QUIET);
            if (!form->f_cmd) {
                base_name(tmp_str, argv[optind]);
                form->f_cmd = locate_file_in_path(form->cmd, tmp_str);
            }
        }
        optind++;
    }
    if (optind < argc && !form->f_receiver_cmd) {
        if (argv[optind][0] != '\0') {
            form->f_receiver_cmd =
                verify_spec_arg(form->receiver_cmd, argv[optind],
                                "~/menuapp/bin", nullptr, X_OK | S_QUIET);
            if (!form->f_receiver_cmd) {
                base_name(tmp_str, argv[optind]);
                form->f_receiver_cmd =
                    locate_file_in_path(form->receiver_cmd, tmp_str);
            }
        }
        optind++;
    }
    if (optind < argc && !form->f_help_spec) {
        form->f_help_spec =
            verify_spec_arg(form->help_spec, init->help_spec, init->mapp_help,
                            "~/menuapp/help", R_OK);
        if (form->f_help_spec)
            optind++;
    }
    if (form->cmd[0] != '\0')
        expand_tilde(form->cmd, MAXLEN - 1);
    if (form->provider_cmd[0] != '\0')
        expand_tilde(form->provider_cmd, MAXLEN - 1);
    if (form->receiver_cmd[0] != '\0')
        expand_tilde(form->receiver_cmd, MAXLEN - 1);
    form->f_erase_remainder = init->f_erase_remainder;
    if (form->title[0] == '\0' && init->title[0] != '\0') {
        strip_quotes(init->title);
        strnz__cpy(form->title, init->title, MAXLEN - 1);
    }
    form->f_multiple_cmd_args = init->f_multiple_cmd_args;
    return true;
}

References base_name(), Form::cmd, Init::cmd, expand_tilde(), Form::f_cmd, Form::f_erase_remainder, Init::f_erase_remainder, Form::f_help_spec, Form::f_in_spec, Form::f_mapp_spec, Form::f_multiple_cmd_args, Init::f_multiple_cmd_args, Form::f_out_spec, Form::f_provider_cmd, Form::f_receiver_cmd, form, Form::help_spec, Init::help_spec, Form::in_spec, Init::in_spec, locate_file_in_path(), Init::mapp_data, Init::mapp_help, Init::mapp_msrc, Form::mapp_spec, Init::mapp_spec, Form::out_spec, Init::out_spec, Form::provider_cmd, Init::provider_cmd, Form::receiver_cmd, Init::receiver_cmd, strip_quotes(), strnz__cpy(), Form::title, Init::title, and verify_spec_arg().

Referenced by new_form().

Here is the call graph for this function:

Here is the caller graph for this function:

init_menu_files()

bool init_menu_files	(	Init *	init,
		int	argc,
		char **	argv )

Initialize Menu file specifications.

Parameters

init	structure
argc	- number of arguments in argv
argv	- Arguments may have been provided by command line, ~/.minitrc, environment variables, or calling program interal to C-Menu

Positional args: [menu desc], [help file]

Definition at line 491 of file mem.c.

                                                        {
    char tmp_str[MAXLEN];
    int optind = 0;
    if (optind < argc && !init->f_mapp_spec) {
        menu->f_mapp_spec =
            verify_spec_arg(menu->mapp_spec, argv[optind], init->mapp_msrc,
                            "~/menuapp/msrc", R_OK);
        if (menu->f_mapp_spec)
            optind++;
    }
    if (optind < argc && !menu->f_help_spec) {
        menu->f_help_spec =
            verify_spec_arg(menu->help_spec, argv[optind], init->mapp_help,
                            "~/menuapp/help", R_OK);
        if (menu->f_help_spec)
            optind++;
    }
    if (!menu->f_mapp_spec) {
        menu->f_mapp_spec = verify_spec_arg(
            menu->mapp_spec, "~/menuapp/msrc/main.m", nullptr, nullptr, R_OK);
        if (!menu->f_mapp_spec) {
            strnz__cpy(tmp_str, "menu cannot read description file ",
                       MAXLEN - 1);
            strnz__cat(tmp_str, menu->mapp_spec, MAXLEN - 1);
            abend(-1, tmp_str);
        }
    }
    if (!menu->f_help_spec) {
        menu->f_help_spec =
            verify_spec_arg(menu->help_spec, "~/menuapp/help/menu.help",
                            nullptr, nullptr, R_OK);
        if (!menu->f_help_spec) {
            strnz__cpy(tmp_str, "menu cannot read help file ", MAXLEN - 1);
            strnz__cat(tmp_str, menu->help_spec, MAXLEN - 1);
            abend(-1, tmp_str);
        }
    }
    return true;
}

References abend(), Menu::f_help_spec, Init::f_mapp_spec, Menu::f_mapp_spec, Menu::help_spec, Init::mapp_help, Init::mapp_msrc, Menu::mapp_spec, menu, strnz__cat(), strnz__cpy(), and verify_spec_arg().

Referenced by new_menu().

Here is the call graph for this function:

Here is the caller graph for this function:

init_pick_files()

bool init_pick_files	(	Init *	init,
		int	argc,
		char **	argv )

Initialize Pick file specifications.

Parameters

init	structure
argc	- number of arguments in argv
argv	- Arguments may have been provided by command line, ~/.minitrc, environment variables, or calling program interal to C-Menu

Positional args: [pick desc], [in_file], [out_file], [help_file]

Definition at line 539 of file mem.c.

                                                        {
    char tmp_str[MAXLEN];
    int optind = 1;
    pick->f_in_spec = verify_spec_arg(pick->in_spec, init->in_spec,
                                      init->mapp_data, "~/menuapp/data", R_OK);
    pick->f_out_spec =
        verify_spec_arg(pick->out_spec, init->out_spec, init->mapp_data,
                        "~/menuapp/data", W_OK | S_QUIET);
    if (init->provider_cmd[0] != '\0') {
        pick->f_provider_cmd =
            verify_spec_arg(pick->provider_cmd, init->provider_cmd,
                            "~/menuapp/bin", "$PATH", X_OK | S_QUIET);
    }
    if (init->cmd[0] != '\0') {
        pick->f_cmd = verify_spec_arg(pick->cmd, init->cmd, "~/menuapp/bin",
                                      "$PATH", X_OK | S_QUIET);
    }
    if (init->receiver_cmd[0] != '\0') {
        pick->f_receiver_cmd =
            verify_spec_arg(pick->receiver_cmd, init->receiver_cmd,
                            "~/menuapp/bin", "$PATH", X_OK | S_QUIET);
    }
    if (init->title[0])
        strnz__cpy(pick->title, init->title, MAXLEN - 1);
    pick->f_help_spec =
        verify_spec_arg(pick->help_spec, init->help_spec, init->mapp_help,
                        "~/menuapp/help", R_OK);
    if (optind < argc && !pick->f_in_spec) {
        pick->f_in_spec =
            verify_spec_arg(pick->in_spec, argv[optind], init->mapp_data,
                            "~/menuapp/data", R_OK);
        if (pick->f_in_spec)
            optind++;
    }
    if (optind < argc && !pick->f_out_spec) {
        pick->f_out_spec =
            verify_spec_arg(pick->out_spec, argv[optind], init->mapp_data,
                            "~/menuapp/data", W_OK | S_QUIET);
        if (pick->f_out_spec)
            optind++;
    }
    if (optind < argc && !pick->f_provider_cmd) {
        if (argv[optind][0] != '\0') {
            pick->f_provider_cmd =
                verify_spec_arg(pick->provider_cmd, argv[optind],
                                "~/menuapp/bin", nullptr, X_OK | S_QUIET);
            if (!pick->f_provider_cmd) {
                base_name(tmp_str, argv[optind]);
                pick->f_provider_cmd =
                    locate_file_in_path(pick->provider_cmd, tmp_str);
            }
        }
        optind++;
    }
    if (optind < argc && !pick->f_cmd) {
        if (argv[optind][0] != '\0') {
            pick->f_cmd =
                verify_spec_arg(pick->cmd, argv[optind], "~/menuapp/bin",
                                nullptr, X_OK | S_QUIET);
            if (!pick->f_cmd) {
                base_name(tmp_str, argv[optind]);
                pick->f_cmd = locate_file_in_path(pick->cmd, tmp_str);
            }
        }
        optind++;
    }
    if (optind < argc && !pick->f_receiver_cmd) {
        if (argv[optind][0] != '\0') {
            pick->f_receiver_cmd =
                verify_spec_arg(pick->receiver_cmd, argv[optind],
                                "~/menuapp/bin", nullptr, X_OK | S_QUIET);
            if (!pick->f_receiver_cmd) {
                base_name(tmp_str, argv[optind]);
                pick->f_receiver_cmd =
                    locate_file_in_path(pick->receiver_cmd, tmp_str);
            }
        }
        optind++;
    }
    if (optind < argc && !pick->f_help_spec) {
        pick->f_help_spec =
            verify_spec_arg(pick->help_spec, argv[optind], init->mapp_help,
                            "~/menuapp/help", R_OK);
        if (pick->f_help_spec)
            optind++;
    }
    if (pick->provider_cmd[0] != '\0')
        expand_tilde(pick->provider_cmd, MAXLEN - 1);
    if (pick->receiver_cmd[0] != '\0')
        expand_tilde(pick->receiver_cmd, MAXLEN - 1);
    pick->select_max = init->select_max;
    pick->f_read_theme = init->f_read_theme;
    pick->f_multiple_cmd_args = init->f_multiple_cmd_args;
    pick->p_view_files = init->p_view_files;
    return true;
}

References base_name(), Init::cmd, Pick::cmd, expand_tilde(), Pick::f_cmd, Pick::f_help_spec, Pick::f_in_spec, Init::f_multiple_cmd_args, Pick::f_multiple_cmd_args, Pick::f_out_spec, Pick::f_provider_cmd, Init::f_read_theme, Pick::f_read_theme, Pick::f_receiver_cmd, Init::help_spec, Pick::help_spec, Init::in_spec, Pick::in_spec, locate_file_in_path(), Init::mapp_data, Init::mapp_help, Init::out_spec, Pick::out_spec, Init::p_view_files, Pick::p_view_files, pick, Init::provider_cmd, Pick::provider_cmd, Init::receiver_cmd, Pick::receiver_cmd, Init::select_max, Pick::select_max, strnz__cpy(), Init::title, Pick::title, and verify_spec_arg().

Referenced by new_pick().

Here is the call graph for this function:

Here is the caller graph for this function:

init_view_files()

bool init_view_files

(

Init *

init

)

Initialize View file specifications.

Parameters

init

structure

Positional args: pick desc, in_file, out_file, help_file

Definition at line 754 of file mem.c.

                                 {
    char *e;
    view = init->view;
    view->lines = init->lines;
    view->cols = init->cols;
    view->begy = init->begy;
    view->begx = init->begx;
    view->f_ignore_case = init->f_ignore_case;
    view->f_at_end_remove = init->f_at_end_remove;
    view->f_squeeze = init->f_squeeze;
    view->tab_stop = init->tab_stop;
    view->f_ln = init->f_ln;
    view->wrap = init->wrap;
    view->h_shift = init->h_shift;
    e = getenv("VIEW_HELP_FILE");
    if (e && e[0] != '\0') {
        strnz__cpy(view->help_spec, e, MAXLEN - 1);
    }
    view->f_help_spec =
        verify_spec_arg(view->help_spec, view->help_spec, init->mapp_help,
                        "~/menuapp/help", R_OK);
    if (!view->f_help_spec) {
        strnz__cpy(view->help_spec, init->mapp_home, MAXLEN - 1);
        strnz__cat(view->help_spec, "/help/", MAXLEN - 1);
        strnz__cat(view->help_spec, VIEW_HELP_FILE, MAXLEN - 1);
    }
    strnz__cpy(view->provider_cmd, init->provider_cmd, MAXLEN - 1);
    strnz__cpy(view->receiver_cmd, init->receiver_cmd, MAXLEN - 1);
    strnz__cpy(view->cmd_all, init->cmd_all, MAXLEN - 1);
    if (view->cmd[0] != '\0')
        expand_tilde(view->cmd, MAXLEN - 1);
    if (view->provider_cmd[0] != '\0')
        expand_tilde(view->provider_cmd, MAXLEN - 1);
    if (view->receiver_cmd[0] != '\0')
        expand_tilde(view->receiver_cmd, MAXLEN - 1);
    if (view->title[0] == '\0') {
        if (init->title[0] != '\0') {
            strnz__cpy(view->title, init->title, MAXLEN - 1);
        } else {
            if (view->provider_cmd[0] != '\0')
                strnz__cpy(view->title, view->provider_cmd, MAXLEN - 1);
            else {
                if (view->argv != nullptr && view->argv[0] != nullptr &&
                    view->argv[0][0] != '\0') {
                    strnz__cpy(view->title, view->argv[0], MAXLEN - 1);
                } else
                    strnz__cpy(view->title, "C-Menu View", MAXLEN - 1);
            }
        }
    }
    strip_quotes(view->title);
    if (view->tab_stop == 0)
        view->tab_stop = 4;
    return true;
}

References View::argv, Init::begx, View::begx, Init::begy, View::begy, View::cmd, Init::cmd_all, View::cmd_all, Init::cols, View::cols, expand_tilde(), Init::f_at_end_remove, View::f_at_end_remove, View::f_help_spec, Init::f_ignore_case, View::f_ignore_case, Init::f_ln, View::f_ln, Init::f_squeeze, View::f_squeeze, Init::h_shift, View::h_shift, View::help_spec, Init::lines, View::lines, Init::mapp_help, Init::mapp_home, Init::provider_cmd, View::provider_cmd, Init::receiver_cmd, View::receiver_cmd, strip_quotes(), strnz__cat(), strnz__cpy(), Init::tab_stop, View::tab_stop, Init::title, View::title, verify_spec_arg(), Init::view, view, Init::wrap, and View::wrap.

Referenced by new_view().

Here is the call graph for this function:

Here is the caller graph for this function:

new_form()

Form * new_form	(	Init *	init,
		int	argc,
		char **	argv,
		uint	begy,
		uint	begx )

Create and initialize Form structure.

Parameters

init	structure
argc	- number of arguments in argv
argv	- Arguments may have been provided by command line, ~/.minitrc, environment variables, or calling program interal to C-Menu
begy,begx	- initial position of form window

Definition at line 252 of file mem.c.

                                                                        {
    init->form = (Form *)calloc(1, sizeof(Form));
    if (!init->form) {
        abend(-1, "calloc form failed");
        return nullptr;
    }
    init->form_cnt++;
    form = init->form;
    if (!init_form_files(init, argc, argv)) {
        abend(-1, "init_form_files failed");
        return nullptr;
    }
    strnz__cpy(form->brackets, init->brackets, 3);
    strnz__cpy(form->fill_char, init->fill_char, MAXLEN - 1);
    form->begy = begy;
    form->begx = begx;
    return init->form;
}

References abend(), Form::begx, Form::begy, Form::brackets, Init::brackets, Form::fill_char, Init::fill_char, form, Init::form, Init::form_cnt, init_form_files(), and strnz__cpy().

Referenced by init_form().

Here is the call graph for this function:

Here is the caller graph for this function:

new_init()

Init * new_init	(	int	argc,
		char **	argv )

Create and initialize Init structure.

Parameters

argc,argv

- arguments

calloc initializes all fields to zero/nullptr idiomatic directory usage:

init->mapp_msrc  description files
init->mapp_help  help files
init->mapp_data  in, out, data files
init->mapp_user  executable scripts
init->mapp_bin   binary executables

Initialize file specifications in priority order:

1 - Default values
2 - Configuration file
3 - Environment variables
4 - Command line positional arguments
5 - Command line option arguments

Definition at line 60 of file mem.c.

                                      {
    int i = 0;
    Init *init = calloc(1, sizeof(Init));
    if (init == nullptr) {
        abend(-1, "calloc init failed");
        return nullptr;
    }
    init->argv = calloc(MAXARGS + 1, sizeof(char *));
    if (init->argv == nullptr) {
        ssnprintf(em0, MAXLEN - 1, "%s, line: %d, errno: %d", __FILE__,
                  __LINE__ - 4, errno);
        ssnprintf(em1, MAXLEN - 1, "%s", strerror(errno));
        ssnprintf(em2, MAXLEN - 1, "view->argv = calloc(%d, %d) failed\n",
                  (MAXARGS + 1), sizeof(char *));
        display_error(em0, em1, em2, nullptr);
        exit(EXIT_FAILURE);
    }
    init->argc = argc;
    for (i = 0; i < init->argc; i++)
        init->argv[i] = argv[i];
    init->argv[i] = nullptr;
 
    init->sio = (SIO *)calloc(1, sizeof(SIO));
    if (!init->sio) {
        Perror("calloc sio failed");
        exit(EXIT_FAILURE);
    }
    init_cnt++;
    return init;
}

References abend(), Init::argc, Init::argv, display_error(), em0, em1, em2, init_cnt, Perror(), Init::sio, and ssnprintf().

Referenced by main().

Here is the call graph for this function:

Here is the caller graph for this function:

new_menu()

Menu * new_menu	(	Init *	init,
		int	argc,
		char **	argv,
		uint	begy,
		uint	begx )

Create and initialize Menu structure.

Parameters

init	structure
argc	- number of arguments in argv
argv	- Arguments may have been provided by command line, ~/.minitrc, environment variables, or calling program interal to C-Menu
begy,begx	- initial position of menu window

Definition at line 134 of file mem.c.

                                                                        {
    init->menu = (Menu *)calloc(1, sizeof(Menu));
    if (!init->menu) {
        abend(-1, "calloc menu failed");
        return nullptr;
    }
    init->menu_cnt++;
    menu = init->menu;
    if (!init_menu_files(init, argc, argv)) {
        abend(-1, "init_menu_files failed");
        return nullptr;
    }
    menu->begy = begy;
    menu->begx = begx;
    return init->menu;
}

References abend(), Menu::begx, Menu::begy, init_menu_files(), Init::menu, menu, and Init::menu_cnt.

Referenced by main(), and popup_menu().

Here is the call graph for this function:

Here is the caller graph for this function:

new_pick()

Pick * new_pick	(	Init *	init,
		int	argc,
		char **	argv,
		uint	begy,
		uint	begx )

Create and initialize Pick structure.

Parameters

init	structure
argc	- number of arguments in argv
argv	- Arguments may have been provided by command line, ~/.minitrc, environment variables, or calling program interal to C-Menu
begy,begx	- initial position of pick window

Definition at line 186 of file mem.c.

                                                                        {
    init->pick = (Pick *)calloc(1, sizeof(Pick));
    if (!init->pick) {
        Perror("calloc pick failed");
        return nullptr;
    }
    init->pick_cnt++;
    pick = init->pick;
    if (!init_pick_files(init, argc, argv)) {
        abend(-1, "init_pick_files failed");
        return nullptr;
    }
    pick->m_object = calloc(OBJ_MAXCNT + 1, sizeof(char *));
    if (pick->m_object == nullptr) {
        ssnprintf(em0, MAXLEN - 1, "%s, line: %d", __FILE__, __LINE__ - 1);
        ssnprintf(em1, MAXLEN - 1,
                  "calloc pick->m_object = calloc(%d, %d) failed\n",
                  OBJ_MAXCNT + 1, sizeof(char *));
        display_error(em0, em1, nullptr, nullptr);
        abend(-1, "User terminated program");
    }
    pick->d_object = calloc(OBJ_MAXCNT + 1, sizeof(char *));
    if (pick->d_object == nullptr) {
        ssnprintf(em0, MAXLEN - 1, "%s, line: %d", __FILE__, __LINE__ - 1);
        ssnprintf(em1, MAXLEN - 1,
                  "calloc pick->d_object = calloc(%d, %d) failed\n",
                  OBJ_MAXCNT + 1, sizeof(char *));
        display_error(em0, em1, nullptr, nullptr);
        abend(-1, "User terminated program");
    }
    pick->begy = begy;
    pick->begx = begx;
    return init->pick;
}

References abend(), Pick::begx, Pick::begy, Pick::d_object, display_error(), em0, em1, init_pick_files(), Pick::m_object, Perror(), Init::pick, pick, Init::pick_cnt, and ssnprintf().

Referenced by init_pick().

Here is the call graph for this function:

Here is the caller graph for this function:

new_view()

View * new_view

(

Init *

init

)

Create and initialize View structure.

Parameters

init

structure

Definition at line 299 of file mem.c.

                           {
    init->view_cnt++;
    init->view = (View *)calloc(1, sizeof(View));
    if (!init->view) {
        free(init->view);
        ssnprintf(em0, MAXLEN - 1, "%s, line: %d, errno: %d", __FILE__,
                  __LINE__ - 1, errno);
        ssnprintf(em1, MAXLEN - 1, "%s", strerror(errno));
        ssnprintf(em2, MAXLEN - 1, "init->view = calloc(%d) failed\n",
                  sizeof(View));
        display_error(em0, em1, em2, nullptr);
        abend(-1, "calloc init->view failed");
        return nullptr;
    }
    view = init->view;
    view->argc = init->argc;
    if (view->argc > 0) {
        view->argv = calloc(view->argc + 1, sizeof(char *));
        if (view->argv == nullptr) {
            free(view->argv);
            ssnprintf(em0, MAXLEN - 1, "%s, line: %d, errno: %d", __FILE__,
                      __LINE__ - 1, errno);
            ssnprintf(em1, MAXLEN - 1, "%s", strerror(errno));
            ssnprintf(em2, MAXLEN - 1, "view->argv = calloc(%d, %d) failed\n",
                      view->argc, sizeof(char *));
            display_error(em0, em1, em2, nullptr);
            abend(-1, "User terminated program");
            return nullptr;
        }
        int s = 0;
        int d = 0;
        while (s < init->argc)
            view->argv[d++] = strnz_dup(init->argv[s++], MAXLEN - 1);
        view->argv[d] = nullptr;
    }
    if (!init_view_files(init)) {
        abend(-1, "init_view_files failed");
        return nullptr;
    }
    return view;
}

References abend(), Init::argc, View::argc, Init::argv, View::argv, display_error(), em0, em1, em2, init_view_files(), ssnprintf(), strnz_dup(), Init::view, view, and Init::view_cnt.

Referenced by main(), new_pick_view(), and popup_view().

Here is the call graph for this function:

Here is the caller graph for this function:

verify_spec_arg()

bool verify_spec_arg	(	char *	spec,
		char *	org_spec,
		char *	dir,
		char *	alt_dir,
		uint	mode )

Verify file specification argument.

Parameters

spec	- menu->spec, form->spec, etc.
org_spec	- init->._spec | argv[optind]
dir	- init->._. directory
alt_dir	- literal, "~/menuapp/data", etc.
mode	- R_OK, W_OK, X_OK, WC_OK, S_QUIET

mode is a bitwise OR of the following flags: S_QUIET - suppress error messages WC_OK - write create ok

Returns

bool - true if file verified

preserve quotes

preserve quotes

Definition at line 369 of file mem.c.

                                {
    bool f_dir = false;
    bool f_spec = false;
    bool f_quote = true;
    char *s1;
    char *s2;
    char s1_s[MAXLEN];
    char s2_s[MAXLEN];
    char file_name[MAXLEN];
    char try_spec[MAXLEN];
    char idio_spec[MAXLEN];
 
    if (!org_spec[0])
        return false;
    idio_spec[0] = '\0';
    // try the provided spec as is, with quotes stripped for file name parsing
    strnz__cpy(try_spec, org_spec, MAXLEN - 1);
    f_quote = stripz_quotes(try_spec);
 
    s1 = strtok(try_spec, " \t\n");
    strnz__cpy(s1_s, s1, MAXLEN - 1);
 
    s2 = strtok(nullptr, "\n");
    strnz__cpy(s2_s, s2, MAXLEN - 1);
 
    strnz__cpy(file_name, s1, MAXLEN - 1);
    strnz__cpy(try_spec, file_name, MAXLEN - 1);
 
    canonicalize_file_spec(try_spec);
 
    if (try_spec[0]) {
        expand_tilde(try_spec, MAXLEN - 1);
        if (try_spec[0] == '/') {
            // try absolute path as is, with quotes stripped for file name parsing
            f_spec = verify_file(try_spec, mode);
            if (f_quote)
                strnz__cpy(spec, org_spec, MAXLEN - 1);
            else
                strnz__cpy(spec, try_spec, MAXLEN - 1);
            return f_spec;
 
        } else {
            if (!f_dir && dir[0]) {
                if (strcmp(dir, "$PATH") == 0) {
                    strnz__cpy(try_spec, file_name, MAXLEN - 1);
                    f_spec = locate_file_in_path(try_spec, file_name);
                } else {
                    strnz__cpy(try_spec, dir, MAXLEN - 1);
                    expand_tilde(try_spec, MAXLEN - 1);
                    f_dir = verify_dir(try_spec, mode);
                    if (f_dir) {
                        // directory is valid, append file_name and verify file
                        strnz__cat(try_spec, "/", MAXLEN - 1);
                        strnz__cat(try_spec, file_name, MAXLEN - 1);
                        strnz__cpy(idio_spec, try_spec, MAXLEN - 1);
                        if (mode & S_WCOK)
                            f_spec = true;
                        else
                            f_spec = verify_file(idio_spec, mode | S_QUIET);
                    }
                }
            }
            if (!f_spec && alt_dir && alt_dir[0] != '\0') {
                if (strcmp(alt_dir, "$PATH") == 0) {
                    strnz__cpy(try_spec, file_name, MAXLEN - 1);
                    f_spec = locate_file_in_path(try_spec, file_name);
                } else {
                    strnz__cpy(try_spec, alt_dir, MAXLEN - 1);
                    expand_tilde(try_spec, MAXLEN - 1);
                    f_dir = verify_dir(try_spec, mode);
                    if (f_dir) {
                        strnz__cat(try_spec, "/", MAXLEN - 1);
                        strnz__cat(try_spec, file_name, MAXLEN - 1);
                        if (mode & S_WCOK)
                            f_spec = true;
                        else
                            f_spec = verify_file(try_spec, mode | S_QUIET);
                    }
                }
            }
            if (!f_spec) {
                strnz__cpy(try_spec, ".", MAXLEN - 1);
                strnz__cat(try_spec, "/", MAXLEN - 1);
                strnz__cat(try_spec, file_name, MAXLEN - 1);
                f_spec = verify_file(try_spec, mode | S_QUIET);
            }
            if (!f_spec && mode == W_OK) {
                strnz__cpy(try_spec, idio_spec, MAXLEN - 1);
                FILE *fp = fopen(try_spec, "a");
                if (fp) {
                    fclose(fp);
                    f_spec = true;
                }
            }
            if (f_quote)
                strnz__cpy(spec, org_spec, MAXLEN - 1);
            else if (f_spec)
                strnz__cpy(spec, try_spec, MAXLEN - 1);
            if (try_spec[0] == '\0' && idio_spec[0] != '\0')
                strnz__cpy(spec, idio_spec, MAXLEN - 1);
            else
                strnz__cpy(spec, try_spec, MAXLEN - 1);
            if (s2_s[0] != '\0') {
                strnz__cat(spec, " ", MAXLEN - 1);
                strnz__cat(spec, s2_s, MAXLEN - 1);
            }
            return f_spec;
        }
    }
    return false;
}

References canonicalize_file_spec(), expand_tilde(), locate_file_in_path(), stripz_quotes(), strnz__cat(), strnz__cpy(), verify_dir(), and verify_file().

Referenced by enter_file_spec(), init_form_files(), init_menu_files(), init_pick_files(), init_view_files(), and new_pick_view().

Here is the call graph for this function:

Here is the caller graph for this function: