1
0
mirror of https://github.com/gophernicus/gophernicus.git synced 2024-12-04 14:46:37 -05:00

add documentation updates for git checkout first

This commit is contained in:
fosslinux 2019-06-20 16:48:50 +10:00
parent 57e0f9a827
commit c3eaf2e64b
2 changed files with 11 additions and 22 deletions

View File

@ -5,13 +5,17 @@ from standard LIBC ones. Care has been taken to use only
standard POSIX syscalls so that it should work pretty much on standard POSIX syscalls so that it should work pretty much on
any \*nix system. any \*nix system.
Please make sure that you checkout to the correct version you want.
Currently, you most likely want version 3.0.
To compile and install run: To compile and install run:
``` ```
$ git clone https://github.com/gophernicus/gophernicus.git $ git clone https://github.com/gophernicus/gophernicus.git
$ cd gophernicus $ cd gophernicus
$ git checkout 3.0
$ make $ make
$ sudo make install # make install
``` ```
That's it - Gophernicus should now be installed, preconfigured That's it - Gophernicus should now be installed, preconfigured
@ -27,10 +31,7 @@ the gopher root and make sure you have at least the primary
hostname (the one set with `-h <hostname>`) directory available hostname (the one set with `-h <hostname>`) directory available
(`mkdir /var/gopher/$HOSTNAME`). (`mkdir /var/gopher/$HOSTNAME`).
## Dependencies
<<<<<<< HEAD:INSTALL
Dependencies
============
These were obtained from a base docker installation, what we These were obtained from a base docker installation, what we
(will) be using on Travis. (will) be using on Travis.
@ -66,18 +67,13 @@ These were obtained from a base docker installation, what we
# Alpine Linux # # Alpine Linux #
- alpine-sdk. once again, less is probably required.. blah blah. - alpine-sdk. once again, less is probably required.. blah blah.
Other installation targets
==========================
=======
## Other installation targets ## Other installation targets
>>>>>>> 82a1abebc4bfabc43ef6b27f0627f526984eaf30:INSTALL.md
Suppose your server runs systemd, but you'd rather have Gophernicus Suppose your server runs systemd, but you'd rather have Gophernicus
started with inetd or xinetd. To do that, do `make install-inetd` started with inetd or xinetd. To do that, do `make install-inetd`
or `make install-xinetd`. Likewise use `make uninstall-inetd` or or `make install-xinetd`. Likewise use `make uninstall-inetd` or
`make uninstall-xinetd` to uninstall Gophernicus. `make uninstall-xinetd` to uninstall Gophernicus.
## Compiling with TCP wrappers ## Compiling with TCP wrappers
Gophernicus uses no extra libraries... well... except libwrap Gophernicus uses no extra libraries... well... except libwrap
@ -93,7 +89,6 @@ at the files `/etc/hosts.allow` and `/etc/hosts.deny` (because the
manual pages suck). Use the daemon name 'gophernicus' to manual pages suck). Use the daemon name 'gophernicus' to
make your access lists. make your access lists.
## Running with traditional inetd superserver ## Running with traditional inetd superserver
If you want to run Gophernicus under the traditional Unix inetd, the If you want to run Gophernicus under the traditional Unix inetd, the
@ -107,7 +102,6 @@ gopher stream tcp nowait nobody /usr/sbin/gophernicus gophernicus -h <host
The Makefile will automatically do this for you and remove it when The Makefile will automatically do this for you and remove it when
uninstalling. uninstalling.
## Compiling on Debian Linux (and Ubuntu) ## Compiling on Debian Linux (and Ubuntu)
The above commands work on Debian just fine, but if you prefer The above commands work on Debian just fine, but if you prefer
@ -122,7 +116,6 @@ Work(tm).
If you need TCP wrappers support on Debian/Ubuntu, please If you need TCP wrappers support on Debian/Ubuntu, please
install libwrap0-dev before compiling. install libwrap0-dev before compiling.
## Cross-compiling ## Cross-compiling
Cross-compiling to a different target architecture can be done Cross-compiling to a different target architecture can be done
@ -134,9 +127,7 @@ arch one.
$ make HOSTCC=gcc CC=target-arch-gcc $ make HOSTCC=gcc CC=target-arch-gcc
``` ```
## Shared memory issues ## Shared memory issues
====================
Gophernicus uses SYSV shared memory for session tracking and Gophernicus uses SYSV shared memory for session tracking and
statistics. It creates the shared memory block using mode 600 statistics. It creates the shared memory block using mode 600
@ -153,7 +144,6 @@ let Gophernicus recreate it - no harm done:
$ sudo make clean-shm $ sudo make clean-shm
``` ```
## Porting to different platforms ## Porting to different platforms
If you need to port Gophernicus to a new platform, please take If you need to port Gophernicus to a new platform, please take
@ -164,9 +154,7 @@ platform please send the patches to
<gophernicus at gophernicus dot org> so we can include them into <gophernicus at gophernicus dot org> so we can include them into
the next release. the next release.
<<<<<<< HEAD:INSTALL # Supported Platforms
Supported Platforms
===================
| Platform | Versions | | Platform | Versions |
| ------------ | ---------------------------- | | ------------ | ---------------------------- |
@ -178,5 +166,3 @@ Supported Platforms
| Arch Linux | up to date | | Arch Linux | up to date |
| Gentoo | up to date | | Gentoo | up to date |
| Alpine Linux | Edge, 3.9 | | Alpine Linux | Edge, 3.9 |
=======
>>>>>>> 82a1abebc4bfabc43ef6b27f0627f526984eaf30:INSTALL.md

View File

@ -1,12 +1,15 @@
# Gophernicus # Gophernicus
Version 3.0 Development! DO NOT USE unless you want fiery dragons!
(you probably want to `git checkout 3.0`)
*Copyright (c) 2009-2019 Kim Holviala and others* *Copyright (c) 2009-2019 Kim Holviala and others*
Gophernicus is a modern full-featured (and hopefully) secure gopher Gophernicus is a modern full-featured (and hopefully) secure gopher
daemon. It is licensed under the BSD license. daemon. It is licensed under the BSD license.
(If you are looking for installation documentation, please see INSTALL.md).
## Support/Contact ## Support/Contact
Developers can be reached at <gophernicus AT gophernicus DOT org>. Developers can be reached at <gophernicus AT gophernicus DOT org>.