Movatterモバイル変換

[0]ホーム
URL:

Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

 Sign up
Appearance settings

Commit44a4cca

Browse files
Adjust documentation for syncfs().
Commit8c16ad3 created a new appendix for syncfs(), which isexcessive for such a small amount of content. This commit movesthe description of the caveats to be aware of when using syncfs()back to the documentation for recovery_init_sync_method. Thedocumentation for the other utilities with syncfs() support nowdirects readers to recovery_init_sync_method for information aboutthese caveats.Reported-by: Peter Eisentraut, Robert HaasSuggested-by: Robert HaasReviewed-by: Robert HaasDiscussion:https://postgr.es/m/42804669-7063-1320-ed37-3226d5f1067d%40eisentraut.orgDiscussion:https://postgr.es/m/CA%2BTgmobUiqKr%2BZMCLc5Qap-sXBnjfGUU%2BZBmzYEjUuWyjsGr1g%40mail.gmail.com
1 parentde7e96b commit44a4cca

File tree

11 files changed

+24
-55
lines changed

11 files changed

+24
-55
lines changed

‎doc/src/sgml/config.sgml‎

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -10870,9 +10870,15 @@ dynamic_library_path = 'C:\tools\postgresql;H:\my_project\lib;$libdir'
1087010870
On Linux, <literal>syncfs</literal> may be used instead, to ask the
1087110871
operating system to synchronize the file systems that contain the
1087210872
data directory, the WAL files and each tablespace (but not any other
10873-
file systems that may be reachable through symbolic links). See
10874-
<xref linkend="syncfs"/> for more information about using
10875-
<function>syncfs()</function>.
10873+
file systems that may be reachable through symbolic links). This may
10874+
be a lot faster than the <literal>fsync</literal> setting, because it
10875+
doesn't need to open each file one by one. On the other hand, it may
10876+
be slower if a file system is shared by other applications that
10877+
modify a lot of files, since those files will also be written to disk.
10878+
Furthermore, on versions of Linux before 5.8, I/O errors encountered
10879+
while writing data to disk may not be reported to
10880+
<productname>PostgreSQL</productname>, and relevant error messages may
10881+
appear only in kernel logs.
1087610882
</para>
1087710883
<para>
1087810884
This parameter can only be set in the

‎doc/src/sgml/filelist.sgml‎

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -182,7 +182,6 @@
182182
<!ENTITY acronyms SYSTEM "acronyms.sgml">
183183
<!ENTITY glossary SYSTEM "glossary.sgml">
184184
<!ENTITY color SYSTEM "color.sgml">
185-
<!ENTITY syncfs SYSTEM "syncfs.sgml">
186185

187186
<!ENTITY features-supported SYSTEM "features-supported.sgml">
188187
<!ENTITY features-unsupported SYSTEM "features-unsupported.sgml">

‎doc/src/sgml/postgres.sgml‎

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -289,7 +289,6 @@ break is not needed in a wider output rendering.
289289
&acronyms;
290290
&glossary;
291291
&color;
292-
&syncfs;
293292
&obsolete;
294293

295294
</part>

‎doc/src/sgml/ref/initdb.sgml‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -394,8 +394,8 @@ PostgreSQL documentation
394394
On Linux, <literal>syncfs</literal> may be used instead to ask the
395395
operating system to synchronize the whole file systems that contain the
396396
data directory, the WAL files, and each tablespace. See
397-
<xref linkend="syncfs"/> formoreinformation about using
398-
<function>syncfs()</function>.
397+
<xref linkend="guc-recovery-init-sync-method"/> for information about
398+
the caveats to be aware of when using <literal>syncfs</literal>.
399399
</para>
400400
<para>
401401
This option has no effect when <option>--no-sync</option> is used.

‎doc/src/sgml/ref/pg_basebackup.sgml‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -642,8 +642,8 @@ PostgreSQL documentation
642642
backup directory. When the plain format is used,
643643
<command>pg_basebackup</command> will also synchronize the file systems
644644
that contain the WAL files and each tablespace. See
645-
<xref linkend="syncfs"/> formoreinformation about using
646-
<function>syncfs()</function>.
645+
<xref linkend="guc-recovery-init-sync-method"/> for information about
646+
the caveats to be aware of when using <literal>syncfs</literal>.
647647
</para>
648648
<para>
649649
This option has no effect when <option>--no-sync</option> is used.

‎doc/src/sgml/ref/pg_checksums.sgml‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -152,8 +152,8 @@ PostgreSQL documentation
152152
On Linux, <literal>syncfs</literal> may be used instead to ask the
153153
operating system to synchronize the whole file systems that contain the
154154
data directory, the WAL files, and each tablespace. See
155-
<xref linkend="syncfs"/> formoreinformation about using
156-
<function>syncfs()</function>.
155+
<xref linkend="guc-recovery-init-sync-method"/> for information about
156+
the caveats to be aware of when using <literal>syncfs</literal>.
157157
</para>
158158
<para>
159159
This option has no effect when <option>--no-sync</option> is used.

‎doc/src/sgml/ref/pg_combinebackup.sgml‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -176,8 +176,8 @@ PostgreSQL documentation
176176
backup directory. When the plain format is used,
177177
<command>pg_combinebackup</command> will also synchronize the file systems
178178
that contain the WAL files and each tablespace. See
179-
<xref linkend="syncfs"/> formoreinformation about using
180-
<function>syncfs()</function>.
179+
<xref linkend="guc-recovery-init-sync-method"/> for information about
180+
the caveats to be aware of when using <literal>syncfs</literal>.
181181
</para>
182182
<para>
183183
This option has no effect when <option>--no-sync</option> is used.

‎doc/src/sgml/ref/pg_dump.sgml‎

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1319,8 +1319,9 @@ PostgreSQL documentation
13191319
<para>
13201320
On Linux, <literal>syncfs</literal> may be used instead to ask the
13211321
operating system to synchronize the whole file system that contains the
1322-
archive directory. See <xref linkend="syncfs"/> for more information
1323-
about using <function>syncfs()</function>.
1322+
archive directory. See <xref linkend="guc-recovery-init-sync-method"/>
1323+
for information about the caveats to be aware of when using
1324+
<literal>syncfs</literal>.
13241325
</para>
13251326
<para>
13261327
This option has no effect when <option>--no-sync</option> is used or

‎doc/src/sgml/ref/pg_rewind.sgml‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -297,8 +297,8 @@ PostgreSQL documentation
297297
On Linux, <literal>syncfs</literal> may be used instead to ask the
298298
operating system to synchronize the whole file systems that contain the
299299
data directory, the WAL files, and each tablespace. See
300-
<xref linkend="syncfs"/> formoreinformation about using
301-
<function>syncfs()</function>.
300+
<xref linkend="guc-recovery-init-sync-method"/> for information about
301+
the caveats to be aware of when using <literal>syncfs</literal>.
302302
</para>
303303
<para>
304304
This option has no effect when <option>--no-sync</option> is used.

‎doc/src/sgml/ref/pgupgrade.sgml‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -204,8 +204,8 @@ PostgreSQL documentation
204204
On Linux, <literal>syncfs</literal> may be used instead to ask the
205205
operating system to synchronize the whole file systems that contain the
206206
upgraded cluster's data directory, its WAL files, and each tablespace.
207-
See <xref linkend="syncfs"/> formoreinformation about using
208-
<function>syncfs()</function>.
207+
See <xref linkend="guc-recovery-init-sync-method"/> for information
208+
about the caveats to be aware of when using <literal>syncfs</literal>.
209209
</para>
210210
<para>
211211
This option has no effect when <option>--no-sync</option> is used.

0 commit comments

Comments
 (0)
[8]ページ先頭
©2009-2025 Movatter.jp