.\" -*- 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 "RRDXPORT 1"
.TH RRDXPORT 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)"
rrdxport \- برون‌بری داده‌ها در قالب XML بر پایه داده‌های یک یا چند RRD
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
\&\fBrrdtool\fR \fBxport\fR
[\fB\-s\fR|\fB\-\-start\fR\ \fIseconds\fR]
[\fB\-e\fR|\fB\-\-end\fR\ \fIseconds\fR]
[\fB\-m\fR|\fB\-\-maxrows\fR\ \fIrows\fR]
[\fB\-S\fR|\fB\-\-step\fR\ \fIvalue\fR]
[\fB\-\-json\fR]
[\fB\-t\fR|\fB\-\-showtime\fR]
[\fB\-\-enumds\fR]
[\fB\-\-daemon\fR|\fB\-d\fR\ \fIaddress\fR]
[\fBDEF:\fR\fIvname\fR\fB=\fR\fIrrd\fR\fB:\fR\fIds\-name\fR\fB:\fR\fICF\fR]
[\fBCDEF:\fR\fIvname\fR\fB=\fR\fIrpn\-expression\fR]
[\fBXPORT\fR\fB:\fR\fIvname\fR[\fB:\fR\fIlegend\fR]]
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
هدف اصلی تابع \fBxport\fR نوشتن بازنمودی با قالب XML از داده‌های ذخیره‌شده در یک یا چند \fBRRD\fR است. این تابع همچنین می‌تواند گزارش‌های عددی استخراج کند.
.PP
اگر هیچ گزارهٔ \fIXPORT\fR یافت نشود، هیچ خروجی‌ای تولید نخواهد شد.
.IP "\fB\-s\fR|\fB\-\-start\fR \fIseconds\fR (پیش‌فرض end\-1day)" 4
.IX Item "-s|--start seconds (default end-1day)"
زمانی که محدودهٔ برون‌بری‌شده باید آغاز شود. زمان بر حسب ثانیه از مبدأ زمانی (epoch؛ 1970\-01\-01) الزامی است. اعداد منفی نسبت به زمان کنونی سنجیده می‌شوند. به‌طور پیش‌فرض، داده‌های به اندازهٔ یک روز چاپ خواهند شد.
همچنین برای توضیحات تفصیلی دربارهٔ چگونگی تعیین زمان، بخش «AT\-STYLE TIME SPECIFICATION» در rrdfetch را ببینید.
.Sp
برای جزئیات دربارهٔ چگونگی تأثیر این مورد بر خروجی، بخش «قالب خروجی (OUTPUT FORMAT)» را در زیر ببینید.
.IP "\fB\-e\fR|\fB\-\-end\fR \fIseconds\fR (پیش‌فرض now)" 4
.IX Item "-e|--end seconds (default now)"
زمانی که محدودهٔ برون‌بری‌شده باید پایان یابد. زمان بر حسب ثانیه از مبدأ زمانی (epoch).
همچنین برای توضیحات تفصیلی دربارهٔ چگونگی تعیین زمان، بخش «AT\-STYLE TIME SPECIFICATION» در rrdfetch را ببینید.
.Sp
برای جزئیات دربارهٔ چگونگی تأثیر این مورد بر خروجی، بخش «قالب خروجی (OUTPUT FORMAT)» را در زیر ببینید.
.IP "\fB\-m\fR|\fB\-\-maxrows\fR \fIrows\fR (پیش‌فرض ۴۰۰ سطر)" 4
.IX Item "-m|--maxrows rows (default 400 rows)"
این گزینه مانند پارامتر \fB\-w\fR|\fB\-\-width\fR در \fIrrdgraph\fR عمل می‌کند.
در واقع دقیقاً همان است، اما نام پارامتر تغییر یافته تا هدف آن در این ماژول توصیف شود. برای جزئیات به مستندات \fIrrdgraph\fR مراجعه کنید.
.IP "\fB\-S\fR|\fB\-\-step\fR \fIvalue\fR (پیش‌فرض خودکار)" 4
.IX Item "-S|--step value (default automatic)"
مستندات rrdgraph را ببینید.
.IP "\fB\-\-daemon\fR|\fB\-d\fR \fIaddress\fR" 4
.IX Item "--daemon|-d address"
نشانی دیمن rrdcached. در صورت تعیین، پیش از خواندن فایل‌های RRD، یک دستور \f(CW\*(C`flush\*(C'\fR به کارساز فرستاده می‌شود. این کار به \fBrrdtool\fR اجازه می‌دهد تا حتی اگر دیمن طوری پیکربندی شده باشد که مقادیر را برای مدتی طولانی کش کند، داده‌های تازه را بازگرداند.
برای مشاهدهٔ فهرستی از قالب‌های پذیرفته‌شده، گزینهٔ \fB\-l\fR را در راهنمای rrdcached ببینید.
.Sp
.Vb 1
\&  rrdtool xport \-\-daemon unix:/var/run/rrdcached.sock ...
.Ve
.IP \fB\-t\fR|\fB\-\-showtime\fR 4
.IX Item "-t|--showtime"
زمان را در هر سطر داده می‌گنجاند.
.IP \fB\-\-json\fR 4
.IX Item "--json"
تولید خروجی با قالب json (به جای xml).
.IP \fB\-\-enumds\fR 4
.IX Item "--enumds"
فایل xml تولیدشده باید مقادیر داده را در برچسب‌های شماره‌گذاری‌شده قرار دهد.
.Sp
.Vb 1
\& <v0>val</v0><v1>val</v1>
.Ve
.IP \fBDEF:\fR\fIvname\fR\fB=\fR\fIrrd\fR\fB:\fR\fIds\-name\fR\fB:\fR\fICF\fR 4
.IX Item "DEF:vname=rrd:ds-name:CF"
مستندات \fIrrdgraph\fR را ببینید.
.IP \fBCDEF:\fR\fIvname\fR\fB=\fR\fIrpn\-expression\fR 4
.IX Item "CDEF:vname=rpn-expression"
مستندات \fIrrdgraph\fR را ببینید.
.IP \fBXPORT:\fR\fIvname\fR[\fB:\fR\fIlegend\fR] 4
.IX Item "XPORT:vname[:legend]"
حداقل یک گزارهٔ \fIXPORT\fR باید وجود داشته باشد. مقادیری که توسط \fIvname\fR ارجاع داده شده‌اند چاپ می‌شوند. به‌صورت اختیاری یک عنوان/راهنما (legend) اضافه کنید.
.SH "قالب خروجی (OUTPUT FORMAT)"
.IX Header "OUTPUT FORMAT"
خروجی درون یک عنصر \fBxport\fR قرار می‌گیرد و شامل دو بلوک است. بلوک نخست توسط یک عنصر \fBmeta\fR در بر گرفته شده و حاوی فراداده است. بلوک دوم توسط یک عنصر \fBdata\fR در بر گرفته شده و شامل سطرهای داده است.
.PP
فرض کنید که دستور \fIxport\fR به این شکل باشد:
.PP
.Vb 7
\&  rrdtool xport \e
\&          \-\-start now\-1h \-\-end now \e
\&          DEF:xx=host\-inout.lo.rrd:output:AVERAGE \e
\&          DEF:yy=host\-inout.lo.rrd:input:AVERAGE \e
\&          CDEF:aa=xx,yy,+,8,* \e
\&          XPORT:xx:"out bytes" \e
\&          XPORT:aa:"in and out bits"
.Ve
.PP
بخش فرادادهٔ حاصل به این صورت خواهد بود (مقادیر به مشخصات RRD بستگی خواهند داشت):
.PP
.Vb 11
\&  <meta>
\&    <start>1020611700</start>
\&    <step>300</step>
\&    <end>1020615600</end>
\&    <rows>14</rows>
\&    <columns>2</columns>
\&    <legend>
\&      <entry>out bytes</entry>
\&      <entry>in and out bits</entry>
\&    </legend>
\&  </meta>
.Ve
.PP
بخش دادهٔ حاصل به این صورت است:
.PP
.Vb 10
\&  <data>
\&    <row><t>1020611700</t><v>3.4000000000e+00</v><v>5.4400000000e+01</v></row>
\&    <row><t>1020612000</t><v>3.4000000000e+00</v><v>5.4400000000e+01</v></row>
\&    <row><t>1020612300</t><v>3.4000000000e+00</v><v>5.4400000000e+01</v></row>
\&    <row><t>1020612600</t><v>3.4113333333e+00</v><v>5.4581333333e+01</v></row>
\&    <row><t>1020612900</t><v>3.4000000000e+00</v><v>5.4400000000e+01</v></row>
\&    <row><t>1020613200</t><v>3.4000000000e+00</v><v>5.4400000000e+01</v></row>
\&    <row><t>1020613500</t><v>3.4000000000e+00</v><v>5.4400000000e+01</v></row>
\&    <row><t>1020613800</t><v>3.4000000000e+00</v><v>5.4400000000e+01</v></row>
\&    <row><t>1020614100</t><v>3.4000000000e+00</v><v>5.4400000000e+01</v></row>
\&    <row><t>1020614400</t><v>3.4000000000e+00</v><v>5.4400000000e+01</v></row>
\&    <row><t>1020614700</t><v>3.7333333333e+00</v><v>5.9733333333e+01</v></row>
\&    <row><t>1020615000</t><v>3.4000000000e+00</v><v>5.4400000000e+01</v></row>
\&    <row><t>1020615300</t><v>3.4000000000e+00</v><v>5.4400000000e+01</v></row>
\&    <row><t>1020615600</t><v>NaN</v><v>NaN</v></row>
\&  </data>
.Ve
.PP
تمام آمارها در خروجی از گام (step) یکسانی استفاده خواهند کرد. نخستین نمونه، اولین نمونه‌ای خواهد بود که بلافاصله پس از \fB\-\-start\fR آغاز می‌شود. آخرین نمونه، نمونه‌ای خواهد بود که در زمان \fB\-\-end\fR یا بلافاصله پس از آن پایان می‌یابد.
.PP
هر نمونه دارای یک برچسب زمانی (timestamp) و یک یا چند مقدار است. برچسب‌های زمانی مرتبط با یک مقدار در RRDtool همواره بیانگر زمانی هستند که نمونه گرفته شده است. از آن‌جا که هر مقداری که نمونه‌برداری می‌کنید نشان‌دهندهٔ نوعی حالت گذشته است که سازوکار نمونه‌برداری شما گردآوری کرده، برچسب زمانی همیشه در پایان دورهٔ نمونه‌برداری خواهد بود.
.PP
ابزار RRDtool نمونه‌های واقعی را ذخیره نمی‌کند، بلکه بازنمونه‌گیری (resampling) درونی بر روی مقادیر ارائه‌شده به آن انجام می‌دهد. با این وجود، هنگامی که یک مقدار داده با یک برچسب زمانی منفرد ارائه می‌شود، این برچسب زمانی در پایان دوره‌ای قرار دارد که مقدار نمایانگر آن است. توجه داشته باشید که خود برچسب زمانی خارج از دوره‌ای است که نمونه برای آن معتبر است. برای جزئیات بیشتر در این باره، توضیحات محاسبهٔ PDP را ببینید.
.PP
بنابراین محدودهٔ زمانی برای یک نمونه با یک برچسب زمانی در واقع از \f(CW\*(C`timestamp \- step\*(C'\fR (شامل آن) تا \f(CW\*(C`timestamp\*(C'\fR (غیرشامل) است.
.PP
نخستین سطر از خروجی نمونه:
.PP
.Vb 1
\&    <row><t>1020611700</t><v>3.4000000000e+00</v><v>5.4400000000e+01</v></row>
.Ve
.PP
بنابراین بدین معناست که مقادیر بازهٔ 1020611400 تا 1020611699 به ترتیب برای «out bytes» و «in and out bits» برابر با 3.4 و 54.4 بوده‌اند، چرا که این مقدار در 1020611700 ثبت شده است.
.SH "مثال ۱ (EXAMPLE 1)"
.IX Header "EXAMPLE 1"
.Vb 3
\&  rrdtool xport \e
\&          DEF:out=if1\-inouts.rrd:outoctets:AVERAGE \e
\&          XPORT:out:"out bytes"
.Ve
.SH "مثال ۲ (EXAMPLE 2)"
.IX Header "EXAMPLE 2"
.Vb 7
\&  rrdtool xport \e
\&          DEF:out1=if1\-inouts.rrd:outoctets:AVERAGE \e
\&          DEF:out2=if2\-inouts.rrd:outoctets:AVERAGE \e
\&          CDEF:sum=out1,out2,+ \e
\&          XPORT:out1:"if1 out bytes" \e
\&          XPORT:out2:"if2 out bytes" \e
\&          XPORT:sum:"output sum"
.Ve
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.IX Header "ENVIRONMENT VARIABLES"
متغیرهای محیطی زیر را می‌توان برای تغییر رفتار \f(CW\*(C`rrdtool\ xport\*(C'\fR به کار برد:
.IP \fBRRDCACHED_ADDRESS\fR 4
.IX Item "RRDCACHED_ADDRESS"
اگر این متغیر محیطی تنظیم شده باشد، اثری مشابه با مشخص کردن گزینهٔ \f(CW\*(C`\-\-daemon\*(C'\fR در خط فرمان خواهد داشت. در صورت وجود هر دو، آرگومان خط فرمان اولویت دارد.
.SH "نویسندگان (AUTHORS)"
.IX Header "AUTHOR"
Tobias Oetiker <tobi@oetiker.ch>