1
0
mirror of https://github.com/postgres/postgres.git synced 2025-10-27 00:12:01 +03:00

aio, bufmgr: Comment fixes/improvements

Some of these comments have been wrong for a while (12f3867f55), some I
recently introduced (da7226993f, 55b454d0e1). This includes an update to a
comment in FlushBuffer(), which will be copied in a future commit.

These changes seem big enough to be worth doing in separate commits.

Suggested-by: Noah Misch <noah@leadboat.com>
Discussion: https://postgr.es/m/20250319212530.80.nmisch@google.com
This commit is contained in:
Andres Freund
2025-03-29 14:45:42 -04:00
parent 50cb7505b3
commit 08ccd56ac7
4 changed files with 27 additions and 9 deletions

View File

@@ -3929,9 +3929,10 @@ FlushBuffer(BufferDesc *buf, SMgrRelation reln, IOObject io_object,
XLogFlush(recptr);
/*
* Now it's safe to write buffer to disk. Note that no one else should
* have been able to write it while we were busy with log flushing because
* only one process at a time can set the BM_IO_IN_PROGRESS bit.
* Now it's safe to write the buffer to disk. Note that no one else should
* have been able to write it, while we were busy with log flushing,
* because we got the exclusive right to perform I/O by setting the
* BM_IO_IN_PROGRESS bit.
*/
bufBlock = BufHdrGetBlock(buf);
@@ -5499,9 +5500,6 @@ IsBufferCleanupOK(Buffer buffer)
/*
* Functions for buffer I/O handling
*
* Note: We assume that nested buffer I/O never occurs.
* i.e at most one BM_IO_IN_PROGRESS bit is set per proc.
*
* Also note that these are used only for shared buffers, not local ones.
*/