On Tue, May 27, 2014 at 12:09 PM, Robert Haas <robertmh...@gmail.com> wrote:
> On Fri, May 23, 2014 at 10:38 AM, Michael Paquier
> <michael.paqu...@gmail.com> wrote:
>> On Fri, May 23, 2014 at 6:29 PM, Shigeru Hanada
>> <shigeru.han...@gmail.com> wrote:
>>> I noticed that contrib/worker_spi can't run as non-dynamic background
>>> worker (IOW, load via shared_preload_libraries), because of
>>> uninitialized bgw_notify_pid.
>> That's actually the case of all the bgworkers that have been developed
>> with 9.3 and not only worker_spi. If bgw_notify_pid needs to be
>> specifically initialized with 9.4, this should be mentioned in the
>> release notes or users will be surprised.
> I agree that it would be appropriate to mention this in the release
> notes, maybe in the incompatibilities section.  The basic idea is:
> When registering a background worker, the new bgw_notify_pid field
> should be initialized to zero, except if you're using the new
> notification feature.
This is an item for the section "Migration to 9.4" IMO.

> That feature (introduced in commit
> 090d0f2050647958865cb495dff74af7257d2bb4) doesn't seem to really be
> mentioned in the release notes at present, so we might want to add
> that too.  It doesn't necessarily have to be separate from the
> existing background worker item, although it could be, but it should
> be mentioned somehow, particularly because of the related
> incompatibility.
The feature itself is already mentioned in the release notes in a very
general manner, by telling that bgworkers can be dynamically
"registered" and "started". Users can still refer to the documentation
to see more precisely what kind of infrastructure is in place in 9.4.

So... As I'm on it... What about something like the attached patch?
diff --git a/doc/src/sgml/release-9.4.sgml b/doc/src/sgml/release-9.4.sgml
index 24862fe..189878b 100644
--- a/doc/src/sgml/release-9.4.sgml
+++ b/doc/src/sgml/release-9.4.sgml
@@ -307,6 +307,15 @@
+      <link linkend="bgworker">background workers</link> registered at
+       postmaster startup time should set <structfield>bgw_notify_pid</structfield>
+       to 0.
+      <command></>
+     </para>
+    </listitem>
+    <listitem>
+     <para>
       <command>DISCARD ALL</> now also discards sequence state.
Sent via pgsql-hackers mailing list (pgsql-hackers@postgresql.org)
To make changes to your subscription:

Reply via email to