]> git.ipfire.org Git - thirdparty/postgresql.git/commit
doc: Correct the timeline for OAuth's shutdown_cb
authorJacob Champion <jchampion@postgresql.org>
Fri, 29 May 2026 21:39:03 +0000 (14:39 -0700)
committerJacob Champion <jchampion@postgresql.org>
Fri, 29 May 2026 21:39:03 +0000 (14:39 -0700)
commit380a8b2ea024c33a35e7abc8628e7c4f52f9f9f9
treed31584e21f6ad8e1116fc5b8cf0962a30480e9a6
parentc8b4186d6eef1bb310708e02aa872947fba87e9f
doc: Correct the timeline for OAuth's shutdown_cb

During original feature development, the OAuth validator shutdown
callback was invoked via before_shmem_exit(). That was changed to use a
reset callback before commit, but I forgot to update the documentation
for validator developers.

Correct this and backport to 18, where OAuth was introduced. The
callback is invoked whenever the server is "finished" with token
validation. (We make no stronger guarantees here, in the hopes that this
API might successfully navigate future multifactor authentication
support and/or changes to the server threading model.)

Reported-by: Zsolt Parragi <zsolt.parragi@percona.com>
Reviewed-by: Zsolt Parragi <zsolt.parragi@percona.com>
Reviewed-by: Chao Li <li.evan.chao@gmail.com>
Discussion: https://postgr.es/m/CAN4CZFOuMb_gnLvCwRdMybg_k8WRNJTjcij%2BPoQkuQHDUzxGWg%40mail.gmail.com
Backpatch-through: 18
doc/src/sgml/oauth-validators.sgml