File: INSTALL

package info (click to toggle)
bnetd 0.4.19-1
  • links: PTS
  • area: main
  • in suites: potato
  • size: 1,552 kB
  • ctags: 2,109
  • sloc: ansic: 23,811; sh: 1,704; makefile: 295
file content (80 lines) | stat: -rw-r--r-- 3,716 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80

INSTALL

	This file contains an outline for installing bnetd-0.4.19.


STEPS

	 1) All the source code is in the src directory.  First change to that
	    directory with the "cd" command.

	 2) Run the configure script.  If you get an error like "configure:
	    command not found" try typing "./configure".  The command should
	    complete successfully and create a Makefile and config.h customized
	    for your system.  You may pass it options to modify the way the
	    program is configured.  Run configure with the "--help" options to
	    display a list of avaliable options.  The most common need is to
	    modify the location that the server should be installed.  The
	    defaults for these values are:
	     --prefix=/usr/local
	     --bindir=/usr/local/bin
	     --sbindir=/usr/local/sbin
	     --localstatedir=/usr/local/var
	     --sysconfdir=/usr/local/etc
	     --mandir=/usr/local/man
	    The directories "users", "reports", and "files" will be created
	    underneath the localstatedir directory during installation.

	 3) Now type "make".

	 4) Hopefully there will be no errors during the compile.
	    the server executable is "sbin/bnetd"
	    the proxy executable is "sbin/bnproxy"
	    the password encrypter is "bin/bnpass"
	    the chat client executable is "bin/bnchat"
	    the bot client executable is "bin/bnbot"
	    the file download client executable is "bin/bnftp"
	    the player stat client executable is "bin/bnstat"

	 5) You may now optionally type "make install".  This will copy the
	    binaries, man pages, and configuration files to the directories you
	    specified in step 2.  The configuration file will be automatically
	    updated before it is copied to reflect the locations of the other
	    files.  Be warned: if you already have configuration files in the
	    destination directories they will be overwritten.

	 6) Before running the server, check the "bnetd.conf" file to verify
	    it suits your preference.  Pay special attention to the files,
	    tracking, and policy sections.  Note the filenames in this file are
	    relative to top (root) directory of the system, so it is best to
	    use absolute paths.  If you do not want your server information to
	    be sent to tracker.bnetd.org, leave the track time variable set 0
	    (zero) and/or specify a different tracking server, otherwise set
	    the time interval to something like 150 seconds.  You may also wish
	    to edit channel.list, bnmotd.txt, and bnetd_default_user.  Some
	    files in the "files/" directory might also be of interest for those
	    people who like to customize things.

	 7) There is little or no reason to run this server under the root
	    user, so consider creating a special account for it or run it as
	    another unprivileged user.  Just make sure the bnetd files and
	    directories are writable by that user.

	 8) If you wish to run the server "in-place" (from the directory you
	    compiled it in), make sure you are in the top level bnetd directory
	    (the one with this file) and type "./sbin/bnetd -f".  This should
	    start your server in the foreground.

	 9) If you ran "make install", you may start your server by simply
	    typing "bnetd".  If you get an error like "bnetd: command not found"
	    that means the server is not in your search path and you will need
	    to type the full path of the binary (for example, type
	    "/usr/local/sbin/bnetd").  The server will automatically background
	    itself.

	10) If there are problems, you may wish to look in the "bnetd.log" file
	    for error messages.  If the server was unable to initialize the
	    network, there may already be a bnetd server running on that
	    computer.