@@ -189,15 +189,17 @@ typedef struct BackgroundWorker
189189 </para>
190190
191191 <para>Once running, the process can connect to a database by calling
192- <function>BackgroundWorkerInitializeConnection(<parameter>char *dbname</parameter>, <parameter>char *username</parameter>)</function> or
193- <function>BackgroundWorkerInitializeConnectionByOid(<parameter>Oid dboid</parameter>, <parameter>Oid useroid</parameter>)</function>.
192+ <function>BackgroundWorkerInitializeConnection(<parameter>char *dbname</parameter>, <parameter>char *username</parameter>, <parameter>uint32 flags</parameter> )</function> or
193+ <function>BackgroundWorkerInitializeConnectionByOid(<parameter>Oid dboid</parameter>, <parameter>Oid useroid</parameter>, <parameter>uint32 flags</parameter> )</function>.
194194 This allows the process to run transactions and queries using the
195195 <literal>SPI</literal> interface. If <varname>dbname</varname> is NULL or
196196 <varname>dboid</varname> is <literal>InvalidOid</literal>, the session is not connected
197197 to any particular database, but shared catalogs can be accessed.
198198 If <varname>username</varname> is NULL or <varname>useroid</varname> is
199199 <literal>InvalidOid</literal>, the process will run as the superuser created
200- during <command>initdb</command>.
200+ during <command>initdb</command>. If <literal>BGWORKER_BYPASS_ALLOWCONN</literal>
201+ is specified as <varname>flags</varname> it is possible to bypass the restriction
202+ to connect to databases not allowing user connections.
201203 A background worker can only call one of these two functions, and only
202204 once. It is not possible to switch databases.
203205 </para>
0 commit comments