options.h

/// @file

#ifndef U3_OPTIONS_H
#define U3_OPTIONS_H

#include "c3.h"
#include "types.h"

  /** Data structures.
  **/
    /* u3o_config: process / system configuration.
    */
      typedef struct _u3o_config {
        u3_noun who;                          //  single identity
        c3_c*   dir_c;                        //  execution directory (pier)
        c3_c*   eph_c;                        //  ephemeral file
        c3_w    wag_w;                        //  flags (both ways)
        size_t  wor_i;                        //  loom word-length (<= u3a_words)
        c3_w    tos_w;                        //  loom toss skip-length
        c3_w    hap_w;                        //  transient memoization cache size
        c3_w    per_w;                        //  persistent memoization cache size
        void (*stderr_log_f)(c3_c*);          //  errors from c code
        void (*slog_f)(u3_noun);              //  function pointer for slog
        void (*sign_hold_f)(void);            //  suspend system signal regime
        void (*sign_move_f)(void);            //  restore system signal regime
      } u3o_config;

    /* u3o_flag: process/system flags.
    **
    **  _debug flags are set outside u3 and heard inside it.
    **  _check flags are set inside u3 and heard outside it.
    */
      enum u3o_flag {                         //  execution flags
        u3o_debug_ram     = 1 <<  0,          //  debug: gc
        u3o_debug_cpu     = 1 <<  1,          //  debug: profile
        u3o_check_corrupt = 1 <<  2,          //  check: gc memory
        u3o_check_fatal   = 1 <<  3,          //  check: unrecoverable
        u3o_verbose       = 1 <<  4,          //  be remarkably wordy
        u3o_dryrun        = 1 <<  5,          //  don't touch checkpoint
        u3o_quiet         = 1 <<  6,          //  disable ~&
        u3o_hashless      = 1 <<  7,          //  disable hashboard
        u3o_trace         = 1 <<  8,          //  enables trace dumping
        u3o_no_demand     = 1 <<  9,          //  disables demand paging
        u3o_auto_meld     = 1 << 10,          //  enables meld under pressure
        u3o_soft_mugs     = 1 << 11,          //  continue replay on mismatch
        u3o_swap          = 1 << 12,          //  enables ephemeral file
        u3o_toss          = 1 << 13           //  reclaim often
      };

  /** Globals.
  **/
    /* u3_Config / u3C: global memory control.
    */
      extern u3o_config u3o_Config;
#     define u3C u3o_Config

#endif /* ifndef U3_OPTIONS_H */