commit fab952e1d7814ae73ce60e577993590a34e45aef from: Omar Polo date: Sat Oct 03 15:49:09 2020 UTC minor documentation edits commit - 30bc2ea9f4ab09e4026eb7667926ccc0b317b2ec commit + fab952e1d7814ae73ce60e577993590a34e45aef blob - 45276fbfca791ef7ca4daee8d873a44e9a9a9e1d blob + b797dbf6e77bf6baf09be18b4ac438a639f39ca4 --- README.md +++ README.md @@ -1,7 +1,7 @@ # NAME -**gmid** - dead simple gemini server +**gmid** - dead simple zero configuration gemini server # SYNOPSIS @@ -26,7 +26,7 @@ or trailing in the requests made by clients, so it's impossible to serve content outside the *docs* -directory by mistake. +directory by mistake, and will also refuse to follow symlink. Furthermore, on OpenBSD, pledge(2) @@ -43,12 +43,19 @@ is very simple in its implementation, and so it may no for serving site with lots of users. After all, the code is single threaded and use a single process. +If a user request path is a directory, +**gmid** +will try to serve a +*index.gmi* +file inside that directory. +If not found, it will return an error 51 (not found) to the user. + The options are as follows: **-c** *cert.pem* > The certificate to use, by default is -> *cert.pem* +> *cert.pem*. **-d** *docs* @@ -58,12 +65,12 @@ The options are as follows: **-h** -> Print the usage and exit +> Print the usage and exit. **-k** *key.pem* > The key for the certificate, by default is -> *key.pem* +> *key.pem*. # EXAMPLES @@ -83,7 +90,7 @@ now you can visit gemini://localhost/ with your prefer # CAVEATS -* it doesn't support virtual host: the host part of the request URL is +* it doesn't support virtual hosts: the host part of the request URL is completely ignored. * it doesn't fork in the background or anything like that. blob - e9e070737db42ac3481eb13f0577f050bd88c4a1 blob + dd2cf2ad47c6009dae1214aea472fbb006cc911b --- gmid.1 +++ gmid.1 @@ -16,7 +16,7 @@ .Os .Sh NAME .Nm gmid -.Nd dead simple gemini server +.Nd dead simple zero configuration gemini server .Sh SYNOPSIS .Nm .Bk -words @@ -39,7 +39,7 @@ or trailing in the requests made by clients, so it's impossible to serve content outside the .Pa docs -directory by mistake. +directory by mistake, and will also refuse to follow symlink. Furthermore, on .Ox , .Xr pledge 2 @@ -56,20 +56,27 @@ is very simple in its implementation, and so it may no for serving site with lots of users. After all, the code is single threaded and use a single process. .Pp +If a user request path is a directory, +.Nm +will try to serve a +.Pa index.gmi +file inside that directory. +If not found, it will return an error 51 (not found) to the user. +.Pp The options are as follows: .Bl -tag -width 12m .It Fl c Ar cert.pem The certificate to use, by default is -.Pa cert.pem +.Pa cert.pem . .It Fl d Ar docs The root directory to serve. .Nm won't serve any file that is outside that directory. .It Fl h -Print the usage and exit +Print the usage and exit. .It Fl k Ar key.pem The key for the certificate, by default is -.Pa key.pem +.Pa key.pem . .El .Sh EXAMPLES To quickly getting started @@ -89,7 +96,7 @@ now you can visit gemini://localhost/ with your prefer .Sh CAVEATS .Bl -bullet .It -it doesn't support virtual host: the host part of the request URL is +it doesn't support virtual hosts: the host part of the request URL is completely ignored. .It it doesn't fork in the background or anything like that.