.TH VNSTATI 1 "FEBRUARY 2025" "version 2.13" "User Manuals" .SH "نام (NAME)" vnstati \- پشتیبانی از خروجی تصویری برای vnStat .SH "خلاصه دستور (SYNOPSIS)" .B vnstati .RB [ \-5bcdDehiLmosStvy? ] .RB [ \-\-95th .IR mode ] .RB [ \-5g .RI [ limit ] .RI [ height ]] .RB [ \-\-altdate ] .RB [ \-\-begin .IR date ] .RB [ \-\-cache .IR time ] .RB [ \-\-config .IR file ] .RB [ \-\-days .RI [ limit ]] .RB [ \-\-db .IR file ] .RB [ \-\-dbdir .IR directory ] .RB [ \-\-dbiflist .RI [ mode ]] .RB [ \-\-debug ] .RB [ \-\-end .IR date ] .RB [ \-\-fivegraph .RI [ limit ] .RI [ height ]] .RB [ \-\-fiveminutes .RI [ limit ]] .RB [ \-\-headertext .IR text ] .RB [ \-\-help ] .RB [ \-hg .RI [ mode ]] .RB [ \-\-hours .RI [ limit ]] .RB [ \-\-hoursgraph .RI [ mode ]] .RB [ \-hs .RI [ graph ]] .RB [ \-\-hsummary .RI [ graph ]] .RB [ \-i .IR interface ] .RB [ \-\-iface .IR interface ] .RB [ \-ic .RI [ mode ]] .RB [ \-\-invert\-colors .RI [ mode ]] .RB [ \-\-large ] .RB [ \-\-limit .IR limit ] .RB [ \-\-locale .IR locale ] .RB [ \-\-months .RI [ limit ]] .RB [ \-ne ] .RB [ \-nh ] .RB [ \-nl ] .RB [ \-\-noedge ] .RB [ \-\-noheader ] .RB [ \-\-nolegend ] .RB [ \-\-output .IR file ] .RB [ \-ru .RI [ mode ]] .RB [ \-\-rateunit .RI [ mode ]] .RB [ \-\-scale .IR percent ] .RB [ \-\-small ] .RB [ \-\-style .IR number ] .RB [ \-\-summary ] .RB [ \-\-top .RI [ limit ]] .RB [ \-\-transparent .RI [ enabled ]] .RB [ \-\-version ] .RB [ \-vs .RI [ graph ]] .RB [ \-\-vsummary .RI [ graph ]] .RB [ \-\-months .RI [ limit ]] .RI [ interface ] .SH "توضیحات (DESCRIPTION)" هدف .B vnstati ارائهٔ پشتیبانی از خروجی تصویری برای آمارهای جمع‌آوری‌شده توسط .BR vnstat (1) است. قالب‌های فایل تصویریِ در دسترس بستگی به مواردی دارد که توسط کتابخانهٔ GD مورداستفاده پشتیبانی می‌شود. تمامی خروجی‌های پایهٔ vnStat به‌جز قابلیت‌های ترافیک زنده پشتیبانی می‌شوند. تصویر را می‌توان در یک فایل یا در خروجی استاندارد تولید کرد که در حالت دوم به قالب تصویری png محدود می‌شود. .SH "گزینه‌ها (OPTIONS)" .TP .BI "--95th " mode نمایش نمودار خروجی صدک ۹۵ام برای ماه جاری. این خروجی از داده‌های با تفکیک‌پذیری ۵ دقیقه‌ای ماه جاری برای محاسبهٔ نرخ ترافیک صدک ۹۵ام برای داده‌های دریافتی، ارسالی یا مجموع بر اساس مقدار پارامتر اجباری .I mode استفاده می‌کند. صدک ۹۵ام به صورت یک خط افقی در نمودار نمایش داده می‌شود و نرخ دقیق ترافیک صدک ۹۵ام در بخش راهنمای (legend) تصویر قابل مشاهده خواهد بود. علاوه بر این، یک نمودار میله‌ای از نرخ ترافیک با تفکیک‌پذیری یک‌ساعته که از میانگین‌گیری داده‌های ۵ دقیقه‌ایِ .I mode انتخاب‌شده به دست آمده است نیز نمایش داده می‌شود. این خروجی نیازمند آن است که گزینهٔ پیکربندی .B 5MinuteHours مقداری حداقل برابر با 744 برای ذخیرهٔ تمامی داده‌های لازم داشته باشد؛ در غیر این صورت پوشش ۱۰۰٪ امکان‌پذیر نخواهد بود. حالت‌های موجود: 0 = دریافتی، 1 = ارسالی، 2 = مجموع. .TP .B "--altdate" استفاده از مکان جایگزین برای متن تاریخ و زمان. متن تاریخ و زمان از بخش بالایی سمت راست سربرگ به گوشهٔ پایینی سمت چپ منتقل خواهد شد. در صورت انتخاب .BR "-nh, --noheader" ، این گزینه هیچ تأثیری نخواهد داشت. .TP .BI "-b, --begin " date شروع خروجی فهرست از یک تاریخ / زمان خاص که توسط .I date مشخص می‌شود، به جای اینکه نقطهٔ شروع بر اساس تعداد مدخل‌های نمایشی انتخاب شود. اگر .I date در پایگاه‌داده در دسترس نباشد، نزدیک‌ترین تاریخ پس از آن استفاده خواهد شد. .I date از قالب‌های زیر پشتیبانی می‌کند: YYYY-MM-DD HH:MM، YYYY-MM-DD و "today". این گزینه فقط با خروجی‌های فهرستی قابل استفاده است. .TP .BI "-c, --cache " time به‌روزرسانی فایل خروجی تنها در صورتی که حداقل .I time دقیقه از آخرین به‌روزرسانی فایل گذشته باشد. در صورت استفاده از خروجی استاندارد (stdout)، این گزینه نادیده گرفته می‌شود. .TP .BI "--config " file استفاده از .I file به عنوان فایل پیکربندی به جای استفاده از قابلیت جستجوی خودکار فایل پیکربندی. اگر .B "--config" چندین بار استفاده شود، در صورت هم‌پوشانی تنظیمات، مقادیرِ فایل‌های بعدی در خط فرمان بر تنظیمات بارگذاری‌شده از فایل‌های قبلی اولویت داشته و آن‌ها را بازنویسی خواهند کرد. .TP .BI "-d, --days " [limit] ارائهٔ خروجی آمار ترافیک به صورت روزانه برای روزهای گذشته. طول فهرست به ۳۰ مدخل محدود خواهد بود، مگر اینکه طور دیگری پیکربندی شده باشد یا از پارامتر اختیاری .I limit استفاده شود. در صورتی که .I limit روی 0 تنظیم شود، تمامی مدخل‌های ذخیره‌شده در پایگاه‌داده نمایش داده خواهند شد. .TP .BI "--db " file استفاده از .I file به عنوان فایل پایگاه‌داده به جای جستجو برای پایگاه‌داده در دایرکتوری مشخص‌شده در فایل پیکربندی یا مقدار پیش‌فرض سخت‌کدشده (در صورت نبود فایل پیکربندی). این گزینه بر .B "--dbdir" اولویت دارد. .TP .BI "--dbdir " directory استفاده از .I directory به عنوان دایرکتوری پایگاه‌داده به جای استفاده از دایرکتوری مشخص‌شده در فایل پیکربندی یا مقدار پیش‌فرض سخت‌کدشده (در صورت نبود فایل پیکربندی). اگر .B "--db" نیز مشخص شده باشد، این گزینه نادیده گرفته می‌شود. .TP .BI "--dbiflist " [mode] فهرست‌کردن رابط‌های موجود در پایگاه‌داده. اگر .I mode مشخص نشود یا روی 0 تنظیم شده باشد، خروجی از قالب تک‌خطی با جزئیات کامل استفاده خواهد کرد. اگر .I mode روی 1 تنظیم شود، خروجی شامل یک رابط در هر خط خواهد بود و اگر .I mode روی 2 تنظیم شود، تنها تعداد رابط‌ها به صورت یک عدد مجزا نمایش داده خواهد شد. همچنین .B "--iflist" را ببینید..TP .B "-D, --debug" نمایش خروجی دیباگ اضافی. .TP .BI "-e, --end " date خاتمه دادن به خروجی فهرست با تاریخ / زمان مشخصی که توسط .I date تعیین شده است، به جای آخرین تاریخ / زمان موجود در پایگاه داده. اگر .I date در پایگاه داده موجود نباشد، نزدیک‌ترین تاریخ قبلی استفاده خواهد شد. .I date از قالب‌های روبرو پشتیبانی می‌کند: YYYY-MM-DD HH:MM و YYYY-MM-DD. این گزینه فقط با خروجی‌های فهرستی قابل استفاده است. فهرست موارد برتر همچنین نیازمند این است که .B "--begin" هم‌زمان با این گزینه استفاده شود. .TP .BI "-5g, --fivegraph " "[limit] [height]" خروجی آمار ترافیک با تفکیک زمانی ۵ دقیقه‌ای برای ۴۸ ساعت گذشته با استفاده از نمودار میله‌ای. پهنای نمودار را می‌توان با استفاده از پارامتر اختیاری .I limit تغییر داد که نشان‌دهنده تعداد مدخل‌های ۵ دقیقه‌ای با ۱۲ مدخل برای هر ساعت است. کوچک‌ترین مقدار پشتیبانی‌شده ۲۸۸ (۲۴ ساعت گذشته) است. علاوه بر این، ارتفاع نمودار را می‌توان با استفاده از پارامتر اختیاری .I height تغییر داد. کمترین ارتفاع پشتیبانی‌شده ۱۵۰ پیکسل است. .TP .BI "-5, --fiveminutes " [limit] خروجی آمار ترافیک با تفکیک زمانی ۵ دقیقه‌ای برای ساعت‌های گذشته. طول فهرست به ۲۴ مدخل محدود خواهد شد مگر اینکه خلاف آن پیکربندی شده باشد یا از پارامتر اختیاری .I limit استفاده شود. در صورتی که .I limit بر روی 0 تنظیم شود، تمام مدخل‌های ذخیره‌شده در پایگاه داده نمایش داده خواهند شد. .TP .BI "--headertext " text نمایش .I text در بخش سربرگ تصویر به جای شناسه رابطی که به طور خودکار تولید شده است. .I text به ۶۴ نویسه محدود است و اگر طولانی‌تر از پهنای تصویر باشد ممکن است به طور کامل نمایش داده نشود. در صورتی که به حداکثر فضا نیاز است از .B "--altdate" استفاده کنید. اگر .B "-nh, --noheader" انتخاب شده باشد، این گزینه هیچ تاثیری نخواهد داشت. .TP .BI "-h, --hours " [limit] خروجی آمار ترافیک بر اساس ساعت. طول فهرست به ۲۴ مدخل محدود خواهد شد مگر اینکه خلاف آن پیکربندی شده باشد یا از پارامتر اختیاری .I limit استفاده شود. در صورتی که .I limit روی 0 تنظیم شود، تمام مدخل‌های ذخیره‌شده در پایگاه داده نمایش داده خواهند شد. .TP .BI "-hg, --hoursgraph " [mode] خروجی آمار ترافیک بر اساس ساعت برای ۲۴ ساعت گذشته با استفاده از نمودار میله‌ای. از پارامتر اختیاری .I mode می‌توان برای نادیده‌گرفتن تنظیمات فایل پیکربندی استفاده کرد. حالت‌های موجود: 0 = پنجره شناور ۲۴ ساعته، 1 = شروع نمودار از نیمه‌شب. .TP .BI "-hs, --hsummary " [graph] خروجی خلاصه ترافیک همراه با نموداری که با تنظیم .B SummaryGraph در فایل پیکربندی انتخاب شده است در کنار آن، با استفاده از چیدمان افقی. پارامتر اختیاری .I graph می‌تواند برای نادیده‌گرفتن تنظیمات فایل پیکربندی استفاده شود. نمودارهای موجود: 0 = ساعت‌ها، 1 = ۵ دقیقه. .TP .BI "-i, --iface " interface استفاده از .I interface به جای رابط پیش‌فرض یا پیکربندی‌شده. همچنین می‌توان با استفاده از نحو .I interface1+interface2+... اطلاعات دو یا چند رابط را با یکدیگر ادغام کرد. تمام رابط‌های ارائه‌شده هنگام استفاده از نحو ادغام باید یکتا باشند و در پایگاه داده وجود داشته باشند. به صورت اختیاری، بسته به تنظیم پیکربندی .BR InterfaceMatchMethod ، می‌توان .I interface را با نام مستعار (alias) که قبلاً با استفاده از .BR "vnstat --setalias" تعیین شده است جایگزین کرد. نحو ادغام هنگام استفاده از .I alias پشتیبانی نمی‌شود. گزینه .B "-i, --iface" اختیاری است و .I interface می‌تواند به عنوان پارامتر در خط فرمان برای انتخاب رابط مورد استفاده حتی بدون استفاده صریح از این گزینه به کار رود. .TP .BI "-ic, --invert-colors " [mode] معکوس کردن رنگ‌های تصویر. در نتیجه رنگ سیاه به سفید، رنگ‌های تیره به روشن، رنگ‌های روشن به تیره و سفید به سیاه تبدیل می‌شود. از پارامتر اختیاری .I mode می‌توان برای تغییر رفتار معکوس‌سازی رنگ‌ها استفاده کرد. حالت‌های موجود: 0 = بدون معکوس‌سازی رنگ، 1 = معکوس‌سازی همه رنگ‌ها به جز رنگ‌های استفاده‌شده برای rx و tx، 2 = معکوس‌سازی تمام رنگ‌ها. هنگامی که .I mode مشخص نشده باشد، از حالت 1 استفاده خواهد شد. .TP .B "-L, --large" استفاده از فونت‌های بزرگ در خروجی. .TP .BI "--limit " limit تنظیم حداکثر تعداد مدخل‌های نمایش‌داده‌شده در خروجی‌های فهرستی به .IR limit . استفاده از .B "--limit" مقادیر پیش‌فرض محدودیت مدخل‌های فهرست و پارامتر اختیاری .I limit را که مستقیماً برای یک پرس‌وجوی فهرست داده شده نادیده می‌گیرد. در صورتی که .I limit روی 0 تنظیم شود، تمام مدخل‌های ذخیره‌شده در پایگاه داده نمایش داده خواهند شد. .TP .BI "--locale " locale استفاده از .I locale به جای تنظیمات محلی مشخص‌شده در فایل پیکربندی، یا پیش‌فرض سیستم در صورتی که هیچ فایل پیکربندی موجود نباشد. .TP .BI "-m, --months " [limit] خروجی آمار ترافیک بر اساس ماه برای ماه‌های گذشته. طول فهرست به ۱۲ مدخل محدود خواهد شد مگر اینکه خلاف آن پیکربندی شده باشد یا از پارامتر اختیاری .I limit استفاده شود. در صورتی که .I limit روی 0 تنظیم شود، تمام مدخل‌های ذخیره‌شده در پایگاه داده نمایش داده خواهند شد. .TP .B "-ne, --noedge" حذف لبه‌های تیره‌تر از اطراف تصویر. .TP .B "-nh, --noheader" حذف سربرگ حاوی عنوان و زمان به‌روزرسانی. زمان به‌روزرسانی قبلی همچنان در گوشه پایین سمت راست با استفاده از رنگی با وضوح کمتر قابل مشاهده خواهد بود. .TP .B "-nl, --nolegend" حذف راهنمای (legend) حاوی اطلاعات نگاشت رنگ‌های rx و tx از تصویر. .TP .BI "-o, --output " file نوشتن تصویر در .I file و خروج. قالب تصویر مورد استفاده توسط پسوند فایل ارائه‌شده برای .I file انتخاب می‌شود. برای مثال، "image.png" به دلیل استفاده از پسوند ".png" منجر به ذخیره فایل با فرمت تصویری png می‌شود. استفاده از فرمت تصویری png معمولاً کمترین اندازه فایل را بدون از دست دادن جزئیات یا ایجاد ناهنجاری‌های فشرده‌سازی در بر دارد. علاوه بر این، با وارد کردن "-" به عنوان .I file می‌توان خروجی را به stdout هدایت کرد که در این صورت از فرمت تصویری png استفاده می‌شود. .TP .BI "-ru, --rateunit " [mode] تغییر واحد نرخ پیکربندی‌شده. اگر نرخ طوری پیکربندی شده باشد که بر حسب بایت نمایش داده شود، در صورت وجود این گزینه نرخ بر حسب بیت نشان داده خواهد شد. به همین ترتیب، اگر نرخ طوری پیکربندی شده باشد که بر حسب بیت نشان داده شود، در صورت حضور این گزینه بر حسب بایت نمایش داده می‌شود. همچنین، می‌توان از .I mode با مقادیر 0 یا 1 به عنوان پارامتر این گزینه استفاده کرد تا صرف‌نظر از تنظیمات فایل پیکربندی، بین بایت (0) و بیت (1) انتخاب صورت گیرد. .TP .BI "--scale " percent مقیاس‌بندی خروجی به .I percent داده‌شده، که منجر به کوچک‌تر یا بزرگ‌تر شدن تصویر نسبت به اندازه پیش‌فرض می‌شود. .TP .B "-S, --small" استفاده از فونت‌های کوچک در خروجی. .TP .BI "--style " number تغییر محتوا و شیوه نمایش خروجی‌ها. تنظیم .I number به 3، میانگین نرخ ترافیک را در تمام خروجی‌هایی که پشتیبانی می‌کنند نشان می‌دهد. سایر مقادیر به جای آن نمودارهای میله‌ای را نمایش خواهند داد. .TP .B "-s, --summary" خروجی خلاصه آمار ترافیک..TP .BI "-t, --top " [limit] روزهای دارای بیشترین ترافیک در تمام دوران را در خروجی نمایش می‌دهد. طول این فهرست به ۱۰ مدخل محدود خواهد بود، مگر اینکه به شکل دیگری پیکربندی شده باشد یا از پارامتر اختیاری .I limit استفاده شود. در صورتی که .I limit روی ۰ تنظیم شود، تمام مدخل‌های ذخیره‌شده در پایگاه‌داده نمایش داده خواهند شد. هنگام استفاده همراه با .B "--begin" و به صورت اختیاری با .BR "--end" ، فهرست به جای مدخل‌های برتر جداگانه، با استفاده از داده‌های روزانه تولید خواهد شد. در دسترس بودن داده‌های روزانه، محدوده‌ای را که پرس‌وجوی مبتنی بر تاریخ مشخص می‌تواند به آن دسترسی داشته باشد، تعیین می‌کند. .TP .BI "--transparent " [enabled] شفافیت رنگ پس‌زمینه را بسته به تنظیم .B TransparentBg در فایل پیکربندی تغییر وضعیت می‌دهد. به عنوان روش دیگر، می‌توان 0 یا 1 را به عنوان پارامتر .I enabled به این گزینه داد تا صرف‌نظر از تنظیمات فایل پیکربندی، شفافیت غیرفعال (0) یا فعال (1) شود. .TP .B "-v, --version" نسخه فعلی را نمایش می‌دهد. .TP .BI "-vs, --vsummary " [graph] خلاصه ترافیک را همراه با نمودار انتخاب‌شده با تنظیم .B SummaryGraph در فایل پیکربندی، در زیر آن با چیدمانی عمودی در خروجی نمایش می‌دهد. از پارامتر اختیاری .I graph می‌توان برای نادیده‌گرفتن تنظیمات فایل پیکربندی استفاده کرد. نمودارهای موجود: 0 = ساعتی، 1 = ۵ دقیقه‌ای. .TP .BI "-y, --years " [limit] آمار ترافیک را بر پایه سال برای سال‌های گذشته در خروجی نمایش می‌دهد. این فهرست به طور پیش‌فرض تمام مدخل‌ها را نشان می‌دهد مگر اینکه به شکل دیگری پیکربندی شده باشد یا از پارامتر اختیاری .I limit استفاده شود. در صورتی که .I limit روی 0 تنظیم شود، تمام مدخل‌های ذخیره‌شده در پایگاه‌داده نیز نشان داده خواهند شد. .TP .B "-?, --help" خلاصه‌ای از گزینه‌های دستور را نمایش می‌دهد. .SH "فایل‌ها (FILES)" .TP .I /var/lib/vnstat/ دایرکتوری پیش‌فرض پایگاه‌داده. .TP .I /etc/vnstat.conf فایل پیکربندی که استفاده خواهد شد، مگر اینکه .I $HOME/.vnstatrc وجود داشته باشد. برای اطلاعات بیشتر .BR vnstat.conf (5) را ببینید. .SH "مثال‌ها (EXAMPLES)" .TP .B "vnstati -s -i eth0 -o /tmp/vnstat.png" خروجی خلاصه ترافیک برای رابط eth0 در فایل /tmp/vnstat.png. .TP .B "vnstati -vs -i eth0+eth1+eth2 -o /tmp/vnstat.png" خروجی خلاصه ترافیک همراه با داده‌های ساعتی در زیر خلاصه معمولی برای ادغام رابط‌های eth0، eth1 و eth2 در فایل /tmp/vnstat.png. .TP .B "vnstati -h -c 15 -o /tmp/vnstat_h.png" خروجی آمار ساعتی ترافیک برای رابط پیش‌فرض در فایل /tmp/vnstat_h.png در صورتی که فایل در ۱۵ دقیقه گذشته به‌روزرسانی نشده باشد. .TP .B "vnstati -d -ne -nh -o -" خروجی آمار روزانه ترافیک بدون نمایش بخش سرآیند و لبه‌ها برای رابط پیش‌فرض در خروجی استاندارد (stdout). .TP .B "vnstati -m --config /home/me/vnstat.cfg -i -o -" خروجی آمار ماهانه ترافیک برای رابط پیش‌فرض تعیین‌شده در فایل پیکربندی /home/me/vnstat.cfg در خروجی استاندارد (stdout). .SH "محدودیت‌ها (RESTRICTIONS)" بسته به قلم‌های توکار ارائه‌شده توسط کتابخانه GD، ممکن است هنگام استفاده از یک لوکال UTF-8 همه نویسه‌ها به درستی نمایش داده نشوند. .PP استفاده از قالب‌های طولانی تاریخ در خروجی ممکن است در صورتی که طول تاریخ از اندازه ثابت اختصاص‌یافته فراتر رود، موجب ناترازی ستون‌های نمایش‌داده‌شده شود. .PP تغییر مقیاس تصویر در زمانی که شفافیت پس‌زمینه فعال است، ممکن است به حفظ شفافیت منجر نشود. .SH "نویسنده (AUTHOR)" Teemu Toivola .SH "همچنین ببینید (SEE ALSO)" .BR vnstat (1), .BR vnstatd (8), .BR vnstat.conf (5), .BR units (7)