نام (NAME)

ifplugstatus - ابزار بررسی وضعیت اتصال کابل و پیوند کارت شبکه

خلاصه دستور (SYNOPSIS)

ifplugstatus [گزینه‌ها] [واسط]

توضیحات (DESCRIPTION)

برنامه ifplugstatus ابزاری است که می‌تواند برای تشخیص وضعیت پیوند (اتصال) یک دستگاه اترنت محلی لینوکس، تقریباً به همان شیوه‌ای که ابزارهای mii-diag، mii-tool و ethtool کار می‌کنند، استفاده شود. در واقع این ابزار از هر سه رابط برنامه‌نویسی کاربردی (API) متفاوتی که این سه ابزار به کار می‌برند پشتیبانی می‌کند. علاوه بر این، از بررسی وضعیت اتصال با استفاده از پرچم واسط IFF_RUNNING (که بیشتر درایورهای امروزی، نه فقط اترنت، از آن پشتیبانی می‌کنند) و همچنین بررسی وضعیت ارتباط با استفاده از API افزونه‌های بی‌سیم (wireless extension) برای دستگاه‌های WLAN پشتیبانی می‌کند.

این APIها به ترتیب زیر آزمایش می‌شوند:

نخست، جدیدترین API: SIOCETHTOOL (معروف به ethtool API)

دوم، API قدیمی‌تر بعدی: SIOCGMIIREG (معروف به mii-diag API)

سپس API مربوط به شبکه بی‌سیم (WLAN): wireless extension (معروف به iwconfig API)

و در ادامه، تمیزترین API: IFF_RUNNING (معروف به ifconfig API)

قدیمی‌ترین API یعنی (SIOCPRIV معروف به mii-tool API) آزمایش نمی‌شود زیرا منسوخ شده است.

از ifplugstatus می‌توان در اسکریپت‌های شل استفاده کرد زیرا وضعیت کنونی را به عنوان مقدار بازگشتی بازمی‌گرداند. این ابزار به‌ویژه برای تشخیص APIهای دردسترس در درایور شبکهٔ استفاده‌شده بسیار مفید است (گزینه -v).

گزینه‌ها (OPTIONS)

می‌توانید یک دستگاه اترنت را در خط فرمان مشخص کنید. در غیر این صورت، ifplugstatus تمام واسط‌های شبکه موجود را بررسی خواهد کرد.

-a | --auto

فعال‌سازی واسط شبکه به‌طور خودکار پیش از پرس‌وجو (پیش‌فرض: غیرفعال).

-h | --help

نمایش راهنما.

-q | --quiet

کاهش سطح پرگویی به میزان یک واحد. اگر سطح پرگویی کمتر از ۰ باشد، هیچ متنی نمایش داده نمی‌شود و تنها مقدار بازگشتی اهمیت خواهد داشت؛ اگر سطح پرگویی برابر با ۰ باشد، وضعیت به صورت خلاصه نشان داده می‌شود؛ و اگر سطح پرگویی بیشتر از ۰ باشد، اطلاعات تفصیلی درباره API استفاده‌شده ارائه می‌گردد (به‌طور پیش‌فرض سطح پرگویی ۰ است).

-v | --verbose

افزایش سطح پرگویی به میزان یک واحد. گزینه -q را ببینید.

-V | --version

نمایش نسخه برنامه.

مقادیر بازگشتی (RETURN VALUES)

0

موفقیت‌آمیز

1

شکست یا خطا

2

ضربان پیوند (اتصال فیزیکی) تشخیص داده شد (تنها هنگامی در دسترس است که واسط مشخص شده باشد)

3

کابل متصل نیست (قطع شده است) (مشابه حالت قبل، تنها هنگامی در دسترس است که واسط مشخص شده باشد)

نویسندگان (AUTHORS)

برنامه ifplugstatus توسط Lennart Poettering <mzvscyhtq (at) 0pointer (dot) de> نوشته شده است. بسته ifplugd در نشانی زیر در دسترس است:
http://0pointer.de/lennart/projects/ifplugd

همچنین ببینید (SEE ALSO)

mii-diag(8)، mii-tool(8)، ethtool(8)، ifplugd(8)

توضیحات تکمیلی (COMMENTS)

این صفحه راهنما با استفاده از xml2man(1) توسط Oliver Kurth نوشته شده است.