mirror of
https://github.com/gophernicus/gophernicus.git
synced 2024-11-03 04:27:17 -05:00
137 lines
4.7 KiB
Plaintext
137 lines
4.7 KiB
Plaintext
Compiling and installing Gophernicus
|
|
====================================
|
|
|
|
Gophernicus requires a C compiler but no extra libraries aside
|
|
from standard LIBC ones. Care has been taken to use only
|
|
standard POSIX syscalls so that it should work pretty much on
|
|
any *nix system.
|
|
|
|
To compile and install run:
|
|
|
|
$ git clone https://github.com/kimholviala/gophernicus.git
|
|
$ cd gophernicus
|
|
$ make
|
|
$ sudo make install
|
|
|
|
That's it - Gophernicus should now be installed, preconfigured
|
|
and running under gopher://<HOSTNAME>/. And more often than not,
|
|
It Just Works(tm). If gopher links don't seem to work you may
|
|
need to configure your public hostname explicitly in whatever
|
|
config file Gophernicus is using.
|
|
|
|
By default Gophernicus serves gopher documents from /var/gopher
|
|
although that can be changed by using the -r <root> parameter.
|
|
To enable virtual hosting create hostname directories under
|
|
the gopher root and make sure you have at least the primary
|
|
hostname (the one set with -h <hostname>) directory available
|
|
(mkdir /var/gopher/$HOSTNAME).
|
|
|
|
|
|
Compiling with TCP wrappers
|
|
===========================
|
|
|
|
Gophernicus uses no extra libraries... well... except libwrap
|
|
(TCP wrappers) if it is installed with headers in default Unix
|
|
directories at the time of compiling. If you have the headers
|
|
installed and don't want wrapper support, run 'make generic'
|
|
instead of just 'make', and if you have wrappers installed in
|
|
non-standard place and want to force compile with wrappers
|
|
just run 'make withwrap'.
|
|
|
|
For configuring IP access lists with TCP wrappers, take a look
|
|
at the files /etc/hosts.allow and /etc/hosts.deny (because the
|
|
manual pages suck). Use the daemon name 'in.gophernicus' to
|
|
make your access lists.
|
|
|
|
|
|
Running with traditional inetd superserver
|
|
==========================================
|
|
|
|
If you want to run Gophernicus under the traditional Unix inetd, the
|
|
below line should be added to your /etc/inetd.conf and the inetd
|
|
process restarted.
|
|
|
|
gopher stream tcp nowait nobody /usr/sbin/in.gophernicus in.gophernicus -h <hostname>
|
|
|
|
The Makefile will automatically do this for you if you have the
|
|
update(1) script installed, which is the usual case in most current
|
|
flavors of Linux and BSD.
|
|
|
|
|
|
Compiling on Debian Linux (and Ubuntu)
|
|
======================================
|
|
|
|
The above commands work on Debian just fine, but if you prefer
|
|
having everything installed as packages run "make deb" instead
|
|
of plain "make". If all the dependencies were in place you'll
|
|
end up with an offical-looking deb package in the parent
|
|
directory (don't ask - that's just how it works). And instead
|
|
of "sudo make install" you should just install the deb with
|
|
"dpkg -i ../gophernicus_*.deb" after which It Should Just
|
|
Work(tm).
|
|
|
|
If you need TCP wrappers support on Debian/Ubuntu, please
|
|
install libwrap0-dev before compiling.
|
|
|
|
|
|
Cross-compiling
|
|
===============
|
|
|
|
Cross-compiling to a different target architecture can be done
|
|
by defining HOSTCC and CC to be different compilers. HOSTCC
|
|
must point to a local arch compiler, and CC to the target
|
|
arch one.
|
|
|
|
$ make HOSTCC=gcc CC=target-arch-gcc
|
|
|
|
|
|
Shared memory issues
|
|
====================
|
|
|
|
Gophernicus uses SYSV shared memory for session tracking and
|
|
statistics. It creates the shared memory block using mode 600
|
|
and a predefined key which means that a shared memory block
|
|
created with one user cannot be used by another user. Simply
|
|
said, running in.gophernicus under various different user
|
|
accounts may create a situation where the memory block is locked
|
|
to the wrong user.
|
|
|
|
If that happens you can simply delete the memory block and
|
|
let Gophernicus recreate it - no harm done:
|
|
|
|
$ sudo make clean-shm
|
|
|
|
|
|
Porting to different platforms
|
|
==============================
|
|
|
|
If you need to port Gophernicus to a new platform, please take
|
|
a look at gophernicus.h which has a bunch of HAVE_* #defines.
|
|
Fiddling with those usually makes it possible to compile a working
|
|
server. If you succeed in compiling Gophernicus to a new
|
|
platform please send the patches to me so I can include them into
|
|
the next release.
|
|
|
|
Tested (and semi-supported) platforms include:
|
|
|
|
OS Arch Compiler
|
|
+---------------+-------------+-------------+
|
|
AIX 5 POWER3 gcc 4
|
|
AIX 6 POWER4 gcc 4
|
|
AIX 7 POWER5 gcc 4
|
|
CentOS 5 x86_64 gcc 4
|
|
CentOS 7 x86_64 gcc 4
|
|
Debian Squeeze armv5tel gcc 4
|
|
Debian Wheezy i386 gcc 4
|
|
Debian Wheezy x86_64 gcc 4
|
|
Debian Jessie x86_64 gcc 4
|
|
Maemo 5 armv7l gcc 4
|
|
MacOSX 10.5 i386 gcc 4
|
|
MacOSX 10.7 x86_64 llvm-gcc 4
|
|
MacOSX 10.8 x86_64 clang 3
|
|
MacOSX 10.10 x86_64 clang 6
|
|
MacOSX 10.11 x86_64 clang 7
|
|
NetBSD 5 x86_64 gcc 4
|
|
Haiku R1 i386 gcc 2
|
|
|