view rogue3/rogue.6.in @ 176:db1c9a21a7c3

srogue: prevent overflowing the score file name. If SCOREFILE is not defined, roguehome() is called to find a directory for the score file. It copies up to PATH_MAX-20 bytes from an environment variable to a static buffer. Later these are strcpy()'d to scorefile, which is of size LINLEN. Unfortunately LINLEN is 80 and PATH_MAX is at least 256. On Linux, it happens to be 4096. I haven't yet managed to crash or exploit it, but there are surely no beneficial consequences, so roguehome() has been modified to check the length, and the string it returns is also checked in main().
author John "Elwin" Edwards
date Sun, 02 Aug 2015 12:14:47 -0400
parents c191a735f811
children
line wrap: on
line source

.TH ROGUE 6
.UC
.SH NAME
rogue \- Exploring The Dungeons of Doom
.SH SYNOPSIS
.B @PROGRAM@
[ -s ]
[
.I save_file
]
[ -n
.I playername
]
.SH DESCRIPTION
.PP
.I Rogue
is a computer fantasy game with a new twist.  It is crt oriented and the
object of the game is to survive the attacks of various monsters and get
a lot of gold, rather than the puzzle solving orientation of most computer
fantasy games.
.PP
To get started you really only need to know two commands.  The command
.B ?
will give you a list of the available commands and the command
.B /
will identify the things you see on the screen.
.PP
To win the game (as opposed to merely playing to beat other people's high
scores) you must locate the Amulet of Yendor which is somewhere below
the 20th level of the dungeon and get it out.  Nobody has achieved this
yet and if somebody does, they will probably go down in history as a hero
among heros.
.PP
When the game ends, either by your death, when you quit, or if you (by
some miracle) manage to win,
.I rogue
will give you a list of the top-ten scorers.  The scoring is based entirely
upon how much gold you get.  There is a 10% penalty for getting yourself
killed.
.PP
For more detailed directions, read the document
.I "A Guide to the Dungeons of Doom."
.SH OPTIONS
.PP
If a
.I save_file
argument is given,
.I rogue
will attempt to load a previously saved game from that file.
.PP
With the
.B -n
option,
.I rogue
will load a game with the name
.I playername
from a location defined at compile time.  If no such game exists, it will 
start one.
.PP
The
.B -s
option prints the top-ten scores list and exits.

.SH FILES
.ta 2i
@SCOREFILE@   Score file
.br
~/rogue3.save                           Default save file
.br
@SAVEDIR@   System savefiles
.DT
.SH SEE ALSO
Michael C. Toy,
.I "A Guide to the Dungeons of Doom"
.SH BUGS
.PP
Probably infinite.  Currently known bugs are: Sometimes you are still hungry
even after you eat food and sometimes you get a monster on the screen in
reverse video which may or may not cause a core dump.
.SH COPYRIGHT
Rogue: Exploring the Dungeons of Doom
.br
Copyright (C) 1980, 1981 Michael Toy, Ken Arnold and Glenn Wichman
.br
All rights reserved.
.br
License: 3-clause BSD, see LICENSE.txt for details.