Date: Mon, 9 Oct 2023 15:48:23 -0500
From: Nathan Bossart <nathandbossart@gmail.com>
To: Peter Eisentraut <peter@eisentraut.org>
Cc: Michael Paquier <michael@paquier.xyz>,
	Justin Pryzby <pryzby@telsasoft.com>,
	Thomas Munro <thomas.munro@gmail.com>,
	David Steele <david@pgmasters.net>,
	Fujii Masao <masao.fujii@oss.nttdata.com>,
	Bruce Momjian <bruce@momjian.us>, Tom Lane <tgl@sss.pgh.pa.us>,
	Michael Brown <michael.brown@discourse.org>,
	pgsql-hackers@postgresql.org
Subject: Re: should frontend tools use syncfs() ?
Message-ID: <20231009204823.GA659480@nathanxps13>
References: <20230729214010.GA189456@nathanxps13>
 <20230731175138.GA432880@nathanxps13>
 <20230731183946.GB537853@nathanxps13>
 <20230801163707.GA862840@nathanxps13>
 <20230808200606.GA1384393@nathanxps13>
 <ZNwF0u/89JFUOQiM@paquier.xyz>
 <20230816151705.GB2651383@nathanxps13>
 <ZN2ZB4afQ2JbR9TA@paquier.xyz>
 <42804669-7063-1320-ed37-3226d5f1067d@eisentraut.org>
 <20231004152907.GD3178@nathanxps13>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20231004152907.GD3178@nathanxps13>
Archived-At: 
 <https://www.postgresql.org/message-id/20231009204823.GA659480%40nathanxps13>
Precedence: bulk

On Wed, Oct 04, 2023 at 10:29:07AM -0500, Nathan Bossart wrote:
> On Wed, Sep 27, 2023 at 01:56:08PM +0100, Peter Eisentraut wrote:
>> We have a collection of platform-specific notes in chapter 19, including
>> file-system-related notes in section 19.2.  Maybe it could be put there?
> 
> I will give this a try.

I started on this, but I couldn't shake the feeling that this wasn't the
right place for these notes.  This chapter is about setting up a server,
and the syncfs() notes do apply to the recovery_init_sync_method
configuration parameter, but it also applies to a number of server/client
applications.

I've been looking around, and I haven't found a great place to move this
section to.  IMO some of the other appendices have similar amounts of
information (e.g., Date/Time Support, The Source Code Repository, Color
Support), so maybe a dedicated appendix isn't too extreme.  Another option
could be to introduce a new section for platform-specific notes, but that
would just make this section even larger for now.

Thoughts?

-- 
Nathan Bossart
Amazon Web Services: https://aws.amazon.com