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:
parent
57e0f9a827
commit
c3eaf2e64b
28
INSTALL.md
28
INSTALL.md
@ -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
|
|
||||||
|
@ -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>.
|
||||||
|
Loading…
Reference in New Issue
Block a user