init.c File Reference

Initialization for Menu Application Programs. More...

#include <argp.h>
#include <common.h>
#include <locale.h>
#include <stddef.h>
#include <stdlib.h>
#include <string.h>
#include <time.h>
#include <unistd.h>
#include <wchar.h>

Include dependency graph for init.c:

Go to the source code of this file.

Macros
#define	_GNU_SOURCE

Enumerations

enum

InitVariables {   BG = 257 , FG , BOX_FG , BOX_BG ,   IND_FG , IND_BG , BRACKETS_FG , BRACKETS_BG ,   FILL_CHAR_FG , FILL_CHAR_BG , NT_FG , NT_BG ,   NT_REV_FG , NT_REV_BG , NT_HL_FG , NT_HL_BG ,   NT_HL_REV_FG , NT_HL_REV_BG , TITLE_FG , TITLE_BG ,   LN_FG , LN_BG , CMDLN_FG , CMDLN_BG ,   XBBLACK , XBBLUE , XBCYAN , XBGREEN ,   XBLACK , XBLUE , XBMAGENTA , XBRED ,   XBWHITE , XBYELLOW , XCYAN , CM_EDITOR ,   XGREEN , XMAGENTA , XRED , XWHITE ,   XYELLOW , GM_BLUE , GM_GRAY , GM_GREEN ,   GM_RED , MAPP_DATA , MAPP_HELP , MAPP_HOME ,   MAPP_MSRC , MAPP_USER , MAPP_SPEC , HELP_SPEC ,   MAPP_THEME , END_INIT_VARS }

Functions
bool	derive_file_spec (char *file_spec, char *dir, char *file_name)
	Derive full file specification from directory and file name.
void	display_version ()
	Display the version information of the application.
void	mapp_initialization (Init *init, int argc, char **argv)
	Main initialization function for MAPP - Menu Application.
void	opt_prt_bool (const char *o, const char *name, bool value)
	Print an option and its value in a formatted manner for boolean values.
void	opt_prt_char (const char *o, const char *name, const char *value)
	Print an option and its value in a formatted manner.
void	opt_prt_double (const char *o, const char *name, double value)
	Print an option and its value in a formatted manner for double values.
void	opt_prt_int (const char *o, const char *name, int value)
	Print an option and its value in a formatted manner for integer values.
void	opt_prt_str (const char *o, const char *name, const char *value)
	Print an option and its value in a formatted manner for integer values.
int	parse_opt_args (Init *init, int argc, char **argv)
	Parse command-line options and set Init struct values accordingly.
void	print_argp_doc (FILE *, char *, char *)
int	process_config_file (char *, Init *)
int	process_config_files (Init *init)
	parse the configuration file specified in init->minitrc and set Init struct values accordingly
int	write_config (Init *init)
	Write the current configuration to a file specified in init->minitrc.
void	zero_opt_args (Init *init)
	Initialize optional arguments in the Init struct to default values.

Variables
const char *	argp_program_bug_address = "billxwaller@gmail.com"
const char *	argp_program_version = CM_VERSION
int	executor = 0
bool	f_write_config = false

Detailed Description

Initialization for Menu Application Programs.

Author

Bill Waller Copyright (c) 2025 MIT License billx.nosp@m.wall.nosp@m.er@gm.nosp@m.ail..nosp@m.com

Date

2026-02-09

Definition in file init.c.

Macro Definition Documentation

_GNU_SOURCE

#define _GNU_SOURCE

Definition at line 20 of file init.c.

Enumeration Type Documentation

InitVariables

enum InitVariables

Enumerator
BG
FG
BOX_FG
BOX_BG
IND_FG
IND_BG
BRACKETS_FG
BRACKETS_BG
FILL_CHAR_FG
FILL_CHAR_BG
NT_FG
NT_BG
NT_REV_FG
NT_REV_BG
NT_HL_FG
NT_HL_BG
NT_HL_REV_FG
NT_HL_REV_BG
TITLE_FG
TITLE_BG
LN_FG
LN_BG
CMDLN_FG
CMDLN_BG
XBBLACK
XBBLUE
XBCYAN
XBGREEN
XBLACK
XBLUE
XBMAGENTA
XBRED
XBWHITE
XBYELLOW
XCYAN
CM_EDITOR
XGREEN
XMAGENTA
XRED
XWHITE
XYELLOW
GM_BLUE
GM_GRAY
GM_GREEN
GM_RED
MAPP_DATA
MAPP_HELP
MAPP_HOME
MAPP_MSRC
MAPP_USER
MAPP_SPEC
HELP_SPEC
MAPP_THEME
END_INIT_VARS

Definition at line 31 of file init.c.

             {
    BG = 257,
    FG,
    BOX_FG,
    BOX_BG,
    IND_FG,
    IND_BG,
    BRACKETS_FG,
    BRACKETS_BG,
    FILL_CHAR_FG,
    FILL_CHAR_BG,
    NT_FG,
    NT_BG,
    NT_REV_FG,
    NT_REV_BG,
    NT_HL_FG,
    NT_HL_BG,
    NT_HL_REV_FG,
    NT_HL_REV_BG,
    TITLE_FG,
    TITLE_BG,
    LN_FG,
    LN_BG,
    CMDLN_FG,
    CMDLN_BG,
    XBBLACK,
    XBBLUE,
    XBCYAN,
    XBGREEN,
    XBLACK,
    XBLUE,
    XBMAGENTA,
    XBRED,
    XBWHITE,
    XBYELLOW,
    XCYAN,
    CM_EDITOR,
    XGREEN,
    XMAGENTA,
    XRED,
    XWHITE,
    XYELLOW,
    GM_BLUE,
    GM_GRAY,
    GM_GREEN,
    GM_RED,
    MAPP_DATA,
    MAPP_HELP,
    MAPP_HOME,
    MAPP_MSRC,
    MAPP_USER,
    MAPP_SPEC,
    HELP_SPEC,
    MAPP_THEME,
    END_INIT_VARS
} InitVariables;

Function Documentation

print_argp_doc()

void print_argp_doc	(	FILE *	minitrc_fp,
		char *	config_s,
		char *	key )

Definition at line 1287 of file init.c.

                                                                 {
    char comment[MAXLEN];
    comment[0] = '\0';
    if (get_argp_doc_by_name(comment, options, key))
        (void)fprintf(minitrc_fp, "%-34s # %s\n", config_s, comment);
    else
        (void)fprintf(minitrc_fp, "%-34s #\n", config_s);
}

References get_argp_doc_by_name().

Referenced by write_config().

Here is the call graph for this function:

Here is the caller graph for this function:

process_config_file()

int process_config_file	(	char *	config_file_name,
		Init *	init )

Definition at line 631 of file init.c.

                                                            {
    char include_file_name[MAXLEN];
    char tmp_str[MAXLEN];
    char *src_p, *dp;
    SIO *sio = init->sio;
    char hex_clr_str[8];
    char key[MAXLEN];
    char value[MAXLEN];
    FILE *config_fp = fopen(config_file_name, "r");
    char quote_char = '\0';
    if (!config_fp) {
        fprintf(stderr, "failed to read file: %s %s\n", config_file_name, strerror(errno));
        return (-1);
    }
    while (fgets(tmp_str, sizeof(tmp_str), config_fp)) {
        bool inquotes = false;
        if (tmp_str[0] == '#')
            continue;
        src_p = tmp_str;
        key[0] = '\0';
        dp = key;
        // copy delimited by "=" into value
        while (*src_p != '\0') {
            if (*src_p == '\n')
                *dp = *src_p = '\0';
            if (*src_p == '=') {
                *dp = '\0';
                src_p++;
                break;
            }
            if (*src_p == '"' && *src_p == ' ') {
                src_p++;
                continue;
            }
            *dp++ = *src_p++;
        }
        value[0] = '\0';
        dp = value;
        // copy delimited by newline or unquoted "#" into value, removing quotes, spaces, semicolons, and newlines, but respecting quotes
        while (*src_p != '\0') {
            if ((*src_p == '"' || *src_p == '\'') && (*(src_p + 1) != '\\')) {
                if (!inquotes) {
                    inquotes = true;
                    quote_char = *src_p++;
                } else if (*src_p == quote_char) {
                    inquotes = false;
                    quote_char = '\0';
                }
            }
            if (!inquotes) {
                if (*src_p == '#') {
                    if (unstr_hex_clr(hex_clr_str, src_p)) {
                        strnz__cpy(value, hex_clr_str, MAXLEN - 1);
                        dp = value + strlen(value);
                    }
                    break;
                }
            }
            if (*src_p == ' ' || *src_p == ';') {
                src_p++;
                continue;
            }
            if (*src_p == '\n') {
                *src_p = '\0';
                break;
            }
            *dp++ = *src_p++;
        }
        *dp = '\0';
        if (key[0] == '\0')
            continue;
        if (value[0] == '\0')
            continue;
        if (!strcmp(key, "include")) {
            strnz__cpy(include_file_name, value, MAXLEN - 1);
            expand_tilde(include_file_name, MAXLEN - 1);
            process_config_file(include_file_name, init);
            continue;
        }
        if (!strcmp(key, "minitrc")) {
            strnz__cpy(init->minitrc, value, MAXLEN - 1);
            continue;
        }
        if (!strcmp(key, "lines")) {
            init->lines = atoi(value);
            continue;
        }
        if (!strcmp(key, "cols")) {
            init->cols = atoi(value);
            continue;
        }
        if (!strcmp(key, "begy")) {
            init->begy = atoi(value);
            continue;
        }
        if (!strcmp(key, "begx")) {
            init->begx = atoi(value);
            continue;
        }
        if (!strcmp(key, "f_ln")) {
            init->f_ln = str_to_bool(value);
            continue;
        }
        if (!strcmp(key, "f_at_end_remove")) {
            init->f_at_end_remove = str_to_bool(value);
            continue;
        }
        if (!strcmp(key, "f_erase_remainder")) {
            init->f_erase_remainder = str_to_bool(value);
            continue;
        }
        if (!strcmp(key, "brackets")) {
            strnz__cpy(init->brackets, value, 2);
            continue;
        }
        if (!strcmp(key, "fill_char")) {
            if (strlen(value) > 1)
                value[1] = '\0';
            if (wcwidth((int)value[0]) > 1)
                value[0] = '?';
            strnz__cpy(init->fill_char, value, 4);
            continue;
        }
        if (!strcmp(key, "f_ignore_case")) {
            init->f_ignore_case = str_to_bool(value);
            continue;
        }
        if (!strcmp(key, "p_view_files")) {
            init->p_view_files = str_to_bool(value);
            continue;
        }
        if (!strcmp(key, "f_read_theme")) {
            init->f_read_theme = str_to_bool(value);
            continue;
        }
        if (!strcmp(key, "f_squeeze")) {
            init->f_squeeze = str_to_bool(value);
            continue;
        }
        if (!strcmp(key, "f_strip_ansi")) {
            init->f_strip_ansi = str_to_bool(value);
            continue;
        }
        if (!strcmp(key, "f_multiple_cmd_args")) {
            init->f_multiple_cmd_args = str_to_bool(value);
            continue;
        }
        if (!strcmp(key, "select_max")) {
            init->select_max = atoi(value);
            continue;
        }
        if (!strcmp(key, "tab_stop")) {
            init->tab_stop = atoi(value);
            continue;
        }
        if (!strcmp(key, "h_shift")) {
            init->h_shift = atoi(value);
            continue;
        }
        if (!strcmp(key, "wait_timeout")) {
            wait_timeout = atoi(value);
            continue;
        }
        if (!strcmp(key, "title")) {
            strnz__cpy(init->title, value, MAXLEN - 1);
            continue;
        }
        if (!strcmp(key, "cmd")) {
            strnz__cpy(init->cmd, value, MAXLEN - 1);
            continue;
        }
        if (!strcmp(key, "cmd_all")) {
            strnz__cpy(init->cmd_all, value, MAXLEN - 1);
            continue;
        }
        if (!strcmp(key, "parent_cmd")) {
            strnz__cpy(init->parent_cmd, value, MAXLEN - 1);
            continue;
        }
        if (!strcmp(key, "provider_cmd")) {
            strnz__cpy(init->provider_cmd, value, MAXLEN - 1);
            continue;
        }
        if (!strcmp(key, "receiver_cmd")) {
            strnz__cpy(init->receiver_cmd, value, MAXLEN - 1);
            continue;
        }
        if (!strcmp(key, "editor")) {
            strnz__cpy(init->editor, value, MAXLEN - 1);
            continue;
        }
        if (!strcmp(key, "fg")) {
            strnz__cpy(sio->fg, value, COLOR_LEN - 1);
            continue;
        }
        if (!strcmp(key, "bg")) {
            strnz__cpy(sio->bg, value, COLOR_LEN - 1);
            continue;
        }
        if (!strcmp(key, "box_fg")) {
            strnz__cpy(sio->box_fg, value, COLOR_LEN - 1);
            continue;
        }
        if (!strcmp(key, "box_bg")) {
            strnz__cpy(sio->box_bg, value, COLOR_LEN - 1);
            continue;
        }
        if (!strcmp(key, "ind_fg")) {
            strnz__cpy(sio->ind_fg, value, COLOR_LEN - 1);
            continue;
        }
        if (!strcmp(key, "ind_bg")) {
            strnz__cpy(sio->ind_bg, value, COLOR_LEN - 1);
            continue;
        }
        if (!strcmp(key, "brackets_fg")) {
            strnz__cpy(sio->brackets_fg, value, COLOR_LEN - 1);
            continue;
        }
        if (!strcmp(key, "brackets_bg")) {
            strnz__cpy(sio->brackets_bg, value, COLOR_LEN - 1);
            continue;
        }
        if (!strcmp(key, "fill_char_fg")) {
            strnz__cpy(sio->fill_char_fg, value, COLOR_LEN - 1);
            continue;
        }
        if (!strcmp(key, "fill_char_bg")) {
            strnz__cpy(sio->fill_char_bg, value, COLOR_LEN - 1);
            continue;
        }
        if (!strcmp(key, "ln_fg")) {
            strnz__cpy(sio->ln_fg, value, COLOR_LEN - 1);
            continue;
        }
        if (!strcmp(key, "ln_bg")) {
            strnz__cpy(sio->ln_bg, value, COLOR_LEN - 1);
            continue;
        }
        if (!strcmp(key, "cmdln_fg")) {
            strnz__cpy(sio->ln_fg, value, COLOR_LEN - 1);
            continue;
        }
        if (!strcmp(key, "cmdln_bg")) {
            strnz__cpy(sio->ln_bg, value, COLOR_LEN - 1);
            continue;
        }
        if (!strcmp(key, "nt_fg")) {
            strnz__cpy(sio->nt_fg, value, COLOR_LEN - 1);
            continue;
        }
        if (!strcmp(key, "nt_bg")) {
            strnz__cpy(sio->nt_bg, value, COLOR_LEN - 1);
            continue;
        }
        if (!strcmp(key, "nt_rev_fg")) {
            strnz__cpy(sio->nt_rev_fg, value, COLOR_LEN - 1);
            continue;
        }
        if (!strcmp(key, "nt_rev_bg")) {
            strnz__cpy(sio->nt_rev_bg, value, COLOR_LEN - 1);
            continue;
        }
        if (!strcmp(key, "nt_hl_fg")) {
            strnz__cpy(sio->nt_hl_fg, value, COLOR_LEN - 1);
            continue;
        }
        if (!strcmp(key, "nt_hl_bg")) {
            strnz__cpy(sio->nt_hl_bg, value, COLOR_LEN - 1);
            continue;
        }
        if (!strcmp(key, "nt_hl_rev_fg")) {
            strnz__cpy(sio->nt_hl_rev_fg, value, COLOR_LEN - 1);
            continue;
        }
        if (!strcmp(key, "nt_hl_rev_bg")) {
            strnz__cpy(sio->nt_hl_rev_bg, value, COLOR_LEN - 1);
            continue;
        }
        if (!strcmp(key, "title_fg")) {
            strnz__cpy(sio->title_fg, value, COLOR_LEN - 1);
            continue;
        }
        if (!strcmp(key, "title_bg")) {
            strnz__cpy(sio->title_bg, value, COLOR_LEN - 1);
            continue;
        }
        if (!strcmp(key, "red_gamma")) {
            sio->red_gamma = str_to_double(value);
            continue;
        }
        if (!strcmp(key, "green_gamma")) {
            sio->green_gamma = str_to_double(value);
            continue;
        }
        if (!strcmp(key, "blue_gamma")) {
            sio->blue_gamma = str_to_double(value);
            continue;
        }
        if (!strcmp(key, "gray_gamma")) {
            sio->gray_gamma = str_to_double(value);
            continue;
        }
        if (!strcmp(key, "black")) {
            strnz__cpy(sio->black, value, COLOR_LEN - 1);
            continue;
        }
        if (!strcmp(key, "red")) {
            strnz__cpy(sio->red, value, COLOR_LEN - 1);
            continue;
        }
        if (!strcmp(key, "green")) {
            strnz__cpy(sio->green, value, COLOR_LEN - 1);
            continue;
        }
        if (!strcmp(key, "yellow")) {
            strnz__cpy(sio->yellow, value, COLOR_LEN - 1);
            continue;
        }
        if (!strcmp(key, "blue")) {
            strnz__cpy(sio->blue, value, COLOR_LEN - 1);
            continue;
        }
        if (!strcmp(key, "magenta")) {
            strnz__cpy(sio->magenta, value, COLOR_LEN - 1);
            continue;
        }
        if (!strcmp(key, "cyan")) {
            strnz__cpy(sio->cyan, value, COLOR_LEN - 1);
            continue;
        }
        if (!strcmp(key, "white")) {
            strnz__cpy(sio->white, value, COLOR_LEN - 1);
            continue;
        }
        if (!strcmp(key, "orange")) {
            strnz__cpy(sio->orange, value, COLOR_LEN - 1);
            continue;
        }
        if (!strcmp(key, "bblack")) {
            strnz__cpy(sio->bblack, value, COLOR_LEN - 1);
            continue;
        }
        if (!strcmp(key, "bred")) {
            strnz__cpy(sio->bred, value, COLOR_LEN - 1);
            continue;
        }
        if (!strcmp(key, "bgreen")) {
            strnz__cpy(sio->bgreen, value, COLOR_LEN - 1);
            continue;
        }
        if (!strcmp(key, "byellow")) {
            strnz__cpy(sio->byellow, value, COLOR_LEN - 1);
            continue;
        }
        if (!strcmp(key, "bblue")) {
            strnz__cpy(sio->bblue, value, COLOR_LEN - 1);
            continue;
        }
        if (!strcmp(key, "bmagenta")) {
            strnz__cpy(sio->bmagenta, value, COLOR_LEN - 1);
            continue;
        }
        if (!strcmp(key, "bcyan")) {
            strnz__cpy(sio->bcyan, value, COLOR_LEN - 1);
            continue;
        }
        if (!strcmp(key, "bwhite")) {
            strnz__cpy(sio->bwhite, value, COLOR_LEN - 1);
            continue;
        }
        if (!strcmp(key, "borange")) {
            strnz__cpy(sio->borange, value, COLOR_LEN - 1);
            continue;
        }
        if (!strcmp(key, "mapp_spec")) {
            strnz__cpy(init->mapp_spec, value, MAXLEN - 1);
            continue;
        }
        if (!strcmp(key, "mapp_data")) {
            strnz__cpy(init->mapp_data, value, MAXLEN - 1);
            continue;
        }
        if (!strcmp(key, "mapp_help")) {
            strnz__cpy(init->mapp_help, value, MAXLEN - 1);
            continue;
        }
        if (!strcmp(key, "mapp_home")) {
            strnz__cpy(init->mapp_home, value, MAXLEN - 1);
            continue;
        }
        if (!strcmp(key, "mapp_msrc")) {
            strnz__cpy(init->mapp_msrc, value, MAXLEN - 1);
            continue;
        }
        if (!strcmp(key, "mapp_user")) {
            strnz__cpy(init->mapp_user, value, MAXLEN - 1);
            continue;
        }
        if (!strcmp(key, "mapp_theme")) {
            strnz__cpy(init->mapp_theme, value, MAXLEN - 1);
            continue;
        }
    }
    (void)fclose(config_fp);
    return 0;
}

References SIO::bblack, SIO::bblue, SIO::bcyan, Init::begx, Init::begy, SIO::bg, SIO::bgreen, SIO::black, SIO::blue, SIO::blue_gamma, SIO::bmagenta, SIO::borange, SIO::box_bg, SIO::box_fg, Init::brackets, SIO::brackets_bg, SIO::brackets_fg, SIO::bred, SIO::bwhite, SIO::byellow, Init::cmd, Init::cmd_all, Init::cols, SIO::cyan, Init::editor, expand_tilde(), Init::f_at_end_remove, Init::f_erase_remainder, Init::f_ignore_case, Init::f_ln, Init::f_multiple_cmd_args, Init::f_read_theme, Init::f_squeeze, Init::f_strip_ansi, SIO::fg, Init::fill_char, SIO::fill_char_bg, SIO::fill_char_fg, SIO::gray_gamma, SIO::green, SIO::green_gamma, Init::h_shift, SIO::ind_bg, SIO::ind_fg, Init::lines, SIO::ln_bg, SIO::ln_fg, SIO::magenta, Init::mapp_data, Init::mapp_help, Init::mapp_home, Init::mapp_msrc, Init::mapp_spec, Init::mapp_theme, Init::mapp_user, Init::minitrc, SIO::nt_bg, SIO::nt_fg, SIO::nt_hl_bg, SIO::nt_hl_fg, SIO::nt_hl_rev_bg, SIO::nt_hl_rev_fg, SIO::nt_rev_bg, SIO::nt_rev_fg, SIO::orange, Init::p_view_files, Init::parent_cmd, process_config_file(), Init::provider_cmd, Init::receiver_cmd, SIO::red, SIO::red_gamma, Init::select_max, Init::sio, str_to_bool(), str_to_double(), strnz__cpy(), Init::tab_stop, Init::title, SIO::title_bg, SIO::title_fg, unstr_hex_clr(), wait_timeout, SIO::white, and SIO::yellow.

Referenced by process_config_file(), process_config_files(), and read_theme().

Here is the call graph for this function:

Here is the caller graph for this function:

Variable Documentation

argp_program_bug_address

const char* argp_program_bug_address = "billxwaller@gmail.com"

Definition at line 109 of file init.c.

argp_program_version

const char* argp_program_version = CM_VERSION

Definition at line 108 of file init.c.

executor

int executor = 0

Definition at line 106 of file init.c.

f_write_config

bool f_write_config = false

Definition at line 88 of file init.c.

Referenced by mapp_initialization().