'\" t
.\"     Title: pg_waldump
.\"    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_WALDUMP" "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_waldump \- نمایش بازنمایی خوانا برای انسان از لاگ پیش از نوشتن (WAL) یک کلاستر پایگاه‌داده PostgreSQL
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBpg_waldump\fR\ 'u
\fBpg_waldump\fR [\fBoption\fR...] [\fBstartseg\fR\ [\fBendseg\fR]]
.SH "توضیحات (DESCRIPTION)"
.PP
دستور
\fBpg_waldump\fR
لاگ پیش از نوشتن (WAL) را نمایش می‌دهد و عمدتاً برای اهداف اشکال‌زدایی یا آموزشی مفید است\&.
.PP
این ابزار تنها توسط کاربری که سرور را نصب کرده است می‌تواند اجرا شود، چرا که نیازمند دسترسی فقط‌خواندنی به دایرکتوری داده (data directory) است\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
گزینه‌های خط فرمان زیر مکان و قالب خروجی را کنترل می‌کنند:
.PP
\fIstartseg\fR
.RS 4
شروع خواندن از فایل سگمنت WAL مشخص‌شده\&. این کار به‌طور ضمنی مسیری را که فایل‌ها در آن جستجو می‌شوند و همچنین خط زمانی (timeline) مورد استفاده را تعیین می‌کند\&.
.RE
.PP
\fIendseg\fR
.RS 4
توقف پس از خواندن فایل سگمنت WAL مشخص‌شده\&.
.RE
.PP
\fB\-b\fR
.br
\fB\-\-bkp\-details\fR
.RS 4
خروجی دادن اطلاعات تفصیلی درباره بلوک‌های پشتیبان (backup blocks)\&.
.RE
.PP
\fB\-B \fR\fB\fIblock\fR\fR
.br
\fB\-\-block=\fR\fB\fIblock\fR\fR
.RS 4
تنها نمایش رکوردهایی که بلوک داده‌شده را تغییر می‌دهند\&. رابطه (relation) نیز باید با
\fB\-\-relation\fR
یا
\fB\-R\fR
مشخص شود\&.
.RE
.PP
\fB\-e \fR\fB\fIend\fR\fR
.br
\fB\-\-end=\fR\fB\fIend\fR\fR
.RS 4
توقف خواندن در مکان مشخص‌شده WAL، به‌جای خواندن تا انتهای جریان لاگ\&.
.RE
.PP
\fB\-f\fR
.br
\fB\-\-follow\fR
.RS 4
پس از رسیدن به انتهای WAL معتبر، هر یک ثانیه یک‌بار برای پدیدار شدن WAL جدید بررسی (poll) ادامه یابد\&.
.RE
.PP
\fB\-F \fR\fB\fIfork\fR\fR
.br
\fB\-\-fork=\fR\fB\fIfork\fR\fR
.RS 4
تنها نمایش رکوردهایی که بلوک‌ها را در انشعاب (fork) داده‌شده تغییر می‌دهند\&. مقادیر معتبر عبارتند از
main
برای انشعاب اصلی،
fsm
برای نقشه فضای آزاد (free space map)،
vm
برای نقشه رویت‌پذیری (visibility map)، و
init
برای انشعاب init\&.
.RE
.PP
\fB\-n \fR\fB\fIlimit\fR\fR
.br
\fB\-\-limit=\fR\fB\fIlimit\fR\fR
.RS 4
نمایش تعداد مشخص‌شده‌ای از رکوردها و سپس توقف\&.
.RE
.PP
\fB\-p \fR\fB\fIpath\fR\fR
.br
\fB\-\-path=\fR\fB\fIpath\fR\fR
.RS 4
دایرکتوری را برای جستجوی فایل‌های سگمنت WAL یا دایرکتوری با یک زیردایرکتوری
pg_wal
که شامل چنین فایل‌هایی است تعیین می‌کند\&. پیش‌فرض جستجو در دایرکتوری جاری، زیردایرکتوری
pg_wal
از دایرکتوری جاری، و زیردایرکتوری
pg_wal
از
\fBPGDATA\fR
است\&.
.RE
.PP
\fB\-q\fR
.br
\fB\-\-quiet\fR
.RS 4
هیچ خروجی چاپ نشود، مگر برای خطاها\&. این گزینه زمانی مفید است که می‌خواهید بدانید آیا بازه‌ای از رکوردهای WAL با موفقیت تجزیه (parse) می‌شوند یا خیر، اما محتوای رکوردها برایتان اهمیتی ندارد\&.
.RE
.PP
\fB\-r \fR\fB\fIrmgr\fR\fR
.br
\fB\-\-rmgr=\fR\fB\fIrmgr\fR\fR
.RS 4
تنها نمایش رکوردهای تولیدشده توسط مدیر منبع (resource manager) مشخص‌شده\&. می‌توانید این گزینه را چندین بار برای انتخاب چندین مدیر منبع مشخص کنید\&. اگر
list
به‌عنوان نام داده شود، فهرستی از نام‌های معتبر مدیر منبع چاپ شده و برنامه خارج می‌شود\&.
.sp
افزونه‌ها ممکن است مدیران منبع سفارشی تعریف کنند، اما
pg_waldump
ماژول افزونه را بارگذاری نمی‌کند و بنابراین مدیران منبع سفارشی را بر اساس نام تشخیص نمی‌دهد\&. در عوض، می‌توانید مدیران منبع سفارشی را به‌صورت
custom###
مشخص کنید که در آن
\fI###\fR
شناسه سه‌رقمی مدیر منبع است\&. نام‌هایی به این شکل همیشه معتبر در نظر گرفته می‌شوند\&.
.RE
.PP
\fB\-R \fR\fB\fItblspc\fR\fR\fB/\fR\fB\fIdb\fR\fR\fB/\fR\fB\fIrel\fR\fR
.br
\fB\-\-relation=\fR\fB\fItblspc\fR\fR\fB/\fR\fB\fIdb\fR\fR\fB/\fR\fB\fIrel\fR\fR
.RS 4
تنها نمایش رکوردهایی که بلوک‌ها را در رابطه (relation) داده‌شده تغییر می‌دهند\&. رابطه با شناسه فضای‌جدول (tablespace OID)، شناسه پایگاه‌داده (database OID) و relfilenode که با اسلش از یکدیگر جدا شده‌اند مشخص می‌شود، برای مثال
1234/12345/12345\&. این همان قالبی است که برای روابط در خروجی برنامه استفاده می‌شود\&.
.RE
.PP
\fB\-s \fR\fB\fIstart\fR\fR
.br
\fB\-\-start=\fR\fB\fIstart\fR\fR
.RS 4
مکان WAL که خواندن از آنجا آغاز می‌شود\&. پیش‌فرض شروع خواندن از نخستین رکورد معتبر WAL است که در اولین فایل پیدا شده یافت می‌شود\&.
.RE
.PP
\fB\-t \fR\fB\fItimeline\fR\fR
.br
\fB\-\-timeline=\fR\fB\fItimeline\fR\fR
.RS 4
خط زمانی (timeline) که رکوردهای WAL از آن خوانده می‌شوند\&. پیش‌فرض استفاده از مقدار موجود در
\fIstartseg\fR
است، اگر مشخص شده باشد؛ در غیر این صورت، مقدار پیش‌فرض 1 است\&. مقدار می‌تواند به‌صورت ده‌دهی یا شانزده‌شانزدهی مشخص شود، برای مثال
17
یا
0x11\&.
.RE
.PP
\fB\-V\fR
.br
\fB\-\-version\fR
.RS 4
چاپ نسخه
pg_waldump
و خروج\&.
.RE
.PP
\fB\-w\fR
.br
\fB\-\-fullpage\fR
.RS 4
تنها نمایش رکوردهایی که شامل تصاویر کامل صفحه (full page images) هستند\&.
.RE.PP
\fB\-x \fR\fB\fIxid\fR\fR
.br
\fB\-\-xid=\fR\fB\fIxid\fR\fR
.RS 4
تنها رکوردهای نشانه‌گذاری‌شده با شناسه تراکنش (transaction ID) داده‌شده را نمایش می‌دهد\&.
.RE
.PP
\fB\-z\fR
.br
\fB\-\-stats[=record]\fR
.RS 4
نمایش آمار خلاصه (تعداد و اندازه رکوردها و تصاویر تمام‌صفحه) به جای رکوردهای تکی\&. به صورت اختیاری، آمارها را به جای هر rmgr، به ازای هر رکورد تولید می‌کند\&.
.sp
اگر
pg_waldump
با سیگنال
SIGINT
(Control+C) متوقف شود، خلاصه آمارهای محاسبه‌شده تا زمان توقف نمایش داده می‌شود\&. این عملیات در
Windows
پشتیبانی نمی‌شود\&.
.RE
.PP
\fB\-\-save\-fullpage=\fR\fB\fIsave_path\fR\fR
.RS 4
تصاویر تمام‌صفحه (full page images) یافت‌شده در رکوردهای WAL را در دایرکتوری
\fIsave_path\fR
ذخیره می‌کند\&. تصاویر ذخیره‌شده مشمول همان معیارهای پالایش و محدودیتی هستند که بر رکوردهای نمایش‌داده‌شده اعمال می‌شود\&.
.sp
تصاویر تمام‌صفحه با این قالب نام‌گذاری فایل ذخیره می‌شوند:
\fITIMELINE\fR\-\fILSN\fR\&.\fIRELTABLESPACE\fR\&.\fIDATOID\fR\&.\fIRELNODE\fR\&.\fIBLKNO\fR_\fIFORK\fR
نام فایل‌ها از بخش‌های زیر تشکیل شده‌اند:
.TS
allbox tab(:);
lB lB.
T{
مؤلفه
T}:T{
توضیحات
T}
.T&
l l
l l
l l
l l
l l
l l
l l.
T{
TIMELINE
T}:T{
خط زمانی (timeline) مربوط به فایل قطعهٔ WAL که رکورد
             در آن واقع شده است، قالب‌بندی‌شده به صورت یک عدد هگزادسیمال ۸\-رقمی
             %08X
T}
T{
LSN
T}:T{
مقدار LSN رکورد حاوی این تصویر،
             قالب‌بندی‌شده به صورت دو عدد هگزادسیمال ۸\-رقمی
             %08X\-%08X
T}
T{
RELTABLESPACE
T}:T{
شناسه OID مربوط به فضای جدول (tablespace) بلوک
T}
T{
DATOID
T}:T{
شناسه OID مربوط به پایگاه‌داده بلوک
T}
T{
RELNODE
T}:T{
مقدار filenode بلوک
T}
T{
BLKNO
T}:T{
شماره بلوک مربوط به بلوک
T}
T{
FORK
T}:T{
نام انشعابی (fork) که تصویر تمام‌صفحه از آن آمده است، مانند
             main، fsm،
             vm یا init\&.
T}
.TE
.sp 1
.RE
.PP
\fB\-?\fR
.br
\fB\-\-help\fR
.RS 4
نمایش راهنما درباره آرگومان‌های خط فرمان
pg_waldump
و خروج\&.
.RE.SH "محیط (ENVIRONMENT)"
.PP
\fBPGDATA\fR
.RS 4
دایرکتوری داده؛ همچنین گزینهٔ
\fB\-p\fR
را ببینید\&.
.RE
.PP
\fBPG_COLOR\fR
.RS 4
مشخص می‌کند که آیا در پیام‌های عیب‌یابی از رنگ استفاده شود یا خیر\&. مقادیر ممکن عبارت‌اند از
always،
auto
و
never\&.
.RE
.SH "نکات (NOTES)"
.PP
هنگامی که سرور در حال اجرا است، ممکن است نتایج نادرستی ارائه دهد\&.
.PP
فقط خط زمانی (timeline) مشخص‌شده نمایش داده می‌شود (یا در صورت عدم تعیین، مقدار پیش‌فرض)\&. رکوردهای موجود در سایر خط‌های زمانی نادیده گرفته می‌شوند\&.
.PP
pg_waldump
نمی‌تواند فایل‌های WAL با پسوند
\&.partial
را بخواند\&. در صورتی که نیاز به خواندن آن فایل‌ها باشد، پسوند
\&.partial
باید از نام فایل حذف شود\&.
.SH "همچنین ببینید (SEE ALSO)"
بخش\ \&28.6