|
|
|
|
.\" The following requests are required for all man pages.
|
|
|
|
|
.Dd July 23, 2018
|
|
|
|
|
.Dt GOSHER 8 SMM
|
|
|
|
|
.Os Linux
|
|
|
|
|
.Sh NAME
|
|
|
|
|
.Nm gosher
|
|
|
|
|
.Nd a Gopher server in a shell script
|
|
|
|
|
.Sh SYNOPSIS
|
|
|
|
|
.Nm gosher
|
|
|
|
|
.Op Ar GOPHERDIR Op Ar HOSTNAME Op Ar PORT
|
|
|
|
|
.Sh DESCRIPTION
|
|
|
|
|
.Pp
|
|
|
|
|
.Ic gosher
|
|
|
|
|
is a server for the Gopher protocol (RFC 1436) in a POSIX shell
|
|
|
|
|
script.
|
|
|
|
|
|
|
|
|
|
.Pp
|
|
|
|
|
Gopher is a textual protocol for information exchange over the Internet,
|
|
|
|
|
that provides a unified hierarchical menu-based interface. The Gopher
|
|
|
|
|
protocol has assigned port 70 by IANA.
|
|
|
|
|
|
|
|
|
|
.Pp
|
|
|
|
|
.Ic gosher
|
|
|
|
|
uses
|
|
|
|
|
.Em netcat(1)
|
|
|
|
|
to listen for incoming connections on the specified
|
|
|
|
|
.Ar HOSTNAME
|
|
|
|
|
(defaults to 'localhost' if not specified) and
|
|
|
|
|
.Ar PORT
|
|
|
|
|
(defaults to 70 if
|
|
|
|
|
.Ar PORT
|
|
|
|
|
is not specified) and makes available all the files under the folder
|
|
|
|
|
.Ar GOPHERDIR
|
|
|
|
|
(defaults to the current directory if not specified).
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
.\" This next request is for sections 1, 6, 7 & 8 only
|
|
|
|
|
.\".Sh ENVIRONMENT
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
.\".Sh EXAMPLES
|
|
|
|
|
.\" This next request is for sections 1, 6, 7 & 8 only
|
|
|
|
|
.\" (command return values (to shell) and
|
|
|
|
|
.\" fprintf/stderr type diagnostics)
|
|
|
|
|
|
|
|
|
|
.\" .Sh DIAGNOSTICS
|
|
|
|
|
.Sh SEE ALSO
|
|
|
|
|
lynx(1), gopher(1), sacc(1), clic(1)
|
|
|
|
|
.\" .Sh CONFORMING TO
|
|
|
|
|
.\" .Sh HISTORY
|
|
|
|
|
.Sh AUTHORS
|
|
|
|
|
.Ic gosher
|
|
|
|
|
is Free Software, distributed under the terms of the GNU
|
|
|
|
|
General Public License (GPL), version 3 of the License.
|
|
|
|
|
.Pp
|
|
|
|
|
.Ic gosher
|
|
|
|
|
is copyleft (c) 2018 by
|
|
|
|
|
.An Vincenzo (KatolaZ) Nicosia <katolaz@freaknet.org>
|
|
|
|
|
|
|
|
|
|
.Sh SECURITY CONSIDERATIONS
|
|
|
|
|
It is recommended to run
|
|
|
|
|
.Ic gosher
|
|
|
|
|
under chroot(8).
|
