.TH LNSTAT 8 .SH "نام (NAME)" rtstat \- چاپ آمار وضعیت شبکه و کش مسیریابی لینوکس .SH "خلاصه دستور (SYNOPSIS)" .B lnstat .RI [ گزینه‌ها ] .SH "توضیحات (DESCRIPTION)" این صفحهٔ راهنما به‌طور خلاصه دستور .B lnstat را شرح می‌دهد. .PP دستور \fBlnstat\fP یک جایگزین عمومی‌تر و با قابلیت‌های کامل‌تر برای برنامه قدیمی rtstat است. این ابزار معمولاً برای چاپ دوره‌ای گزیده‌ای از مقادیر آماری صادرشده توسط هسته لینوکس استفاده می‌شود. علاوه بر آمار حافظه نهان مسیریابی، از هر نوع آماری که هسته لینوکس از طریق فایلی در مسیر /proc/net/stat/ ارائه می‌دهد پشتیبانی می‌کند. .PP هر فایل در مسیر /proc/net/stat/ شامل یک خط سربرگ است که نام ستون‌ها را فهرست می‌کند. این نام‌ها توسط \fBlnstat\fP به‌عنوان کلید برای انتخاب آمارهای مورد نظر جهت چاپ به کار می‌روند. به ازای هر پردازنده (CPU) موجود در سیستم، خطی به دنبال می‌آید که مقادیر واقعی هر ستون فایل را فهرست می‌کند. \fBlnstat\fP این مقادیر را (که در واقع شمارنده هستند) پیش از چاپ جمع می‌زند. پس از هر بازه زمانی، تنها تفاوت نسبت به مقدار قبلی چاپ می‌شود. .PP فایل‌ها و ستون‌ها را می‌توان با استفاده از پارامترهای \fB\-f\fP و \fB\-k\fP انتخاب کرد. به‌طور پیش‌فرض، تمام ستون‌های همه فایل‌ها چاپ می‌شوند. .SH "گزینهها (OPTIONS)" دستور lnstat از گزینه‌های زیر پشتیبانی می‌کند: .TP .B \-h, \-\-help نمایش چکیده و خلاصهٔ گزینه‌ها. .TP .B \-V, \-\-version نمایش نسخه برنامه. .TP .B \-c, \-\-count چاپ تعداد بازه زمانی. .TP .B \-d, \-\-dump تخلیه و نمایش فهرست فایل‌ها/کلیدهای موجود. .TP .B \-f, \-\-file فایل آماری مورد استفاده؛ این گزینه می‌تواند چند بار مشخص شود. به‌طور پیش‌فرض تمام فایل‌های موجود در مسیر /proc/net/stat پیمایش می‌شوند. .TP .B \-i, \-\-interval تنظیم بازه زمانی بر حسب ثانیه (intv). .TP .B \-j, \-\-json نمایش نتایج در قالب JSON. .TP .B \-k, \-\-keys k,k,k,... تنها کلیدهای مشخص‌شده را نمایش می‌دهد. هر کلید \fBk\fP به‌صورت \fB[file:]key\fP است. اگر \fB\fP داده شود، جستجو برای کلید داده‌شده به آن فایل محدود می‌شود. در غیر این صورت، اولین فایلی که حاوی کلید جستجو شده باشد استفاده می‌شود. .TP .B \-s, \-\-subject [0-2] نحوه نمایش عنوان/سربرگ را مشخص می‌کند. مقدار «0» به معنای عدم نمایش سربرگ، مقدار «1» چاپ سربرگ تنها در شروع برنامه، و مقدار «2» چاپ سربرگ در هر 20 خط است. .TP .B \-w, \-\-width n,n,n,... عرض ستون برای هر فیلد. .SH "مثال‌های کاربردی (USAGE EXAMPLES)" .TP .B # lnstat -d دریافت فهرستی از فایل‌های آماری پشتیبانی‌شده. .TP .B # lnstat -k arp_cache:entries,rt_cache:in_hit,arp_cache:destroys انتخاب فایل‌ها و کلیدهای مشخص‌شده. .TP .B # lnstat -i 10 استفاده از بازه زمانی ۱۰ ثانیه‌ای. .TP .B # lnstat -f ip_conntrack استفاده تنها از فایل مشخص‌شده برای آمار. .TP .B # lnstat -s 0 عدم چاپ سربرگ. .TP .B # lnstat -s 20 چاپ سربرگ در ابتدا و سپس هر ۲۰ خط یک‌بار. .TP .B # lnstat -c -1 -i 1 -f rt_cache -k entries,in_hit,in_slow_tot نمایش آمار کلیدهای entries، in_hit و in_slow_tot از فیلد rt_cache در هر ثانیه. .SH "فایلها (FILES)" .TP .B /proc/net/stat/arp_cache, /proc/net/stat/ndisc_cache آمار مربوط به حافظه نهان همسایه و ARP. فایل \fBarp_cache\fP برای IPv4 و \fBndisc_cache\fP معادل همان برای IPv6 است. .sp .B entries تعداد مدخل‌ها در جدول همسایه. .sp .B allocs تعداد مدخل‌های همسایه که تخصیص یافته‌اند. .sp .B destroys تعداد مدخل‌های همسایه که حذف شده‌اند. .sp .B hash_grows تعداد دفعاتی که جدول درهم‌سازی (هش) همسایه افزایش اندازه داشته است. .sp .B lookups تعداد جستجوهای انجام‌شده. .sp .B hits تعداد \fBlookups\fP (جستجوها) که موفقیت‌آمیز بوده‌اند. .sp .B res_failed تعداد جستجوهای ناموفق همسایه. .sp .B rcv_probes_mcast تعداد درخواست‌های همسایه چندپخشی (multicast neighbor solicitations) دریافت‌شده (تنها در IPv6). .sp .B rcv_probes_ucast تعداد درخواست‌های همسایه تک‌پخشی (unicast neighbor solicitations) دریافت‌شده (تنها در IPv6). .sp .B periodic_gc_runs تعداد دفعات اجرای بازیافت حافظه دوره‌ای (garbage collection). .sp .B forced_gc_runs تعداد دفعات اجرای اجباری بازیافت حافظه. این اتفاق هنگامی رخ می‌دهد که هنگام افزودن یک مدخل جدید، جدول بیش از حد پر باشد. .sp .B unresolved_discards تعداد مدخل‌های جدول همسایه که به دلیل شکست در جستجو دور ریخته شده‌اند. .sp .B table_fulls تعداد سرریزهای جدول. زمانی رخ می‌دهد که جدول پر است و اجرای اجباری بازیافت حافظه (ببینید: \fBforced_gc_runs\fP) شکست خورده باشد. .TP .B /proc/net/stat/ip_conntrack, /proc/net/stat/nf_conntrack شمارنده‌های مربوط به رهگیری اتصال (conntrack). فایل \fBip_conntrack\fP تنها برای سازگاری با نسخه‌های قدیمی‌تر فضای کاربری است و همان داده‌های \fBnf_conntrack\fP را نمایش می‌دهد. .sp .B entries تعداد مدخل‌ها در جدول رهگیری اتصال. .sp .B searched تعداد جستجوهای انجام‌شده در جدول conntrack. .sp .B found تعداد جستجوهای (\fBsearched\fP) که موفقیت‌آمیز بوده‌اند. .sp .B new تعداد مدخل‌های conntrack اضافه‌شده که قبلاً مورد انتظار نبوده‌اند. .sp .B invalid تعداد بسته‌های دیده‌شده که امکان رهگیری آن‌ها وجود ندارد. .sp .B ignore تعداد بسته‌های دیده‌شده که هم‌اکنون به یک مدخل conntrack متصل هستند. .sp .B delete تعداد مدخل‌های conntrack که حذف شده‌اند. .sp .B delete_list تعداد مدخل‌های conntrack که به فهرست در حال انقضا (dying list) منتقل شده‌اند. .sp .B insert تعداد مدخل‌های درج‌شده در فهرست. .sp .B insert_failed تعداد مدخل‌هایی که تلاش برای درج آن‌ها در فهرست انجام شد اما شکست خورد (زمانی رخ می‌دهد که همان مدخل از قبل موجود باشد). .sp .B drop تعداد بسته‌های دور ریخته‌شده به دلیل خطای conntrack. یا تخصیص مدخل جدید conntrack با شکست مواجه شده، یا کمکی پروتکل (protocol helper) بسته را دور انداخته است. .sp .B early_drop تعداد مدخل‌های conntrack دور انداخته‌شده جهت باز کردن فضا برای موارد جدید، در صورتی که اندازه جدول به بیشینه ظرفیت رسیده باشد. .sp .B icmp_error تعداد بسته‌هایی که به دلیل شرایط خطا امکان رهگیری آن‌ها وجود نداشت. این مورد زیرمجموعه‌ای از \fBinvalid\fP است. .sp .B expect_new تعداد مدخل‌های conntrack اضافه‌شده پس از آن‌که یک انتظار برای آن‌ها از قبل وجود داشت. .sp .B expect_create تعداد انتظارات اضافه‌شده. .sp .B expect_delete تعداد انتظارات حذف‌شده. .sp .B search_restart تعداد جستجوهای جدول conntrack که به دلیل تغییر اندازه جدول هش مجبور به شروع مجدد شدند. .TP .B /proc/net/stat/rt_cache آمار حافظه نهان مسیریابی (routing cache). .sp .B entries تعداد مدخل‌ها در حافظه نهان مسیریابی. .sp .B in_hit تعداد تطابق‌های موفق در حافظه نهان مسیر برای بسته‌های ورودی. از زمان حذف حافظه نهان مسیر IP منسوخ شده و بنابراین همواره صفر است. .sp .B in_slow_tot تعداد مدخل‌های حافظه نهان مسیریابی اضافه‌شده برای ترافیک ورودی. .sp .B in_slow_mc تعداد مدخل‌های حافظه نهان مسیریابی چندپخشی اضافه‌شده برای ترافیک ورودی. .sp .B in_no_route تعداد بسته‌های ورودی که هیچ مدخلی در جدول مسیریابی برای آن‌ها یافت نشد. .sp .B in_brd تعداد بسته‌های هم‌پخشی (broadcast) ورودی تطبیق‌یافته. .sp .B in_martian_dst تعداد بسته‌های ورودی با مقصد مریخی (martian destination). .sp .B in_martian_src تعداد بسته‌های ورودی با مبدا مریخی (martian source). .sp .B out_hit تعداد تطابق‌های موفق در حافظه نهان مسیر برای بسته‌های خروجی. از زمان حذف حافظه نهان مسیر IP منسوخ شده و بنابراین همواره صفر است. .sp .B out_slow_tot تعداد مدخل‌های حافظه نهان مسیریابی اضافه‌شده برای ترافیک خروجی. .sp .B out_slow_mc تعداد مدخل‌های حافظه نهان مسیریابی چندپخشی اضافه‌شده برای ترافیک خروجی. .sp .B gc_total تعداد کل دفعات اجرای بازیافت حافظه (garbage collection). از زمان حذف حافظه نهان مسیر IP منسوخ شده و بنابراین همواره صفر است. .sp .B gc_ignored تعداد دفعات نادیده گرفتن بازیافت حافظه به دلیل نرسیدن به حداقل بازه زمانی GC و پر نبودن حافظه نهان مسیریابی. از زمان حذف حافظه نهان مسیر IP منسوخ شده و بنابراین همواره صفر است. .sp .B gc_goal_miss تعداد موارد محقق نشدن هدف بازیافت حافظه. از زمان حذف حافظه نهان مسیر IP منسوخ شده و بنابراین همواره صفر است. .sp .B gc_dst_overflow تعداد سرریزهای حافظه نهان مقصد. از زمان حذف حافظه نهان مسیر IP منسوخ شده و بنابراین همواره صفر است. .sp .B in_hlist_search تعداد پیمایش‌های فهرست جدول هش برای ترافیک ورودی. از زمان حذف حافظه نهان مسیر IP منسوخ شده و بنابراین همواره صفر است. .sp .B out_hlist_search تعداد پیمایش‌های فهرست جدول هش برای ترافیک خروجی. از زمان حذف حافظه نهان مسیر IP منسوخ شده و بنابراین همواره صفر است. .SH "همچنین ببینید (SEE ALSO)" .BR ip (8) .br .SH "نویسنده (AUTHOR)" دستور lnstat توسط Harald Welte نوشته شده است. .PP این صفحهٔ راهنما توسط Michael Prokop برای پروژه دبیان نوشته شده است (اما دیگران نیز می‌توانند از آن استفاده کنند).