annotate rogue3/INSTALL.txt @ 81:0e212d46b68f

rogue4: don't put savefile metadata into the savefile. The save_file() function in save.c stored the savefile's device number, inode number, creation time, and modification time in the file. The restore() function read them back, and apparently used to compare them to protect against cheaters. Unfortunately, the types and sizes of these numbers differ from system to system, which ruins the Roguelike Restoration Project's fine portability work. So they have been removed from the savefile. This BREAKS SAVEFILE COMPATIBILITY, but old files can be converted by excising the chunk starting at offset 0x22 with length sizeof(ino_t) + sizeof(dev_t) + 2 * sizeof(time_t). That's 0x14 on i686 and 0x20 on x86_64, at least with current versions of Linux and glibc.
author John "Elwin" Edwards
date Mon, 05 Aug 2013 20:49:41 -0700
parents 9223b6d7a243
children c9c6bb34734d
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
31
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
1 Roguelike Gallery (rlgallery.org)
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
2
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
3 This is the source code for the Roguelike Gallery's version of Rogue V3.
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
4
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
5 History
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
6 Rogue 3 was released by Michael Toy, Ken Arnold, and Glenn Wichman, probably
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
7 late in 1980. It went through several minor updates. The last, Rogue 3.6,
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
8 was completed mid-June 1981.
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
9
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
10 The Roguelike Restoration Project (rogue.rogueforge.net) updated the game to
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
11 work on modern systems.
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
12
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
13 The Roguelike Gallery's version has been slightly modified for compatibility
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
14 with dgamelaunch and security for multiple players.
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
15
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
16 Installing
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
17 First, configure for your system by editing machdep.h. The defaults are for a
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
18 system-wide installation, which will require setgid on the binary. For a
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
19 single-user installation, comment out SAVEDIR and set SCOREFILE and LOGFILE to
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
20 locations somewhere in your home directory. (That's probably the best thing to
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
21 do on Windows, too.)
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
22
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
23 Once that's finished, compile by running make. (I haven't tested the Visual
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
24 Studio project files on Windows, but they should work.)
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
25
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
26 If you want multi-user play, install the rogue3 binary with setgid games. You
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
27 will need to make sure that SAVEDIR exists and that savefiles, SCOREFILE, and
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
28 LOGFILE can be created and written by the games group (assuming you want those
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
29 features.) For a single user, installing shouldn't be necessary.
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
30
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
31 Playing
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
32 For more details, see readme36.html (contains the man page) and rogue36.html
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
33 (Michael Toy's "Guide to the Dungeons of Doom").
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
34
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
35 Contact
9223b6d7a243 Added INSTALL.txt files
elwin
parents:
diff changeset
36 rlgallery.org admin: John "Elwin" Edwards <elwin@sdf.lonestar.org>