.\"#############################################################################
.\"$Id: ipmidetect.8.pre.in,v 1.17 2010-06-30 21:56:36 chu11 Exp $
.\"#############################################################################
.\"  Copyright (C) 2007-2015 Lawrence Livermore National Security, LLC.
.\"  Copyright (C) 2007 The Regents of the University of California.
.\"  Produced at Lawrence Livermore National Laboratory (cf, DISCLAIMER).
.\"  Written by Albert Chu <chu11@llnl.gov>
.\"  UCRL-CODE-228523
.\"
.\"  This file is part of Ipmidetect, tools and libraries for detecting
.\"  IPMI nodes in a cluster. For details, see http://www.llnl.gov/linux.
.\"
.\"  Ipmidetect is free software; you can redistribute it and/or modify it under
.\"  the terms of the GNU General Public License as published by the Free
.\"  Software Foundation; either version 3 of the License, or (at your option)
.\"  any later version.
.\"
.\"  Ipmidetect is distributed in the hope that it will be useful, but WITHOUT
.\"  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
.\"  FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
.\"  for more details.
.\"
.\"  You should have received a copy of the GNU General Public License along
.\"  with Ipmidetect.  If not, see <http://www.gnu.org/licenses>.
.\"############################################################################
.TH Ipmidetect 8 "2026-08-27" "Ipmidetect 1.6.19" "Ipmidetect"
.SH "نام (NAME)"
ipmidetect \- فهرست کردن رابط‌های IPMI شناسایی‌شده و/یا شناسایی‌نشده در یک کلاستر
.SH "خلاصه دستور (SYNOPSIS)"
.B ipmidetect
[\fIOPTION\fR...] [\fINODES\fR...]
.br
.SH "توضیحات (DESCRIPTION)"
دستور
.B ipmidetect
فهرست می‌کند که کدام گره‌های IPMI در یک کلاستر شناسایی شده یا شناسایی‌نشده‌اند. این اطلاعات توسط کتابخانه
.B libipmidetect(3)
و دیمن
.B ipmidetectd(8)
فراهم می‌شود.
.LP
دستور
.B ipmidetect
وضعیت هر گره IPMI پیکربندی‌شده با
.B ipmidetectd(8)
را در خروجی نمایش می‌دهد مگر اینکه گره‌ها در خط فرمان مشخص شده باشند. اگر نخستین گره فهرست‌شده "-" باشد، گره‌ها از ورودی استاندارد خوانده می‌شوند. گره‌ها می‌توانند در قالب محدوده میزبان (hostrange)، فهرست‌های جداشده با کاما، یا فهرست‌های جداشده با فاصله مشخص شوند. برای دستورالعمل‌های نحوه فهرست کردن میزبان‌ها در قالب محدوده، بخش «پشتیبانی از محدوده میزبان (HOSTRANGED SUPPORT)» را در ادامه ببینید. نام‌های میزبان درج‌شده باید نام‌های کوتاه میزبان باشند.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-h\fR \fISTRING\fR, \fB\-\-hostname\fR=\fISTRING\fR
نام میزبان سرور (پیش‌فرض=localhost)
.TP
\fB\-p\fR \fIINT\fR, \fB\-\-port\fR=\fIINT\fR
درگاه سرور (پیش‌فرض=8649)
.TP
\fB\-d\fR, \fB\-\-detected\fR
تنها گره‌های شناسایی‌شده را فهرست می‌کند
.TP
\fB\-u\fR, \fB\-\-undetected\fR
تنها گره‌های شناسایی‌نشده را فهرست می‌کند
.TP
\fB\-q\fR, \fB\-\-hostrange\fR
فهرست کردن گره‌ها در قالب محدوده میزبان (پیش‌فرض)
.TP
\fB\-c\fR, \fB\-\-comma\fR
فهرست کردن گره‌ها در فهرستی جداشده با کاما
.TP
\fB\-n\fR, \fB\-\-newline\fR
فهرست کردن گره‌ها در فهرستی جداشده با خط جدید
.TP
\fB\-s\fR, \fB\-\-space\fR
فهرست کردن گره‌ها در فهرستی جداشده با فاصله
.TP
\fB\-V\fR, \fB\-\-version\fR
چاپ نسخه برنامه و خروج
.LP
.SH "پشتیبانی از محدوده میزبان (HOSTRANGED SUPPORT)"
چندین میزبان را می‌توان به عنوان یک فهرست صریح از نام میزبان‌ها که با کاما از هم جدا شده‌اند، یا به صورت محدوده‌ای از نام‌های میزبان در قالب کلی زیر وارد کرد:
prefix[n-m,l-k,...] که در آن n < m و l < k و غیره است. قالب اخیر نباید با کلاس‌های نویسه‌ای عبارات باقاعده (که با [] نیز نشان داده می‌شوند) اشتباه گرفته شود. برای نمونه، foo[19] نشان‌دهنده foo1 یا foo9 نیست، بلکه یک محدوده تک‌عضوی است: foo19.
.LP
این نحو محدوده صرفاً برای راحتی کار در خوشه‌هایی با قرارداد نام‌گذاری prefixNN در نظر گرفته شده است و مشخص کردن محدوده‌ها ضروری نیست -- فهرست foo1,foo9 را می‌توان به همین صورت یا با محدوده foo[1,9] مشخص کرد.
.LP
چند نمونه از کاربرد محدوده در زیر آمده است:
.nf
    foo[01-05] به جای foo01,foo02,foo03,foo04,foo05
    foo[7,9-10] به جای foo7,foo9,foo10
    foo[0-3] به جای foo0,foo1,foo2,foo3
.fi
.LP
به عنوان یادآوری، برخی پوسته‌ها براکت‌ها ([ و ]) را برای تطبیق الگو (pattern matching) تفسیر می‌کنند. بسته به پوسته شما، ممکن است لازم باشد فهرست‌های دامنه‌ای را داخل گیومه قرار دهید.
.SH "عیب‌یابی (DIAGNOSTICS)"
مقدار خروج دستور
.B ipmidetect
به گزینه‌های اجراشده در خط فرمان بستگی دارد. اگر از خروجی پیش‌فرض استفاده شود، در صورتی که دستور بدون خطا با موفقیت اجرا شود، مقدار خروج ۰ خواهد بود. اگر از گزینه
.B \-\-detected
استفاده شود و هیچ گره شناسایی‌نشده‌ای یافت نشود، مقدار خروج ۰ خواهد بود. اگر گره‌های شناسایی‌نشده‌ای یافت شوند، مقدار خروج ۱ خواهد بود. اگر از گزینه
.B \-\-undetected
استفاده شود و هیچ گره شناسایی‌شده‌ای یافت نشود، مقدار خروج ۰ خواهد بود. اگر گره‌های شناسایی‌شده‌ای یافت شوند، مقدار خروج ۱ خواهد بود. در صورت بروز خطا، مقدار خروج ۲ خواهد بود.
.SH "گزارش باگ‌ها (REPORTING BUGS)"
گزارش باگ‌ها را به <freeipmi\-users@gnu.org> یا <freeipmi\-devel@gnu.org> ارسال کنید.
.SH "حق نشر (COPYRIGHT)"
حق نشر \(co 2007-2015 Lawrence Livermore National Security, LLC.
.br
حق نشر \(co 2007 The Regents of the University of California.
.PP
این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط اجازه‌نامه عمومی همگانی گنو (GNU GPL) که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، چه نسخه ۳ اجازه‌نامه و چه (به انتخاب خودتان) هر نسخه بالاتری، بازتوزیع کرده یا تغییر دهید.
.SH "همچنین ببینید (SEE ALSO)"
libipmidetect(3), ipmidetect.conf(5), ipmidetectd(8)
.PP
http://www.gnu.org/software/freeipmi