/* NetHack 5.0	global.h	$NHDT-Date: 1704225560 2024/01/02 19:59:20 $  $NHDT-Branch: keni-luabits2 $:$NHDT-Revision: 1.159 $ */
/* Copyright (c) Stichting Mathematisch Centrum, Amsterdam, 1985. */
/*-Copyright (c) Michael Allison, 2006. */
/* NetHack may be freely redistributed.  See license for details. */

#ifndef GLOBAL_H
#define GLOBAL_H

/*
 * Files expected to exist in the playground directory (possibly inside
 * a dlb container file).
 */

#define RECORD "record"         /* file containing list of topscorers */
#define HELP "help"             /* file containing command descriptions */
#define SHELP "hh"              /* abbreviated form of the same */
#define KEYHELP "keyhelp"       /* explanatory text for 'whatdoes' command */
#define DEBUGHELP "wizhelp"     /* file containing debug mode cmds */
#define RUMORFILE "rumors"      /* file with fortune cookies */
#define ORACLEFILE "oracles"    /* file with oracular information */
#define DATAFILE "data"         /* file giving the meaning of symbols used */
#define CMDHELPFILE "cmdhelp"   /* file telling what commands do */
#define HISTORY "history"       /* file giving nethack's history */
#define LICENSE "license"       /* file with license information */
#define OPTIONFILE "opthelp"    /* file explaining runtime options */
#define OPTMENUHELP "optmenu"   /* file explaining #options command */
#define USAGEHELP "usagehlp"    /* file explaining command line use */
#define OPTIONS_USED "options"  /* compile-time options, for #version */
#define SYMBOLS "symbols"       /* replacement symbol sets */
#define EPITAPHFILE "epitaph"   /* random epitaphs on graves */
#define ENGRAVEFILE "engrave"   /* random engravings on the floor */
#define BOGUSMONFILE "bogusmon" /* hallucinatory monsters */
#define TRIBUTEFILE "tribute"   /* 3.6 tribute to Terry Pratchett */
#define LEV_EXT ".lua"          /* extension for special level files */

/* padding amounts for files that have lines chosen by fseek to random spot,
   advancing to the next line, and using that line; makedefs forces shorter
   lines to be padded to these lengths; value of 0 will inhibit any padding,
   avoiding an increase in files' sizes, but resulting in biased selection;
   used by makedefs while building and by core's callers of get_rnd_text() */
#define MD_PAD_RUMORS 60u /* for RUMORFILE, EPITAPHFILE, and ENGRAVEFILE */
#define MD_PAD_BOGONS 20u /* for BOGUSMONFILE */

/* Assorted definitions that may depend on selections in config.h. */

/*
 * for DUMB preprocessor and compiler, e.g., cpp and pcc supplied
 * with Microport SysV/AT, which have small symbol tables;
 * DUMB if needed is defined in CFLAGS
 */
#ifdef DUMB
#ifdef BITFIELDS
#undef BITFIELDS
#endif
#ifndef STUPID
#define STUPID
#endif
#endif /* DUMB */

/*
 * type xint8: small integers (typedef'd as signed,
 * in the range -127 - 127).
 */
typedef int8_t xint8;
/*
 * type coordxy: integers (typedef'd as signed,
 * in the range -32768 to 32767), mostly coordinates.
 * Note that in 2022, screen coordinates easily
 * surpass an upper limit of 127.
 */
typedef int16_t coordxy;
/*
 * type xint16: integers (typedef'd as signed,
 * in the range -32768 to 32767), non-coordinates.
 */
typedef int16_t xint16;

#ifdef __MINGW32__
/* Resolve conflict with Qt 5 and MinGW-w32 */
typedef unsigned char boolean; /* 0 or 1 */
#else
#ifndef SKIP_BOOLEAN
typedef schar boolean; /* 0 or 1 */
#endif
#endif

/* vision seen vectors: viz_array[][] and levl[][].seenv, which use different
   values from each other but are close enough in size to share a type;
   viz_array contains 8-bit bitmasks, lev->seenv is a 5-bit bitfield */
typedef unsigned char seenV; /* no need for uint8_t */

/* Type for third parameter of read(2) */
#if defined(BSD) || defined(ULTRIX)
typedef int readLenType;
#else /* e.g. SYSV, __TURBOC__ */
typedef unsigned readLenType;
#endif

#ifndef TRUE /* defined in some systems' native include files */
#define TRUE ((boolean) 1)
#define FALSE ((boolean) 0)
#endif
#define BOOL_RANDOM (-1)

/*
 * type nhsym: loadable symbols go into this type
 */
typedef uchar nhsym;

#ifndef STRNCMPI
/* SAS/C already shifts to stricmp */
#if !defined(__SASC_60) && !defined(CROSS_TO_AMIGA)
#define strcmpi(a, b) strncmpi((a), (b), -1)
#endif
#endif
#ifdef CROSS_TO_AMIGA
#define strcmpi(a, b) stricmp(a, b)
#endif

/* #define SPECIALIZATION */ /* do "specialized" version of new topology */

#ifdef BITFIELDS
#define Bitfield(x, n) unsigned x : n
#else
#define Bitfield(x, n) uchar x
#endif

#define SIZE(x) (int)(sizeof(x) / sizeof(x[0]))

/* A limit for some NetHack int variables.  It need not, and for comparable
 * scoring should not, depend on the actual limit on integers for a
 * particular machine, although it is set to the minimum required maximum
 * signed integer for C (2^15 -1).
 */
#define LARGEST_INT 32767

#include "coord.h"

/* define USING_ADDRESS_SANITIZER if ASAN is in use */
#if defined(__clang__)
#if defined(__has_feature)
#if __has_feature(address_sanitizer)
#define USING_ADDRESS_SANITIZER
#endif  /* __has_feature */
#endif  /* __has_feature(address_sanitizer) */
#else   /* ?__clang__ */
#if defined(__GNUC__) || defined(_MSC_VER)
#ifdef __SANITIZE_ADDRESS__
#define USING_ADDRESS_SANITIZER
#endif  /* __SANITIZE_ADDRESS__ */
#endif  /* __GNUC__ || _MSC_VER */
#endif  /* !__clang__ */

/*
 * Automatic inclusions for the subsidiary files.
 * Please don't change the order.  It does matter.
 */

#ifdef VMS
#include "vmsconf.h"
#endif

#ifdef UNIX
#include "unixconf.h"
#endif

#ifdef MSDOS
#include "pcconf.h"
#endif

#ifdef WIN32
#include "windconf.h"
#endif

#include "warnings.h"

/* amiconf.h needs to be the last nested #include of config.h because
   'make depend' will turn it into a comment, hiding anything after it */
#ifdef AMIGA
#include "amiconf.h"
#endif

/* Displayable name of this port; don't redefine if defined in *conf.h */
#ifndef PORT_ID
#ifdef AMIGA
#define PORT_ID "Amiga"
#endif
#ifdef MACOS9
#define PORT_ID "Mac"
#endif
#ifdef __APPLE__
#define PORT_ID "MacOS"
#endif
#ifdef MSDOS
#ifdef PC9800
#define PORT_ID "PC-9800"
#else
#define PORT_ID "PC"
#endif
#ifdef DJGPP
#define PORT_SUB_ID "djgpp"
#else
#ifdef OVERLAY
#define PORT_SUB_ID "overlaid"
#else
#define PORT_SUB_ID "non-overlaid"
#endif
#endif
#endif
#ifdef OS2
#define PORT_ID "OS/2"
#endif
#ifdef TOS
#define PORT_ID "ST"
#endif
/* Check again in case something more specific has been defined above. */
#ifndef PORT_ID
#ifdef UNIX
#define PORT_ID "Unix"
#endif
#endif
#ifdef VMS
#define PORT_ID "VMS"
#endif
#ifdef WIN32
#define PORT_ID "Windows"
#endif
#endif

#if !defined(CROSSCOMPILE)
#if defined(MICRO)
#if !defined(AMIGA) && !defined(TOS) && !defined(OS2_HPFS)
#define SHORT_FILENAMES /* filenames are 8.3 */
#endif
#endif
#endif

#include "fnamesiz.h" /* file sizes shared between nethack and recover */

#ifdef VMS
/* vms_exit() (sys/vms/vmsmisc.c) expects the non-VMS EXIT_xxx values below.
 * these definitions allow all systems to be treated uniformly, provided
 * main() routines do not terminate with return(), whose value is not
 * so massaged.
 */
#ifdef EXIT_SUCCESS
#undef EXIT_SUCCESS
#endif
#ifdef EXIT_FAILURE
#undef EXIT_FAILURE
#endif
#endif

#ifndef EXIT_SUCCESS
#define EXIT_SUCCESS 0
#endif
#ifndef EXIT_FAILURE
#define EXIT_FAILURE 1
#endif

#if defined(X11_GRAPHICS) || defined(QT_GRAPHICS) || defined(GNOME_GRAPHICS) \
    || defined(MSWIN_GRAPHICS)
#ifndef NO_TILE_C
#ifndef TILES_IN_GLYPHMAP
#define TILES_IN_GLYPHMAP
#endif
#endif
#endif
#if defined(AMII_GRAPHICS) || defined(GEM_GRAPHICS)
#ifndef NO_TILE_C
#ifndef TILES_IN_GLYPHMAP
#define TILES_IN_GLYPHMAP
#endif
#endif
#endif

#if defined(UNIX) || defined(VMS) || defined(__EMX__) || defined(WIN32)
#define HANGUPHANDLING
#endif
#if defined(SAFERHANGUP) \
    && (defined(NOSAVEONHANGUP) || !defined(HANGUPHANDLING))
#undef SAFERHANGUP
#endif

#define Sprintf (void) sprintf
#define Strcat (void) strcat
#define Strcpy (void) strcpy
#define Strlen(s) Strlen_(s,__func__,__LINE__)
#ifdef NEED_VARARGS
#define Vprintf (void) vprintf
#define Vfprintf (void) vfprintf
#define Vsprintf (void) vsprintf
#endif

/*
 *  Memory allocation.  Functions are declared here rather than in
 *  extern.h so that source files which use config.h instead of hack.h
 *  will see the declarations.
 *
 *  NetHack does not use malloc() [except to implement alloc() in alloc.c]
 *  or realloc() or calloc().  They return Null if memory runs out and
 *  nethack's code relies on alloc() to intercept that so that a zillion
 *  callers don't need to test for Null result.  alloc() never returns
 *  Null; if memory runs out, it calls panic() and does not return at all.
 */

/* dupstr() is unconditional in alloc.c but not used when MONITOR_HEAP
   is enabled; some utility programs link with alloc.{o,obj} and need it
   if nethack is built with MONITOR_HEAP enabled and they aren't; this
   declaration has been moved out of the '#else' below to avoid getting
   a complaint from -Wmissing-prototypes when building with MONITOR_HEAP */
extern char *dupstr(const char *) NONNULL NONNULLARG1;
/* same, but return strlen(string) in extra argument */
extern char *dupstr_n(const char *string,
                      unsigned *lenout) NONNULL NONNULLPTRS;

/*
 * MONITOR_HEAP is conditionally used for primitive memory leak debugging.
 * When enabled, NH_HEAPLOG (if defined in the environment) is used as the
 * name of a log file to create for capturing allocations and releases.
 * [The 'heaputil' program to analyze that file isn't included in releases.]
 *
 * See alloc.c.
 */
#ifdef MONITOR_HEAP
/* plain alloc() is not declared except in alloc.c */
extern long *nhalloc(unsigned int, const char *, int) NONNULL NONNULLARG2;
extern long *nhrealloc(long *, unsigned int, const char *,
                       int) NONNULL NONNULLARG3;
extern void nhfree(genericptr_t, const char *, int) NONNULLARG2;
extern char *nhdupstr(const char *, const char *, int) NONNULL NONNULLPTRS;
/* this predates C99's __func__; that is trickier to use conditionally
   because it is not implemented as a preprocessor macro; MONITOR_HEAP
   wouldn't gain much benefit from it anyway so continue to live without it;
   if func's caller were accessible, that would be a very different issue */
#define alloc(a) nhalloc(a, __FILE__, (int) __LINE__)
#define re_alloc(a,n) nhrealloc(a, n, __FILE__, (int) __LINE__)
#define free(a) nhfree(a, __FILE__, (int) __LINE__)
#define dupstr(s) nhdupstr(s, __FILE__, (int) __LINE__)
#else /* !MONITOR_HEAP */
/* declare alloc.c's alloc(); allocations made with it use ordinary free() */
extern long *alloc(unsigned int) NONNULL;  /* alloc.c */
extern long *re_alloc(long *, unsigned int) NONNULL;
#endif /* ?MONITOR_HEAP */

/* Used for consistency checks of various data files; declare it here so
   that utility programs which include config.h but not hack.h can see it. */
struct version_info {
    unsigned long incarnation;   /* actual version number */
    unsigned long feature_set;   /* bitmask of config settings */
    unsigned long entity_count;  /* # of monsters and objects */
};

/* This is used to store some build-info data that used
   to be present in makedefs-generated header file date.h */

struct nomakedefs_s {
    const char *build_date;
    const char *copyright_banner_c;
    const char *git_sha;
    const char *git_branch;
    const char *git_prefix;
    const char *version_string;
    const char *version_id;
    unsigned long version_number;
    unsigned long version_features;
    unsigned long ignored_features;
    unsigned long version_sanity1;
    unsigned long build_time;
};
extern struct nomakedefs_s nomakedefs;

/*
 * Configurable internal parameters.
 *
 * Please be very careful if you are going to change one of these.  Any
 * changes in these parameters, unless properly done, can render the
 * executable inoperative.
 */

/* size of terminal screen is (at least) (ROWNO+3) by COLNO */
#define COLNO 80
#define ROWNO 21

#define MAXNROFROOMS 40 /* max number of rooms per level */
#define MAX_SUBROOMS 24 /* max # of subrooms in a given room */
#define DOORINC      20 /* number of doors per level, increment */

#define BUFSZ 256  /* for getlin buffers */
#define QBUFSZ 128 /* for building question text */
#define TBUFSZ 300 /* gt.toplines[] buffer max msg: 3 81-char names
                    * plus longest prefix plus a few extra words */

/* COLBUFSZ is the larger of BUFSZ and COLNO */
#if BUFSZ > COLNO
#define COLBUFSZ BUFSZ
#else
#define COLBUFSZ COLNO
#endif

#define PL_NSIZ 32 /* name of player, ghost, shopkeeper */
#define PL_CSIZ 32 /* sizeof pl_character */
#define PL_FSIZ 32 /* fruit name */
#define PL_PSIZ 63 /* player-given names for pets, other monsters, objects */
/* room for "name-role-race-gend-algn" plus 1 character playmode code */
#define PL_NSIZ_PLUS (PL_NSIZ + 4 * (1 + 3) + 1) /* 49 */

#define MAXDUNGEON 16 /* current maximum number of dungeons */
#define MAXLEVEL 32   /* max number of levels in one dungeon */
#define MAXSTAIRS 1   /* max # of special stairways in a dungeon */
#define ALIGNWEIGHT 4 /* generation weight of alignment */

#define MAXULEV 30 /* max character experience level */

#define MAXMONNO 120 /* extinct monst after this number created */
#define MHPMAX 500   /* maximum monster hp */

#ifndef MAX_MSG_HISTORY
#define MAX_MSG_HISTORY 128 /* max # of lines in msg_history */
#endif

#include "color.h"

/*
 * Version 5.0.x has aspirations of portable file formats. We
 * make a distinction between MAIL functionality and MAIL_STRUCTURES
 * so that the underlying structures are consistent, whether MAIL is
 * defined or not.
 */
#define MAIL_STRUCTURES

/* PANICTRACE: Always defined for NH_DEVEL_STATUS != NH_STATUS_RELEASED
   but only for supported platforms. */
#ifndef NOPANICTRACE
#ifdef UNIX
#if (NH_DEVEL_STATUS != NH_STATUS_RELEASED)
/* see end.c */
#if !defined(CROSS_TO_WASM) && !defined(CROSS_TO_MSDOS)
#ifndef PANICTRACE
#define PANICTRACE
#endif  /* PANICTRACE */
#endif  /* CROSS_TO_WASM |  CROSS_TO_MSDOS */
#endif  /* NH_DEVEL_STATUS != NH_STATUS_RELEASED */
#endif  /* UNIX */
#endif  /* !NOPANICTRACE */

/* The following are meaningless if PANICTRACE is not defined: */
#if defined(__linux__) && defined(__GLIBC__) && (__GLIBC__ >= 2)
#define PANICTRACE_LIBC
#endif
#if defined(MACOS)
#define PANICTRACE_LIBC
#endif
#ifdef UNIX
#if !defined(CROSS_TO_WASM) /* no popen in WASM */
#define PANICTRACE_GDB
#endif
#ifdef CROSS_TO_WASM
#undef COMPRESS
#endif
#endif

/* Supply nethack_enter macro if not supplied by port */
#ifndef nethack_enter
#define nethack_enter(argc, argv) ((void) 0)
#endif

/* Supply nhassert macro if not supplied by port */
#ifndef nhassert
#define nhassert(expression) (void)((!!(expression)) || \
        (nhassert_failed(#expression, __FILE__, __LINE__), 0))
#endif

/* Macros for meta and ctrl modifiers:
 *   M and C return the meta/ctrl code for the given character;
 *     e.g., (C('c') is ctrl-c
 */
#ifndef M
#ifndef NHSTDC
#define M(c) (0x80 | (c))
#else
#define M(c) ((c) - 128)
#endif /* NHSTDC */
#endif

#ifndef C
#define C(c) (0x1f & (c))
#endif

#define unmeta(c) (0x7f & (c))

/* Game log message type flags */
#define LL_NONE       0x0000L /* No message is livelogged */
#define LL_WISH       0x0001L /* Report stuff people type at the wish prompt */
#define LL_ACHIEVE    0x0002L /* Achievements bitfield + invocation, planes */
#define LL_UMONST     0x0004L /* defeated unique monster */
#define LL_DIVINEGIFT 0x0008L /* Sacrifice gifts, crowning */
#define LL_LIFESAVE   0x0010L /* Use up amulet of lifesaving */
#define LL_CONDUCT    0x0020L /* Break conduct - not reported early-game */
#define LL_ARTIFACT   0x0040L /* bestowed, found, or manufactured */
#define LL_GENOCIDE   0x0080L /* Logging of genocides */
#define LL_KILLEDPET  0x0100L /* Killed a tame monster */
#define LL_ALIGNMENT  0x0200L /* changed alignment, temporary or permanent */
#define LL_DUMP_ASC   0x0400L /* Log URL for dumplog if ascended */
#define LL_DUMP_ALL   0x0800L /* Log dumplog url for all games */
#define LL_MINORAC    0x1000L /* Log 'minor' achievements - can be spammy */
#define LL_SPOILER    0x2000L /* reveals information so don't show in-game
                               * via #chronicle unless in wizard mode */
#define LL_DUMP       0x4000L /* none of the above but should be in dumplog */
#define LL_DEBUG      0x8000L /* For debugging messages and other spam */

/*
 * Lua sandbox
 */
/* Control block for setting up a Lua state with nhl_init(). */
typedef struct nhl_sandbox_info {
    uint32_t  flags;       /* see below */
    uint32_t  memlimit;    /* approximate memory limit */
    uint32_t  steps;       /* instruction limit for state OR ... */
    uint32_t  perpcall;    /* ... instruction limit per nhl_pcall */
} nhl_sandbox_info;

/* For efficiency, we only check every NHL_SB_STEPSIZE instructions. */
#ifndef NHL_SB_STEPSIZE
#define NHL_SB_STEPSIZE 1000
#endif

/* High level groups.  Use these flags. */
    /* Safe functions. */
#define NHL_SB_SAFE        0x80000000
    /* Access to Lua version information. */
#define NHL_SB_VERSION     0x40000000
    /* Debugging library - mostly unsafe. */
#define NHL_SB_DEBUGGING   0x08000000

/* Low level groups.  If you need these, you probably need to define
 * a new high level group instead. */
#define NHL_SB_STRING      0x00000001
#define NHL_SB_TABLE       0x00000002
#define NHL_SB_COROUTINE   0x00000004
#define NHL_SB_MATH        0x00000008
#define NHL_SB_UTF8        0x00000010
#ifdef notyet
#define NHL_SB_IO          0x00000020
#endif
#define NHL_SB_OS          0x00000040

#define NHL_SB_BASEMASK    0x00000f80
#define NHL_SB_BASE_BASE   0x00000080
#define NHL_SB_BASE_ERROR  0x00000100
#define NHL_SB_BASE_META   0x00000200
#define NHL_SB_BASE_GC     0x00000400
#define NHL_SB_BASE_UNSAFE 0x00000800

#define NHL_SB_DBMASK      0x00003000
#define NHL_SB_DB_DB       0x00001000
#define NHL_SB_DB_SAFE     0x00002000

#define NHL_SB_OSMASK      0x0000c000
#define NHL_SB_OS_TIME     0x00004000
#define NHL_SB_OS_FILES    0x00008000

#define NHL_SB_ALL         0x0000ffff

/* return codes */
#define NHL_SBRV_DENY 1
#define NHL_SBRV_ACCEPT 2
#define NHL_SBRV_FAIL 3

/* NHL_pcall_handle action values */
typedef enum NHL_pcall_action {
    NHLpa_panic,
    NHLpa_impossible
} NHL_pcall_action;

enum optchoice { opt_in, opt_out};
/*
 * option setting restrictions
 */
enum optset_restrictions {
    set_in_sysconf = 0, /* system config file option only */
    set_in_config = 1,  /* config file option only */
    set_viaprog = 2,    /* may be set via extern program, not seen in game */
    set_gameview = 3,   /* may be set via extern program, displayed in game */
    set_in_game = 4,    /* may be set via extern program or set in the game */
    set_wizonly = 5,    /* may be set in the game if wizmode */
    set_wiznofuz = 6,   /* wizard-mode only, but not by fuzzer */
    set_hidden = 7      /* placeholder for prefixed entries, never show it  */
};

/* these aren't the same as set_xxx */
enum option_phases {
    phase_not_set = 0,
    builtin_opt = 1, /* compiled-in default value of an option */
    syscf_opt,       /* sysconf setting of an option, overrides builtin */
    rc_file_opt, /* player's run-time config file setting, overrides syscf */
    environ_opt, /* player's environment NETHACKOPTIONS, overrides rc_file */
    cmdline_opt, /* program invocation command-line, overrides environ */
    play_opt,    /* 'O' command, interactively set so overrides all */
    num_opt_phases
};

#define SET__IS_VALUE_VALID(s) ((s < set_in_sysconf) || (s > set_wiznofuz))
#include "optlist.h"
enum opt {
    opt_prefix_only = -1,
#define NHOPT_ENUM
#include "optlist.h"
#undef NHOPT_ENUM
    OPTCOUNT
};



#define SFCTOOL_BIT (1UL << 30)

#endif /* GLOBAL_H */
