mem.c

Go to the documentation of this file.

/** @file mem.c
    @brief Create and destroy main data structures for C-Menu
    @author Bill Waller
    Copyright (c) 2025
    MIT License
    billxwaller@gmail.com
    @date 2026-02-09
 */
 
/** @defgroup mem Memory Management
 * @brief Create, populate, and destroy main data structures for C-Menu
   @verbatim
   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
   @endverbatim
*/
 
#include <common.h>
#include <errno.h>
#include <stdlib.h>
#include <string.h>
#include <unistd.h>
 
Init *new_init(int, char **);
Menu *new_menu(Init *init, int, char **, int, int);
Pick *new_pick(Init *init, int, char **, int, int);
Form *new_form(Init *init, int, char **, int, int);
View *new_view(Init *init);
View *destroy_view(Init *init);
Form *destroy_form(Init *init);
Pick *destroy_pick(Init *init);
Menu *destroy_menu(Init *init);
Init *destroy_init(Init *init);
bool init_menu_files(Init *, int, char **);
bool init_pick_files(Init *, int, char **);
bool init_form_files(Init *, int, char **);
bool init_view_files(Init *);
bool verify_spec_arg(char *, char *, char *, char *, int);
int init_cnt = 0;
 
Menu *menu;
Pick *pick;
Form *form;
View *view;
/** @brief Create and initialize Init structure
    @ingroup mem
    @param argc, argv - arguments
    @details calloc initializes all fields to zero/nullptr
    idiomatic directory usage:
    @code
        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
    @endcode
    Initialize file specifications in priority order:
    @code
    1 - Default values
    2 - Configuration file
    3 - Environment variables
    4 - Command line positional arguments
    5 - Command line option arguments
    @endcode
 */
Init *new_init(int argc, char **argv) {
    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;
}
/** @brief Destroy Init structure
    @ingroup mem
    @param init structure
    @returns nullptr
 */
Init *destroy_init(Init *init) {
    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->view) {
        init->view = destroy_view(init);
        init->view = 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;
}
/** @brief Create and initialize Menu structure
    @ingroup mem
    @param init structure
    @param argc - number of arguments in argv
    @param argv - Arguments may have been provided by command line,
                    ~/.minitrc,
                    environment variables, or
                    calling program interal to C-Menu
    @param begy, begx - initial position of menu window
 */
Menu *new_menu(Init *init, int argc, char **argv, int begy, int begx) {
    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;
}
/** @brief Destroy Menu structure
    @ingroup mem
    @param init structure
    @return nullptr
 */
Menu *destroy_menu(Init *init) {
    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;
}
/** @brief Create and initialize Pick structure
    @ingroup mem
    @param init structure
    @param argc - number of arguments in argv
    @param argv - Arguments may have been provided by command line,
                    ~/.minitrc,
                    environment variables, or
                    calling program interal to C-Menu
    @param begy, begx - initial position of pick window
 */
Pick *new_pick(Init *init, int argc, char **argv, int begy, int begx) {
    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;
}
/** @brief Destroy Pick structure
    @ingroup mem
    @param init structure
    @return nullptr
 */
Pick *destroy_pick(Init *init) {
    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;
}
/** @brief Create and initialize Form structure
    @ingroup mem
    @param init structure
    @param argc - number of arguments in argv
    @param argv - Arguments may have been provided by command line,
                    ~/.minitrc,
                    environment variables, or
                    calling program interal to C-Menu
    @param begy, begx - initial position of form window
 */
Form *new_form(Init *init, int argc, char **argv, int begy, int begx) {
    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;
}
/** @brief Destroy Form structure
    @ingroup mem
    @param init structure
    @return nullptr
 */
Form *destroy_form(Init *init) {
    int 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;
}
/** @brief Create and initialize View structure
    @ingroup mem
    @param init structure
 */
View *new_view(Init *init) {
    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;
}
/** @brief Destroy View structure
    @ingroup mem
    @param init structure
    @return nullptr
 */
View *destroy_view(Init *init) {
    view = init->view;
    if (!view)
        return nullptr;
    if (view->ln_tbl) {
        free(view->ln_tbl);
        view->ln_tbl = nullptr;
    }
    if (view->ln_win) {
        delwin(view->ln_win);
        view->ln_win = nullptr;
    }
    if (view->cmdln_win) {
        delwin(view->cmdln_win);
        view->cmdln_win = nullptr;
    }
    delwin(view->cmdln_win);
    if (view->box) {
        delwin(view->box);
        view->box = nullptr;
    }
    delwin(view->box);
    if (view->pad) {
        delwin(view->pad);
        view->pad = nullptr;
    }
    delwin(view->pad);
    view->argc = destroy_argv(view->argc, view->argv);
    free(view->argv);
    free(view);
    init->view = nullptr;
    view = nullptr;
    init->view_cnt--;
    return init->view;
}
/** @brief Verify file specification argument
    @ingroup mem
    @param spec - menu->spec, form->spec, etc.
    @param org_spec - init->._spec | argv[optind]
    @param dir - init->._. directory
    @param alt_dir - literal, "~/menuapp/data", etc.
    @param mode - R_OK, W_OK, X_OK, WC_OK, S_QUIET
    @details mode is a bitwise OR of the following flags:
              S_QUIET - suppress error messages
              WC_OK - write create ok
    @return bool - true if file verified
 */
bool verify_spec_arg(char *spec, char *org_spec, char *dir, char *alt_dir,
                     int mode) {
    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)
                /** preserve quotes */
                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)
                /** preserve quotes */
                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;
}
/** @brief Initialize Menu file specifications
    @ingroup mem
    @param init structure
    @param argc - number of arguments in argv
    @param argv - Arguments may have been provided by command line,
                   ~/.minitrc, environment variables, or calling program
                   interal to C-Menu
    @details Positional args: [menu desc], [help file] */
bool init_menu_files(Init *init, int argc, char **argv) {
    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;
}
/** @brief Initialize Pick file specifications
    @ingroup mem
    @param init structure
    @param argc - number of arguments in argv
    @param argv - Arguments may have been provided by command line,
                   ~/.minitrc,
                   environment variables, or
                   calling program interal to C-Menu
    @details Positional args: [pick desc], [in_file], [out_file], [help_file] */
bool init_pick_files(Init *init, int argc, char **argv) {
    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_multiple_cmd_args = init->f_multiple_cmd_args;
    return true;
}
/** @brief Initialize Form file specifications
    @ingroup mem
    @param init pointer to init structure
    @param argc - number of arguments in argv
    @param argv - Arguments may have been provided by command line ~/.minitrc,
   environment variables, or calling program interal to C-Menu
    @details Positional args: [pick desc], [in_file], [out_file], [help_file] */
bool init_form_files(Init *init, int argc, char **argv) {
    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;
}
/** @brief Initialize View file specifications
    @ingroup mem
    @param init structure
    @details Positional args: pick desc, in_file, out_file, help_file */
bool init_view_files(Init *init) {
    char *e;
    view = init->view;
    view->lines = init->lines;
    view->cols = init->cols;
    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->f_ln = init->f_ln;
    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;
}