Re: Another documentation issue - Mailing list pgsql-general

From Daniel Gustafsson
Subject Re: Another documentation issue
Date
Msg-id 4B9E0CAC-FB06-4F35-8C77-33AEA7F741B7@yesql.se
Whole thread Raw
In response to Re: Another documentation issue  (Laurenz Albe <laurenz.albe@cybertec.at>)
Responses Re: Another documentation issue
Re: Another documentation issue
List pgsql-general
> 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:

>> However, this page
>> https://www.postgresql.org/docs/current/runtime-config-resource.html#GUC-EFFECTIVE-IO-CONCURRENCY
>> describes both default and mn/max, however t s says:
>>
>> [quote]
>> The default is 1 on supported systems, otherwise 0
>> [/quote]]
>>
>> No explanation of what is "supported system" is given...
>>
>> And the same can be said about
>> https://www.postgresql.org/docs/current/runtime-config-resource.html#GUC-MAINTENANCE-IO-CONCURRENCY.
>
> 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, macOS and
OpenBSD not supporting it.  Assuming I'm not completely wrong (a 1 minute
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.

--
Daniel Gustafsson




pgsql-general by date:

Previous
From: Laurenz Albe
Date:
Subject: Re: Another documentation issue
Next
From: "Zechman, Derek S"
Date:
Subject: segmentation fault