'\" t
.\"     Title: NetworkManager-wait-online.service
.\"    Author:
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 08/21/2026
.\"    Manual: Network management daemons
.\"    Source: NetworkManager-wait-online.service 1.58.1
.\"  Language: Persian
.\"
.TH "NETWORKMANAGER\-WAIT\-ONLINE\&" "8" "" "NetworkManager\-wait\-online\&" "Network management daemons"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
NetworkManager-wait-online.service \- انتظار برای برخط شدن شبکه
.SH "توضیحات (DESCRIPTION)"
.PP
سرویس
.B NetworkManager\-wait\-online
یک سرویس یک‌باره
.RI ( oneshot )
در
systemd
است که رسیدن به تارگت
.I network\-online
را تا زمانی که NetworkManager تکمیل راه‌اندازی را روی D\-Bus گزارش کند، به تأخیر می‌اندازد\&.
.PP
هنگامی که سیستم بوت می‌شود، برای نمونه، نقاط اتصال راه دور تعریف‌شده در
.BR /etc/fstab ،
نیازمند برپا بودن شبکه هستند\&. برای این منظور، این واحدهای systemd حاوی تنظیم
.B After=network\-online\&.target
هستند تا ترتیب اجرای خود را پس از این تارگت قرار دهند\&. سرویس
.B NetworkManager\-wait\-online
تضمین می‌کند که تارگت
.I network\-online
تنها پس از در دسترس قرار گرفتن شبکه محقق شود\&.
.PP
در شرایط بهینه، تمامی سرویس‌های روی میزبان به تغییرات شبکه واکنش پویا نشان می‌دهند و نیازی نیست سرویس‌های systemd طوری پیکربندی شوند که پس از رسیدن به تارگت
.I network\-online
شروع به کار کنند\&. در این صورت، سرویس
.B NetworkManager\-wait\-online\&.service
هیچ تأثیری نداشته و زمان بوت را به تأخیر نمی‌اندازد\&. از سوی دیگر، اگر به دلیل تأخیر
.B NetworkManager\-wait\-online
با زمان طولانی راه‌اندازی سیستم مواجه شدید، سرویس‌هایی را که نیاز به دسترسی به شبکه دارند بررسی کرده و آن‌ها را برطرف سازید\&.
.PP
به جز مقدار مهلت زمانی (timeout) در واحد
.BR NetworkManager\-wait\-online\&.service ،
شما نمی‌توانید این سرویس را پیکربندی کنید\&. در عوض، تنظیمات موجود در NetworkManager و نمایه‌های اتصال بر رفتار آن تأثیر می‌گذارند:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
تا زمانی که نمایه‌های NetworkManager در وضعیت فعال‌سازی (activating) باشند، راه‌اندازی کامل نشده است\&. هنگام بوت، NetworkManager نمایه‌های دارای تنظیم
.B connection\&.autoconnect=yes
را آغاز می‌کند\&. اگر فعال‌سازی با شکست مواجه شود، NetworkManager بسته به مقدار تنظیم
.B connection\&.autoconnect\-retries
فعال‌سازی را مجدداً تکرار می‌کند\&.
.sp
هنگامی که همه نمایه‌ها و دستگاه‌ها فعال شده یا در وضعیت قطع اتصال (disconnect) باشند و هیچ رویداد دیگری انتظار نرود، NetworkManager اتمام راه‌اندازی را گزارش می‌دهد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
زمان رسیدن یک دستگاه به وضعیت فعال به پیکربندی آن بستگی دارد\&. برای نمونه، در نمایه‌ای که هر دو پروتکل IPv4 و IPv6 در آن فعال هستند، NetworkManager به طور پیش‌فرض دستگاه را حتی زمانی که تنها یکی از خانواده‌های آدرس آماده باشد، کاملاً فعال‌شده در نظر می‌گیرد\&.
.sp
تنظیمات
.B ipv4\&.may\-fail
و
.B ipv6\&.may\-fail
این رفتار را کنترل می‌کنند\&. افزون بر این، تنظیمات زیر بر زمان تکمیل این دو خانواده آدرس تأثیر می‌گذارند:
.BR ipv4\&.required\-timeout ،
.BR ipv6\&.required\-timeout ،
.B ipv4\&.dhcp\-timeout
و
.BR ipv6\&.ra\-timeout \&.
برای جزئیات بیشتر، به
\fBnm-settings-nmcli\fR(5)
مراجعه کنید\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
برنامه NetworkManager نمی‌تواند روی دستگاه‌های پل (bridge) و باند (bond) که دارای درگاه‌هایی با عدم فعال‌سازی خودکار هستند، آدرس‌های IP را تنظیم کند\&. به دلیل این خطای پیکربندی،
.B NetworkManager\-wait\-online
مسدود می‌شود تا زمانی که سرویس به مقدار مهلت زمانی (timeout) خود برسد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
اسکریپت‌های توزیع‌کننده (dispatcher) برای رویداد
.B pre\-up
در مراحل پایانی فعال‌سازی یک نمایه اجرا می‌شوند\&. این اسکریپت‌ها فعال‌سازی را تا زمانی که NetworkManager نمایه را کاملاً فعال‌شده در نظر بگیرد مسدود می‌کنند\&. برای جزئیات بیشتر، به
\fBNetworkManager-dispatcher\fR(8)
مراجعه کنید\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ویژگی
.B connection\&.wait\-activation\-delay
یک تأخیر اضافی در طول فعال‌سازی اضافه کرده و اتمام راه‌اندازی را به تأخیر می‌اندازد\&. این تنظیم شرایطی را دور می‌زند که در آن مشخص است دستگاه برای مدت زمان معینی آماده نخواهد بود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ویژگی
.B connection\&.wait\-device\-timeout
در نمایه‌های اتصال باعث ایجاد تأخیر تا زمان ظاهر شدن دستگاه‌های در حال انتظار می‌شود\&. این گزینه زمانی سودمند است که درایور برای شناسایی رابط‌های شبکه به زمان بیشتری نیاز دارد\&. این تنظیم مشابه ویژگی
.B connection\&.gateway\-ping\-timeout
است\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
در دستگاه‌های Wi\-Fi، برنامه NetworkManager باید منتظر نخستین نتیجه پویش بماند تا بداند چه شبکه‌هایی در دسترس هستند\&. این امر موجب ایجاد تأخیر می‌شود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
در دستگاه‌های اترنت (Ethernet)، برنامه NetworkManager تا زمان رسیدن به مقدار تعیین‌شده در
.B [device*]\&.carrier\-wait\-timeout
منتظر حامل (carrier) می‌ماند\&. دلیل آن این است که برخی دستگاه‌ها برای تشخیص حامل به زمان زیادی نیاز دارند\&. در نتیجه، بوت کردن سیستم با کابل کشیده‌شده، سرویس
.B NetworkManager\-wait\-online\&.service
را بدون لزوم به تأخیر می‌اندازد\&.
.RE
.SH "اشکالات (BUGS)"
.PP
لطفاً هرگونه اشکال در NetworkManager را در
\m[blue]\fBسامانه ردیابی مشکلات NetworkManager\fR\m[]\&\s-2\u[1]\d\s+2
گزارش دهید\&.
.SH "همچنین ببینید (SEE ALSO)"
.PP
\m[blue]\fBصفحه خانگی NetworkManager\fR\m[]\&\s-2\u[2]\d\s+2،
\fBNetworkManager\fR(8)،
\fBnm-online\fR(1)،
توضیحات
.B network\-online\&.target
در
\fBsystemd.special\fR(7)
.SH "نکات (NOTES)"
.IP " 1." 4
سامانه ردیابی مشکلات NetworkManager
.RS 4
\%https://gitlab.freedesktop.org/NetworkManager/NetworkManager/-/issues
.RE
.IP " 2." 4
صفحه خانگی NetworkManager
.RS 4
\%https://networkmanager.dev
.RE