مقادیر نمایش‌یافته در خروجی (Output shows four values):

- FIELDS: فیلدهای جریان، برای نمونه in_port(1).

- COUNT: تعداد خطوط در خروجی dump-flow که حاوی این فیلد جریان هستند.

- PACKETS: تعداد کل بسته‌های حاوی این فیلد جریان.

- BYTES: تعداد کل بایت‌های حاوی این فیلد جریان. در صورتی که واحد مشخص نشده باشد، مقادیر بر حسب بایت هستند.

- AVERAGE: میانگین اندازه بسته‌ها (BYTES/PACKET).

رفتار شبیه Top (Top Behavior)

در حین قرار داشتن در حالت top (که رفتار پیش‌فرض است)، دستورهای تک‌نویسه‌ای زیر پشتیبانی می‌شوند:

a - تغییر وضعیت بین حالت انباشتی (accumulate) و زنده (live). حالت انباشتی در ادامه تشریح شده است.

s - تغییر ستون مورد استفاده برای مرتب‌سازی نزولی محتوا. عنوان DESC در بالای ستون قرار می‌گیرد.

_ - فاصله (space) نشان‌دهنده جمع‌آوری مجدد محتوای dump-flow است.

h - توقف خروجی. فشردن هر کلیدی نمونه‌برداری را دوباره راه‌اندازی می‌کند.

f - پیمایش چرخشی میان فیلدهای جریان.

q - حرف q برای خروج (quit).

حالت انباشتی (Accumulate Mode)

دو حالت پشتیبانی می‌شود: زنده (live) و انباشتی (accumulate). پیش‌فرض حالت زنده است. پارامتر --accumulate یا نویسه 'a' در حالت top، حالت دوم را فعال می‌کند. در حالت زنده، محتوای اخیر dump-flow نمایش داده می‌شود؛ در حالی که در حالت انباشتی، اطلاعات تاریخی پیشین تا زمان بازنشانی جریان (و نه هنگام پاکسازی جریان) نگهداری و ردیابی می‌شوند. جریان‌های بازنشانی‌شده زمانی تشخیص داده می‌شوند که تعداد بسته‌های یک جریان نسبت به نمونه پیشین خود کاهش یافته باشد. یک نکته وجود دارد: سیستم در نهایت با کمبود حافظه روبرو خواهد شد، مگر اینکه پس از پایان دوره زوال انباشت (accumulate-decay)، جریان‌هایی که تازه‌سازی نشده‌اند پاکسازی گردند. هدف در اینجا آزادسازی حافظه از جریان‌های غیرفعال است. آمارها کاهش نمی‌یابند؛ هدف آن‌ها بازتاب تاریخچه کلی فیلدهای جریان است.

اشکال‌زدایی خطاها (Debugging Errors)

خطاهای تجزیه شمارش شده و در خط وضعیت در ابتدای خروجی نمایش داده می‌شوند. برای مشاهده خروجی‌هایی که تجزیه نشده‌اند، از گزینه --verbose همراه با --script استفاده کنید، مانند:

$ ovs-dpctl dump-flows | ovs-dpctl-top --script --verbose

پیام‌های خطا محتوایی را که تجزیه آن با شکست مواجه شده است مشخص می‌کنند.

دسترسی به میزبان‌های دوردست (Access Remote Hosts)

گزینه --host باید از قالب user@hostname پیروی کند. این اسکریپت صرفاً 'ssh user@Hostname' را بدون بررسی اعتبارنامه‌های ورود فراخوانی می‌کند؛ بنابراین کلیدهای عمومی باید روی سیستمی که با hostname مشخص شده است نصب باشند، مانند:

$ ssh-copy-id user@hostname

برای جزئیات بیشتر به صفحات راهنمای ssh-copy-id(1) مراجعه کنید.

کاربرد مورد انتظار (Expected usage)

$ ovs-dpctl-top

یا برای اجرا در قالب یک اسکریپت:

$ ovs-dpctl dump-flows > dump-flows.log
$ ovs-dpctl-top --script --flow-file dump-flows.log

گزینه‌ها (OPTIONS)

-h, --help

نمایش این پیام راهنما و خروج.

-v, --version

نمایش شماره نسخه برنامه و خروج.

-f FLOWFILES, --flow-file FLOWFILES

فایل حاوی جریان‌ها از خروجی ovs-dpctl dump-flow.

-V, --verbose

فعال‌سازی پرگویی در سطح اشکال‌زدایی (debug).

-s, --script

اجرا از طریق اسکریپت (بدون رابط کاربری).

--host HOST

مشخص کردن یک user@host برای واکشی جریان‌ها؛ برای اطلاعات بیشتر بخش دسترسی به میزبان‌های دوردست را ببینید.

-a, --accumulate

انباشت محتوای dump-flow.

--accumulate-decay ACCUMULATEDECAY

زوال جریان‌های انباشته قدیمی. مقدار پیش‌فرض ۵ دقیقه است. مقدار ۰ فرآیند زوال را غیرفعال می‌کند.

-d DELAY, --delay DELAY

تاخیر بر حسب میلی‌ثانیه برای جمع‌آوری محتوای dump-flow (نرخ نمونه‌برداری).