PYGOPHERD(8)

NAME
PyGopherd - Multiprotocol Information Server

SYNOPSIS

pygopherd [ configfile ]

DESCRIPTION

Welcome to PyGopherd. In a nutshell, PyGopherd is a modern dynamic multi-protocol hierarchical information server with a pluggable modularized extension system, full flexible caching, virtual files and folders, and autodetection of file types -- all with support for standardized yet extensible per-document metadata. Whew! Read on for information on this what all these buzzwords mean.

QUICK START

If you have already installed PyGopherd system-wide, or your administrator has done that for you, your task for setting up PyGopherd for the first time is quite simple. You just need to set up your configuration file, make your folder directory, and run it!

You can quickly set up your configuration file. The distribution includes two files of interest: conf/pygopherd.conf and conf/mime.types. Debian users will find the configuration file pre-installed in /etc/pygopherd/pygopherd.conf and the mime.types file provided by the system already.

Open up pygopherd.conf in your editor and adjust to suit. The file is heavily commented and you can refer to it for detailed information. Some settings to take a look at include: detach, pidfile, port, usechroot, setuid, setgid, and root. These may or may not work at their defaults for you. The remaining ones should be fine for a basic setup.

Invoke PyGopherd with pygopherd path/to/configfile (or /etc/init.d/pygopherd start on Debian). Place some files in the location specified by the root directive in the config file and you're ready to run!

OPTIONS

All PyGopherd configuratoin is done via the configuration file. Therefore, the program has only one command-line option:

configfile
    This option argument specifies the location of the configuration file that PyGopherd is to use.

CONFORMING TO

•   The Internet Gopher Protocol as specified in RFC1436

•   The Gopher+ upward-compatible enhancements to the Internet Gopher Protocol from the University of Minnesota as laid out at
     <URL:gopher://gopher.quux.org/0/Archives/mirrors/boombox.micro.umn.edu/pub/gopher/gopher_protocol/Gopher+/Gopher+.txt>.

•   The gophermap file format as originally implemented in the Bucktooth gopher server and described at
     <URL:gopher://gopher.floodgap.com/0/buck/dbrowse%3Ffaquse%201>.

•   The Links to URL specification as laid out by John Goerzen at
     <URL:gopher://gopher.quux.org/0/Archives/Mailing%20Lists/gopher/gopher.2002-02%3f/MBOX-MESSAGE/34>.

•   The UMN format for specifying object attributes and links with .cap, .Links, .abstract, and similar files as specified elsewhere in this document and implemented by UMN gopherd.

•   The PYG format for extensible Python gopher objects as created for PyGopherd.

•   Hypertext Transfer Protocol HTTP/1.0 as specified in RFC1945

•   Hypertext Markup Language (HTML) 3.2 and 4.0 Transitional as specified in RFC1866 and RFC2854.

•   Maildir as specified in
     <URL:http://www.qmail.org/qmail-manual-html/man5/maildir.html> and
     <URL:http://cr.yp.to/proto/maildir.html>.

•   The mbox mail storage format as specified in
     <URL:http://www.qmail.org/qmail-manual-html/man5/mbox.html>.

•   Registered MIME media types as specified in RFC2048.

•   Script execution conforming to both UMN standards as laid out in UMN gopherd(1) and Bucktooth standards as specified at
     <URL:gopher://gopher.floodgap.com:70/0/buck/dbrowse%3ffaquse%202>, so far as each can be implemented consistent with secure design principles.

•   Standard Python 2.2.1 or above as implemented on POSIX-compliant systems.

•   WAP/WML as defined by the WAP Forum.

BUGS

Reports of bugs should be sent via e-mail to the PyGopherd issue tracker at <URL:https://github.com/michael-lazar/pygopherd/issues>.

The Web site also lists all current bugs, where you can check their status or contribute to fixing them.

COPYRIGHT

PyGopherd is Copyright (C) 2002-2019 John Goerzen, 2021 Michael Lazar.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; version 2 of the License.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to:

Free Software Foundation, Inc.
59 Temple Place
Suite 330
Boston, MA  02111-1307
USA

AUTHOR

PyGopherd, its libraries, documentation, and all included files (except where noted) was written by John Goerzen <jgoerzen@complete.org> and copyright is held as stated in the Copyright section.

Portions of this manual (specifically relating to certian UMN gopherd features and characteristics that PyGopherd emulates) are modified versions of the original gopherd(1) manpage accompanying the UMN gopher distribution. That document is distributed under the same terms as this, and bears the following copyright notices:

Copyright (C) 1991-2000  University of Minnesota
Copyright (C) 2000-2002  John Goerzen and other developers

PyGopherd may be downloaded, and information found, from its homepage:

 <URL:https://github.com/michael-lazar/pygopherd>

SEE ALSO

python (1).