NHDT->ANH, in most cases
[aNetHack.git] / sys / unix / sysconf
blob9e877ea8fd8b4e689a6eb19b00c44e21434c0e81
1 # NetHack 3.6 sysconf $ANH-Date$ $ANH-Branch$:$ANH-Revision$
3 # Sample sysconf file.
4 # The sysconf file is only used if NetHack is compiled with SYSCF defined.
5 # It can be used to augment or override certain settings compiled into the
6 # program.
8 # This file can also be used to set local system defaults for run-time
9 # options, using the same syntax as an individual user's ./nethackrc file.
11 # Which users can use debug mode (aka wizard mode; accessed via '-D' command
12 # line flag or OPTIONS=playmode:debug in the runtime options config file).
13 # A value of * allows anyone to enter debugging mode.
14 WIZARDS=root games
16 # Which users can use explore mode (aka discover mode; accessed via '-X'
17 # command line flag or OPTIONS=playmode:explore in runtime options file or
18 # via '#exploremode' command during normal play).  Same syntax as WIZARDS.
19 EXPLORERS=*
21 # Users allowed to use the '!' (shell escape) and '^Z' (suspend process)
22 # commands to temporarily leave the game and enter a shell process.
23 # (To resume play, use the shell command 'exit' (for most shells) to
24 # return from '!' or the shell command 'fg' to return from '^Z'.
25 # For the typical multi-user system where players have access to a shell
26 # prompt when logged in and run the game from their own username, a value
27 # of 'SHELLERS=*' is appropriate.  However, some inexperienced players
28 # occasionally get stuck outside the game by accidentally typing '!' or
29 # '^Z' during play and not knowing how to go back.)
30 # Uses the same syntax as the WIZARDS and EXPLORERS options above.
31 #SHELLERS=
33 # If the user name is found in this list, prompt for username instead.
34 # Uses the same syntax as the WIZARDS option above.
35 # A public server should probably disable this.
36 GENERICUSERS=play player game games nethack nethacker
38 # Use the player name for matching WIZARDS, EXPLORERS and SHELLERS,
39 # instead of the user's login name.
40 #CHECK_PLNAME=1
42 # Limit the number of simultaneous games (see also nethack.sh).
43 # Valid values are 0-25.
44 # Commenting this out or setting the value to 0 constructs lock files
45 # with UID and playername, so each user may have one game at a time,
46 # but number of different players is not limited.
47 # Setting this to any other value constructs the lock files with
48 # letter and "lock" (eg. alock, block, ...)
49 MAXPLAYERS=10
51 # If not null, added to string "To get local support, " in the support
52 # information help.
53 #SUPPORT=call Izchak at extension 42.
55 # If not null, displayed at the end of a panic-save sequence.
56 #RECOVER=Run the recover program.
58 # Uncomment the next line to disable the SEDUCE option, causing succubi and
59 # incubi to use nymphs' charm behavior rather than their own seduce behavior.
60 #SEDUCE=0
62 # Uncomment to disable savefile UID checking.
63 #CHECK_SAVE_UID=0
65 # Record (high score) file options.
66 # CAUTION: changing these after people have started playing games can
67 #  lead to lost high scores!
68 # Maximum entries for one person.
69 #PERSMAX=10
70 # Maximum entries in the record file.
71 #ENTRYMAX=100
72 # Minimum points to get an entry.
73 #POINTSMIN=1
74 # Determine identity of "person" in the score file with name (0) or
75 # numeric (1) user id.
76 #PERS_IS_UID=1
78 # Maximum number of score file entries to use for random statue names
79 #MAX_STATUENAME_RANK=10
81 # Show debugging information originating from these source files.
82 # Use '*' for all, or list source files separated by spaces.
83 # Only available if game has been compiled with DEBUG, and can be
84 # overridden via DEBUGFILES environment variable.
85 #DEBUGFILES=*
87 # Save end of game dump log to this file.
88 # Only available if NetHack was compiled with DUMPLOG
89 # Allows following placeholders:
90 #   %% literal '%'
91 #   %v version (eg. "3.6.1-0")
92 #   %u game UID
93 #   %t game start time, UNIX timestamp format
94 #   %T current time, UNIX timestamp format
95 #   %d game start time, YYYYMMDDhhmmss format
96 #   %D current time, YYYYMMDDhhmmss format
97 #   %n player name
98 #   %N first character of player name
99 #DUMPLOGFILE=/tmp/nethack.%n.%d.log
101 # Try to get more info in case of a program bug or crash.  Only used
102 # if the program is built with the PANICTRACE compile-time option enabled.
103 # By default PANICTRACE is enabled if BETA is defined, otherwise disabled.
104 # Using GDB can get more information and works on more systems but requires
105 # 'gdb' be available; using LIBC only works if NetHack is linked with a
106 # libc that supports the backtrace(3) API.  Both require certain compilation
107 # options.  See src/end.c and sys/unix/hints/* for more information.
108 GDBPATH=/usr/bin/gdb
109 GREPPATH=/bin/grep
110 # Values are priorities: 0 - do not use this method, 1 - low priority,
111 # 2 - high priority.  Non-zero priority methods are tried in order.
112 PANICTRACE_GDB=1
113 PANICTRACE_LIBC=2
115 # Ordinary run-time options can be set here to override the builtin-in
116 # default values.  Unlike the SYSCF values above, individual users can
117 # still choose their own option settings via NETHACKOPTIONS in their
118 # environment or via ~/.nethackrc run-time configuration file.
119 #OPTIONS=!autopickup,fruit:tomato,symset:DECgraphics
121 #eof