Обсуждение: Document DSM Registry

Поиск
Список
Период
Сортировка

Document DSM Registry

От
Florents Tselai
Дата:
With the functions GetNamedDSA and GetNamedDSHash added in fe07100
and the system view pg_dsm_registry_allocations (167ed8),
I think its time the DSM Registry get its own subsection in the documentation that connects all these.

Here’s a patch that changes the title of xfunc-shared-addin-after-startup into “DSM Registry”,
and updates the content of the section itself.
I thought about updating the id too, but I don’t think it’s strictly necessary.



Вложения

Re: Document DSM Registry

От
Nathan Bossart
Дата:
-     <title>Requesting Shared Memory After Startup</title>
+     <title>DSM Registry</title>

I'm -1 for renaming the section like this.  The existing title makes the
purpose clear and is symmetrical with the section above it.  I don't see a
need to expose the current implementation's name, either.

+      It supports creating named DSM segments with <function>GetNamedDSMSegment</function>,
+      named dynamic shared memory areas (DSAs) with <function>GetNamedDSA</function>,
+      and named hash tables backed by a DSA with <function>GetNamedDSHash</function>.

IMHO we should provide more details about DSAs and dshash tables.

One of the reasons I didn't add GetNamedDSA() and GetNamedDSHash() to these
docs was because there's no documentation for ShmemInitHash(), either.  Can
we add something for that, too?

-- 
nathan