'\" t .\" SPDX-License-Identifier: GPL-2.0 .\" License-Filename: LICENSES/preferred/GPL-2.0 .TH "BATCTL" "8" "17 ژوئیه 2015" "Linux" "ابزار کنترل B.A.T.M.A.N. Advanced" .ad l .SH "نام (NAME)" batctl \- ابزار کنترل و مدیریت B.A.T.M.A.N. advanced .SH "خلاصه دستور (SYNOPSIS)" .B batctl [\fIگزینه‌ها\fP]\ \fIدستور\fP|\fIجدول\ اشکال‌زدایی\fP|\fIJSON\ اشکال‌زدایی\fP\ [\fIپارامترها\fP] .br .SH "توضیحات (DESCRIPTION)" دستور .B batctl روشی آسان برای پیکربندی ماژول کرنل .BR batman\-adv و همچنین نمایش اطلاعات اشکال‌زدایی مانند جدول‌های مبدا و جدول‌های ترجمه فراهم می‌کند. در ترکیب با یک فایل .BR bat\-hosts ، ابزار .B batctl امکان استفاده از نام میزبان به جای نشانی‌های MAC را می‌دهد. .PP پروتکل B.A.T.M.A.N. advanced در لایه ۲ عمل می‌کند. بنابراین تمام میزبان‌های حاضر در شبکه سوییچ‌شده مجازی، برای تمام پروتکل‌های بالاتر از لایه ۲ به‌صورت شفاف به یکدیگر متصل می‌شوند. از این رو ابزارهای معمول عیب‌یابی آن‌گونه که انتظار می‌رود کار نمی‌کنند. برای رفع این مشکلات، .B batctl شامل دستورهای .BR ping ، .B traceroute و .B tcpdump است که قابلیتی مشابه دستورهای معمول .BR ping (1)، .BR traceroute (1) و .BR tcpdump (1) فراهم می‌کنند، اما برای رفتار در لایه ۲ یا استفاده از پروتکل B.A.T.M.A.N. advanced بهینه‌سازی شده‌اند. به دلایل مشابه، دستور .BR throughputmeter برای ارزیابی کارایی شبکه نیز گنجانده شده است. .SH "گزینه‌ها (OPTIONS)" .TP \fB\-m\fP مشخص کردن رابط مش (پیش‌فرض 'bat0') .TP \fB\-h\fP چاپ راهنمای عمومی batctl .TP \fB\-v\fP چاپ نسخه batctl و نسخه batman-adv (در صورت بارگذاری بودن ماژول) .SH "دستورها (COMMANDS)" .TP \fBbisect_iv\fP [\fB\-l MAC\fP][\fB\-t\fP \fIMAC\fP][\fB\-r\fP \fIMAC\fP][\fB\-s\fP \fImin\fP [\- \fImax\fP]][\fB\-o\fP \fIMAC\fP][\fB\-n\fP] \fIlogfile1\fP ... تحلیل فایل‌های گزارش B.A.T.M.A.N. IV جهت ساخت یک پایگاه‌داده داخلی کوچک از تمام شماره‌های ترتیبی ارسال‌شده و تغییرات جدول مسیریابی. سپس این پایگاه‌داده را می‌توان به روش‌های مختلفی تحلیل کرد. با .B \-l می‌توان از پایگاه‌داده برای جستجوی حلقه‌های مسیریابی استفاده کرد. از .B \-t برای ردیابی OGMهای یک میزبان در سرتاسر شبکه استفاده کنید. از .B \-r برای نمایش جدول‌های مسیریابی گره‌ها استفاده کنید. گزینه .B \-s می‌تواند برای محدود کردن خروجی به محدوده‌ای از شماره‌های ترتیبی میان min و max، یا به یک شماره ترتیبی مشخص min به کار رود. علاوه بر این، با استفاده از .B \-o می‌توانید خروجی را برای یک مبدا مشخص فیلتر کنید. اگر .B \-n داده شود، batctl نشانی‌های MAC را با نام‌های bat-host در خروجی جایگزین نخواهد کرد. .RE .TP \fBevent\fP|\fBe\fP [\fB\-t\fP|\fB\-r\fP] دستور batctl رویدادها را از رابط کرنل netlink مربوط به batman-adv پایش می‌کند. در صورت مشخص شدن پارامتر .BR \-t ، برچسب زمانی محلی رویداد چاپ خواهد شد. پارامتر .B \-r همان عمل را با برچسب زمانی نسبی انجام می‌دهد. .TP [\fBmeshif\fP \fInetdev\fP] \fBinterface\fP|\fBif\fP .TQ [\fBmeshif\fP \fInetdev\fP] \fBinterface\fP|\fBif\fP [\fB-M\fP] \fBadd\fP|\fBdel\fP \fIiface\fP ... اگر پارامتری داده نشود یا اولین پارامتر نه "add" و نه "del" باشد، تنظیمات فعلی رابط نمایش داده می‌شود. جهت افزودن یا حذف رابط‌ها، "add" یا "del" را به عنوان اولین آرگومان مشخص کرده و نام رابط‌های مورد نظر برای افزودن یا حذف را اضافه کنید. می‌توان چندین رابط را مشخص کرد. گزینه .B \-M به batctl اعلام می‌کند که هنگام "add" رابط batman-adv را به‌طور خودکار ایجاد نکند. همچنین می‌توان از آن برای چشم‌پوشی از هشدار تخریب دستی در زمانی که "del" تمام رابط‌های متعلق به آن را حذف کرده استفاده کرد. .TP [\fBmeshif\fP \fInetdev\fP] \fBinterface\fP|\fBif\fP \fBcreate\fP [\fBrouting_algo\fP|\fBra\fP \fIRA_NAME\fP] یک رابط batman-adv بدون رابط‌های متصل را می‌توان با "create" ایجاد کرد. پارامتر routing_algo می‌تواند برای بازنویسی الگوریتم مسیریابی (پیش‌فرض) استفاده شود. .TP [\fBmeshif\fP \fInetdev\fP] \fBinterface\fP|\fBif\fP \fBdestroy\fP حذف تمام رابط‌های متصل و نابود کردن رابط batman-adv. .TP [\fBmeshif\fP \fInetdev\fP] \fBping\fP|\fBp\fP [\fB\-c\fP \fIcount\fP][\fB\-i\fP \fIinterval\fP][\fB\-t\fP \fItime\fP][\fB\-R\fP][\fB\-T\fP] \fIMAC_address\fP|\fIbat\-host_name\fP|\fIhost_name\fP|\fIIP_address\fP ارسال پینگ لایه ۲ به یک نشانی MAC یا نام bat-host. در صورتی که پارامتر داده‌شده نشانی MAC نباشد، batctl تلاش می‌کند نام bat-host را پیدا کند. همچنین در صورتی که نشانی IPv4/IPv6 بر روی رابط batman-adv دستگاه مقصد پیکربندی شده باشد و هر دو دستگاه مبدا و مقصد در یک زیرشبکه IP باشند، می‌تواند تلاش کند نشانی MAC را با استفاده از نشانی IPv4/IPv6 یا یک نام میزبان حدس بزند. گزینه .B \-c به batctl می‌گوید پیش از خروج برنامه چه تعداد پینگ باید ارسال شود. بدون گزینه .B \-c ابزار batctl پینگ گرفتن را بدون پایان ادامه می‌دهد. از CTRL + C برای متوقف کردن آن استفاده کنید. با .B \-i و .B \-t می‌توانید فاصله زمانی پیش‌فرض بین پینگ‌ها و مهلت زمانی پاسخ‌ها را بر حسب ثانیه مشخص کنید. هنگام اجرا با .BR \-R ، مسیر طی‌شده توسط پیام‌های پینگ ثبت خواهد شد. با .B \-T می‌توانید ترجمه خودکار نشانی MAC کلاینت به نشانی مبدایی که مسئول این کلاینت است را غیرفعال کنید. .TP \fBrouting_algo\fP|\fBra\fP [\fIalgorithm\fP] اگر پارامتری داده نشود، پیکربندی فعلی الگوریتم مسیریابی و همچنین الگوریتم‌های مسیریابی پشتیبانی‌شده نمایش داده می‌شوند. در غیر این صورت، این پارامتر برای انتخاب الگوریتم مسیریابی رابط batX بعدی که ایجاد می‌شود استفاده خواهد شد. .TP [\fBmeshif\fP \fInetdev\fP] \fBstatistics\fP|\fBs\fP دریافت شمارنده‌های ترافیک از ماژول هسته batman-adv. خروجی ممکن است بسته به ویژگی‌هایی که درون ماژول هسته کامپایل شده‌اند متفاوت باشد. .br هر زیرسیستم ماژول شمارنده‌های اختصاصی خود را دارد که با پیشوند آن‌ها مشخص می‌شوند: .TS tab (@); r lx. mgmt@T{ شمارنده‌های پروتکل مش T} tt@T{ شمارنده‌های جدول ترجمه T} .TE تمامی شمارنده‌های بدون پیشوند مربوط به ترافیک بار داده (داده‌های خالص کاربر) هستند. .TP \fBtcpdump\fP|\fBtd\fP [\fB\-c\fP][\fB\-n\fP][\fB\-p\fP \fIfilter\fP][\fB\-x\fP \fIfilter\fP] \fBinterface ...\fP ابزار batctl تمامی بسته‌های دیده‌شده روی رابط(های) مشخص‌شده را نمایش می‌دهد. گزینه‌های مختلفی برای فیلتر کردن خروجی در دسترس است: برای چاپ بسته‌هایی که با شماره سازگاری batctl مطابقت دارند، گزینه .B \-c (فیلتر سازگاری) را مشخص کنید. اگر .B \-n داده شود، batctl نشانی‌های MAC را با نام‌های bat-host در خروجی جایگزین نخواهد کرد. برای فیلتر کردن انواع بسته‌های نمایش‌یافته می‌توانید از .B \-p (تنها تخلیه انواع بسته‌های مشخص‌شده) یا .B \-x (تخلیه تمامی بسته‌ها به جز موارد مشخص‌شده) استفاده کنید. انواع بسته‌های زیر موجود هستند: .TS tab (@); r lx. 1@T{ بسته‌های ogm بتمن T} 2@T{ بسته‌های icmp بتمن T} 4@T{ بسته‌های unicast بتمن T} 8@T{ بسته‌های broadcast بتمن T} 16@T{ بسته‌های unicast tvlv بتمن T} 32@T{ بسته‌های قطعه‌قطعه‌شده بتمن T} 64@T{ بسته‌های tt / رومینگ بتمن T} 128@T{ بسته‌های غیر بتمن T} .TE مثال: batctl td \-p 129 \-> تنها نمایش بسته‌های ogm بتمن و بسته‌های غیر بتمن .TP [\fBmeshif\fP \fInetdev\fP] \fBthroughputmeter\fP|\fBtp\fP \fIMAC\fP این دستور یک آزمون توان عملیاتی را آغاز می‌کند که تماماً توسط ماژول batman در فضای هسته کنترل می‌شود: منابع محاسباتی لازم برای تراز حافظه و رونوشت داده میان فضای کاربر و فضای هسته که ابزارهای دیگر فضای کاربر نیاز دارند، ممکن است روی برخی دستگاه‌های ضعیف گلوگاه ایجاد کند. این آزمون شامل انتقال ۱۴ مگابایت داده میان دو گره است. پروتکل مورداستفاده برای انتقال داده تا حدی شبیه به TCP اما ساده‌تر است: برخی امکانات TCP هنوز در آن پیاده‌سازی نشده‌اند، بنابراین کارایی پروتکل ممکن است بدتر باشد. از آنجا که حجم ثابتی از داده منتقل می‌شود، مدت زمان آزمایش به شرایط شبکه بستگی دارد. آزمایش را می‌توان با کلیدهای CTRL + C لغو کرد. در پایان یک آزمایش موفقیت‌آمیز، توان عملیاتی بر حسب کیلوبایت در ثانیه همراه با مدت زمان آزمایش بر حسب میلی‌ثانیه و حجم بایت‌های منتقل‌شده نمایش داده می‌شود. اگر بسته‌های بسیار زیادی گم شوند یا نشانی MAC مشخص‌شده در دسترس نباشد، پیامی برای اطلاع‌رسانی خطا به جای نتیجه بازگردانده می‌شود. .TP [\fBmeshif\fP \fInetdev\fP] \fBtraceroute\fP|\fBtr\fP [\fB\-n\fP][\fB\-T\fP] \fIMAC_address\fP|\fIbat\-host_name\fP|\fIhost_name\fP|\fIIP_address\fP ردگیری مسیر در لایه ۲ به یک نشانی MAC یا نام bat-host. در صورتی که پارامتر داده‌شده نشانی MAC نباشد، batctl تلاش می‌کند نام bat-host را پیدا کند. همچنین در صورتی که نشانی IPv4/IPv6 بر روی رابط batman-adv دستگاه مقصد تنظیم شده باشد و هر دو دستگاه مبدا و مقصد در یک زیرشبکه IP باشند، می‌تواند تلاش کند نشانی MAC را بر اساس نشانی IPv4/IPv6 یا نام میزبان حدس بزند. ابزار batctl تعداد ۳ بسته به هر میزبان می‌فرستد و زمان پاسخ را نمایش می‌دهد. اگر .B \-n داده شود، batctl نشانی‌های MAC را با نام‌های bat-host در خروجی جایگزین نخواهد کرد. با .B \-T می‌توانید ترجمه خودکار نشانی MAC کلاینت به نشانی مبدایی که مسئول این کلاینت است را غیرفعال کنید. .TP [\fBmeshif\fP \fInetdev\fP] \fBtranslate\fP|\fBt\fP \fIMAC_address\fP|\fIbat\-host_name\fP|\fIhost_name\fP|\fIIP_address\fP ترجمه یک مقصد (نام میزبان، IP، MAC، نام bat_host) به نشانی MAC مبدایی که مسئول آن است. .SH "تنظیمات (SETTINGS)" .TP [\fBmeshif\fP \fInetdev\fP] \fBaggregation\fP|\fBag\fP [\fI0\fP|\fI1\fP] اگر پارامتری داده نشود، وضعیت تجمیع فعلی نمایش داده می‌شود. در غیر این صورت از این پارامتر برای فعال یا غیرفعال کردن تجمیع بسته‌های OGM استفاده می‌شود. .TP [\fBmeshif\fP \fInetdev\fP] \fBap_isolation\fP|\fBap\fP [\fI0\fP|\fI1\fP] اگر پارامتری داده نشود، وضعیت فعلی جداسازی AP نمایش داده می‌شود. در غیر این صورت از این پارامتر برای فعال یا غیرفعال کردن جداسازی AP استفاده می‌شود. .TP [\fBmeshif\fP \fInetdev\fP] \fBap_isolation\fP|\fBap\fP [\fI0\fP|\fI1\fP] .TQ [\fBmeshif\fP \fInetdev\fP] \fBvid \fP \fBap_isolation\fP|\fBap\fP [\fI0\fP|\fI1\fP] .TQ \fBvlan\fP \fIvdev\fP \fBap_isolation\fP|\fBap\fP [\fI0\fP|\fI1\fP] اگر پارامتری داده نشود، وضعیت فعلی جداسازی AP برای VLAN مشخص‌شده نمایش داده می‌شود. در غیر این صورت از پارامتر برای فعال یا غیرفعال کردن جداسازی AP برای VLAN مشخص‌شده استفاده می‌شود. .TP [\fBmeshif\fP \fInetdev\fP] \fBbonding\fP|\fBb\fP [\fI0\fP|\fI1\fP] اگر پارامتری داده نشود، وضعیت حالت پیوند فعلی نمایش داده می‌شود. در غیر این صورت از این پارامتر برای فعال یا غیرفعال کردن حالت پیوند استفاده می‌شود. .TP [\fBmeshif\fP \fInetdev\fP] \fBbridge_loop_avoidance\fP|\fBbl\fP [\fI0\fP|\fI1\fP] اگر پارامتری داده نشود، تنظیمات فعلی جلوگیری از حلقه پل نمایش داده می‌شود. در غیر این صورت از پارامتر برای فعال یا غیرفعال کردن جلوگیری از حلقه پل استفاده می‌شود. پشتیبانی از جلوگیری از حلقه پل باید هنگام کامپایل ماژول فعال شده باشد وگرنه این گزینه در دسترس نخواهد بود. .TP [\fBmeshif\fP \fInetdev\fP] \fBdistributed_arp_table\fP|\fBdat\fP [\fI0\fP|\fI1\fP] اگر پارامتری داده نشود، تنظیمات فعلی جدول توزیع‌شده ARP نمایش داده می‌شود. در غیر این صورت از پارامتر برای فعال یا غیرفعال کردن جدول توزیع‌شده ARP استفاده می‌شود. .TP \fBhardif\fP \fIhardif\fP \fBelp_interval\fP|\fBet\fP [\fIinterval\fP] اگر پارامتری داده نشود، تنظیمات فعلی بازه زمانی ELP رابط فیزیکی نمایش داده می‌شود، در غیر این صورت از پارامتر برای تعیین بازه ELP استفاده خواهد شد. این بازه بر حسب میلی‌ثانیه است. .TP [\fBmeshif\fP \fInetdev\fP] \fBfragmentation\fP|\fBf\fP [\fI0\fP|\fI1\fP] اگر پارامتری داده نشود، تنظیمات فعلی حالت قطعه‌قطعه‌سازی بسته نمایش داده می‌شود. در غیر این صورت از پارامتر برای فعال یا غیرفعال کردن قطعه‌قطعه‌سازی استفاده می‌شود. .TP [\fBmeshif\fP \fInetdev\fP] \fBgw_mode|gw\fP [\fBoff\fP|\fBclient\fP|\fBserver\fP] [\fIsel_class\fP|\fIbandwidth\fP] اگر پارامتری داده نشود، حالت فعلی درگاه نمایش داده می‌شود وگرنه از پارامتر برای تنظیم حالت درگاه استفاده خواهد شد. آرگومان دوم (اختیاری) کلاس انتخاب (در صورتی که اولین آرگومان 'client' باشد) یا پهنای باند درگاه (در صورتی که اولین آرگومان 'server' باشد) را مشخص می‌کند. اگر گره یک سرور باشد، این پارامتر برای آگاه کردن سایر گره‌های شبکه از پهنای باند اتصال اینترنت این گره استفاده می‌شود. کافی است هر عددی را وارد کنید (اختیاراً به دنبال "kbit" یا "mbit") و ماژول batman-adv مقدار واردشده را در شبکه مش منتشر خواهد کرد. از "/" برای جداسازی نرخ‌های بارگیری و بارگذاری استفاده کنید. می‌توانید نرخ بارگذاری را حذف کنید و ماژول نرخ بارگذاری را یک‌پنجم (۱/۵) بارگیری فرض خواهد کرد. .RS 17 پیش‌فرض: 10000 \-> 10.0/2.0 MBit .RE .RS 16 مثال‌ها: 5000 \-> 5.0/1.0 MBit .RE .RS 26 5000kbit 5mbit 5mbit/1024 5mbit/1024kbit 5mbit/1mbit .RE .RS 7 اگر گره یک کلاینت درگاه باشد، پارامتر تعیین می‌کند که هنگام انتخاب میان اتصالات اینترنتی مختلف اعلام‌شده توسط سرورهای یادشده، ماژول batman-adv چه معیارهایی را در نظر بگیرد. .RE .RS 7 B.A.T.M.A.N. IV: .RE .RS 17 پیش‌فرض: 20 \-> تغییر با تاخیر (TQ 20) .RE .RS 16 مثال‌ها: 1 -> اتصال سریع .RS 16 توان عملیاتی تبلیغ‌شده توسط درگاه و همچنین کیفیت پیوند تا درگاه را در نظر گرفته و به این انتخاب پایبند می‌ماند تا زمانی که درگاه ناپدید شود .RE .RE .RS 25 2 \-> اتصال پایدار .RS 7 درگاهی با بهترین کیفیت پیوند را انتخاب می‌کند و به آن پایبند می‌ماند (توان عملیاتی اعلام‌شده را نادیده می‌گیرد) .RE 3 \-> اتصال با تغییر سریع .RS 7 درگاهی با بهترین کیفیت پیوند را انتخاب می‌کند اما به محض یافتن درگاه بهتر، تغییر می‌دهد .RE XX \-> اتصال با تغییر با تاخیر .RS 7 درگاهی با بهترین کیفیت پیوند را انتخاب می‌کند اما تنها زمانی به درگاه دیگر تغییر می‌دهد که دست‌کم XX واحد TQ بهتر از درگاه فعلی باشد (XX باید عددی بین ۳ تا ۲۵۶ باشد). .RE .RE .RS 7 B.A.T.M.A.N. V: .RE .RS 17 پیش‌فرض: 5000 \-> تغییر با تاخیر (توان عملیاتی 5000 kbit/s) .br مثال: 1500 \-> اتصال با تغییر سریع .RS 17 به محض یافتن درگاه دیگر که توان عملیاتی آن دست‌کم 1500 kbit/s بیشتر از درگاه فعلی باشد تغییر می‌کند. توان عملیاتی بر اساس ارزیابی کمترین مقدار بین توان تبلیغ‌شده توسط درگاه و حداکثر پهنای باند کل مسیر تعیین می‌شود. .RE .RE .br .TP [\fBmeshif\fP \fInetdev\fP] \fBhop_penalty\fP|\fBhp\fP [\fIpenalty\fP] اگر پارامتری داده نشود، تنظیمات فعلی جریمه پرش (hop penalty) نمایش داده می‌شود. در غیر این صورت از پارامتر برای تنظیم جریمه پرش استفاده می‌شود. این جریمه می‌تواند ۰-۲۵۵ باشد (مقدار ۲۵۵ مقدار TQ پیام مبدا را هنگام فوروارد توسط این پرش صفر می‌کند). .TP [\fBhardif\fP \fIhardif\fP] \fBhop_penalty\fP|\fBhp\fP [\fIpenalty\fP] اگر پارامتری داده نشود، تنظیمات فعلی جریمه پرش رابط فیزیکی نمایش داده می‌شود. در غیر این صورت از پارامتر برای تنظیم جریمه پرش استفاده می‌شود. جریمه می‌تواند ۰-۲۵۵ باشد (مقدار ۲۵۵ مقدار TQ پیام مبدا را هنگام فوروارد از طریق این رابط صفر می‌کند). .TP [\fBmeshif\fP \fInetdev\fP] \fBisolation_mark\fP|\fBmark\fP [\fIvalue\fP[/\fImask\fP]] اگر پارامتری داده نشود، مقدار فعلی نشانگر جداسازی نمایش داده می‌شود. در غیر این صورت از پارامتر برای تنظیم یا حذف نشانگر جداسازی مورد استفاده قابلیت Extended Isolation استفاده خواهد شد. .br ورودی باید به قالب value/mask$ باشد، که در آن value$ می‌تواند هر عدد صحیح ۳۲ بیتی (در مبنای ده‌دهی یا شانزده‌شانزدهی) باشد و mask$ یک ماسک بیتی کلی (در مبنای شانزده‌شانزدهی) است که بیت‌های مورد نظر از value$ را مشخص می‌کند. همچنین می‌توان ورودی را تنها با استفاده از value$ وارد کرد که در این صورت ماسک بیتی کامل به‌صورت پیش‌فرض استفاده می‌شود. .br .br مثال ۱: 0x00000001/0xffffffff .br مثال ۲: 0x00040000/0xffff0000 .br مثال ۳: 16 یا 0x0F .br .TP [\fBmeshif\fP \fInetdev\fP] \fBloglevel\fP|\fBll\fP [\fIlevel\fP ...] اگر پارامتری داده نشود، تنظیمات فعلی سطح گزارش‌گیری نمایش داده می‌شود وگرنه از پارامتر(ها) برای تعیین سطح گزارش استفاده می‌شود. سطح 'none' تمام گزارش‌های پرحجم را غیرفعال می‌کند. سطح 'batman' پیام‌های مربوط به مسیریابی / سیل‌آسایی / پخش همگانی را فعال می‌سازد. سطح 'routes' پیام‌های مربوط به افزودن / تغییر / حذف مسیرها را فعال می‌کند. سطح 'tt' پیام‌های مربوط به عملیات جدول ترجمه را فعال می‌کند. سطح 'bla' پیام‌های مربوط به جلوگیری از حلقه پل را فعال می‌کند. سطح 'dat' پیام‌های مربوط به تجسس ARP و جدول توزیع‌شده ARP را فعال می‌کند. سطح 'mcast' پیام‌های مربوط به بهینه‌سازی‌های چندپخشی را فعال می‌کند. سطح 'tp' پیام‌های مربوط به سنجش توان عملیاتی را فعال می‌کند. سطح 'all' تمام پیام‌ها را فعال می‌کند. پیام‌ها به بافرهای ردیابی هسته ارسال می‌شوند. از \fBtrace-cmd stream -e batadv:batadv_dbg\fP برای دریافت پیام‌های گزارش در سطح سیستم استفاده کنید. .TP [\fBmeshif\fP \fInetdev\fP] \fBmulticast_fanout\fP|\fBmo\fP [\fIfanout\fP] اگر پارامتری داده نشود، مقدار فعلی انشعاب چندپخشی نمایش داده می‌شود. در غیر این صورت از پارامتر برای تنظیم انشعاب چندپخشی استفاده خواهد شد. انشعاب چندپخشی حداکثر تعداد کپی‌های بسته‌ای را تعیین می‌کند که ممکن است برای تبدیل چندپخشی به تک‌پخشی تولید شود. با فراتر رفتن از این محدودیت، ارسال به روش پخش همگانی انجام خواهد شد. .TP [\fBmeshif\fP \fInetdev\fP] \fBmulticast_forceflood\fP|\fBmff\fP [\fI0\fP|\fI1\fP] اگر پارامتری داده نشود، تنظیم فعلی سیل‌آسایی اجباری چندپخشی نمایش داده می‌شود. در غیر این صورت از پارامتر برای فعال یا غیرفعال کردن سیل‌آسایی اجباری چندپخشی استفاده می‌شود. این تنظیم مشخص می‌کند آیا بهینه‌سازی‌های چندپخشی باید با سیل‌آسایی ساده شبیه به پخش همگانی برای بسته‌های چندپخشی جایگزین شود یا خیر. در صورت تنظیم روی مقداری غیر از صفر، تمام گره‌های شبکه مش برای تمام بسته‌های چندپخشی از سیل‌آسایی کلاسیک بدون هیچ‌گونه بهینه‌سازی استفاده خواهند کرد. .TP [\fBmeshif\fP \fInetdev\fP] \fBorig_interval\fP|\fBit\fP [\fIinterval\fP] اگر پارامتری داده نشود، تنظیم فعلی بازه زمانی مبدا نمایش داده می‌شود وگرنه از پارامتر برای تعیین بازه زمانی مبدا استفاده خواهد شد. این بازه بر حسب میلی‌ثانیه است. .TP \fBhardif\fP \fIhardif\fP \fBthroughput_override|to\fP [\fIbandwidth\fP] اگر پارامتری داده نشود، بازنویسی توان عملیاتی فعلی نمایش داده می‌شود وگرنه از پارامتر برای تنظیم بازنویسی توان عملیاتی برای رابط فیزیکی مشخص‌شده استفاده می‌شود. کافی است هر عددی وارد کنید (اختیاراً به دنبال "kbit" یا "mbit"). .SH "جدول‌های اشکال‌زدایی (DEBUG TABLES)" ماژول کرنل batman-adv با انواع جدول‌های اشکال‌زدایی حاوی اطلاعات گوناگون درباره وضعیت شبکه مش از دید هر یک از گره‌ها ارائه می‌شود. تمامی جدول‌های اشکال‌زدایی از گزینه‌های زیر پشتیبانی می‌کنند: .TP \fB-w\fP تازه‌سازی فهرست در هر ثانیه یا افزودن یک عدد برای تازه‌سازی در بازه زمانی سفارشی بر حسب ثانیه (با اعشار اختیاری) .TP \fB-n\fP عدم جایگزینی نشانی‌های MAC با نام‌های bat-host در خروجی .TP \fB-H\fP عدم نمایش سرآیند جدول اشکال‌زدایی .PP جدول مبدا همچنین از گزینه فیلتر .B \-t برای حذف تمام مبداهایی که در بازه زمانی مشخص‌شده بر حسب ثانیه (با اعشار اختیاری) دیده نشده‌اند از خروجی پشتیبانی می‌کند. افزون بر این، از پارامتر .B \-i برای مشخص کردن رابطی که جدول مبدا باید برای آن چاپ شود پشتیبانی می‌کند. در صورت ارائه نشدن این پارامتر، جدول مبدا پیش‌فرض چاپ می‌شود. جدول‌های ترجمه محلی و سراسری همچنین از گزینه‌های .B \-u و .B \-m به ترتیب برای نمایش انحصاری اعلان‌های جدول ترجمه تک‌پخشی یا چندپخشی پشتیبانی می‌کنند. .TP [\fBmeshif\fP \fInetdev\fP] \fBbackbonetable\fP|\fBbbt\fP [\fB-n\fP] [\fB-H\fP] [\fB-w\fP\fIinterval\fP] (گزینه زمان کامپایل) .TP [\fBmeshif\fP \fInetdev\fP] \fBclaimtable\fP|\fBcl\fP [\fB-n\fP] [\fB-H\fP] [\fB-w\fP[\fIinterval\fP]] .TP [\fBmeshif\fP \fInetdev\fP] \fBdat_cache\fP|\fBdc\fP [\fB-n\fP] [\fB-H\fP] [\fB-w\fP[\fIinterval\fP]] (گزینه زمان کامپایل) .TP [\fBmeshif\fP \fInetdev\fP] \fBgateways\fP|\fBgwl\fP [\fB-n\fP] [\fB-H\fP] [\fB-w\fP[\fIinterval\fP]] .TP [\fBmeshif\fP \fInetdev\fP] \fBmcast_flags\fP|\fBmf\fP [\fB-n\fP] [\fB-H\fP] [\fB-w\fP[\fIinterval\fP]] (گزینه زمان کامپایل) .TP [\fBmeshif\fP \fInetdev\fP] \fBneighbors\fP|\fBn\fP [\fB-n\fP] [\fB-H\fP] [\fB-w\fP[\fIinterval\fP]] .TP [\fBmeshif\fP \fInetdev\fP] \fBoriginators\fP|\fBo\fP [\fB-n\fP] [\fB-H\fP] [\fB-w\fP[\fIinterval\fP]] [\fB-t\fP \fItimeout_interval\fP] [\fB-i\fP \fIinterface\fP] .TP [\fBmeshif\fP \fInetdev\fP] \fBtransglobal\fP|\fBtg\fP [\fB-n\fP] [\fB-H\fP] [\fB-w\fP[\fIinterval\fP]] [\fB-u\fP] [\fB-m\fP] (گزینه زمان کامپایل) .TP [\fBmeshif\fP \fInetdev\fP] \fBtranslocal\fP|\fBtl\fP [\fB-n\fP] [\fB-H\fP] [\fB-w\fP[\fIinterval\fP]] [\fB-u\fP] [\fB-m\fP] .SH "پرس‌وجوهای JSON (JSON QUERIES)" خانواده netlink عمومی ارائه‌شده توسط ماژول هسته batman-adv می‌تواند توسط batctl مورد پرس‌وجو (فقط‌خواندنی) قرار گرفته و به‌طور خودکار به JSON ترجمه شود. این قابلیت می‌تواند برای پایش وضعیت سیستم بدون نیاز به تجزیه جدول‌های اشکال‌زدایی بدون قالب مشخص یا پیام‌های بومی netlink استفاده شود. .TP [\fBmeshif\fP \fInetdev\fP] \fBbla_backbone_json\fP|\fBbbj\fP .TP [\fBmeshif\fP \fInetdev\fP] \fBbla_claim_json\fP|\fBclj\fP .TP [\fBmeshif\fP \fInetdev\fP] \fBdat_cache_json\fP|\fBdcj\fP .TP [\fBmeshif\fP \fInetdev\fP] \fBgateways_json\fP|\fBgwj\fP .TP \fBhardif\fP \fIhardif\fP \fBhardif_json\fP|\fBhj\fP .TP [\fBmeshif\fP \fInetdev\fP] \fBhardifs_json\fP|\fBhj\fP .TP [\fBmeshif\fP \fInetdev\fP] \fBmcast_flags_json\fP|\fBmfj\fP .TP [\fBmeshif\fP \fInetdev\fP] \fBmesh_json\fP|\fBmj\fP .TP [\fBmeshif\fP \fInetdev\fP] \fBneighbors_json\fP|\fBnj\fP .TP [\fBmeshif\fP \fInetdev\fP] \fBoriginators_json\fP|\fBoj\fP .TP [\fBmeshif\fP \fInetdev\fP] \fBtranstable_global_json\fP|\fBtgj\fP .TP [\fBmeshif\fP \fInetdev\fP] \fBtranstable_local_json\fP|\fBtlj\fP .TP [\fBmeshif\fP \fInetdev\fP] \fBvid \fP \fBvlan_json\fP|\fBvj\fP .TQ \fBvlan\fP \fIvdev\fP \fBvlan_json\fP|\fBvj\fP .SH "مثال‌ها (EXAMPLES)" راه‌اندازی یک رابط batadv معمولاً شامل ساخت رابط اصلی، پیوست کردن رابط فیزیکی (پایین‌دست)، اعمال تنظیمات و بالا آوردن رابط است: .PP .in +4n .EX # create batadv (mesh) interface bat0 with routing algorithm B.A.T.M.A.N. IV .RB "$" " batctl meshif bat0 interface create routing_algo BATMAN_IV" # add the (already up and running) mesh0 interface as lower (hard) interface to bat0 .RB "$" " batctl meshif bat0 interface -M add mesh0" # change some settings to better match the requirements of the user .RB "$" " batctl meshif bat0 orig_interval 5000" .RB "$" " batctl meshif bat0 distributed_arp_table disable" .RB "..." # set the batadv (mesh) interface up before it is possible to use it .RB "$" " ip link set up dev bat0" .EE .in این عمل تنها راه‌اندازی کارکرد لایه ۲ رابط bat0 را تضمین می‌کند. کاربر موظف است اطمینان حاصل کند که پیش از استفاده، دستگاه bat0 به یک پل متصل شده، یک نشانی IP بر روی آن پیکربندی شده (دستی/کلاینت DHCP/...)، یا با سایر بخش‌های سیستم یکپارچه شده است. .PP همچنین رابط‌های فیزیکی (پایین‌دست) متصل به رابط batadv باید توسط کاربر به‌گونه‌ای پیکربندی شوند که از انتقال بسته‌های اترنت تک‌پخشی و پخش همگانی میان گره‌های متصل به آن پشتیبانی کنند. متداول‌ترین دلیل کار نکردن مش batman-adv پیکربندی نادرست رابط‌های فیزیکی، سخت‌افزار، سفت‌افزار یا باگ‌های درایور است که مانع تبادل صحیح برخی از انواع بسته‌ها می‌شود. .PP وضعیت فعلی رابط را می‌توان با استفاده از جدول‌های اشکال‌زدایی بررسی کرد. اغلب بررسی این نکته سودمند است که بسته‌های اکتشافی از کدام همسایگان مستقیم دریافت شده‌اند. مرحله بعدی بررسی مسیرهای (ارجح) به سمت مبداها است. این مسیرها تنها زمانی شکل می‌گیرند که سنجه شبکه اتصالات دوطرفه میان همسایگان را شناسایی کرده باشد و ممکن است بسته‌های اکتشافی را از گره‌ها/مبداهایی که مستقیماً در دسترس نیستند فوروارد کرده باشد. .PP .in +4n .EX # get list of neighbors from which the current node was able to receive discovery packets .RB "$" " batctl meshif bat0 neighbors" # get (preferred) routes the routing algorithm found .RB "$" " batctl meshif bat0 originators" .EE .in .PP اگر دیگر نیازی به استفاده از رابط bat0 در سیستم نباشد، می‌توان آن را نابود کرد: .PP .in +4n .EX # destroy the interface and let the system remove its state .RB "$" " batctl meshif bat0 interface destroy" .EE .in .SH "فایل‌ها (FILES)" .TP \fBbat-hosts\fP این فایل شبیه به فایل ‎/etc/hosts است. می‌توانید در هر سطر یک نشانی MAC و یک نام میزبان بنویسید. ابزار batctl برای یافتن bat-hosts در ‎/etc، پوشه خانگی شما و پوشه فعلی جستجو می‌کند. اطلاعات یافت‌شده برای تطبیق نشانی MAC با نام میزبان ارائه‌شده توسط شما یا جایگزینی نشانی‌های MAC در خروجی‌های اشکال‌زدایی و گزارش‌ها استفاده می‌شود. به خاطر سپردن نام میزبان بسیار آسان‌تر از نشانی‌های MAC است. .SH "همچنین ببینید (SEE ALSO)" .BR bridge (8), .BR dmesg (1), .BR ip (8), .BR ip-link (8), .BR ping (8), .BR tcpdump (8), .BR traceroute (1), .BR trace-cmd (1) .SH "نویسندگان (AUTHORS)" ابزار batctl توسط Andreas Langer و Marek Lindner نوشته شده است. .PP این صفحه راهنما توسط Simon Wunderlich ، Marek Lindner و Andrew Lunn نوشته شده است.