1NetHack 3.4.3 Linux Elf 2 3This README provides the instructions for using the official Linux binary, 4system platform requirements, as well as steps used to create that binary. 5The same steps can be used from the source distribution to create a similar 6binary. 7 8The official Linux binary has support for tty and X11 windowing systems, but 9not Qt. This means you will need to have X11 libraries installed on your 10system to run this binary, even in its tty flavor. 11 12 13The Linux binary package assumes that you have a user and a group named 14"games" on your system. If you do not, you can simplify installation by 15creating them first. 16 17Log in as or su to "root". Then, cd /, gunzip and untar the package, 18preserving permissions to put the NetHack files in /usr/games/nethack and 19/usr/games/lib/nethackdir. For example, if the package in in your 20home directory you might perform these steps. 21 % su 22 # cd / 23 # tar xpvzf ~yourlogin/nethack-343-linux-X11.tgz 24 25If you have old record and logfile entries from a previous NetHack version, 26you might want to save copies before they get overwritten by the new empty 27files; old saved games and bones files from 3.4.x will work with 3.4.3. 28If you are installing from the RPM, there is no need to save the old record 29and logfile; they are automatically preserved. 30 31In addition to data files for running the game, you will find other useful 32things in /usr/games/lib/nethackdir (such as a copy of this README :-). 33 34The general documentation Guidebook.txt and the processed man pages 35nethack.txt and recover.txt should provide an introduction to the game. 36 37The sample config file called dot.nethackrc can be used by copying 38it to your home directory as .nethackrc and modifying it to your liking. 39 40If you are running X11 copy the nh10.pcf and ibm.pcf font files from 41/usr/games/lib/nethackdir to a X11 fonts directory (such as 42/usr/X11/lib/X11/fonts/misc) and run "mkfontdir", then restart X 43windows to load them. If you prefer to use the graphical tiles, 44add the following to your .Xdefaults or .Xresources file: 45 NetHack.tile_file: x11tiles 46You may need to run "xrdb -merge $HOME/.Xdefaults" (or .Xresources) after 47doing this. 48 49The official Linux binary is set up to run setgid games, which allows 50multiple users on your system to play the game and prevents cheating by 51unprivileged users. The usual default for NetHack is setuid games, but 52this causes problems with accessing .nethackrc on distributions with 53restrictive default security on home directories and users who don't know 54the tradeoffs of various permission settings. 55 56 57If you have problems, send us some email. 58 59nethack-bugs@nethack.org 60 61 62 63Steps used to build this binary release, in addition to the basic 64instructions found in sys/unix/Install.unx. The step numbers below 65correspond to the step numbers in sys/unix/Install.unx. 66 67System: gcc-3.2, XFree86-libs-4.2.1, ncurses-5.2, glibc-2.3.2 (GLIBC_2.3) 68 693. Edit include/config.h and include/unixconf.h 70 config.h: define X11_GRAPHICS window support. 71 define USE_XPM support. 72 define COMPRESS as /bin/gzip as that is where it 73 seems to reside on newer Linux's. 74 define COMPRESS_EXTENSION as ".gz" 75 define DLB 76 define AUTOPICKUP_EXCEPTIONS 77 78 unixconf.h: define LINUX 79 define TIMED_DELAY 80 816. Makefile.src: define modern, non-BSD Linux and linux options throughout 82 CC = gcc 83 LFLAGS = -L/usr/X11R6/lib 84 WINSRC = $(WINTTYSRC) $(WINX11SRC) 85 WINOBJ = $(WINTTYOBJ) $(WINX11OBJ) 86 WINTTYLIB = /usr/lib/libncurses.a 87 WINX11LIB = -lXaw -lXmu -lXext -lXt -lXpm -lX11 88 WINLIB = $(WINTTYLIB) $(WINX11LIB) 89 90 Makefile.utl: define modern, non-BSD Linux and linux options throughout 91 Use bison/flex instead of yacc/lex 92 CC = gcc 93 LFLAGS = -L/usr/X11R6/lib 94 YACC = bison -y 95 LEX = flex 96 977. Makefile.top: GAMEGRP = games 98 GAMEPERM = 02755 99 FILEPERM = 0664 100 EXEPERM = 0755 101 DIRPERM = 0775 102 VARDATND = x11tiles NetHack.ad pet_mark.xbm rip.xpm 103 104 make all; su; make install 105 1069. Additional step: As discussed in win/X11/Install.X11, convert nh10.bdf 107 and ibm.bdf to proper font files and place in font path. 108