Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.94.2) (envelope-from ) id 1u7gVA-0040dH-G7 for pgsql-general@arkaria.postgresql.org; Wed, 23 Apr 2025 20:15:24 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.94.2) (envelope-from ) id 1u7gV8-009taj-JW for pgsql-general@arkaria.postgresql.org; Wed, 23 Apr 2025 20:15:23 +0000 Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29]) by malur.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.94.2) (envelope-from ) id 1u7gV8-009taa-8M for pgsql-general@lists.postgresql.org; Wed, 23 Apr 2025 20:15:23 +0000 Received: from mail-yw1-x1129.google.com ([2607:f8b0:4864:20::1129]) by magus.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 (Exim 4.96) (envelope-from ) id 1u7gV5-001eof-38 for pgsql-general@lists.postgresql.org; Wed, 23 Apr 2025 20:15:22 +0000 Received: by mail-yw1-x1129.google.com with SMTP id 00721157ae682-702628e34f2so3074107b3.0 for ; Wed, 23 Apr 2025 13:15:20 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1745439319; x=1746044119; darn=lists.postgresql.org; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:from:to:cc:subject:date:message-id:reply-to; bh=XXDXUQ4xgafnFICaR265I3X2P+jPh2D2LNjcJ4PgZDs=; b=ltxR8OKLP3aZo4SgoEJK0+wwbLY6VWpoq8nHWC54x8/cKyGKYpnPhNlzek9rM9rgk0 b5M9U2rP5LO3cuILXGfIga2G8sQWplHd3COtCGEK6joj5wd0WUvD6vaEYFGJjTB+Uo5w OZAMu+pq6DeCgGipqlK3dsKDFcNfa3qCVNPrtOUVwdomCMXbs5Zp4JDn9HmQI4euY2MK Ya9NHR8pjBruGBjYk84s3uI7bkgjvNPOnrUZzfM2JfZTs1OyhKZSBugTAbwTiOY8jxas QJvAFe2KuEYV3MtO0bj8oV+RggHJpZp2eC4/5iyjBAyDUc/FAv89MDEVPFhastjQzuQa Nmyw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1745439319; x=1746044119; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=XXDXUQ4xgafnFICaR265I3X2P+jPh2D2LNjcJ4PgZDs=; b=HXVb3JeecbUssriqvi/YxeN76+KkfZViGaO/fFfkHPAlqeWkdCJgG7wZy5yQw+8QBL 5t+UHawNzURfx6sVV6DEEPKZXePleDSre/HTRnJAC6RLcTINssBi3W5wXrqPFus8//rW sMyFyAj8lywH4OFaYVXUMBsqkRWrkITE0f3ce8n98tCbr3GMNGywnlpmz39zBkcztfVE 0WvOfWxh/ryCPxUL8q1VONF9s8RX55wWPNUnZFRE764KhFGfVtrTJYLnyFwWQzVhpabx x+s0Jwy12kp5Az4qYGkAQbZD11GvP+mZvStRi1sV8GaoTwx+gKKs/ZZDfaaikszERguc BUTQ== X-Forwarded-Encrypted: i=1; AJvYcCXXoj1g0sU+H3oe1Abra+3MQGVT/qdkwESQkZ2MSlqoUDhDmv9g9QvOZtyeIJmxav+hs5j1DoPEezlSdmpY@lists.postgresql.org X-Gm-Message-State: AOJu0YwB39jk74RmRH0ibN6ORFtj+WecY+1yT38GslTbg7PFdsEPMF8x FzR7TtGDRwj5DE0NUz4btFtKV7gV1xOnOApeXakH1fOr6K8arEzX4AnCOaJ2qJnj+DczCMCwfFc DvpB38PV+Qbxy31APbw4gVFcET+Y= X-Gm-Gg: ASbGncsPCiAyP5FFfQEa8zk9niqB0UQaV0vx6+xXE33vteZygCf/DaZYYo3BC6LBqyb E+wQ3CwYzfkpfDQeak+5fzahU/mWBa0cz47GQPP3AZAPgpf1wfd3H+ijySjrsCZyGRkGCBl4hu6 ApBd+ijOpLvLvtYCgfJ896QhDonlWz/VzTntwRQbmfHWXrfcWkrIcm78Bg X-Google-Smtp-Source: AGHT+IHkw16GaJRBLwYQwyV50Vn28MznOoi/UFMM1dAfaFd0RrEz+PLudSjUNckRXMC1GmlaMuOGokDU934xESy3ug0= X-Received: by 2002:a05:690c:6a82:b0:6f9:4c00:53ae with SMTP id 00721157ae682-7083f7c8a97mr1524517b3.8.1745439319173; Wed, 23 Apr 2025 13:15:19 -0700 (PDT) MIME-Version: 1.0 References: <03763b6b43cfd8a7194c2fb06452178db4256494.camel@cybertec.at> <4B9E0CAC-FB06-4F35-8C77-33AEA7F741B7@yesql.se> <1430373.1745432896@sss.pgh.pa.us> <1431982.1745433654@sss.pgh.pa.us> In-Reply-To: <1431982.1745433654@sss.pgh.pa.us> From: Igor Korot Date: Wed, 23 Apr 2025 15:15:08 -0500 X-Gm-Features: ATxdqUGJz6obKlAj_3SeB_e7M2QkXaJ3BvX0teS5F6qZN3GYrBL6oytEg2HJ1-4 Message-ID: Subject: Re: Another documentation issue To: Tom Lane Cc: Daniel Gustafsson , Laurenz Albe , "pgsql-generallists.postgresql.org" Content-Type: multipart/alternative; boundary="00000000000098b179063377c24f" List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Archived-At: Precedence: bulk --00000000000098b179063377c24f Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Tom, On Wed, Apr 23, 2025 at 1:40=E2=80=AFPM Tom Lane wrote: > Igor Korot writes: > > On Wed, Apr 23, 2025 at 1:28=E2=80=AFPM Tom Lane wr= ote: > >> 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()? > > > Imagine a person that wants to write a program which will cover creatin= g > > the table space. > > Such person needs to cover the appropriate fields with possible values. > > Is there a #define such person should check to cover the appropriate > values? > > HAVE_POSIX_FADVISE. Seems to me it'd be way easier to find that > from documentation that mentions posix_fadvise than from documentation > that says "it works on systems X, Y, Z". Agreed. Hopefully someone can put this in=E2=80=A6 Thx. > > regards, tom lane > --00000000000098b179063377c24f Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
Tom,

On Wed, Apr 23, 2025 at 1:= 40=E2=80=AFPM Tom Lane <tgl@sss.pgh= .pa.us> wrote:
Igor Korot &l= t;ikorot01@gmail.co= m> writes:
> On Wed, Apr 23, 2025 at 1:28=E2=80=AFPM Tom Lane <tgl@sss.pgh.pa.us> wrote:
>> If we do anything about this, I'd just say "systems that = have
>> posix_fadvise()".=C2=A0 If we write something more specific i= t'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()?

> Imagine a person that wants to write a program which will cover creati= ng
> the table space.
> Such person needs to cover the appropriate fields with possible values= .
> Is there a #define such person should check to cover the appropriate v= alues?

HAVE_POSIX_FADVISE.=C2=A0 Seems to me it'd be way easier to find that from documentation that mentions posix_fadvise than from documentation
that says "it works on systems X, Y, Z".

Agreed.
Hopefully = someone can put this in=E2=80=A6


Thx.



=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2= =A0 =C2=A0 regards, tom lane
--00000000000098b179063377c24f--