.TH ifplugd 8 User Manuals
.SH "نام (NAME)"
ifplugd \- دیمن تشخیص وضعیت اتصال برای دستگاه‌های اترنت
.SH "خلاصه دستور (SYNOPSIS)"
\fBifplugd\f1 [\fIگزینه‌ها\f1]
.SH "توضیحات (DESCRIPTION)"
برنامه \fBifplugd\f1 دیمنی است که با متصل شدن کابل شبکه، دستگاه اترنت شما را به‌طور خودکار پیکربندی کرده و با کشیده شدن کابل، پیکربندی آن را حذف می‌کند. این قابلیت به‌ویژه در لپ‌تاپ‌های دارای کارت شبکه داخلی بسیار مفید است، زیرا رابط شبکه را تنها در زمانی پیکربندی می‌کند که کابل واقعاً متصل باشد.

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

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

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

\fI/var/run/ifplugd.<iface>.pid\f1: فایل شناسه فرآیند (PID) برای \fBifplugd\f1.
.SH "متغیرهای محیطی (ENVIRONMENT)"
اسکریپت عملیات با دو متغیر محیطی تنظیم‌شده زیر فراخوانی می‌شود:

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

\fIIFPLUGD_CURRENT\f1 وضعیت کنونی اتصال. برای مقادیر ممکن به توضیحات بالا مراجعه کنید.
.SH "سیگنال‌ها (SIGNALS)"
\fISIGINT, SIGTERM\f1 برنامه \fBifplugd\f1 خارج می‌شود و در صورت امکان اسکریپت خاموش‌سازی را اجرا می‌کند. این سیگنال با ارسال گزینه \fB\-k\f1 به \fBifplugd\f1 فرستاده می‌شود.

\fISIGQUIT\f1 برنامه \fBifplugd\f1 خارج می‌شود و اسکریپت خاموش‌سازی هرگز اجرا نخواهد شد.

\fISIGHUP\f1 برنامه \fBifplugd\f1 اطلاعات وضعیت خود را در syslog می‌نویسد. این سیگنال با ارسال گزینه \fB\-z\f1 فرستاده می‌شود.

\fISIGUSR1\f1 برنامه \fBifplugd\f1 به حالت تعلیق می‌رود (\fB\-S\f1).

\fISIGUSR2\f1 برنامه \fBifplugd\f1 از حالت تعلیق خارج شده و فعالیت خود را از سر می‌گیرد (\fB\-R\f1).
.SH "نویسندگان (AUTHORS)"
برنامه \fBifplugd\f1 توسط Lennart Poettering <mzvscyhtq (at) 0pointer (dot) de> نوشته شده است. این برنامه در نشانی زیر در دسترس است:
.br
\fBhttp://0pointer.de/lennart/projects/ifplugd\f1
.SH "همچنین ببینید (SEE ALSO)"
\fBifplugd.conf\f1(5)، \fBifup\f1(8)، \fBinterfaces\f1(5)، \fBifconfig\f1(8)، \fBifplugstatus\f1(8)
.SH "توضیحات تکمیلی (COMMENTS)"
این صفحه راهنما با استفاده از \fBxmltoman\f1(1) توسط Oliver Kurth نوشته شده است.