نام (NAME)

nm-online - پرسش از NetworkManager درباره متصل بودن شبکه

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

nm-online [گزینه‌ها...]

توضیحات (DESCRIPTION)

دستور nm-online ابزاری برای آگاهی از متصل بودن سیستم به اینترنت و شبکه (آنلاین بودن) است. این کار با استعلام وضعیت از NetworkManager انجام می‌پذیرد. هنگام اجرا، nm-online منتظر می‌ماند تا NetworkManager یک اتصال فعال را گزارش دهد، یا مهلت زمانی مشخص‌شده منقضی شود. هنگام خروج، کد وضعیت بازگردانده‌شده باید بررسی شود (کدهای بازگشتی را در ادامه مشاهده کنید).

فراخوانی مستقیم این ابزار چندان متداول نیست. با این حال، توسط سرویس NetworkManager-wait-online.service همراه با آرگومان --wait-for-startup استفاده می‌شود (به NetworkManager-wait-online.service(8) مراجعه کنید).

به طور پیش‌فرض، اتصالات دارای ویژگی‌های ipv4.may-fail و ipv6.may-fail تنظیم‌شده روی yes هستند؛ این بدان معناست که NetworkManager منتظر می‌ماند تا پیکربندی یکی از این دو خانواده آدرس کامل شود و سپس اتصال را فعال‌شده تلقی می‌کند. اگر نیاز دارید که قبل از رسیدن به network-online.target یک خانواده آدرس خاص پیکربندی شده باشد، ویژگی may-fail مربوطه را روی no تنظیم کنید.

گزینه‌ها (OPTIONS)

-h | --help

چاپ اطلاعات راهنما.

-q | --quiet

عدم چاپ هرگونه خروجی در ترمینال.

-s | --wait-for-startup

انتظار برای تکمیل فرایند راه‌اندازی NetworkManager، به جای انتظار اختصاصی برای برقراری اتصال شبکه. راه‌اندازی زمانی کامل تلقی می‌شود که NetworkManager تمام اتصال‌های خودفعال‌شونده‌ای (auto-activate) را که با توجه به وضعیت فعلی شبکه در دسترس هستند، فعال کرده باشد (یا برای فعال‌سازی آن‌ها تلاش کرده باشد). این لحظه منطبق بر زمانی است که NetworkManager پیام "startup complete" را ثبت می‌کند. این حالت معمولاً فقط در زمان بالا آمدن سیستم (بوت) کاربرد دارد. پس از اتمام فرایند راه‌اندازی اولیه، اجرای nm-online -s صرف‌نظر از وضعیت فعلی شبکه بلافاصله بازمی‌گردد.

روش‌های گوناگونی برای تاثیرگذاری بر زمان رسیدن به startup complete وجود دارد. برای جزئیات بیشتر به NetworkManager-wait-online.service(8) مراجعه کنید.

-t | --timeout ثانیه

مدت زمان انتظار برای برقراری اتصال بر حسب ثانیه. اگر این گزینه تعیین نشود، متغیر محیطی NM_ONLINE_TIMEOUT در نظر گرفته می‌شود. مهلت پیش‌فرض ۳۰ ثانیه است.

-x | --exit

اگر NetworkManager در حال اجرا نباشد یا در حال اتصال نباشد، فوراً خارج شود.

وضعیت خروج (EXIT STATUS)

دستور nm-online در صورت موفقیت با وضعیت 0 خارج می‌شود؛ در صورتی که خطایی رخ دهد مقداری بزرگ‌تر از 0 بازگردانده می‌شود.

0

موفقیت – سیستم از قبل آنلاین بوده یا اتصال در مدت زمان مشخص‌شده برقرار گردیده است.

1

آفلاین یا عدم برقراری اتصال در مدت زمان تعیین‌شده.

2

خطای ناشناخته یا نامشخص.

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

nmcli(1), NetworkManager(8), NetworkManager-wait-online.service(8).