Sysconf - Revision history

Phol ende wodan: expand on what sysconf does and doesn't do in top section, add new 3.7 sysconf option

2026-01-20T18:05:14Z

expand on what sysconf does and doesn't do in top section, add new 3.7 sysconf option

Ville: /* PERS_IS_UID */ add default

2025-03-10T09:46:35Z

‎PERS_IS_UID: add default

Furey: No version template. Make it {{nethack-361}} based on history.

2024-06-07T15:20:01Z

No version template. Make it {{nethack-361}} based on history.

Paxed: links

2019-03-22T19:24:33Z

links

Paxed: update for 361

2019-03-22T19:20:21Z

update for 361

Paxed: start of sysconf

2018-12-12T06:37:00Z

start of sysconf

New page

{{stub}}
The system-wide configuration file, sysconf, is a plain text-file, usually in the same directory as NetHack binary, and it allows the system admin to change some settings compiled into the game. Only available if NetHack was compiled with SYSCF.

sysconf can also be used to set defaults for config [[options]].

File format is the same as the options file.

==Settings==

===WIZARDS===
Which users can use debug mode (aka wizard mode; accessed via '-D' command
line flag or <tt>OPTIONS=playmode:debug</tt> in the runtime [[options]] config file).
A value of * allows anyone to enter debugging mode.
WIZARDS=root games

===EXPLORERS===
Which users can use explore mode (aka discover mode; accessed via '-X'
command line flag or <tt>OPTIONS=playmode:explore</tt> in runtime [[options]] file or
via #exploremode command during normal play). Same syntax as WIZARDS.
EXPLORERS=*

===SHELLERS===
Users allowed to use the '!' (shell escape) and '^Z' (suspend process)
commands to temporarily leave the game and enter a shell process.
Uses the same syntax as the WIZARDS and EXPLORERS options.

===GENERICUSERS===
If the user name is found in this list, prompt for username instead.
Uses the same syntax as the WIZARDS option above.
A public server should probably disable this.
GENERICUSERS=play player game games nethack nethacker

===CHECK_PLNAME===
Use the player name for matching WIZARDS, EXPLORERS and SHELLERS, instead of the user's login name.
CHECK_PLNAME=1

===MAXPLAYERS===
Limit the number of simultaneous games. Valid values are 0-25.
Commenting this out or setting the value to 0 constructs lock files with UID and playername, so each user may have one game at a time, but number of different players is not limited.
MAXPLAYERS=10

===SUPPORT===
If not null, added to string "To get local support, " in the support information help.
SUPPORT=call Izchak at extension 42.

===RECOVER===
If not null, displayed at the end of a panic-save sequence.
RECOVER=Run the recover program.

===SEDUCE===
Make succubi and incubi to use nymphs' charm behavior rather than their own seduce behavior.
SEDUCE=0

===CHECK_SAVE_UID===
Disable savefile UID checking.
CHECK_SAVE_UID=0

@@ Line 1: / Line 1: @@
 {{stub}}
-The system-wide configuration file, ''sysconf'', is a plain text-file, usually in the same directory as NetHack binary, and it allows the system admin to change some settings compiled into the game. Only available if NetHack was compiled with [[Compile-time options|SYSCF]].
+The system-wide configuration file, ''sysconf'', is a plain text-file, usually in the same directory as NetHack binary, and it allows the system admin to change some game settings that apply to the entire installation. These settings will be the same for all players on a multi-user NetHack installation, and those users cannot change them. (On a single-user NetHack installation, the player is the admin and may change the sysconf however they like.)
 sysconf can also be used to set defaults for config [[options]].
@@ Line 114: / Line 116: @@
 Generally useful for public servers only. Changing this might make existing bones inaccessible. Disabled by setting to 0, or commenting out.
   BONES_POOLS=10
 {{nethack-361}}

@@ Line 69: / Line 69: @@
 ===PERS_IS_UID===
-High score file: Determine identity of "person" with name (0) or numeric (1) user id.
+High score file: Determine identity of "person" with character name (0, default) or numeric (1) user id.
   PERS_IS_UID=1

← Older revision		Revision as of 15:20, 7 June 2024
Line 114:		Line 114:
	Generally useful for public servers only. Changing this might make existing bones inaccessible. Disabled by setting to 0, or commenting out.		Generally useful for public servers only. Changing this might make existing bones inaccessible. Disabled by setting to 0, or commenting out.
	BONES_POOLS=10		BONES_POOLS=10
		+
		+	{{nethack-361}}

@@ Line 1: / Line 1: @@
 {{stub}}
-The system-wide configuration file, sysconf, is a plain text-file, usually in the same directory as NetHack binary, and it allows the system admin to change some settings compiled into the game. Only available if NetHack was compiled with SYSCF.
+The system-wide configuration file, ''sysconf'', is a plain text-file, usually in the same directory as NetHack binary, and it allows the system admin to change some settings compiled into the game. Only available if NetHack was compiled with [[Compile-time options|SYSCF]].
 sysconf can also be used to set defaults for config [[options]].
@@ Line 75: / Line 75: @@
 Show debugging information originating from these source files.
 Use '*' for all, or list source files separated by spaces.
-Only available if game has been compiled with DEBUG, and can be overridden via DEBUGFILES environment variable.
+Only available if game has been compiled with [[Compile-time options|DEBUG]], and can be overridden via DEBUGFILES environment variable.
   DEBUGFILES=*
 ===DUMPLOGFILE===
-Save end of game dump log to this file. Only available if NetHack was compiled with DUMPLOG. Allows following placeholders:
+Save end of game dump log to this file. Only available if NetHack was compiled with [[Compile-time options|DUMPLOG]]. Allows following placeholders:
 {|
 |%%

← Older revision		Revision as of 19:20, 22 March 2019
Line 55:		Line 55:
	Disable savefile UID checking.		Disable savefile UID checking.
	CHECK_SAVE_UID=0		CHECK_SAVE_UID=0
		+
		+	===PERSMAX===
		+	High score file: maximum entries for one person.
		+	PERSMAX=10
		+
		+	===ENTRYMAX===
		+	High score file: maximum number of entries.
		+	ENTRYMAX=100
		+
		+	===POINTSMIN===
		+	High score file: minimum points to get an entry.
		+	POINTSMIN=1
		+
		+	===PERS_IS_UID===
		+	High score file: Determine identity of "person" with name (0) or numeric (1) user id.
		+	PERS_IS_UID=1
		+
		+	===DEBUGFILES===
		+	Show debugging information originating from these source files.
		+	Use '*' for all, or list source files separated by spaces.
		+	Only available if game has been compiled with DEBUG, and can be overridden via DEBUGFILES environment variable.
		+	DEBUGFILES=*
		+
		+	===DUMPLOGFILE===
		+	Save end of game dump log to this file. Only available if NetHack was compiled with DUMPLOG. Allows following placeholders:
		+	{\|
		+	\|%%
		+	\|literal '%'
		+	\|-
		+	\|%v
		+	\|version (eg. "3.6.1-0")
		+	\|-
		+	\|%u
		+	\|game UID
		+	\|-
		+	\|%t
		+	\|game start time, UNIX timestamp format
		+	\|-
		+	\|%T
		+	\|current time, UNIX timestamp format
		+	\|-
		+	\|%d
		+	\|game start time, YYYYMMDDhhmmss format
		+	\|-
		+	\|%D
		+	\|current time, YYYYMMDDhhmmss format
		+	\|-
		+	\|%n
		+	\|player name
		+	\|-
		+	\|%N
		+	\|first character of player name
		+	\|}
		+	DUMPLOGFILE=/tmp/nethack.%n.%d.log
		+
		+	===BONES_POOLS===
		+	Number of bones file pools. The pool you belong to is determined at game start. You will load and save bones only from that pool.
		+	Generally useful for public servers only. Changing this might make existing bones inaccessible. Disabled by setting to 0, or commenting out.
		+	BONES_POOLS=10