This file contains notes on building Coldmud on various platforms, it is
outdated.
Under Ultrix, AIX, Solaris, Linux, HP-UX, and SysVr4 systems, building
is easy:
Ultrix: make ultrix
AIX: make aix
Solaris: make solaris
Linux: make linux
HP-UX: make hpux
SysVr4: make sysvr4
On other systems, try 'make coldmud'.
The 'make univel' target is for a SysVr4 system with ucb includes and
libraries in /usr/ucbinclude and /usr/ucblib. If your ucb includes
are libraries are in the regular directories, use "make solaris".
If your system is not one of the above, but is allegedly
POSIX-conformant, has dbm libraries, and deals well with Berkeley
networking code, then you will probably be able to get away with just
typing 'make coldmud' and maybe adding a few libraries to the LIBS
line. If you have trouble, see if your system is covered specifically
later on in this file.
Here are more detailed notes in case things break:
The code is ANSI, POSIX code, except for the following aspects:
* The files dbmchunk.c and net.c are not POSIX at all, and
must be ported to platforms they are not compatible with.
* The file util.c makes a call to a library function crypt(),
which is not POSIX.
* list.c, string.c, and memory.c make assumptions about memory
that are not guaranteed by ANSI (they use unit-length arrays
at the end of structures, allocate extra space, and write
beyond the end of the arrays). Fortunately, these
assumptions are true of just about every system in practice.
The optimizations could be removed without too much effort
on systems they cause trouble on.
If you define USE_VFORK in config.h, adminop.c will use vfork()
instead of fork(), improving performance of run_script() on many
systems.
Note (7-Nov-94/Brandon): configure checks for vfork()
The makefile assumes gcc and bison are installed. If you have trouble
with your system's default make rules, try using gmake instead.
If you do not have gcc, you can try using cc instead; if it is an ANSI
compiler, it should do fine.
If you do not have bison, use yacc in place of bison -y.
Note (7-Nov-94/Brandon): configure checks for cc/gcc and asks which
compiler compiler to use.
I refuse to obfuscate my header files or POSIX code with #ifdefs to
make Coldmud compile more easily on antiquated operating systems;
however, some advice for building on popular environments follows.
Use "make coldmud" to do the build, once you've made the appropriate
modifications.
BSD 4.3
-------
It's not too difficult to build Coldmud under BSD 4.3, although it
requires some changes.
SEEK_SET is not defined; change this to 0 when it occurs (in db.c,
three times).
pid_t is not defined; change this to int where it occurs (in
adminop.c, twice).
STDIN_FILENO and STDOUT_FILENO are undefined; change STDIN_FILENO to 0
and STDOUT_FILENO to 1, where they occur (once each, in adminop.c).
waitpid() is not defined for run_script() in adminop.c, where's it's
used as follows:
} else if (pid > 0) {
if (num_args == 3 && args[2].u.val) {
if (waitpid(pid, &status, WNOHANG) == 0)
status = 0;
} else {
waitpid(pid, &status, 0);
}
} else {
Replace that code with:
} else if (pid > 0) {
if (num_args == 3 && args[2].u.val) {
status = 0;
} else {
while (wait(&status) != pid);
}
} else {
strstr() is not defined. Add a strstr() function to util.c:
char *strstr(char *s1, char *s2)
{
char *p;
p = strchr(s1, *s2);
while (p) {
if (strncmp(p, s2, strlen(s2)) == 0)
return p;
p = strchr(p + 1, *s2);
}
return NULL;
}
Also, follow the advice for SunOS in the next section.
SUNOS 4.1.x
-----------
SunOS presents several problems, since it is not good at being either
ANSI or POSIX.
There are several problems:
RAND_MAX is undefined (compile time).
This is a problem in the following function in util.c:
long random_number(long n)
{
long num = rand();
if (RAND_MAX >> 8 >= n)
num >>= 8;
return num % n;
}
Replace that with
long random_number(long n)
{
long num = rand();
if (n <= 256)
num >>= 8;
return num % n;
}
memmove() is undefined (link time).
Most of the calls to memmove() are moving memory backwards, so
they will actually work with memcpy(). You can do this wholesale
by replacing the definition of MEMMOVE() in memory.h to use
memcpy(). However, the first call in list.c moves memory forwards,
so it needs to be unrolled:
List *list_insert(List *list, int pos, Data *elem)
{
int i;
list = prepare_to_modify(list, list->start, list->len + 1);
for (i = list->len - 1; i >= pos; i++)
list->el[i + 1] = list->el[i];
data_dup(&list->el[pos], elem);
list->len++;
return list;
}
memcmp() is undefined (link time).
Change the MEMCMP() macro in memory.h to use bcmp() instead of
memcmp().
strerror() is undefined (link time).
There are three calls to strerror(), in adminop.c. At the
top of adminop.c, add the following lines:
extern char *sys_errlist[];
#define strerror(n) (sys_errlist[n])
NEXTSTEP 3.1
------------
(If you're running NEXTSTEP 3.0 or earlier, you're on your own,
although the following may help. Also look at the BSD 4.3 and SunOS
4.1.x notes.)
POSIX support seems to be rather halfway in this version of NEXTSTEP.
Coldmud will compile okay, but it fails to link, not finding waitpid,
sigaction, or sigemptyset.
waitpid() is used in run_script() in adminop.c:
} else if (pid > 0) {
if (num_args == 3 && args[2].u.val) {
if (waitpid(pid, &status, WNOHANG) == 0)
status = 0;
} else {
waitpid(pid, &status, 0);
}
} else {
Replace that code with:
} else if (pid > 0) {
if (num_args == 3 && args[2].u.val) {
if (wait4(pid, &status, WNOHANG, NULL) == 0)
status = 0;
else
status = WEXITSTATUS(status);
} else {
wait4(pid, &status, 0, NULL);
status = WEXITSTATUS(status);
}
} else {