From: Tom Lane <tgl@sss.pgh.pa.us>
To: Daniel Gustafsson <daniel@yesql.se>
cc: Laurenz Albe <laurenz.albe@cybertec.at>, Igor Korot <ikorot01@gmail.com>,
        "pgsql-generallists.postgresql.org" <pgsql-general@lists.postgresql.org>
Subject: Re: Another documentation issue
In-reply-to: <4B9E0CAC-FB06-4F35-8C77-33AEA7F741B7@yesql.se>
References: <CA+FnnTxPHoCZz2JBFxC3Wdsce9KUwNL0KcH5Ua37R55XLQbrpg@mail.gmail.com> <03763b6b43cfd8a7194c2fb06452178db4256494.camel@cybertec.at> <4B9E0CAC-FB06-4F35-8C77-33AEA7F741B7@yesql.se>
Comments: In-reply-to Daniel Gustafsson <daniel@yesql.se>
	message dated "Wed, 23 Apr 2025 11:14:13 +0200"
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-ID: <1430372.1745432896.1@sss.pgh.pa.us>
Content-Transfer-Encoding: quoted-printable
Date: Wed, 23 Apr 2025 14:28:16 -0400
Message-ID: <1430373.1745432896@sss.pgh.pa.us>
Archived-At: <https://www.postgresql.org/message-id/1430373.1745432896%40sss.pgh.pa.us>
Precedence: bulk

Daniel Gustafsson <daniel@yesql.se> writes:
>> On 23 Apr 2025, at 09:16, Laurenz Albe <laurenz.albe@cybertec.at> wrote=
:
>> On Wed, 2025-04-23 at 00:21 -0500, Igor Korot wrote:
>>> No explanation of what is "supported system" is given...

>> According to the source, it is "systems that have posix_fadvise()".  We=
 could document that,
>> but I don't know if it would help many people.  I am not sure how easy =
and feasible it is
>> to research which versions of which operating systems qualify.

>> From memory it's supported on FreeBSD, NetBSD and Linux with Windows, m=
acOS and
> OpenBSD not supporting it.  Assuming I'm not completely wrong (a 1 minut=
e
> search shows it's in the ballpark) we could perhaps add something like
> "Unsupported platforms include (but isn't limited to) Windows and macOS"=
 which
> would provide a bit more clarity.

If we do anything about this, I'd just say "systems that have
posix_fadvise()".  If we write something more specific it's likely to
become obsolete, and it doesn't seem to me that it's hard for someone
to research "does my box have posix_fadvise()?".

			regards, tom lane