FreeBSD Manual Pages
GMID(8) System Manager's Manual GMID(8) NAME gmid -- Gemini server SYNOPSIS gmid [-fhnVv] [-c config] [-D macro=value] [-P pidfile] DESCRIPTION gmid is a simple and minimal gemini server that can serve static files, talk to FastCGI applications and act as a gemini reverse proxy. gmid rereads the configuration file when it receives SIGHUP and reopens log files when it receives SIGUSR1. The options are as follows: -c config Specifies the configuration file. The default is /etc/gmid.conf. -D macro=value Define macro to be set to value on the command line. Overrides the definition of macro in the config file if present. -f Do not daemonize. Stay and log in the foreground. -h, --help Print the usage and exit. -n Check that the configuration is valid, but don't start the server. If specified two or more time, dump the configuration in addition to verify it. -P pidfile Write daemon's pid to the given location. pidfile will also act as lock: if another process is holding a lock on that file, gmid will refuse to start. -V, --version Print the version and exit. -v Verbose mode. EXAMPLES To run gmid a configuration file and a X.509 certificate must be pro- vided. A self-signed certificate, which are commonly used in the Gemi- nispace, can be generated using for e.g. openssl(1): # openssl req -x509 -newkey rsa:4096 -nodes \ -keyout /etc/ssl/private/example.com.key \ -out /etc/ssl/example.com.pem \ -days 365 -subj "/CN=example.com" # chmod 600 /etc/ssl/example.com.crt # chmod 600 /etc/ssl/private/example.com.key Then gmid can be started with # gmid -c /etc/gmid.conf SEE ALSO gemexp(1), gg(1), gmid.conf(5) ACKNOWLEDGEMENTS gmid uses the "Flexible and Economical" UTF-8 decoder written by Bjoern Hoehrmann. AUTHORS The gmid program was written by Omar Polo <op@omarpolo.com>. CAVEATS • All the root directories are opened during the daemon configura- tion; if a root directory is deleted and then re-created, gmid won't be able to serve files inside that directory until a reload. This restriction only applies to the root directories and not their content. • a %2F sequence is indistinguishable from a literal slash: this is not RFC3986-compliant. • a %00 sequence is treated as invalid character and thus rejected. FreeBSD Ports 14.quarterly April 27, 2024 GMID(8)
NAME | SYNOPSIS | DESCRIPTION | EXAMPLES | SEE ALSO | ACKNOWLEDGEMENTS | AUTHORS | CAVEATS
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gmid&sektion=8&manpath=FreeBSD+Ports+14.3.quarterly>