Files
mercury/grade_lib/var_value_names.m
Zoltan Somogyi 05ef8e01fb Rename the .ll_debug grade component to .c_debug.
Rename mmc and mgnuc options that set this grade component to --c-debug-grade.
Let the options named --c-debug of both mmc and mgnuc enable C level debugging
of only the module being compiled.

runtime/mercury_grade.h:
    Rename the .ll_debug grade component to .c_debug. Also rename the C macro
    that controls the presence or absence of this grade component
    from MR_LL_DEBUG to MR_C_DEBUG_GRADE.

runtime/mercury_conf_param.h:
runtime/mercury_debug.c:
runtime/mercury_debug.h:
runtime/mercury_engine.c:
runtime/mercury_label.c:
runtime/mercury_memory_zones.c:
runtime/mercury_memory_zones.h:
runtime/mercury_overflow.c:
runtime/mercury_std.h:
runtime/mercury_wrapper.c:
    Rename the MR_LOWLEVEL_DEBUG macro to MR_DEBUG_THE_RUNTIME.
    Previously, the name of this macro wrongly implied that it had
    something to do with the old .ll_debug grade component, even though

    - the MR_LOWLEVEL_DEBUG macro was designed to debug LLDS grades,
      since only these existed when it was created, while

    - the .ll_debug grade component (now .c_debug) is useful only for
      MLDS grades targeting C.

compiler/options.m:
    Rename the old confusingly named low_level_debug option to c_debug_grade.
    Move it to the list of grade options, and fix its documentation, which
    was completely wrong:

    - code in compile_target_code.m treated it as being a synonym of
      the .ll_debug (now .c_debug) grade component, while
    - its (commented out) documentation here in options.m said it called for
      the enabling of what is now MR_DEBUG_THE_RUNTIME.

compiler/compile_target_code.m:
    Conform to the rename just above.

    Define MR_C_DEBUG_GRADE instead of MR_LL_DEBUG if c_debug_grade is enabled.

    Pass -g to the C compiler if either c_debug_grade or target_debug
    is enabled.

    Add an XXX about a missing safety check for an obsolete experimental
    feature.

compiler/compute_grade.m:
    When given a grade with a .c_debug grade component, set only the
    c_debug_grade option; don't set the target_debug option, which is NOT
    a grade option. The change to compile_target_code.m above handles the
    only situation in which this implication was formerly required.

scripts/canonical_grade.sh-subr:
scripts/init_grade_options.sh-subr:
scripts/parse_grade_options.sh-subr:
    Look for and process the .c_debug grade component instead of .ll_debug.
    Use a sh variable named c_debug_grade to record its absence/presence.

    Look for and process the --c-debug-grade grade-component option,
    setting the same sh variable, c_debug_grade. (All grade components
    can be set piecemeal using sh options to the scripts using these
    subroutines.) This replaces the old, confusingly named option
    --low-level-debug.

scripts/mgnuc.in:
scripts/mgnuc_file_opts.sh-subr:
    Consistently use the sh variable c_debug to record the presence of
    the (non-grade) --c-debug option to mgnuc, and the sh variable
    c_debug_grade to record the presence of the .c_debug grade component.

    Stop looking for and handling the --low-level-debug option, which
    mgnuc used to document, even though this duplicated the same documentation
    in init_grade_options.sh-subr, which mgnuc includes. The difference was
    that init_grade_options.sh-subr meant it to represent the old .ll_debug
    MLDS grade component, while mgnuc treated it as specifying what is now
    MR_DEBUG_THE_RUNTIME for LLDS grades. It didn't help that two sh variables
    with quite different semantics had names that differed only in an
    underscore: LLDEBUG_OPTS vs LL_DEBUG_OPTS.

scripts/Mmakefile:
    Add a missing dependency to force the rebuild of mgnuc after each update
    of its sh subroutine mgnuc_file_ops.sh-subr.

doc/user_guide.texi:
    Document the --c-debug-grade option of mmc. This option was not publicly
    documented under its original misleading name (--low-level-debug), but
    its documentation is now possible without contorted dancing around the
    name.

    Clarify the documentation of mgnuc's --c-debug option.

README.sanitizers:
configure.ac:
    Conform to the rename of the grade component.

grade_lib/grade_spec.m:
grade_lib/grade_string.m:
grade_lib/grade_structure.m:
grade_lib/try_all_grade_structs.m:
    Conform to the rename of the grade component .ll_debug to .c_debug.

    Don't allow the .c_debug grade component in LLDS grades.

    In grade_string.m, add some obvious implications of some grade components.

grade_lib/choose_grade.m:
grade_lib/grade_lib.m:
grade_lib/test_grades.m:
grade_lib/var_value_names.m:
    Fix white space.

scripts/ml.in:
tools/lmc.in:
tools/test_mercury:
    Conform to the change in compile_target_code.m to the naming of
    Boehm gc library variants.
2022-12-29 20:33:08 +11:00

188 lines
9.4 KiB
Mathematica

%---------------------------------------------------------------------------%
% vim: ts=4 sw=4 et ft=mercury
%---------------------------------------------------------------------------%
% Copyright (C) 2016, 2018 The Mercury team.
% This file is distributed under the terms specified in COPYING.LIB.
%---------------------------------------------------------------------------%
%
% Maps the solver_var_ids and solver_var_value_ids to strings and vice versa.
% These names are used by choose_grade.m to specify what grade problem
% the user wishes to set up, and by error messages during the solver setup
% process.
%
% XXX The compiler will use a mechanism for specifying grade problems
% to be solved using a mechanism ENTIRELY SEPARATE from this one.
%
:- module var_value_names.
:- interface.
:- import_module grade_lib.
:- import_module grade_lib.grade_spec.
%---------------------------------------------------------------------------%
:- pred solver_var_name(string, solver_var_id).
:- mode solver_var_name(in, out) is semidet.
:- mode solver_var_name(out, in) is det.
:- pred solver_var_value_name(string, solver_var_value_id).
:- mode solver_var_value_name(in, out) is semidet.
:- mode solver_var_value_name(out, in) is det.
%---------------------------------------------------------------------------%
:- implementation.
%---------------------------------------------------------------------------%
solver_var_name("gcc_regs_avail", svar_ac_gcc_regs_avail).
solver_var_name("gcc_gotos_avail", svar_ac_gcc_gotos_avail).
solver_var_name("gcc_labels_avail", svar_ac_gcc_labels_avail).
solver_var_name("low_tag_bits_avail", svar_ac_low_tag_bits_avail).
solver_var_name("size_of_double", svar_ac_size_of_double).
solver_var_name("mercuryfile", svar_ac_merc_file).
solver_var_name("backend", svar_backend).
solver_var_name("target", svar_target).
solver_var_name("gcc_conf", svar_gcc_conf).
solver_var_name("low_tag_bits_use", svar_low_tag_bits_use).
solver_var_name("stack_len", svar_stack_len).
solver_var_name("trail", svar_trail).
solver_var_name("minmodel", svar_minmodel).
solver_var_name("thread_safe", svar_thread_safe).
solver_var_name("gc", svar_gc).
solver_var_name("deep_prof", svar_deep_prof).
solver_var_name("mprof_call", svar_mprof_call).
solver_var_name("mprof_time", svar_mprof_time).
solver_var_name("mprof_memory", svar_mprof_memory).
solver_var_name("tscope_prof", svar_tscope_prof).
solver_var_name("term_size_prof", svar_term_size_prof).
solver_var_name("debug", svar_debug).
solver_var_name("ssdebug", svar_ssdebug).
solver_var_name("target_debug", svar_target_debug).
solver_var_name("rbmm", svar_rbmm).
solver_var_name("rbmm_debug", svar_rbmm_debug).
solver_var_name("rbmm_prof", svar_rbmm_prof).
solver_var_name("pregen", svar_pregen).
solver_var_name("single_prec_float", svar_request_single_prec_float).
solver_var_name("merc_float", svar_merc_float).
solver_var_value_name("gcc_regs_not_avail", svalue_ac_gcc_regs_avail_no).
solver_var_value_name("gcc_regs_avail", svalue_ac_gcc_regs_avail_yes).
solver_var_value_name("gcc_gotos_not_avail", svalue_ac_gcc_gotos_avail_no).
solver_var_value_name("gcc_gotos_avail", svalue_ac_gcc_gotos_avail_yes).
solver_var_value_name("gcc_labels_not_avail", svalue_ac_gcc_labels_avail_no).
solver_var_value_name("gcc_labels_avail", svalue_ac_gcc_labels_avail_yes).
solver_var_value_name("low_tag_bits_avail_0", svalue_ac_low_tag_bits_avail_0).
solver_var_value_name("low_tag_bits_avail_2", svalue_ac_low_tag_bits_avail_2).
solver_var_value_name("low_tag_bits_avail_3", svalue_ac_low_tag_bits_avail_3).
solver_var_value_name("size_of_double_eq_ptr", svalue_ac_size_of_double_eq_ptr).
solver_var_value_name("size_of_double_ne_ptr", svalue_ac_size_of_double_ne_ptr).
solver_var_value_name("no_mercuryfile", svalue_ac_merc_file_no).
solver_var_value_name("mercuryfile", svalue_ac_merc_file_yes).
solver_var_value_name("mlds", svalue_backend_mlds).
solver_var_value_name("llds", svalue_backend_llds).
solver_var_value_name("c", svalue_target_c).
solver_var_value_name("csharp", svalue_target_csharp).
solver_var_value_name("java", svalue_target_java).
solver_var_value_name("none", svalue_gcc_conf_none).
solver_var_value_name("reg", svalue_gcc_conf_reg).
solver_var_value_name("jump", svalue_gcc_conf_jump).
solver_var_value_name("fast", svalue_gcc_conf_fast).
solver_var_value_name("asm_jump", svalue_gcc_conf_asm_jump).
solver_var_value_name("asm_fast", svalue_gcc_conf_asm_fast).
solver_var_value_name("low_tag_bits_use_0", svalue_low_tag_bits_use_0).
solver_var_value_name("low_tag_bits_use_2", svalue_low_tag_bits_use_2).
solver_var_value_name("low_tag_bits_use_3", svalue_low_tag_bits_use_3).
solver_var_value_name("stfix", svalue_stack_len_std).
solver_var_value_name("stseg", svalue_stack_len_segments).
solver_var_value_name("exts", svalue_stack_len_extend).
solver_var_value_name("no_trail", svalue_trail_no).
solver_var_value_name("trail", svalue_trail_yes).
solver_var_value_name("no_mm", svalue_minmodel_no).
solver_var_value_name("mm_stack_copy",
svalue_minmodel_stack_copy).
solver_var_value_name("mm_stack_copy_debug",
svalue_minmodel_stack_copy_debug).
solver_var_value_name("mm_own_stack",
svalue_minmodel_own_stack).
solver_var_value_name("mm_own_stack_debug",
svalue_minmodel_own_stack_debug).
solver_var_value_name("not_thread_safe", svalue_thread_safe_c_no).
solver_var_value_name("thread_safe", svalue_thread_safe_c_yes).
solver_var_value_name("native_thread_safe",
svalue_thread_safe_target_native).
solver_var_value_name("no_gc", svalue_gc_none).
solver_var_value_name("bdw", svalue_gc_bdw).
solver_var_value_name("bdw_debug", svalue_gc_bdw_debug).
solver_var_value_name("target_native", svalue_gc_target_native).
solver_var_value_name("accurate", svalue_gc_accurate).
solver_var_value_name("history", svalue_gc_history).
solver_var_value_name("no_deep_prof", svalue_deep_prof_no).
solver_var_value_name("deep_prof", svalue_deep_prof_yes).
solver_var_value_name("no_mprof_call", svalue_mprof_call_no).
solver_var_value_name("mprof_call", svalue_mprof_call_yes).
solver_var_value_name("no_mprof_time", svalue_mprof_time_no).
solver_var_value_name("mprof_time", svalue_mprof_time_yes).
solver_var_value_name("no_mprof_memory", svalue_mprof_memory_no).
solver_var_value_name("mprof_memory", svalue_mprof_memory_yes).
solver_var_value_name("no_tscope_prof", svalue_tscope_prof_no).
solver_var_value_name("tscope_prof", svalue_tscope_prof_yes).
solver_var_value_name("no_term_size_prof", svalue_term_size_prof_no).
solver_var_value_name("term_size_prof_cells", svalue_term_size_prof_cells).
solver_var_value_name("term_size_prof_words", svalue_term_size_prof_words).
solver_var_value_name("nodebug", svalue_debug_none).
solver_var_value_name("debug", svalue_debug_debug).
solver_var_value_name("decldebug", svalue_debug_decldebug).
solver_var_value_name("no_ssdebug", svalue_ssdebug_no).
solver_var_value_name("ssdebug", svalue_ssdebug_yes).
solver_var_value_name("no_target_debug", svalue_target_debug_no).
solver_var_value_name("target_debug", svalue_target_debug_yes).
solver_var_value_name("no_rbmm", svalue_rbmm_no).
solver_var_value_name("rbmm", svalue_rbmm_yes).
solver_var_value_name("no_rbmm_debug", svalue_rbmm_debug_no).
solver_var_value_name("rbmm_debug", svalue_rbmm_debug_yes).
solver_var_value_name("no_rbmm_prof", svalue_rbmm_prof_no).
solver_var_value_name("rbmm_prof", svalue_rbmm_prof_yes).
solver_var_value_name("no_pregen", svalue_pregen_no).
solver_var_value_name("pregen", svalue_pregen_yes).
solver_var_value_name("no_spf", svalue_request_single_prec_float_no).
solver_var_value_name("spf", svalue_request_single_prec_float_yes).
solver_var_value_name("boxed_double", svalue_merc_float_is_boxed_c_double).
solver_var_value_name("unboxed_double", svalue_merc_float_is_unboxed_c_double).
solver_var_value_name("unboxed_float", svalue_merc_float_is_unboxed_c_float).
%---------------------------------------------------------------------------%
:- end_module var_value_names.
%---------------------------------------------------------------------------%