.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Required to disable full justification in groff 1.23.0.
.if n .ds AD l
.\" ========================================================================
.\"
.IX Title "RRDDUMP 1"
.TH RRDDUMP 1 2026-08-08 1.11.0 rrdtool
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "نام (NAME)"
rrddump \- استخراج محتویات یک RRD به قالب XML
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
\&\fBrrdtool\fR \fBdump\fR \fIfilename.rrd\fR [\fIfilename.xml\fR]
[\fB\-\-header\fR|\fB\-h\fR\ {none,xsd,dtd}]
[\fB\-\-no\-header\fR|\fB\-n\fR]
[\fB\-\-daemon\fR|\fB\-d\fR\ \fIaddress\fR]
[>\ \fIfilename.xml\fR]
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
تابع \fBdump\fR محتویات یک \fBRRD\fR را در یک قالب XML خوانا برای انسان (؟) درون یک فایل یا در خروجی استاندارد (stdout) می‌نویسد. این قالب توسط rrdrestore قابل خواندن است. این دو در کنار یکدیگر به شما امکان می‌دهند تا فایل‌های خود را از یک معماری رایانه به معماری دیگر انتقال داده و همچنین محتویات یک فایل \fBRRD\fR را به شیوه‌ای تا حدودی آسان‌تر دستکاری کنید.
.IP \fIfilename.rrd\fR 8
.IX Item "filename.rrd"
نام فایل \fBRRD\fR که می‌خواهید محتویات آن را استخراج کنید.
.IP \fIfilename.xml\fR 8
.IX Item "filename.xml"
نام فایل (اختیاری) که می‌خواهید خروجی XML در آن نوشته شود. در صورت عدم تعیین، XML در خروجی استاندارد چاپ خواهد شد.
.IP "\fB\-\-header\fR|\fB\-h\fR {none,xsd,dtd}" 8
.IX Item "--header|-h {none,xsd,dtd}"
به‌طور پیش‌فرض، RRDtool یک هدر dtd به فایل xml اضافه می‌کند. در اینجا می‌توانید آن را به یک هدر xsd یا بدون هیچ هادری تغییر دهید.
.IP \fB\-\-no\-header\fR|\fB\-n\fR 8
.IX Item "--no-header|-n"
میانبری برای \-\-header=none.
.Sp
اگر می‌خواهید داده‌های استخراج‌شده را با RRDtool 1.2 بازیابی کنید، باید از گزینهٔ \&\-\-no\-header استفاده کنید؛ زیرا نسخهٔ 1.2 توانایی پردازش هدرهای xml را ندارد.
.IP "\fB\-\-daemon\fR|\fB\-d\fR \fIaddress\fR" 8
.IX Item "--daemon|-d address"
آدرس دیمن rrdcached. در صورت تعیین، پیش از خواندن فایل‌های RRD، یک دستور \f(CW\*(C`flush\*(C'\fR به سرور ارسال می‌شود. این کار به \fBrrdtool\fR اجازه می‌دهد داده‌های تازه را بازگرداند، حتی اگر دیمن برای کش کردن طولانی‌مدت مقادیر پیکربندی شده باشد. هنگام تعیین این گزینه، نام فایل RRD نمایانگر فایلی در سمت سرور است، اما نام فایل خروجی (XML) به سمت محلی اشاره دارد.
برای مشاهدهٔ فهرستی از قالب‌های پذیرفته‌شده، به گزینهٔ \fB\-l\fR در راهنمای rrdcached مراجعه کنید.
.Sp
.Vb 1
\& rrdtool dump \-\-daemon unix:/var/run/rrdcached.sock /var/lib/rrd/foo.rrd
.Ve
.SH "مثال‌ها (EXAMPLES)"
.IX Header "EXAMPLES"
برای انتقال یک RRD میان معماری‌های مختلف، مراحل زیر را دنبال کنید:
.IP 1. 4
در همان سیستمی که RRD ایجاد شده است، از \fBrrdtool\fR \fBdump\fR برای برون‌ریزی داده‌ها به قالب XML استفاده کنید.
.IP 2. 4
فایل XML استخراج‌شده را به سیستم مقصد انتقال دهید.
.IP 3. 4
دستور \fBrrdtool\fR \fBrestore\fR را اجرا کنید تا یک RRD جدید از فایل XML استخراج‌شده ایجاد شود. برای جزئیات بیشتر به \&\fBrrdrestore\fR مراجعه کنید.
.SH "محیط (ENVIRONMENT)"
.IX Header "ENVIRONMENT"
از متغیرهای محیطی زیر می‌توان برای تغییر رفتار \&\f(CW\*(C`rrdtool\ dump\*(C'\fR استفاده کرد:
.IP \fBRRDCACHED_ADDRESS\fR 4
.IX Item "RRDCACHED_ADDRESS"
اگر این متغیر محیطی تنظیم شده باشد، همان اثری را خواهد داشت که تعیین گزینهٔ \f(CW\*(C`\-\-daemon\*(C'\fR در خط فرمان دارد. در صورت وجود هر دو، آرگومان خط فرمان اولویت دارد.
.SH "نویسندگان (AUTHORS)"
.IX Header "AUTHORS"
Tobias Oetiker <tobi@oetiker.ch>