Blob


1 # change log
3 ## 2024/01/11 - 2.0 “Lady Stardust”
5 ### New Features
7 * added `listen on' to specify per-server the list of addresses from where connections are to be accepted.
8 * added titan(1), a simple titan client.
9 * splitted the "configless" version of gmid as a standalone executable gemexp(1)
10 * added ability to log to files with `log access <path>`
11 * added ability to change the syslog(3) facility with `log syslog facility <facility>`
12 * added ability to change the logging style with `log style <style>`
13 * added `fastcgi strip'
14 * reworked the privsep implementation and added a privsep crypto engine
15 * implemented `SCRIPT_NAME' and `PATH_INFO' splitting for fastcgi
17 ### Bug fixes
19 * fixed handling of TLS handshake failures
21 ### Improvements
23 * contrib/gencert: added -e to generate EC keys
24 * use default prefork (3) in regress
25 * removed the sha256 dependency of the regress suite
26 * parse and log the fastcgi reply
27 * revamped the fastcgi configuration, now it's per-location
28 * attempt to load the TLS certificates, mimes and virtual hosts root as part of the configtest (-n) instead of verifying the syntax only.
29 * synced the parameters with RFC3875 (CGI)
30 * gg: exit with the gemini response code unless it's 2X
31 * gemexp: generate EC certificates too (it's also the new default)
32 * (contrib/vim) added an ALE linter and updated the Vim syntax file; thanks Anna “CyberTailor”
34 ### Breaking Changes
36 * gg now warns when the server doesn't use TLS' close_notify
37 * deprecated the global `ipv6' and `port' settings in favour of the per-server `listen on` directive
38 * removed the already deprecated config options `mime' and `map'
39 * droped seccomp and capsicum support
40 * FastCGI: set REQUEST_METHOD to "GET" instead of the empty string
43 ## 2022/12/02 - 1.8.6 “Lightbulb Sun” bugfix release
45 * add tests and compat for setresuid setresgid
46 * add GEMINI_SEARCH_STRING fastcgi parameter / cgi env variable
47 * manpage fix: QUERY_STRING is *not* urldecoded
48 * fixed use-after-free in the fastcgi code
49 * when switching user also set the groups
50 * always cast is*() arguments to unsigned char
52 ## 2022/11/01 - 1.8.5 “Lightbulb Sun” bugfix release
54 * removed OpenBSD' rc file because now is maintained in the ports tree
55 * (hopefully) fix build on DragonflyBSD
56 * call tzset(3) to fix times in logs
57 * always send custom list of fcgi parameters (alex)
59 ## 2022/07/04 - 1.8.4 “Lightbulb Sun” bugfix release
61 ### Bug fixes
63 * allow "@" and ":" in paths; spotted by freezr
64 * URL-encode the file names in the directory index; reported by cage
66 ### Improvements
68 * move the documentation about the config file in its own manual page: gmid.conf.5
69 * improvements to the mime handling: fixed a memory leak and improve lookup speed.
70 * log (with low priority) when gmid failed to open a file because of its permissions.
71 * include a trailing "/" for dirs in the auto-generated directory index.
73 ### Breaking Changes
75 * deprecated the `map' rule in favour of the new `types' block.
76 * the default list is not loaded anymore when `types' is used; except for the text/gemini to ".gmi"/".gemini" mappings.
79 ## 2022/03/27 - 1.8.3 “Lightbulb Sun” bugfix release
81 ### Bug fixes
83 * fix a possible out-of-bound access in the CGI handling. It was introduced last October during a refactoring, but due to how many malloc(3) implementations works this hasn't been found until now. Otto' malloc is more strict fortunately.
86 ## 2022/03/26 - 1.8.2 “Lightbulb Sun” bugfix release
88 ### Bug fixes
90 * fix a CGI timing issue: if a connection handled by a CGI scripts is interrupted with the right timing it causes the server process to exit with "fatal in client_by_id: invalid id X".
92 ### New Features
94 * add a new block `type { ... }' to define mime types mapping.
96 ### Improvements
98 * use shell built-in `command' instead of which(1), prodded by cage and Allen Sobot.
99 * configure script: allow to set MANDIR from cmdline (Allen Sobot)
100 * add systemd-sysusers sample file in contrib/ (Nakaya)
101 * [linux/seccomp] allow fstatat64(2), llseek(2) and sigreturn(2), needed by glibc on armv7. (Tobias Berger)
102 * [linux/seccomp] tightens rules by allowing openat(2) only with the O_RDONLY flag.
105 ## 2022/02/10 - 1.8.1 “Lightbulb Sun” bugfix release
107 ### Bug fixes
109 * fix landlock usage on linux: don't assume that access capabilities not listed are implicitly denied, because they are not. Mickaël Salaün, the landlock author, found the same error on game of trees:
111 > In a nutshell, the ruleset's handled_access_fs is required for backward and forward compatibility (i.e. the kernel and user space may not know each other's supported restrictions), hence the need to be explicit about the denied-by-default access rights.
113 In practice this affects only linux and only partially: thanks to the design of the daemon and the seccomp filter the effects of this mistake in handling landlock are fortunately limited. However, in theory at least, gmid could be for e.g. tricked into truncating existing files, so it's highly suggested to update.
115 ## Improvements
117 All by Anna “CyberTailor”, thanks!
119 * don't skip unit tests when SKIP_RUNTIME_TEST is set
120 * add `gg' to the regress target dependencies
121 * fix the "implicit declaration of asprintf" warning
122 * sync vim syntax
125 ## 2022/01/30 - 1.8 “Lightbulb Sun”
127 ### New Features
129 * reverse proxying support: gmid now can relay gemini requests to other hosts.
130 * install gg too: it's a simple gemini client ("gemini get") initially developed as part of the regression suite.
131 * added OCSP stapling support (by @The-King-of-Toasters, thanks!)
132 * add gencert, a simple script to generate self-signed certs.
133 * add renew-certs, a script to automatically renew self-signed certs.
134 * multiple -n partially dump the parsed configuration.
136 ### Improvements
138 * reworked the fastcgi subsystem, now it's completely asynchronous.
139 * refactored the internal of the server too.
140 * refactored the regression suite (in particular reduced the timeout for single tests from 30 to 10 seconds.)
141 * configure: add support for --prefix=... autoconf-style flag.
142 * relax the "wont proxy" check: don't check that the port in the request is the same we're listening on. Suggested and discussed with Allen Sobot, thanks!
143 * relax the strict ordering of options, locations and proxy blocks inside a server block.
145 ### Bug fixes
147 * don't pass through illegal replies from CGI scripts.
148 * fix the "double slash" error in logs.
149 * fix the configure for cross-compilation: don't run the test binaries just built. Suggested by Nikolay Korotkiy (@sikmir), thanks!
150 * (seccomp) allow ugetrlimit(2), needed by glibc on arm7l. By Max, thanks!
153 ## 2021/10/15 - 1.7.5 “Space-dye Vest” fifth bugfix release
155 This version includes the following bugfix
157 * don’t die when a connection is closed before being accepted by gmid (i.e. handle ‘ECONNRESET’)
160 ## 2021/09/24 - 1.7.4 “Space-dye Vest” fourth bugfix release
162 This version includes the following bugfix:
164 * fix a possible out-of-bound access when handling a request for a non-existent file in the root directory of a vhost that's matched by the cgi option
166 and the relative regression test.
169 ## 2021/09/19 - 1.7.3 “Space-dye Vest” third bugfix release
171 ### Improvements
173 * follows symlinks
174 * improved documentation and added key generation example (thanks! Anna)
176 ### Bugfix
178 * fix syslog logging on FreeBSD. Reported by Karl Jeacle, thanks!
179 * don't crash if ``-c'' is missing in configtest mode (-n). Reported by heph, thanks!
180 * allow fstat64 on linux (needed by glibc on aarch64). Reported by pine, thanks!
183 ## 2021/07/19 - 1.7.2 “Space-dye Vest” second bugfix release
185 This version incudes the following bugfix:
187 * an un-initialized field in the configless code path leads to a crash on the first request.
189 and the relative regression test.
192 ## 2021/07/11 - 1.7.1 “Space-dye Vest” bugfix release
194 This version includes two bugfixes:
195 * use ${MAKE} to recursively call make.
196 * fix the misleading example in the manpage: macros may not be reserved words
199 ## 2021/07/10 - 1.7 “Space-dye Vest”
201 Starting from this version gmid doesn't depend on lex anymore, but yacc is still needed.
203 ### New features
205 * initial fastcgi support! (it's still young!)
206 * added user-defined macros, either via ‘-Dname=val’ or directly in the configuration file.
207 * new ‘include’ keyword to load additional configuration files.
208 * new ‘env’ rule to define environment vars for CGI scripts.
209 * new ‘alias’ rule to define hostname aliases for a server.
210 * allow ‘root’ to be specified per-location block.
211 * pidfile support with the new ‘-P’ cli flag.
212 * define ‘TLS_VERSION’, ‘TLS_CIPHER’ and ‘TLS_CIPHER_STRENGTH’ for CGI scripts.
214 ### Improvements
216 * remove limits on the number of virtual hosts and location blocks that can be defined.
217 * print the datetime when logging to stderr.
218 * use ‘text/x-patch’ for ‘.patch’ and ‘.diff’ files.
219 * sort the auto index alphabetically.
220 * various improvements to the log management.
221 * drop the dependency on lex.
222 * added ‘--help’ as synonym of ‘-h’ and ‘-V’/‘--version‘ to print the version.
223 * c-like handling of strings in the configuration file: when two or more strings are next to each-others, are automatically joined into a single string. This is particularly useful with $-macros.
225 ### Bug fixes
227 * correctly handle CGI scripts that replies with the maxium header length allowed.
228 * fixed the static target.
229 * fixed recursive mkdirs for configless mode (i.e. create ‘~/.local/share/gmid’)
230 * logs sent to syslog now have proper priority (before every message ended up as LOG_CRIT). Found by Anna “CyberTailor”, thanks!
231 * ensure ‘%p’ (path) is always absolute in ‘block return’ rules.
232 * fix automatic certificate generation, it caused problems on some adroid devices. Found by Gnuserland, thanks!
233 * document the ‘log’ rule.
234 * the seccomp filter was reworked and now it's known to work properly on a vast range of architectures (to be more specific: all the architectures supported by alpine linux), see github issue #4. Prompted and tested by @begss, thanks!
235 * various improvements to the configure script, notified and fixed by Anna “CyberTailor”, thanks!
236 * added a timeout to the regression tests.
238 ### Breaking changes
240 * if duplicate rules are found in the configuration file, an error is now raised instead of silently using only the last value.
241 * (sort of) ‘gg’ moved to ‘regress’ as it's only used in the regression suite.
242 * (notice) the “mime "mime-type" "extension"” rule was deprecated and replaced by the new “map "mime-type" to-ext "extension"”. The ‘mime’ rule will be removed in a future version because its syntax is incompatible with the new string auto-concat mechanism.