." Man page generated from reStructuredText ." by the Docutils 0.23 manpage writer. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \ \n[an-margin] level \n[rst2man-indent-level] level margin: \n[rst2man-indent\n[rst2man-indent-level]] - \n[rst2man-indent0] \n[rst2man-indent1] \n[rst2man-indent2] .. .de1 INDENT ." .rstReportMargin pre: . RS \ . nr rst2man-indent\n[rst2man-indent-level] \n[an-margin] . nr rst2man-indent-level +1 ." .rstReportMargin post: .. .de UNINDENT . RE ." indent \n[an-margin] ." old: \n[rst2man-indent\n[rst2man-indent-level]] .nr rst2man-indent-level -1 ." new: \n[rst2man-indent\n[rst2man-indent-level]] .in \n[rst2man-indent\n[rst2man-indent-level]]u .. .TH "IBNETDISCOVER" "8" "2013-06-22" "" "Open IB Diagnostics" .SH "نام (NAME)" ibnetdiscover \- کشف همبندی (توپولوژی) شبکه اینفینی‌باند .SH "خلاصه دستور (SYNOPSIS)" .sp ibnetdiscover [options] [] .SH "توضیحات (DESCRIPTION)" .sp دستور ibnetdiscover عملیات کشف زیرشبکه IB را انجام داده و یک فایل توپولوژی خوانا برای انسان خروجی می‌دهد. شناسه‌های GUID، انواع گره‌ها و شماره پورت‌ها به همراه LIDهای پورت و NodeDescriptionها نمایش داده می‌شوند. تمام گره‌ها (و پیوندها) نمایش داده می‌شوند (توپولوژی کامل). به صورت اختیاری، این ابزار می‌تواند برای فهرست کردن گره‌های متصل فعلی بر اساس نوع گره استفاده شود. خروجی در خروجی استاندارد چاپ می‌شود، مگر اینکه یک فایل توپولوژی مشخص شده باشد. .SH "گزینه‌ها (OPTIONS)" .sp B\-l, \-\^list P فهرست گره‌های متصل .sp B\-g, \-\^grouping P نمایش گروه‌بندی. گروه‌بندی، گره‌های IB را بر اساس طرح‌های اختصاصی سازندگان مختلف مرتبط می‌کند. همچنین ممکن است تطابق پورت‌های خارجی سوییچ را نشان دهد. .sp B\-H, \-\^Hca_list P فهرست CAهای متصل .sp B\-S, \-\^Switch_list P فهرست سوییچ‌های متصل .sp B\-R, \-\^Router_list P فهرست مسیریاب‌های متصل .sp B\-s, \-\^show P نمایش اطلاعات پیشرفت در طول فرآیند کشف. .sp B\-f, \-\^full P نمایش اطلاعات کامل (سرعت و پهنای پورت‌ها، vlcap) .sp B\-p, \-\^ports P دریافت گزارش پورت‌ها که فهرستی از پورت‌های متصل به همراه اطلاعات مرتبط است (مانند LID، شماره پورت، GUID، پهنا، سرعت و NodeDescription). .sp B\-m, \-\^max_hops P گزارش حداکثر گام‌های (hops) کشف‌شده. ." Define the common option -z . .INDENT 0.0 .TP .B B\-\^outstanding_smps, \-o P تعیین تعداد SMPهای معلقی که باید در طول پویش ارسال شوند .sp پیش‌فرض: 2 .UNINDENT .SS "پرچم‌های فایل حافظه موقت (Cache File flags)" ." Define the common option cache . .sp B\-\^cache P ذخیره داده‌های شبکه ibnetdiscover در فایل مشخص‌شده. این حافظه موقت می‌تواند توسط ابزارهای دیگر برای تحلیل بعدی استفاده شود. ." Define the common option load-cache . .sp B\-\^load\-cache P بارگیری و استفاده از داده‌های ذخیره‌شده ibnetdiscover در فایل مشخص‌شده. برای مشاهده و بررسی سایر ساختارهای شبکه یا وضعیت پیشین ساختار مفید است. ." Define the common option diff . .sp B\-\^diff P بارگیری داده‌های ذخیره‌شده ibnetdiscover و انجام مقایسه تفاضلی با شبکه فعلی یا یک فایل حافظه موقت دیگر. یک خروجی تفاضلی ویژه برای ibnetdiscover نمایش داده خواهد شد که تفاوت‌های میان ساختار پیشین و فعلی را نشان می‌دهد. به طور پیش‌فرض، موارد زیر برای تفاوت‌ها مقایسه می‌شوند: سوییچ‌ها، آداپتورهای کانال، مسیریاب‌ها و اتصالات پورت‌ها. ." Define the common option diffcheck . .sp B\-\^diffcheck P مشخص کردن اینکه چه بررسی‌های تفاضلی باید در گزینه B\-\^diff P بالا انجام شود. چندین کلید بررسی را با کاما جدا کنید. بررسی‌های موجود عبارتند از: Bsw = سوییچ‌ها P، Bca = آداپتورهای کانال P، Brouter P = مسیریاب‌ها، Bport P = اتصالات پورت، Blid P = شناسه‌های LID، Bnodedesc P = توصیف‌های گره. توجه داشته باشید که Bport P، Blid P و Bnodedesc P تنها برای انواع گره‌های مشخص‌شده (مانند Bsw P، Bca P، Brouter P) بررسی می‌شوند. اگر Bport P در کنار Blid P یا Bnodedesc P مشخص شود، LIDها و توصیف‌های پورت‌های دوردست نیز مقایسه خواهند شد. .SS "پرچم‌های انتخاب پورت (Port Selection flags)" ." Define the common option -C . .sp B\-C, \-\^Ca P استفاده از ca_name مشخص‌شده. ." Define the common option -P . .sp B\-P, \-\^Port P استفاده از ca_port مشخص‌شده. ." Define the common option -Y . .INDENT 0.0 .TP .B B\-Y, \-\^pkey\-idx P شاخص جدول P_Key (از 0 تا 65535، پیش‌فرض 0) مورد استفاده برای MADهای خروجی SA/GMP. بسته‌های SMP MAD همیشه از شاخص P_Key برابر با 0 استفاده می‌کنند. .UNINDENT ." Explanation of local port selection . .SS "انتخاب پورت محلی (Local port Selection)" .sp پشتیبانی از چند پورت/چند CA: هنگامی که هیچ دستگاه یا پورت IB مشخص نشده باشد، کتابخانه libibumad پورت مورد استفاده را بر اساس معیارهای زیر انتخاب می‌کند: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 نخستین پورتی که ACTIVE باشد. .IP 2. 3 در صورت نیافتن، نخستین پورتی که UP باشد (پیوند فیزیکی برقرار باشد). .UNINDENT .sp اگر پورت و/یا نام CA مشخص شده باشد، کتابخانه libibumad تلاش می‌کند درخواست کاربر را برآورده سازد و در صورت عدم امکان شکست خواهد خورد. .sp برای نمونه: .INDENT 0.0 .INDENT 3.5 .sp .EX ibaddr # استفاده از نخستین پورت (معیار ۱ در بالا) ibaddr \-C mthca1 # انتخاب بهترین پورت تنها از "mthca1" ibaddr \-P 2 # استفاده از پورت دوم (فعال/بالا) از نخستین دستگاه IB موجود ibaddr \-C mthca0 \-P 2 # تنها استفاده از پورت مشخص‌شده .EE .UNINDENT .UNINDENT .UNINDENT .UNINDENT .SS "پرچم‌های پیکربندی (Configuration flags)" ." Define the common option -z . .sp B\-\^config, \-z P تعیین فایل پیکربندی جایگزین. .INDENT 0.0 .INDENT 3.5 پیش‌فرض: /etc/infiniband\-diags/ibdiag.conf .UNINDENT .UNINDENT ." Define the common option -z . .INDENT 0.0 .TP .B B\-\^outstanding_smps, \-o P تعیین تعداد SMPهای معلقی که باید در طول پویش ارسال شوند .sp پیش‌فرض: 2 .UNINDENT ." Define the common option --node-name-map . .sp B\-\^node\-name\-map P تعیین فایل نگاشت نام گره. .INDENT 0.0 .INDENT 3.5 این فایل GUIDها را به نام‌های کاربرپسندتر نگاشت می‌کند. بخش FILES را ببینید. .UNINDENT .UNINDENT ." Define the common option -t . .sp B\-t, \-\^timeout P بازتعریف مهلت زمانی پیش‌فرض برای MADهای درخواستی. ." Define the common option -y . .INDENT 0.0 .TP .B B\-y, \-\^m_key P استفاده از M_key مشخص‌شده برای درخواست‌ها. اگر مقدار غیرعددی (مانند 'x') مشخص شود، مقدار از کاربر پرسیده خواهد شد. .UNINDENT .SS "پرچم‌های اشکال‌زدایی (Debugging flags)" ." Define the common option -d . .INDENT 0.0 .TP .B \-d افزایش سطح اشکال‌زدایی IB. می‌تواند چندین بار استفاده شود (\-ddd یا \-d \-d \-d). .UNINDENT ." Define the common option -e . .INDENT 0.0 .TP .B \-e نمایش خطاهای ارسال و دریافت (اتمام مهلت زمانی و موارد دیگر) .UNINDENT ." Define the common option -h . .sp B\-h, \-\^help P نمایش پیام راهنما ." Define the common option -v . .INDENT 0.0 .TP .B B\-v, \-\^verbose P افزایش سطح پرگویی و جزئیات برنامه. می‌تواند چندین بار استفاده شود (\-vv یا \-v \-v \-v) .UNINDENT ." Define the common option -V . .sp B\-V, \-\^version P نمایش اطلاعات نسخه. .SH "فایل‌ها (FILES)" ." Common text for the config file . .SS "فایل پیکربندی (CONFIG FILE)" .sp /etc/infiniband\-diags/ibdiag.conf .sp یک فایل پیکربندی سراسری برای تنظیم برخی گزینه‌های مشترک تمامی ابزارها ارائه شده است. برای جزئیات، فایل پیکربندی ارائه‌شده را ببینید. ." Common text to describe the node name map file. . .SS "قالب فایل نگاشت نام گره (NODE NAME MAP FILE FORMAT)" .sp نگاشت نام گره برای مشخص کردن نام‌های کاربرپسند برای گره‌ها در خروجی استفاده می‌شود. از GUIDها برای انجام جستجو استفاده می‌گردد. .sp این قابلیت توسط بسته opensm\-libs ارائه می‌شود. برای مکان فایل در نصب خود به Bopensm(8) P مراجعه کنید. .sp Bبه طور عمومی: P .INDENT 0.0 .INDENT 3.5 .sp .EX # comment "" .EE .UNINDENT .UNINDENT .sp Bمثال: P .INDENT 0.0 .INDENT 3.5 .sp .EX # IB1 # Line cards 0x0008f104003f125c "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f125d "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d2 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10d3 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D" 0x0008f104003f10bf "IB1 (Rack 11 slot 12 ) ISR9288/ISR9096 Voltaire sLB\-24D" # Spines 0x0008f10400400e2d "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2e "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e2f "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e31 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" 0x0008f10400400e32 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D" # GUID Node Name 0x0008f10400411a08 "SW1 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a28 "SW2 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a34 "SW3 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f104004119d0 "SW4 (Rack 3) ISR9024 Voltaire 9024D" .EE .UNINDENT .UNINDENT ." Common text to describe the Topology file. . .SS "قالب فایل توپولوژی (TOPOLOGY FILE FORMAT)" .sp قالب فایل توپولوژی برای انسان خوانا و تا حد زیادی شهودی است. اکثر شناسه‌ها دارای نام‌های متنی هستند مانند شناسه سازنده (vendid)، شناسه دستگاه (devid)، انواع GUIDها (مانند sysimgguid، caguid، switchguid و غیره). PortGUIDها در پرانتز () نمایش داده می‌شوند. برای سوییچ‌ها، این مورد در خط switchguid نشان داده می‌شود. برای پورت‌های CA و مسیریاب، در خطوط اتصال نشان داده می‌شود. گره IB مشخص شده و به دنبال آن تعداد پورت‌ها و GUID گره داخل نقل‌قول می‌آید. در سمت راست این خط یک کامنت (#) و به دنبال آن NodeDescription داخل نقل‌قول قرار دارد. اگر گره یک سوییچ باشد، این خط همچنین مشخص می‌کند که پورت ۰ سوییچ پایه است یا پیشرفته، و LID و LMC پورت ۰ را نشان می‌دهد. خطوط بعدی مربوط به این گره اتصالات را نشان می‌دهند. در سمت چپ شماره پورت گره فعلی قرار دارد. در سمت راست گره همتا (گره در سر دیگر پیوند) قرار دارد. این گره با نوع گره داخل نقل‌قول و به دنبال آن \- و NodeGUID به همراه شماره پورت در قلاب [] مشخص می‌شود. در سمت راست‌تر یک کامنت (#) قرار دارد. آنچه پس از کامنت می‌آید بستگی به نوع گره دارد. اگر گره سوییچ باشد، NodeDescription داخل نقل‌قول و LID گره همتا می‌آید. اگر گره CA یا مسیریاب باشد، LID و LMC محلی و سپس NodeDescription داخل نقل‌قول و LID گره همتا می‌آید. پهنا و سرعت پیوند فعال نیز به انتهای این خط خروجی اضافه می‌شود. .sp نمونه‌ای از آن: .INDENT 0.0 .INDENT 3.5 .sp .EX # # Topology file: generated on Tue Jun 5 14:15:10 2007 # # Max of 3 hops discovered # Initiated from node 0008f10403960558 port 0008f10403960559 Non\-Chassis Nodes vendid=0x8f1 devid=0x5a06 sysimgguid=0x5442ba00003000 switchguid=0x5442ba00003080(5442ba00003080) Switch 24 "S\-005442ba00003080" # "ISR9024 Voltaire" base port 0 lid 6 lmc 0 [22] "H\-0008f10403961354"[1](8f10403961355) # "MT23108 InfiniHost Mellanox Technologies" lid 4 4xSDR [10] "S\-0008f10400410015"[1] # "SW\-6IB4 Voltaire" lid 3 4xSDR [8] "H\-0008f10403960558"[2](8f1040396055a) # "MT23108 InfiniHost Mellanox Technologies" lid 14 4xSDR [6] "S\-0008f10400410015"[3] # "SW\-6IB4 Voltaire" lid 3 4xSDR [12] "H\-0008f10403960558"[1](8f10403960559) # "MT23108 InfiniHost Mellanox Technologies" lid 10 4xSDR vendid=0x8f1 devid=0x5a05 switchguid=0x8f10400410015(8f10400410015) Switch 8 "S\-0008f10400410015" # "SW\-6IB4 Voltaire" base port 0 lid 3 lmc 0 [6] "H\-0008f10403960984"[1](8f10403960985) # "MT23108 InfiniHost Mellanox Technologies" lid 16 4xSDR [4] "H\-005442b100004900"[1](5442b100004901) # "MT23108 InfiniHost Mellanox Technologies" lid 12 4xSDR [1] "S\-005442ba00003080"[10] # "ISR9024 Voltaire" lid 6 1xSDR [3] "S\-005442ba00003080"[6] # "ISR9024 Voltaire" lid 6 4xSDR vendid=0x2c9 devid=0x5a44 caguid=0x8f10403960984 Ca 2 "H\-0008f10403960984" # "MT23108 InfiniHost Mellanox Technologies" [1](8f10403960985) "S\-0008f10400410015"[6] # lid 16 lmc 1 "SW\-6IB4 Voltaire" lid 3 4xSDR vendid=0x2c9 devid=0x5a44 caguid=0x5442b100004900 Ca 2 "H\-005442b100004900" # "MT23108 InfiniHost Mellanox Technologies" [1](5442b100004901) "S\-0008f10400410015"[4] # lid 12 lmc 1 "SW\-6IB4 Voltaire" lid 3 4xSDR vendid=0x2c9 devid=0x5a44 caguid=0x8f10403961354 Ca 2 "H\-0008f10403961354" # "MT23108 InfiniHost Mellanox Technologies" [1](8f10403961355) "S\-005442ba00003080"[22] # lid 4 lmc 1 "ISR9024 Voltaire" lid 6 4xSDR vendid=0x2c9 devid=0x5a44 caguid=0x8f10403960558 Ca 2 "H\-0008f10403960558" # "MT23108 InfiniHost Mellanox Technologies" [2](8f1040396055a) "S\-005442ba00003080"[8] # lid 14 lmc 1 "ISR9024 Voltaire" lid 6 4xSDR [1](8f10403960559) "S\-005442ba00003080"[12] # lid 10 lmc 1 "ISR9024 Voltaire" lid 6 1xSDR .EE .UNINDENT .UNINDENT .sp هنگامی که از گروه‌بندی استفاده می‌شود، گره‌های IB در شاسی‌هایی سازماندهی می‌شوند که شماره‌گذاری شده‌اند. گره‌هایی که نتوان حضور آن‌ها را در یک شاسی تعیین کرد، با عنوان "Non\-Chassis Nodes" نمایش داده می‌شوند. پورت‌های خارجی نیز روی خطوط اتصال نمایش داده می‌شوند. .SH "نویسندگان (AUTHORS)" .INDENT 0.0 .TP .B Hal Rosenstock < \% > .TP .B Ira Weiny < \% > .UNINDENT ." End of generated man page.