نام (NAME)

ifplugd - دیمن تشخیص وضعیت اتصال برای دستگاه‌های اترنت

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

ifplugd [گزینه‌ها]

توضیحات (DESCRIPTION)

برنامه ifplugd دیمنی است که با متصل شدن کابل شبکه، دستگاه اترنت شما را به‌طور خودکار پیکربندی کرده و با کشیده شدن کابل، پیکربندی آن را حذف می‌کند. این قابلیت به‌ویژه در لپ‌تاپ‌های دارای کارت شبکه داخلی بسیار مفید است، زیرا رابط شبکه را تنها در زمانی پیکربندی می‌کند که کابل واقعاً متصل باشد.

این دیمن از برنامه‌های بومی توزیع شما مانند ifup و ifdown استفاده می‌کند، اما می‌توان آن را طوری پیکربندی کرد که هنگام تغییر وضعیت رابط، هر عملیاتی را که مایل باشید اجرا کند. همچنین می‌تواند قطعی‌های کوتاه‌مدت کابل (با گزینه -d) یا اتصالات کوتاه‌مدت (با گزینه -u) را نادیده بگیرد.

با مشخص کردن گزینه -F در خط فرمان، می‌توان از ifplugd در «حالت سازگاری» استفاده کرد. در این حالت، ifplugd با درایورهای شبکه‌ای که از پرس‌وجوی ضربان اتصال (link beat) پشتیبانی نمی‌کنند به گونه‌ای رفتار می‌کند که گویی همیشه متصل هستند.

گزینه‌ها (OPTIONS)

-a | --no-auto: رابط شبکه به‌طور خودکار فعال نشود (پیش‌فرض: غیرفعال).
-n | --no-daemon: به حالت دیمن (پس‌زمینه) نرود؛ مناسب برای عیب‌یابی (پیش‌فرض: غیرفعال).
-s | --no-syslog: به‌جای لاگ سیستم (syslog)، از خروجی استاندارد (stdout) استفاده شود؛ مناسب برای عیب‌یابی (پیش‌فرض: غیرفعال).
-b | --no-beep: بوق هشدار صوتی نزند (غیرفعال).
-f | --ignore-fail: خطای تشخیص نادیده گرفته شود و مجدداً تلاش کند. خطا به عنوان «عدم اتصال» در نظر گرفته می‌شود (پیش‌فرض: غیرفعال).
-F | --ignore-fail-positive: خطای تشخیص نادیده گرفته شود و مجدداً تلاش کند. خطا به عنوان «اتصال برقرار است» در نظر گرفته می‌شود (پیش‌فرض: غیرفعال).
-i | --iface=IFACE: مشخص کردن رابط اترنت (پیش‌فرض: eth0).
-r | --run=EXEC: تعیین برنامه‌ای که هنگام تغییر وضعیت اتصال اجرا شود (پیش‌فرض: /etc/ifplugd/ifplugd.action).
-I | --ignore-retval: در صورت بازگرداندن مقدار خروج غیرصفر توسط برنامه اجراشده هنگام تغییر وضعیت، خارج نشود (پیش‌فرض: غیرفعال).
-t | --poll-time=SECS: تعیین زمان بررسی وضعیت (poll) بر حسب ثانیه (پیش‌فرض: ۱).
-u | --delay-up=SECS: تعیین تاخیر پیش از پیکربندی رابط پس از برقراری اتصال (پیش‌فرض: ۰).
-d | --delay-down=SECS: تعیین تاخیر پیش از حذف پیکربندی رابط پس از قطع اتصال (پیش‌فرض: ۵).
-m | --api-mode=MODE: اجبار به استفاده از یک API خاص ioctl() برای تشخیص ضربان اتصال. مقادیر مجاز عبارتند از: auto (تشخیص خودکار)، iff (فلگ رابط IFF_RUNNING)، wlan (اکستنشن بی‌سیم)، ethtool (واسط SIOCETHTOOL)، mii (واسط SIOCGMIIREG) و priv (واسط SIOCPRIV). تنها حرف اول آرگومان ملاک است و به بزرگ یا کوچک بودن حروف حساس نیست (پیش‌فرض: auto).
-p | --no-startup: هنگام راه‌اندازی دیمن، اسکریپت فعال‌سازی شبکه فراخوانی نشود (پیش‌فرض: غیرفعال).
-q | --no-shutdown: هنگام خروج دیمن، اسکریپت قطع شبکه فراخوانی نشود (پیش‌فرض: غیرفعال).
-w | --wait-on-fork: هنگام رفتن به حالت دیمن، تا پایان تشخیص اولیه ضربان اتصال توسط فرآیند پس‌زمینه منتظر بماند. در صورت فعال بودن، فرآیند والد وضعیت اتصال را در هنگام خروج بازمی‌گرداند؛ مقدار ۱ به معنای تشخیص اتصال، مقدار ۲ به معنای عدم تشخیص اتصال، و مقادیر دیگر نشانه خطا هستند.
-W | --wait-on-kill: هنگام متوقف کردن یک دیمن در حال اجرا (با گزینه -k)، تا پایان کامل فرآیند دیمن منتظر بماند.
-x | --extra-arg=ARG: تعیین یک آرگومان اضافی برای ارسال به اسکریپت عملیات.
-M | --monitor: در صورت در دسترس نبودن رابط شبکه متوقف نشود، بلکه از NETLINK برای پایش در دسترس قرار گرفتن دستگاه استفاده کند. این گزینه برای دستگاه‌های PCMCIA و موارد مشابه مفید است.
-h | --help: نمایش راهنما.
-k | --kill: متوقف کردن دیمن در حال اجرا (از گزینه -i برای انتخاب نمونه دیمن مورد نظر استفاده کنید).
-c | --check-running: بررسی اینکه آیا دیمنی برای رابط شبکه داده‌شده در حال اجرا است یا خیر. در صورتی که دیمن در حال اجرا باشد مقدار خروج را برابر ۰ و در غیر این صورت برابر ۲۵۵ قرار می‌دهد.
-v | --version: نمایش نسخه برنامه.
-S | --supend: تعلیق یک دیمن در حال اجرا. دیمن تا زمان ازسرگیری مجدد (با گزینه -R) دیگر وضعیت اتصال را بررسی نخواهد کرد (از گزینه -i برای انتخاب نمونه دیمن جهت تعلیق استفاده کنید).
-R | --resume: ازسرگیری یک دیمن معلق‌شده (از گزینه -i برای انتخاب نمونه دیمن جهت ازسرگیری استفاده کنید).
-z | --info: درخواست از دیمن در حال اجرا برای نوشتن اطلاعات وضعیت خود در syslog (از گزینه -i برای انتخاب نمونه دیمن جهت ارسال درخواست استفاده کنید).

فایل‌ها (FILES)

/etc/ifplugd/ifplugd.conf: این فایل توسط اسکریپت راه‌اندازی /etc/init.d/ifplugd خوانده می‌شود و شامل رابط تحت پایش و گزینه‌های مورد استفاده است.

/etc/ifplugd/ifplugd.action: این اسکریپت زمانی که وضعیت رابط تغییر کند توسط دیمن فراخوانی می‌شود. این اسکریپت دو آرگومان می‌گیرد: اولی نام رابط (مانند eth0) و دومی «up» یا «down».

/var/run/ifplugd.<iface>.pid: فایل شناسه فرآیند (PID) برای ifplugd.

متغیرهای محیطی (ENVIRONMENT)

اسکریپت عملیات با دو متغیر محیطی تنظیم‌شده زیر فراخوانی می‌شود:

IFPLUGD_PREVIOUS وضعیت پیشین اتصال. یکی از مقادیر «up»، «down»، «error» یا «disabled». سه مقدار اول مشخص هستند و مقدار آخر هنگام شروع به کار دیمن تنظیم می‌شود.

IFPLUGD_CURRENT وضعیت کنونی اتصال. برای مقادیر ممکن به توضیحات بالا مراجعه کنید.

سیگنال‌ها (SIGNALS)

SIGINT, SIGTERM برنامه ifplugd خارج می‌شود و در صورت امکان اسکریپت خاموش‌سازی را اجرا می‌کند. این سیگنال با ارسال گزینه -k به ifplugd فرستاده می‌شود.

SIGQUIT برنامه ifplugd خارج می‌شود و اسکریپت خاموش‌سازی هرگز اجرا نخواهد شد.

SIGHUP برنامه ifplugd اطلاعات وضعیت خود را در syslog می‌نویسد. این سیگنال با ارسال گزینه -z فرستاده می‌شود.

SIGUSR1 برنامه ifplugd به حالت تعلیق می‌رود (-S).

SIGUSR2 برنامه ifplugd از حالت تعلیق خارج شده و فعالیت خود را از سر می‌گیرد (-R).

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

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

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

ifplugd.conf(5)، ifup(8)، interfaces(5)، ifconfig(8)، ifplugstatus(8)

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

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