hearse - Online in the Cloud

PROGRAM:

NUME

hearse - exchange Nethack bones files with other players

REZUMAT

dric [-b | --bones-dir dir] [--bones-mode mod] [-c | --config-file fişier] [--cron]
[--depanare] [--delete-uploaded] [--Ajutor] [--lock-file fişier] [-q | --Liniște] [--run-as-me]
[--run-as-user utilizator] [--run-as-group grup] [--server-url url] [--stamp-file fişier]
[--user-email adresa] [--user-token semn] [--user-token-file fişier] [--versiune]

DESCRIERE

Nethack sometimes saves the level on which you die (including your stuff, what killed you,
and your ghost) in a "bones file". These files get loaded into later Nethack games. If
you're the only Nethack player on your system you'll only get bones files you created
tu.

dric lets you automatically exchange Nethack bones file with other players. When run it
uploads any new bones files it finds on your system, then downloads any bones files the
server feels like giving it. See <http://www.argon.org/~roderick/hearse/> pentru mai multe
informaţii.

An important thing to note is that by default using dric will cause you to end up with
more bones than you otherwise would have. This changes the game's balance and is
considered by many players to be a mild form of cheating. You can address this by turning
pe --delete-uploaded option, but the down side is you'll never encounter your own
bones files.

In order to use the Hearse server, you've got to supply your email address. Do this by
folosind --user-email switch the first time you use the program, or by putting
"user-email address" in the config file. Your email address will only be used to contact
you about Hearse, and will never be given to any third party. If you enter an invalid
address, the server won't be able to support you if you download a bad bones file, and
will be forced to ban you if any of your uploaded files are bad.

Hearse was set up as a service to the Nethack community. Please respect that; abuse of
the service can only lead to it being removed.

RAPID START

The defaults are set up for a Linux system using a nethack binary which is either set-uid
or set-gid games. If this is what you've got, as root run

# hearse --user-email [e-mail protejat]

one time by hand, then put

0 3 * * * root perl -we 'sleep rand 3600'; hearse --quiet

in / etc / crontab.

CONFIGURARE

dric comes with default values for its various configuration settings which match the
way many Linux systems are set up. If any of them don't match your system, you can either
change them in a configuration file, or you can specify the right values via command line
switches. This last isn't as onerous as it sounds, because most people run it from cron.
You can put the switches in the crontab file and leave it at that. If you'd rather use a
configuration file, you can use the default location (/etc/nethack/hearse.conf), or use
il -c (Aka --config-file) switch to specify the file you'd like to use.

The configuration file can specify all of the options for which it makes sense, using the
long version of the option name followed by the value. Blank and commented lines are
ignored in the usual fashion. A string value can be given as "-" to mean the empty
string. Booleans can use on/off/true/false/yes/no/1/0. A sample hearse.conf este inclus
with the distribution. Eg,

bones-dir /local/games/nethackdir
bones-mode 600
quiet on
run-as-user daemon
run-as-group -
user-token-file /local/games/nethackdir/hearse.user-token

PRIVILEGII

dric needs to run with permissions like those used by Nethack itself, so that it can
read and write the bones files. It should not be made set-uid or set-gid, though; it
hasn't been audited for that.

The default configuration will try to set both the user and group ids to "games". Nethack
itself will generally only be set-id to either one or the other, but using both hurts
nothing and allows dric to run as-is on more systems. This will only work if you run
dric ca rădăcină.

Dacă doriți să dezactivați dric's id setting and take care of it externally you can use the
--run-as-me switch to turn it off, or the --run-as-user și --run-as-group switches for
finer grained control. Specify '' or "-" for either of the latter to disable just that
lucru.

ALERGARE DIN CRON

If you're using the pre-packaged .deb or .rpm versiune a dric, the program is already
set up to run automatically (both daily and when you connect to the Internet). You don't
have to do anything unless you want to change this behavior. If you're installing dric
by hand, read on.

The normal way to use the program is to run it from cron, either daily or on whatever
schedule you like. (There's no harm in running it often, if it doesn't find any new bones
files it doesn't even contact the server.) If letting it manage its own permissions,
you'd just run it as root. Eg, to run it some time in the 3:00 hour, put something like

0 3 * * * root perl -we 'sleep rand 3600'; hearse --quiet

in / etc / crontab. The randomization is to prevent the server from getting hammered at the
top of each time zone's 3:00 hour.

If you'd like to see what the server's doing, you can use --cron mai degrabă decât --Liniște.
This will cause it to output its status message, but only when it actually transfers a
bones file.

ALERGARE PENTRU MULTIPLU NETHACK VARIANTE

If you use multiple Nethack variants which are supported by the Hearse server, you can run
dric for all of them. The normal way to do this is to run dric once for each variant,
specifying the bones directory on the command line

# hearse -b /var/games/slashem

leaving the rest of the configuration settings to be read from the configuration file.
The last upload time is by default stored in the bones directory, so everything just
funcționează.

The Hearse protocol requires that you have only a single concurrent connection for each
user account (it decides what kind of bones file to send you based on the kind you most
recently uploaded), so dric does locking on the user token file in order to ensure this.
A se vedea --lock-file switch for more info.

OPŢIUNI

-b, --bones-dir dir
Specify the bones directory. By default the program uses the first of
/var/games/nethack, /usr/games/lib/nethackdir, and the current directory which
contains a file called record.

--bones-mode mod
Specify the mode for the bones files dric creates. The default is 660.

-c, --config-file fişier
Specificați un fișier de configurare alternativ. Valoarea implicită este /etc/nethack/hearse.conf.

--cron
Suppress the "no bones to upload" message. This makes it so that there's no output at
all when there's nothing to do, but you still see what's going on when bones files are
transfered. This is a nice way to run it from cron if you want to keep an eye on it.

--depanare
Activați depanarea.

--delete-uploaded
Delete locally generated bones files after uploading them. Some people might want to
do this in order to avoid changing the game's balance. Since the server normally
gives you 1 bones file for each one you upload, if you delete your local bones after
uploading them you'll end up with the same number of bones you otherwise would have
had, but they'll be somebody else's rather than your own.

--Ajutor
Afișați mesajul de utilizare și muriți.

--lock-file fişier
The Hearse protocol requires that dric do locking to be sure that only a single
connection per user can happen at a time. It does this by locking the
--user-token-file. You should not generally change this, but if you have special
requirements (that that file be read only, eg), you can override it with this switch.
Use '' to disable locking (which I do not recommend).

-q, --Liniște
Don't output information messages.

--run-as-me
Turn off both --run-as-user și --run-as-group.

--run-as-user utilizator
Utilizare utilizator as the real and effecitve user id, default "games". You've generally got to
be root for this to work.

--run-as-group grup
Utilizare grup as the real and effecitve group id, default "games". You've generally got
to be root for this to work.

--server-url url
Specify the URL for the server program. See the source or the --Ajutor message for the
Mod implicit.

--stamp-file fişier
dric only tries to upload bones files which were created since the last time it
sucessfully talked to the server. The modification time of the --stamp-file
(.hearse.timestamp by default) tells it when that was. This path is taken relative to
il --bones-dir (unless it's absolute).

--user-email adresa
Specify your email address. You only have to do this the first time you run dric.

--user-token semn
Specify your user token directly. You won't normally need to do this, as dric
requests the token from the server and stores it in the --user-token-file pentru mai târziu
regăsire.

--user-token-file fişier
Specify the file used to store the user token, by default
/etc/nethack/hearse.user-token.

--versiune
Afișați numărul versiunii și ieșiți.

DISPONIBILITATE

The code is licensed under the GNU GPL. Check <http://www.argon.org/~roderick/hearse/>
for updated versions.

Use hearse online using onworks.net services