tskrtt

Simple libev based gopher server
git clone https://git.inz.fi/tskrtt/
Log | Files | Refs | README

tskrtt.1 (1961B)

      1 .Dd May 16, 2021
      2 .Dt TSKRTT 8
      3 .Os
      4 .
      5 .Sh NAME
      6 .Nm tskrtt
      7 .Nd a gopher daemon
      8 .
      9 .Sh SYNOPSIS
     10 .Nm
     11 .Bk -words
     12 .Op Fl 4
     13 .Op Fl 6
     14 .Op Fl d
     15 .Op Fl l Ar logfile
     16 .Op Fl b Ar rootdir
     17 .Op Fl h Ar host
     18 .Op Fl p Ar port
     19 .Op Fl o Ar outport
     20 .Op Fl u Ar user
     21 .Op Fl g Ar group
     22 .Op Fl i Ar listen-address
     23 .Op Fl t Ar key cert
     24 .Ek
     25 .
     26 .Sh DESCRIPTION
     27 .Bd -filled
     28 .Nm
     29 is a Gopher server.
     30 .Ed
     31 .
     32 .Sh OPTIONS
     33 tskrtt options and default settings:
     34 .Bl -tag -width Ds
     35 .
     36 .It Fl 4
     37 Only listen for IPv4 connections.
     38 .
     39 .It Fl 6
     40 Only listen for IPv6 connections.
     41 .
     42 .It Fl c
     43 Chroot to root directory.
     44 .
     45 .It Fl d
     46 Don't fork into background.
     47 .
     48 .It Fl l Ar logfile
     49 Location for an access log file (no default).
     50 .
     51 .It Fl b Ar rootdir
     52 Root directory of served content (default: /var/gopher).
     53 .
     54 .It Fl h Ar host
     55 Hostname used in generated content (default: listen address or system hostname)
     56 .
     57 .It Fl p Ar port
     58 Port on which the daemon will listen (default: 70).
     59 .
     60 .It Fl o Ar oport
     61 Port shown on generated content (default: same as port).
     62 .
     63 .It Fl u Ar user
     64 Change to user after startup.
     65 .
     66 .It Fl g Ar group
     67 Change to group after startup.
     68 .
     69 .It Fl i Ar listen-address
     70 Listen for incoming connections on given address (default: listen on any address).
     71 .
     72 .It Fl t Ar key cert
     73 Allow connections using TLS using the given key and cert (default: only plain text connection).
     74 .
     75 .Sh KNOWN BUGS
     76 Served text, gophermap and .gph and .dcgi lines can only have line length of 511 characters, longer lines are wrapped, which may break .gph formatting. This should pose no problems, as any gopher content shouldn't exceed 70 characters.
     77 .Pp
     78 If listen address resolves into multiple available addresses, only the first successful one will be listened to.
     79 .Pp
     80 Any headers received from CGI/DCGI will be passed onto the client, which is probably not what is wanted.
     81 .
     82 .Sh CONFORMING TO
     83 The daemon strives to conform to RFC 1436 and to be reasonably compatible with geomyidae server
     84 .
     85 .Sh SEE ALSO
     86 .Xr geomyidae 8
     87 .