pg_blocking

pg_blocking
Prev	4.4. Asynchronous Query Processing Commands	Next

pg_blocking — Get or set the connection mode - blocking or nonblocking

Synopsis

pg_blocking conn ?newSetting?

Description

pg_blocking changes the blocking mode of a connection, or just gets the current mode.

Arguments

conn: The handle of the connection.
newSetting: If supplied, a Tcl boolean value with the new blocking mode setting. Use 1 (or true, yes, or on) to set blocking mode, or 0 (or false, no, or off) for non-blocking mode.

Return Value

If newSetting is provided, returns the blocking state: 1 if blocking, 0 if non-blocking, before changing to the new setting. If newSetting is not provided, returns the current blocking state.

There are no error conditions other than argument errors.

Notes

You do not need to set a connection to non-blocking state to use the asynchronous query commands such as pg_sendquery. Furthermore, non-blocking mode has not been tested with other pgtcl commands, so the consequences of using non-blocking mode are generally not known.

This command uses or emulates the PostgreSQL libpq function PQsetnonblocking.

Prev	Up	Next
pg_cancelrequest	Home	pg_result_callback