PG_ON_CONNECTION_LOSS(n)

📦 version 3.1.1, in alpine 3.22, alpine 3.23, alpine 3.24, nixpkgs unstable

💅 pg_on_connection_loss 💅

🎀 NAME 🎀

okay so bestie, pg_on_connection_loss — set or change a callback for unexpected connection loss. This page comes straight from the PostgreSQL Tcl Interface Documentation, and it's here to help you handle that "wait, where did the database go?" moment with main character energy. 💖

✨ SYNOPSIS ✨

pg_on_connection_loss conn [callbackCommand]

💖 DESCRIPTION 💖

pg_on_connection_loss creates, changes, or cancels a request to execute a callback command if an unexpected loss of connection to the database occurs. The way it works is lowkey simple:

  • With a callbackCommand parameter, the request is established, or the command string of an already existing request is replaced. Slay. ✨
  • With no callbackCommand parameter, a prior request is canceled. Bye bestie. 👋

The callback command string is executed from the Tcl idle loop. That is the normal idle state of an application written with Tk. In non-Tk Tcl shells, you can execute update or vwait to cause the idle loop to be entered. iykyk 🫶

🦋 ARGUMENTS 🦋

  • conn — the handle to watch for connection losses. 👀
  • callbackCommand — if present, provides the command string to execute when connection loss is detected. 🎀

🌸 RETURN VALUE 🌸

None. That's it. Nothing returned. periodt. 💅

🫶 signed, sealed, delivered: this page is from the PostgreSQL Tcl Interface Documentation, dated 17 September 2020. no cap. 💖
📦 where this page comes from