.TH ifplugstatus 8 User Manuals
.SH "نام (NAME)"
ifplugstatus \- ابزار بررسی وضعیت اتصال کابل و پیوند کارت شبکه
.SH "خلاصه دستور (SYNOPSIS)"
\fBifplugstatus\f1 [\fIگزینه‌ها\f1] [\fIواسط\f1]
.SH "توضیحات (DESCRIPTION)"
برنامه \fBifplugstatus\f1 ابزاری است که می‌تواند برای تشخیص وضعیت پیوند (اتصال) یک دستگاه اترنت محلی لینوکس، تقریباً به همان شیوه‌ای که ابزارهای \fBmii-diag\f1، \fBmii-tool\f1 و \fBethtool\f1 کار می‌کنند، استفاده شود. در واقع این ابزار از هر سه رابط برنامه‌نویسی کاربردی (API) متفاوتی که این سه ابزار به کار می‌برند پشتیبانی می‌کند. علاوه بر این، از بررسی وضعیت اتصال با استفاده از پرچم واسط \fIIFF_RUNNING\f1 (که بیشتر درایورهای امروزی، نه فقط اترنت، از آن پشتیبانی می‌کنند) و همچنین بررسی وضعیت ارتباط با استفاده از API افزونه‌های بی‌سیم (wireless extension) برای دستگاه‌های WLAN پشتیبانی می‌کند.
.PP
این APIها به ترتیب زیر آزمایش می‌شوند:
.PP
نخست، جدیدترین API:
\fISIOCETHTOOL\f1
(معروف به ethtool API)
.PP
دوم، API قدیمی‌تر بعدی:
\fISIOCGMIIREG\f1
(معروف به mii-diag API)
.PP
سپس API مربوط به شبکه بی‌سیم (WLAN):
\fIwireless extension\f1
(معروف به iwconfig API)
.PP
و در ادامه، تمیزترین API:
\fIIFF_RUNNING\f1
(معروف به ifconfig API)
.PP
قدیمی‌ترین API یعنی
(\fISIOCPRIV\f1
معروف به mii-tool API)
آزمایش نمی‌شود زیرا منسوخ شده است.
.PP
از \fBifplugstatus\f1 می‌توان در اسکریپت‌های شل استفاده کرد زیرا وضعیت کنونی را به عنوان مقدار بازگشتی بازمی‌گرداند. این ابزار به‌ویژه برای تشخیص APIهای دردسترس در درایور شبکهٔ استفاده‌شده بسیار مفید است (گزینه
\fB\-v\f1).
.SH "گزینه‌ها (OPTIONS)"
می‌توانید یک دستگاه اترنت را در خط فرمان مشخص کنید. در غیر این صورت، \fBifplugstatus\f1 تمام واسط‌های شبکه موجود را بررسی خواهد کرد.
.TP
\fB\-a | \-\-auto\f1
فعال‌سازی واسط شبکه به‌طور خودکار پیش از پرس‌وجو (پیش‌فرض: غیرفعال).
.TP
\fB\-h | \-\-help\f1
نمایش راهنما.
.TP
\fB\-q | \-\-quiet\f1
کاهش سطح پرگویی به میزان یک واحد. اگر سطح پرگویی کمتر از ۰ باشد، هیچ متنی نمایش داده نمی‌شود و تنها مقدار بازگشتی اهمیت خواهد داشت؛ اگر سطح پرگویی برابر با ۰ باشد، وضعیت به صورت خلاصه نشان داده می‌شود؛ و اگر سطح پرگویی بیشتر از ۰ باشد، اطلاعات تفصیلی درباره API استفاده‌شده ارائه می‌گردد (به‌طور پیش‌فرض سطح پرگویی ۰ است).
.TP
\fB\-v | \-\-verbose\f1
افزایش سطح پرگویی به میزان یک واحد. گزینه
.B \-q
را ببینید.
.TP
\fB\-V | \-\-version\f1
نمایش نسخه برنامه.
.SH "مقادیر بازگشتی (RETURN VALUES)"
.TP
\fI0\f1
موفقیت‌آمیز
.TP
\fI1\f1
شکست یا خطا
.TP
\fI2\f1
ضربان پیوند (اتصال فیزیکی) تشخیص داده شد (تنها هنگامی در دسترس است که واسط مشخص شده باشد)
.TP
\fI3\f1
کابل متصل نیست (قطع شده است) (مشابه حالت قبل، تنها هنگامی در دسترس است که واسط مشخص شده باشد)
.SH "نویسندگان (AUTHORS)"
برنامه \fBifplugstatus\f1 توسط Lennart Poettering <mzvscyhtq (at) 0pointer (dot) de> نوشته شده است. بسته \fBifplugd\f1 در نشانی زیر در دسترس است:
.br
\fBhttp://0pointer.de/lennart/projects/ifplugd\f1
.SH "همچنین ببینید (SEE ALSO)"
\fBmii-diag\f1(8)، \fBmii-tool\f1(8)، \fBethtool\f1(8)، \fBifplugd\f1(8)
.SH "توضیحات تکمیلی (COMMENTS)"
این صفحه راهنما با استفاده از \fBxml2man\f1(1) توسط Oliver Kurth نوشته شده است.