'\" t
.\"     Title: pg_test_fsync
.\"    Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 2026
.\"    Manual: PostgreSQL 18.6 Documentation
.\"    Source: PostgreSQL 18.6
.\"  Language: English
.\"
.TH "PG_TEST_FSYNC" "1" "2026" "PostgreSQL 18.6" "PostgreSQL 18.6 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
pg_test_fsync \- تعیین سریع‌ترین \fIwal_sync_method\fR برای PostgreSQL
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBpg_test_fsync\fR\ 'u
\fBpg_test_fsync\fR [\fIگزینه\fR...]
.SH "توضیحات (DESCRIPTION)"
.PP
ابزار
pg_test_fsync
به این منظور طراحی شده است که دید مناسبی از اینکه کدام
wal_sync_method
روی سیستم مشخص شما سریع‌ترین است ارائه دهد، و نیز در هنگام بروز مشکلات شناسایی‌شده I/O اطلاعات عیب‌یابی فراهم کند\&. با این حال، تفاوت‌های نشان داده‌شده توسط
pg_test_fsync
ممکن است تأثیر چشمگیری روی بازدهی و گذردهی واقعی پایگاه داده نداشته باشد، به‌ویژه از آن رو که کارایی بسیاری از کارسازهای پایگاه داده توسط لاگ‌های پیش‌نویس (write\-ahead logs) محدود نمی‌شود\&.
ابزار
pg_test_fsync
میانگین زمان عملیات همگام‌سازی فایل را بر حسب میکروثانیه برای هر
wal_sync_method
گزارش می‌کند، که می‌تواند جهت تلاش برای بهینه‌سازی مقدار
commit_delay
نیز به کار رود\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
دستور
pg_test_fsync
گزینه‌های خط فرمان زیر را می‌پذیرد:
.PP
\fB\-f\fR
.br
\fB\-\-filename\fR
.RS 4
نام فایلی را که داده‌های آزمایشی باید در آن نوشته شوند مشخص می‌کند\&. این فایل باید در همان فایل‌سیستمی باشد که دایرکتوری
pg_wal
در آن قرار دارد یا قرار خواهد گرفت\&. (دایرکتوری
pg_wal
حاوی فایل‌های
WAL
است\&.) مقدار پیش‌فرض
pg_test_fsync\&.out
در دایرکتوری جاری است\&.
.RE
.PP
\fB\-s\fR
.br
\fB\-\-secs\-per\-test\fR
.RS 4
تعداد ثانیه‌ها را برای هر آزمایش مشخص می‌کند\&. هر چه زمان هر آزمایش بیشتر باشد، دقت آزمایش بیشتر خواهد بود، اما اجرای آن زمان بیشتری می‌برد\&. مقدار پیش‌فرض ۵ ثانیه است، که اجازه می‌دهد برنامه در کمتر از ۲ دقیقه به پایان برسد\&.
.RE
.PP
\fB\-V\fR
.br
\fB\-\-version\fR
.RS 4
نسخه
pg_test_fsync
را چاپ کرده و خارج می‌شود\&.
.RE
.PP
\fB\-?\fR
.br
\fB\-\-help\fR
.RS 4
راهنمایی درباره آرگومان‌های خط فرمان
pg_test_fsync
را نمایش داده و خارج می‌شود\&.
.RE
.SH "محیط (ENVIRONMENT)"
.PP
متغیر محیطی
\fBPG_COLOR\fR
مشخص می‌کند که آیا در پیام‌های عیب‌یابی از رنگ استفاده شود یا خیر\&. مقادیر ممکن عبارتند از
always،
auto
و
never\&.
.SH "همچنین ببینید (SEE ALSO)"
\fBpostgres\fR(1)