| | | | |
| Offset 1, 113 lines modified | Offset 1, 113 lines modified |
| 1 | PYGOPHERD(8)···················PyGopherd·Manpage··················PYGOPHERD(8) | 1 | PYGOPHERD(8)···················PyGopherd·Manpage··················PYGOPHERD(8) |
| | |
| | |
| | |
| 2 | N.NA.AM.ME.E | 2 | NAME |
| 3 | ·······PyGopherd·-·Multiprotocol·Information·Server | 3 | ·······PyGopherd·-·Multiprotocol·Information·Server |
| | |
| 4 | S\x8SY\x8YN\x8NO\x8OP\x8PS\x8SI\x8IS\x8S | |
| 5 | ·······p.py.yg.go.op.ph.he.er.rd.d·[·_.c_.o_.n_.f_.i_.g_.f_.i_.l_.e·] | 4 | SYNOPSIS |
| | 5 | ·······pygopherd·[·configfile·] |
| | |
| | |
| 6 | D.DE.ES.SC.CR.RI.IP.PT.TI.IO.ON.N | 6 | DESCRIPTION |
| 7 | ·······Welcome··to··P.Py.yG.Go.op.ph.he.er.rd.d.···In··a·nutshell,·P.Py.yG.Go.op.ph.he.er.rd.d·is·a·modern·dynamic | 7 | ·······Welcome··to··PyGopherd.···In··a·nutshell,·PyGopherd·is·a·modern·dynamic |
| 8 | ·······multi-protocol·hierarchical·information·server·with·a··pluggable··modu- | 8 | ·······multi-protocol·hierarchical·information·server·with·a··pluggable··modu- |
| 9 | ·······larized··extension··system,··full··flexible··caching,·virtual·files·and | 9 | ·······larized··extension··system,··full··flexible··caching,·virtual·files·and |
| 10 | ·······folders,·and·autodetection·of·file·types·--·all·with·support·for··stan- | 10 | ·······folders,·and·autodetection·of·file·types·--·all·with·support·for··stan- |
| 11 | ·······dardized·yet·extensible·per-document·metadata.·Whew!·Read·on·for·infor- | 11 | ·······dardized·yet·extensible·per-document·metadata.·Whew!·Read·on·for·infor- |
| 12 | ·······mation·on·this·what·all·these·buzzwords·mean. | 12 | ·······mation·on·this·what·all·these·buzzwords·mean. |
| | |
| 13 | Q.QU.UI.IC.CK.K·S.ST.TA.AR.RT.T | 13 | QUICK·START |
| 14 | ·······If·you·have·already·installed·P.Py.yG.Go.op.ph.he.er.rd.d·system-wide,·or··your··adminis- | 14 | ·······If·you·have·already·installed·PyGopherd·system-wide,·or··your··adminis- |
| 15 | ·······trator··has··done··that·for·you,·your·task·for·setting·up·P.Py.yG.Go.op.ph.he.er.rd.d·for | 15 | ·······trator··has··done··that·for·you,·your·task·for·setting·up·PyGopherd·for |
| 16 | ·······the·first·time·is·quite·simple.··You·just·need·to·set·up·your··configu- | 16 | ·······the·first·time·is·quite·simple.··You·just·need·to·set·up·your··configu- |
| 17 | ·······ration·file,·make·your·folder·directory,·and·run·it! | 17 | ·······ration·file,·make·your·folder·directory,·and·run·it! |
| | |
| 18 | ·······You··can··quickly·set·up·your·configuration·file.··The·distribution·in- | 18 | ·······You··can··quickly·set·up·your·configuration·file.··The·distribution·in- |
| 19 | ·······cludes·two·files·of·interest:·_.c_.o_.n_.f_./_.p_.y_.g_.o_.p_.h_.e_.r_.d_.._.c_.o_.n_.f·and··_.c_.o_.n_.f_./_.m_.i_.m_.e_.._.t_.y_.p_.e_.s. | 19 | ·······cludes·two·files·of·interest:·conf/pygopherd.conf·and··conf/mime.types. |
| 20 | ·······Debian·users·will·find·the·configuration·file·pre-installed·in·_./_.e_.t_.c_./_.p_.y_.- | 20 | ·······Debian·users·will·find·the·configuration·file·pre-installed·in·/etc/py- |
| 21 | ·······_.g_.o_.p_.h_.e_.r_.d_./_.p_.y_.g_.o_.p_.h_.e_.r_.d_.._.c_.o_.n_.f·and·the·_.m_.i_.m_.e_.._.t_.y_.p_.e_.s·file·provided·by··the··system | 21 | ·······gopherd/pygopherd.conf·and·the·mime.types·file·provided·by··the··system |
| 22 | ·······already. | 22 | ·······already. |
| | |
| 23 | ·······Open··up·_.p_.y_.g_.o_.p_.h_.e_.r_.d_.._.c_.o_.n_.f·in·your·editor·and·adjust·to·suit.··The·file·is | 23 | ·······Open··up·pygopherd.conf·in·your·editor·and·adjust·to·suit.··The·file·is |
| 24 | ·······heavily·commented·and·you·can·refer·to··it··for··detailed··information. | 24 | ·······heavily·commented·and·you·can·refer·to··it··for··detailed··information. |
| 25 | ·······Some··settings·to·take·a·look·at·include:·_.d_.e_.t_.a_.c_.h,·_.p_.i_.d_.f_.i_.l_.e,·_.p_.o_.r_.t,·_.u_.s_.e_.c_.h_.- | 25 | ·······Some··settings·to·take·a·look·at·include:·detach,·pidfile,·port,·usech- |
| 26 | ·······_.r_.o_.o_.t,·_.s_.e_.t_.u_.i_.d,·_.s_.e_.t_.g_.i_.d,·and·_.r_.o_.o_.t.··These·may·or·may·not·work·at·their·de- | 26 | ·······root,·setuid,·setgid,·and·root.··These·may·or·may·not·work·at·their·de- |
| 27 | ·······faults·for·you.··The·remaining·ones·should·be·fine·for·a·basic·setup. | 27 | ·······faults·for·you.··The·remaining·ones·should·be·fine·for·a·basic·setup. |
| | |
| 28 | ·······Invoke··P.Py.yG.Go.op.ph.he.er.rd.d·with·p.py.yg.go.op.ph.he.er.rd.d·p.pa.at.th.h/./t.to.o/./c.co.on.nf.fi.ig.gf.fi.il.le.e·(or·/./e.et.tc.c/./i.in.ni.it.t...d.d/./p.py.y-.- | 28 | ·······Invoke··PyGopherd·with·pygopherd·path/to/configfile·(or·/etc/init.d/py- |
| 29 | ·······g.go.op.ph.he.er.rd.d·s.st.ta.ar.rt.t·on·Debian).··Place·some·files·in·the··location··specified | 29 | ·······gopherd·start·on·Debian).··Place·some·files·in·the··location··specified |
| 30 | ·······by·the·_.r_.o_.o_.t·directive·in·the·config·file·and·you're·ready·to·run! | 30 | ·······by·the·root·directive·in·the·config·file·and·you're·ready·to·run! |
| | |
| 31 | O.OP.PT.TI.IO.ON.NS.S | 31 | OPTIONS |
| 32 | ·······All·P.Py.yG.Go.op.ph.he.er.rd.d·configuratoin·is·done·via·the·configuration·file.··There- | 32 | ·······All·PyGopherd·configuratoin·is·done·via·the·configuration·file.··There- |
| 33 | ·······fore,·the·program·has·only·one·command-line·option: | 33 | ·······fore,·the·program·has·only·one·command-line·option: |
| | |
| 34 | ·······_.c_.o_.n_.f_.i_.g_.f_.i_.l_.e | 34 | ·······configfile |
| 35 | ··············This·option·argument·specifies·the·location·of·the·configuration | 35 | ··············This·option·argument·specifies·the·location·of·the·configuration |
| 36 | ··············file·that·P.Py.yG.Go.op.ph.he.er.rd.d·is·to·use. | 36 | ··············file·that·PyGopherd·is·to·use. |
| | |
| 37 | C.CO.ON.NF.FO.OR.RM.MI.IN.NG.G·T.TO.O | 37 | CONFORMING·TO |
| 38 | ·······+.o·The·Internet·Gopher·Protocol·as·specified·in·RFC1436 | 38 | ·······o·The·Internet·Gopher·Protocol·as·specified·in·RFC1436 |
| | |
| 39 | ·······+.o·The··Gopher+··upward-compatible··enhancements··to·the·Internet·Gopher | 39 | ·······o·The··Gopher+··upward-compatible··enhancements··to·the·Internet·Gopher |
| 40 | ·········Protocol·from·the·University·of·Minnesota·as·laid·out·at | 40 | ·········Protocol·from·the·University·of·Minnesota·as·laid·out·at |
| 41 | ··········<URL:gopher://gopher.quux.org/0/Archives/mirrors/boombox.mi- | 41 | ··········<URL:gopher://gopher.quux.org/0/Archives/mirrors/boombox.mi- |
| 42 | ·········cro.umn.edu/pub/gopher/gopher_protocol/Gopher+/Gopher+.txt>. | 42 | ·········cro.umn.edu/pub/gopher/gopher_protocol/Gopher+/Gopher+.txt>. |
| | |
| 43 | ·······+.o·The··gophermap·file·format·as·originally·implemented·in·the·Bucktooth | 43 | ·······o·The··gophermap·file·format·as·originally·implemented·in·the·Bucktooth |
| 44 | ·········gopher·server·and·described·at | 44 | ·········gopher·server·and·described·at |
| 45 | ··········<URL:gopher://gopher.floodgap.com/0/buck/dbrowse%3Ffaquse%201>. | 45 | ··········<URL:gopher://gopher.floodgap.com/0/buck/dbrowse%3Ffaquse%201>. |
| | |
| 46 | ·······+.o·The·Links·to·URL·specification·as·laid·out·by·John·Goerzen·at | 46 | ·······o·The·Links·to·URL·specification·as·laid·out·by·John·Goerzen·at |
| 47 | ··········<URL:gopher://gopher.quux.org/0/Archives/Mailing%20Lists/gopher/go- | 47 | ··········<URL:gopher://gopher.quux.org/0/Archives/Mailing%20Lists/gopher/go- |
| 48 | ·········pher.2002-02%3f/MBOX-MESSAGE/34>. | 48 | ·········pher.2002-02%3f/MBOX-MESSAGE/34>. |
| | |
| 49 | ·······+.o·The··UMN·format·for·specifying·object·attributes·and·links·with·.cap, | 49 | ·······o·The··UMN·format·for·specifying·object·attributes·and·links·with·.cap, |
| 50 | ·········.Links,·.abstract,·and·similar·files·as·specified·elsewhere··in··this | 50 | ·········.Links,·.abstract,·and·similar·files·as·specified·elsewhere··in··this |
| 51 | ·········document·and·implemented·by·UMN·gopherd. | 51 | ·········document·and·implemented·by·UMN·gopherd. |
| | |
| 52 | ·······+.o·The··PYG··format··for·extensible·Python·gopher·objects·as·created·for | 52 | ·······o·The··PYG··format··for·extensible·Python·gopher·objects·as·created·for |
| 53 | ·········P.Py.yG.Go.op.ph.he.er.rd.d. | 53 | ·········PyGopherd. |
| | |
| 54 | ·······+.o·Hypertext·Transfer·Protocol·HTTP/1.0·as·specified·in·RFC1945 | 54 | ·······o·Hypertext·Transfer·Protocol·HTTP/1.0·as·specified·in·RFC1945 |
| | |
| 55 | ·······+.o·Hypertext·Markup·Language·(HTML)·3.2·and·4.0·Transitional··as··speci- | 55 | ·······o·Hypertext·Markup·Language·(HTML)·3.2·and·4.0·Transitional··as··speci- |
| 56 | ·········fied·in·RFC1866·and·RFC2854. | 56 | ·········fied·in·RFC1866·and·RFC2854. |
| | |
| 57 | ·······+.o·Maildir·as·specified·in | 57 | ·······o·Maildir·as·specified·in |
| 58 | ··········<URL:http://www.qmail.org/qmail-manual-html/man5/maildir.html>·and | 58 | ··········<URL:http://www.qmail.org/qmail-manual-html/man5/maildir.html>·and |
| 59 | ··········<URL:http://cr.yp.to/proto/maildir.html>. | 59 | ··········<URL:http://cr.yp.to/proto/maildir.html>. |
| | |
| 60 | ·······+.o·The·mbox·mail·storage·format·as·specified·in | 60 | ·······o·The·mbox·mail·storage·format·as·specified·in |
| 61 | ··········<URL:http://www.qmail.org/qmail-manual-html/man5/mbox.html>. | 61 | ··········<URL:http://www.qmail.org/qmail-manual-html/man5/mbox.html>. |
| | |
| 62 | ·······+.o·Registered·MIME·media·types·as·specified·in·RFC2048. | 62 | ·······o·Registered·MIME·media·types·as·specified·in·RFC2048. |
| | |
| 63 | ·······+.o·Script··execution·conforming·to·both·UMN·standards·as·laid·out·in·UMN | 63 | ·······o·Script··execution·conforming·to·both·UMN·standards·as·laid·out·in·UMN |
| 64 | ·········gopherd(1)·and·Bucktooth·standards·as·specified·at | 64 | ·········gopherd(1)·and·Bucktooth·standards·as·specified·at |
| 65 | ··········<URL:gopher://gopher.floodgap.com:70/0/buck/dbrowse%3ffaquse%202>, | 65 | ··········<URL:gopher://gopher.floodgap.com:70/0/buck/dbrowse%3ffaquse%202>, |
| 66 | ·········so·far·as·each·can·be·implemented·consistent·with·secure·design·prin- | 66 | ·········so·far·as·each·can·be·implemented·consistent·with·secure·design·prin- |
| 67 | ·········ciples. | 67 | ·········ciples. |
| | |
| 68 | ·······+.o·Standard·Python·2.2.1·or·above·as·implemented·on·POSIX-compliant·sys- | 68 | ·······o·Standard·Python·2.2.1·or·above·as·implemented·on·POSIX-compliant·sys- |
| 69 | ·········tems. | 69 | ·········tems. |
| | |
| 70 | ·······+.o·WAP/WML·as·defined·by·the·WAP·Forum. | 70 | ·······o·WAP/WML·as·defined·by·the·WAP·Forum. |
| | |
| 71 | B.BU.UG.GS.S | 71 | BUGS |
| 72 | ·······Reports··of··bugs··should··be··sent··via··e-mail·to·the·P.Py.yG.Go.op.ph.he.er.rd.d·issue | 72 | ·······Reports··of··bugs··should··be··sent··via··e-mail·to·the·PyGopherd·issue |
| 73 | ·······tracker·at··<URL:https://github.com/michael-lazar/pygopherd/issues>. | 73 | ·······tracker·at··<URL:https://github.com/michael-lazar/pygopherd/issues>. |
| | |
| 74 | ·······The·Web·site·also·lists·all·current·bugs,·where··you··can··check··their | 74 | ·······The·Web·site·also·lists·all·current·bugs,·where··you··can··check··their |
| 75 | ·······status·or·contribute·to·fixing·them. | 75 | ·······status·or·contribute·to·fixing·them. |
| | |
| 76 | C.CO.OP.PY.YR.RI.IG.GH.HT.T | 76 | COPYRIGHT |
| 77 | ·······P.Py.yG.Go.op.ph.he.er.rd.d·is·Copyright·(C)·2002-2019·John·Goerzen,·2021·Michael·Lazar. | 77 | ·······PyGopherd·is·Copyright·(C)·2002-2019·John·Goerzen,·2021·Michael·Lazar. |
| | |
| 78 | ·······This·program·is·free·software;·you·can·redistribute·it·and/or·modify·it | 78 | ·······This·program·is·free·software;·you·can·redistribute·it·and/or·modify·it |
| 79 | ·······under·the·terms·of·the·GNU·General·Public·License·as·published··by··the | 79 | ·······under·the·terms·of·the·GNU·General·Public·License·as·published··by··the |
| 80 | ·······Free·Software·Foundation;·version·2·of·the·License. | 80 | ·······Free·Software·Foundation;·version·2·of·the·License. |
| | |
| 81 | ·······This··program··is··distributed··in·the·hope·that·it·will·be·useful,·but | 81 | ·······This··program··is··distributed··in·the·hope·that·it·will·be·useful,·but |
| 82 | ·······WITHOUT·ANY··WARRANTY;··without··even··the··implied··warranty··of··MER- | 82 | ·······WITHOUT·ANY··WARRANTY;··without··even··the··implied··warranty··of··MER- |
| Offset 120, 32 lines modified | Offset 120, 32 lines modified |
| 120 | ·······Free·Software·Foundation,·Inc. | 120 | ·······Free·Software·Foundation,·Inc. |
| 121 | ·······59·Temple·Place | 121 | ·······59·Temple·Place |
| 122 | ·······Suite·330 | 122 | ·······Suite·330 |
| 123 | ·······Boston,·MA··02111-1307 | 123 | ·······Boston,·MA··02111-1307 |
| 124 | ·······USA | 124 | ·······USA |
| | |
| | |
| 125 | A.AU.UT.TH.HO.OR.R | 125 | AUTHOR |
| 126 | ·······P.Py.yG.Go.op.ph.he.er.rd.d,·its·libraries,·documentation,·and·all·included·files·(except | 126 | ·······PyGopherd,·its·libraries,·documentation,·and·all·included·files·(except |
| 127 | ·······where·noted)·was·written·by·John··Goerzen··<jgoerzen@complete.org>··and | 127 | ·······where·noted)·was·written·by·John··Goerzen··<jgoerzen@complete.org>··and |
| 128 | ·······copyright·is·held·as·stated·in·the·Copyright·section. | 128 | ·······copyright·is·held·as·stated·in·the·Copyright·section. |
| | |
|
Max diff block lines reached; 872/9728 bytes (8.96%) of diff not shown.
|