.\" -*- nroff -*- .\" ovs.tmac .\" .\" Open vSwitch troff macro library . . .\" Continuation line for .IP. .de IQ . br . ns . IP "\\$1" .. . .\" Introduces a sub-subsection .de ST . PP . RS -0.15in . I "\\$1" . RE .. . .\" The content between the lines below is from an-ext.tmac in groff .\" 1.21, with some modifications. .\" ---------------------------------------------------------------------- .\" an-ext.tmac .\" .\" Written by Eric S. Raymond .\" Werner Lemberg .\" .\" Version 2007-Feb-02 .\" .\" Copyright (C) 2007, 2009, 2011 Free Software Foundation, Inc. .\" You may freely use, modify and/or distribute this file. .\" .\" .\" The code below provides extension macros for the `man' macro package. .\" Care has been taken to make the code portable; groff extensions are .\" properly hidden so that all troff implementations can use it without .\" changes. .\" .\" With groff, this file is sourced by the `man' macro package itself. .\" Man page authors who are concerned about portability might add the .\" used macros directly to the prologue of the man page(s). . . .\" Convention: Auxiliary macros and registers start with `m' followed .\" by an uppercase letter or digit. . . .\" Declare start of command synopsis. Sets up hanging indentation. .de SY . ie !\\n(mS \{\ . nh . nr mS 1 . nr mA \\n(.j . ad l . nr mI \\n(.i . \} . el \{\ . br . ns . \} . . HP \w'\fB\\$1\fP\ 'u . B "\\$1" .. . . .\" End of command synopsis. Restores adjustment. .de YS . in \\n(mIu . ad \\n(mA . hy \\n(HY . nr mS 0 .. . . .\" Declare optional option. .de OP . ie \\n(.$-1 \ . RI "[\fB\\$1\fP" "\ \\$2" "]" . el \ . RB "[" "\\$1" "]" .. . . .\" Start URL. .de UR . ds m1 \\$1\" . nh . if \\n(mH \{\ . \" Start diversion in a new environment. . do ev URL-div . do di URL-div . \} .. . . .\" End URL. .de UE . ie \\n(mH \{\ . br . di . ev . . \" Has there been one or more input lines for the link text? . ie \\n(dn \{\ . do HTML-NS "" . \" Yes, strip off final newline of diversion and emit it. . do chop URL-div . do URL-div \c . do HTML-NS . \} . el \ . do HTML-NS "\\*(m1" \&\\$*\" . \} . el \ \\*(la\\*(m1\\*(ra\\$*\" . . hy \\n(HY .. . . .\" Start email address. .de MT . ds m1 \\$1\" . nh . if \\n(mH \{\ . \" Start diversion in a new environment. . do ev URL-div . do di URL-div . \} .. . . .\" End email address. .de ME . ie \\n(mH \{\ . br . di . ev . . \" Has there been one or more input lines for the link text? . ie \\n(dn \{\ . do HTML-NS "" . \" Yes, strip off final newline of diversion and emit it. . do chop URL-div . do URL-div \c . do HTML-NS . \} . el \ . do HTML-NS "\\*(m1" \&\\$*\" . \} . el \ \\*(la\\*(m1\\*(ra\\$*\" . . hy \\n(HY .. . . .\" Continuation line for .TP header. .de TQ . br . ns . TP \\$1\" no doublequotes around argument! .. . . .\" Start example. .de EX . nr mE \\n(.f . nf . nh . ft CR .. . . .\" End example. .de EE . ft \\n(mE . fi . hy \\n(HY .. . .\" EOF .\" ---------------------------------------------------------------------- .TH ovs\-dpctl\-top "8" "4.0.0" "Open vSwitch" "Open vSwitch Manual" . .SH "نام (NAME)" ovs\-dpctl\-top \- ابزار پایش بصری شبیه top برای دیتapathهای Open vSwitch . .SH "خلاصه دستور (SYNOPSIS)" \fBovs\-dpctl\-top\fR [\-h] [\-v] [\-f FLOWFILES] [\-V] [\-s] [\-\-host HOST] [\-a | \-\-accumulate] [\-\-accumulate\-decay ACCUMULATEDECAY] [\-d DELAY] . .SH "توضیحات (DESCRIPTION)" .PP این برنامه با تجمیع تعداد بسته‌ها، کل بایت‌ها و رخداد فیلدهای زیر، محتوای جریان‌های \fBovs\-dpctl\fR را خلاصه‌سازی می‌کند: .IP \- درگاه ورودی (\fIin_port\fR) دیتapath .IP \- نوع اترنت (\fIEthernet type\fR) .IP \- نشانی‌های MAC مبدأ و مقصد .IP \- پروتکل IP .IP \- نشانی‌های IPv4 مبدأ و مقصد .IP \- نشانی‌های IPv6 مبدأ و مقصد .IP \- درگاه‌های مقصد UDP و TCP .IP \- نشانی‌های مبدأ و مقصد تونل . .SS "مقادیر نمایش‌یافته در خروجی (Output shows four values):" .IP \- \fBFIELDS\fR: فیلدهای جریان، برای نمونه \fIin_port(1)\fR. .IP \- \fBCOUNT\fR: تعداد خطوط در خروجی \fIdump\-flow\fR که حاوی این فیلد جریان هستند. .IP \- \fBPACKETS\fR: تعداد کل بسته‌های حاوی این فیلد جریان. .IP \- \fBBYTES\fR: تعداد کل بایت‌های حاوی این فیلد جریان. در صورتی که واحد مشخص نشده باشد، مقادیر بر حسب بایت هستند. .IP \- \fBAVERAGE\fR: میانگین اندازه بسته‌ها (\fIBYTES/PACKET\fR). .PP .SS "رفتار شبیه Top (Top Behavior)" .PP در حین قرار داشتن در حالت top (که رفتار پیش‌فرض است)، دستورهای تک‌نویسه‌ای زیر پشتیبانی می‌شوند: .IP \fBa\fR \- تغییر وضعیت بین حالت انباشتی (accumulate) و زنده (live). حالت انباشتی در ادامه تشریح شده است. .IP \fBs\fR \- تغییر ستون مورد استفاده برای مرتب‌سازی نزولی محتوا. عنوان \fBDESC\fR در بالای ستون قرار می‌گیرد. .IP \fB_\fR \- فاصله (space) نشان‌دهنده جمع‌آوری مجدد محتوای \fIdump\-flow\fR است. .IP \fBh\fR \- توقف خروجی. فشردن هر کلیدی نمونه‌برداری را دوباره راه‌اندازی می‌کند. .IP \fBf\fR \- پیمایش چرخشی میان فیلدهای جریان. .IP \fBq\fR \- حرف q برای خروج (\fIquit\fR). .PP .SS "حالت انباشتی (Accumulate Mode)" .PP دو حالت پشتیبانی می‌شود: زنده (live) و انباشتی (accumulate). پیش‌فرض حالت زنده است. پارامتر \fB\-\-accumulate\fR یا نویسه 'a' در حالت top، حالت دوم را فعال می‌کند. در حالت زنده، محتوای اخیر \fIdump\-flow\fR نمایش داده می‌شود؛ در حالی که در حالت انباشتی، اطلاعات تاریخی پیشین تا زمان بازنشانی جریان (و نه هنگام پاکسازی جریان) نگهداری و ردیابی می‌شوند. جریان‌های بازنشانی‌شده زمانی تشخیص داده می‌شوند که تعداد بسته‌های یک جریان نسبت به نمونه پیشین خود کاهش یافته باشد. یک نکته وجود دارد: سیستم در نهایت با کمبود حافظه روبرو خواهد شد، مگر اینکه پس از پایان دوره زوال انباشت (\fIaccumulate\-decay\fR)، جریان‌هایی که تازه‌سازی نشده‌اند پاکسازی گردند. هدف در اینجا آزادسازی حافظه از جریان‌های غیرفعال است. آمارها کاهش نمی‌یابند؛ هدف آن‌ها بازتاب تاریخچه کلی فیلدهای جریان است. .PP .SS "اشکال‌زدایی خطاها (Debugging Errors)" .PP خطاهای تجزیه شمارش شده و در خط وضعیت در ابتدای خروجی نمایش داده می‌شوند. برای مشاهده خروجی‌هایی که تجزیه نشده‌اند، از گزینه \fB\-\-verbose\fR همراه با \fB\-\-script\fR استفاده کنید، مانند: .PP .nf $ ovs\-dpctl dump\-flows | ovs\-dpctl\-top \fB\-\-script\fR \fB\-\-verbose\fR .fi .PP پیام‌های خطا محتوایی را که تجزیه آن با شکست مواجه شده است مشخص می‌کنند. .PP .SS "دسترسی به میزبان‌های دوردست (Access Remote Hosts)" .PP گزینه \fB\-\-host\fR باید از قالب \fIuser@hostname\fR پیروی کند. این اسکریپت صرفاً \fB\&'ssh user@Hostname'\fR را بدون بررسی اعتبارنامه‌های ورود فراخوانی می‌کند؛ بنابراین کلیدهای عمومی باید روی سیستمی که با \fIhostname\fR مشخص شده است نصب باشند، مانند: .PP .nf $ ssh\-copy\-id user@hostname .fi .PP برای جزئیات بیشتر به صفحات راهنمای \fBssh\-copy\-id\fR(1) مراجعه کنید. .PP .SS "کاربرد مورد انتظار (Expected usage)" .PP .nf $ ovs\-dpctl\-top .fi .PP یا برای اجرا در قالب یک اسکریپت: .PP .nf $ ovs\-dpctl dump\-flows > dump\-flows.log $ ovs\-dpctl\-top \fB\-\-script\fR \fB\-\-flow\-file\fR dump\-flows.log .fi .SS "گزینه‌ها (OPTIONS)" .TP \fB\-h\fR, \fB\-\-help\fR نمایش این پیام راهنما و خروج. .TP \fB\-v\fR, \fB\-\-version\fR نمایش شماره نسخه برنامه و خروج. .TP \fB\-f\fR FLOWFILES, \fB\-\-flow\-file\fR FLOWFILES فایل حاوی جریان‌ها از خروجی \fIovs\-dpctl dump\-flow\fR. .TP \fB\-V\fR, \fB\-\-verbose\fR فعال‌سازی پرگویی در سطح اشکال‌زدایی (debug). .TP \fB\-s\fR, \fB\-\-script\fR اجرا از طریق اسکریپت (بدون رابط کاربری). .TP \fB\-\-host\fR HOST مشخص کردن یک \fIuser@host\fR برای واکشی جریان‌ها؛ برای اطلاعات بیشتر بخش دسترسی به میزبان‌های دوردست را ببینید. .TP \fB\-a\fR, \fB\-\-accumulate\fR انباشت محتوای \fIdump\-flow\fR. .TP \fB\-\-accumulate\-decay\fR ACCUMULATEDECAY زوال جریان‌های انباشته قدیمی. مقدار پیش‌فرض ۵ دقیقه است. مقدار ۰ فرآیند زوال را غیرفعال می‌کند. .TP \fB\-d\fR DELAY, \fB\-\-delay\fR DELAY تاخیر بر حسب میلی‌ثانیه برای جمع‌آوری محتوای \fIdump\-flow\fR (نرخ نمونه‌برداری).