'\" t
.TH "SYSTEMD\-NETWORKD\-WAIT\-ONLINE\&.SERVICE" "8" "" "systemd 261.2" "systemd-networkd-wait-online.service"
.\" -----------------------------------------------------------------
.\" * 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)"
systemd-networkd-wait-online.service, systemd-networkd-wait-online@.service, systemd-networkd-wait-online \- انتظار برای برخط شدن شبکه
.SH "خلاصه دستور (SYNOPSIS)"
.PP
systemd\-networkd\-wait\-online\&.service
.PP
systemd\-networkd\-wait\-online@\&.service
.PP
/usr/lib/systemd/systemd\-networkd\-wait\-online
.SH "توضیحات (DESCRIPTION)"
.PP
\fBsystemd\-networkd\-wait\-online\fR
یک سرویس سیستمی یک‌باره (oneshot؛ به
\fBsystemd.service\fR(5)
مراجعه کنید) است که منتظر می‌ماند تا شبکه پیکربندی شود\&. به‌طور پیش‌فرض، این سرویس منتظر می‌ماند تا تمامی پیوندهایی که از آن‌ها آگاه است و توسط
\fBsystemd-networkd.service\fR(8)
مدیریت می‌شوند، به‌طور کامل پیکربندی شده یا با شکست مواجه شوند، و دست‌کم یکی از پیوندها برخط (online) شود\&. در اینجا، برخط بودن به این معنی است که وضعیت عملیاتی (operational state) پیوند برابر یا بالاتر از
"degraded"
باشد\&. این آستانه را می‌توان با گزینه
\fB\-\-operational\-state=\fR
پیکربندی کرد\&.
.PP
سرویس
systemd\-networkd\-wait\-online\&.service
دستور
\fBsystemd\-networkd\-wait\-online\fR
را بدون هیچ گزینه‌ای فراخوانی می‌کند\&. بنابراین، منتظر می‌ماند تا تمامی رابط‌های تحت مدیریت پیکربندی شده یا با شکست مواجه شوند، و دست‌کم یکی از آن‌ها برخط شود\&.
.PP
سرویس
systemd\-networkd\-wait\-online@\&.service
نام یک رابط شبکه را می‌گیرد و
\fBsystemd\-networkd\-wait\-online\fR
را همراه با
\fB\-i\fR
و نام رابط مشخص‌شده فراخوانی می‌کند\&. بنابراین، منتظر می‌ماند تا رابط مشخص‌شده پیکربندی و برخط شود\&. برای نمونه،
systemd\-networkd\-wait\-online@eth0\&.service
منتظر می‌ماند تا
eth0
توسط
\fBsystemd\-networkd\fR
پیکربندی شده و برخط گردد\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
گزینه‌های زیر پشتیبانی می‌شوند:
.PP
\fB\-i\fR \fIINTERFACE\fR[:\fIMIN_OPERSTATE\fR[:\fIMAX_OPERSTATE\fR]], \fB\-\-interface=\fR\fB\fIINTERFACE\fR\fR\fB[:\fIMIN_OPERSTATE\fR[:\fIMAX_OPERSTATE\fR]]\fR
.RS 4
رابط شبکه‌ای که باید پیش از تصمیم‌گیری درباره برخط بودن سیستم منتظر آن ماند\&. این گزینه زمانی مفید است که سیستم دارای چندین رابط است که پیکربندی خواهند شد، اما رابط خاصی برای دسترسی به برخی منابع شبکه ضروری است\&. در صورت استفاده، تمامی رابط‌های دیگر نادیده گرفته می‌شوند\&. از این گزینه می‌توان بیش از یک بار برای انتظار برای چندین رابط شبکه استفاده کرد\&. هنگامی که این گزینه چندین بار مشخص شود،
\fBsystemd\-networkd\-wait\-online\fR
منتظر برخط شدن تمامی رابط‌های مشخص‌شده می‌ماند\&. به‌طور اختیاری، وضعیت‌های عملیاتی کمینه و بیشینه مورد نیاز را می‌توان پس از یک دونقطه
":"
مشخص کرد\&. لطفاً برای وضعیت‌های عملیاتی ممکن به
\fBnetworkctl\fR(1)
مراجعه کنید\&. اگر وضعیت عملیاتی در اینجا مشخص نشود، در صورت وجود، مقدار
\fIRequiredForOnline=\fR
در فایل
\&.network
مربوطه استفاده می‌شود، و در غیر این صورت مقدار
"degraded"
به‌کار می‌رود\&.
.sp
افزوده‌شده در نسخه 213\&.
.RE
.PP
\fB\-\-ignore=\fR\fB\fIINTERFACE\fR\fR
.RS 4
رابط‌های شبکه‌ای که هنگام تصمیم‌گیری درباره برخط بودن سیستم باید نادیده گرفته شوند\&. به‌طور پیش‌فرض، فقط رابط loopback نادیده گرفته می‌شود\&. این گزینه می‌تواند بیش از یک بار برای نادیده گرفتن چندین رابط شبکه استفاده شود\&.
.sp
افزوده‌شده در نسخه 219\&.
.RE
.PP
\fB\-o\fR \fIMIN_OPERSTATE\fR[:\fIMAX_OPERSTATE\fR], \fB\-\-operational\-state=\fR\fB\fIMIN_OPERSTATE\fR\fR\fB[:\fIMAX_OPERSTATE\fR]\fR
.RS 4
یک وضعیت عملیاتی کمینه و یک وضعیت عملیاتی بیشینه اختیاری می‌گیرد\&. لطفاً برای وضعیت‌های عملیاتی ممکن به
\fBnetworkctl\fR(1)
مراجعه کنید\&. در صورت تعیین، مقدار مشخص‌شده بر تنظیمات
\fIRequiredForOnline=\fR
در فایل‌های
\&.network
اولویت دارد\&. اما این گزینه بر وضعیت‌های عملیاتی مشخص‌شده در گزینه
\fB\-\-interface=\fR
اولویت ندارد\&.
.sp
افزوده‌شده در نسخه 242\&.
.RE
.PP
\fB\-4\fR, \fB\-\-ipv4\fR
.RS 4
انتظار برای پیکربندی یک آدرس IPv4 برای هر رابط شبکه\&. اگر این گزینه همراه با
\fB\-\-any\fR
مشخص شود، در این صورت
\fBsystemd\-networkd\-wait\-online\fR
هنگامی که دست‌کم یک رابط برخط شود و دارای آدرس IPv4 باشد با موفقیت خارج می‌شود\&. اگر وضعیت عملیاتی کمینه مورد نیاز پایین‌تر از
"routable"
باشد، هر پیوند (یا در صورت استفاده از
\fB\-\-any\fR،
دست‌کم یک پیوند) باید دارای یک آدرس link\-local یا آدرس قابل‌مسیریابی (routable) برای IPv4 باشد\&. اگر وضعیت عملیاتی کمینه مورد نیاز
"routable"
باشد، هر پیوند باید یک آدرس IPv4 قابل‌مسیریابی داشته باشد\&.
.sp
اگر هیچ‌کدام از گزینه‌های
\fB\-\-ipv4\fR
یا
\fB\-\-ipv6\fR
مشخص نشده باشند، در صورت وجود، مقدار
\fIRequiredFamilyForOnline=\fR
در فایل
\&.network
مربوطه استفاده می‌شود\&.
.sp
افزوده‌شده در نسخه 249\&.
.RE
.PP
\fB\-6\fR, \fB\-\-ipv6\fR
.RS 4
انتظار برای پیکربندی یک آدرس IPv6 برای هر رابط شبکه\&. اگر این گزینه همراه با
\fB\-\-any\fR
مشخص شود، در این صورت
\fBsystemd\-networkd\-wait\-online\fR
هنگامی که دست‌کم یک رابط برخط شود و دارای آدرس IPv6 باشد با موفقیت خارج می‌شود\&. اگر وضعیت عملیاتی کمینه مورد نیاز پایین‌تر از
"routable"
باشد، هر پیوند (یا در صورت استفاده از
\fB\-\-any\fR،
دست‌کم یک پیوند) باید دارای یک آدرس link\-local یا آدرس قابل‌مسیریابی (routable) برای IPv6 باشد\&. اگر وضعیت عملیاتی کمینه مورد نیاز
"routable"
باشد، هر پیوند باید یک آدرس IPv6 قابل‌مسیریابی داشته باشد\&.
.sp
اگر هیچ‌کدام از گزینه‌های
\fB\-\-ipv4\fR
یا
\fB\-\-ipv6\fR
مشخص نشده باشند، در صورت وجود، مقدار
\fIRequiredFamilyForOnline=\fR
در فایل
\&.network
مربوطه استفاده می‌شود\&.
.sp
افزوده‌شده در نسخه 249\&.
.RE
.PP
\fB\-\-dns\fR
.RS 4
انتظار برای قابل‌دسترس بودن کارگزارهای DNS بر روی هر رابط\&. اگر این گزینه همراه با
\fB\-\-any\fR
مشخص شود، در این صورت
\fBsystemd\-networkd\-wait\-online\fR
هنگامی که دست‌کم یک رابط برخط شود و دارای یک کارگزار DNS قابل‌دسترس باشد با موفقیت خارج می‌شود\&.
.sp
اگر یک پیوند دارای ویژگی
\fIDefaultRoute=yes\fR
باشد (چه به دلیل اینکه ویژگی شبکه
\fIDNSDefaultRoute=\fR
به‌صراحت پیکربندی شده است، یا به دلیل اینکه پیوند هیچ دامنه "فقط مسیریابی" (routing\-only) ندارد)، یا اگر دامنه جستجوی "\&." پیکربندی شده باشد، منتظر می‌ماند تا کارگزارهای DNS مخصوص پیوند قابل دسترس شوند\&. در غیر این صورت، اجازه می‌دهد کارگزارهای DNS سراسری (global) این شرط را برآورده کنند\&.
.sp
افزوده‌شده در نسخه 258\&.
.RE
.PP
\fB\-\-any\fR
.RS 4
حتی اگر چندین رابط در وضعیت پیکربندی (configuring) باشند،
\fBsystemd\-networkd\-wait\-online\fR
هنگامی که دست‌کم یک رابط برخط شود با موفقیت خارج می‌شود\&. هنگامی که این گزینه همراه با
\fB\-\-interface=\fR
مشخص شود، در این صورت
\fBsystemd\-networkd\-wait\-online\fR
منتظر می‌ماند تا یکی از رابط‌های مشخص‌شده برخط شود\&. این گزینه زمانی مفید است که برخی رابط‌ها هنگام راه‌اندازی سیستم فاقد حامل (carrier) باشند\&.
.sp
افزوده‌شده در نسخه 242\&.
.RE
.PP
\fB\-\-timeout=\fR\fB\fISECS\fR\fR
.RS 4
در صورتی که تا زمان پایان مهلت زمانی (timeout)، شبکه برخط نشود، سرویس را با شکست مواجه می‌کند\&. مقدار مهلت 0، مهلت زمانی را غیرفعال می‌کند\&. مقدار پیش‌فرض 120 ثانیه است\&.
.sp
افزوده‌شده در نسخه 219\&.
.RE
.PP
\fB\-q\fR, \fB\-\-quiet\fR
.RS 4
فرونشاندن پیام‌های گزارش (log)\&.
.sp
افزوده‌شده در نسخه 242\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
چاپ یک متن راهنمای کوتاه و خروج\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
چاپ یک رشته نسخه کوتاه و خروج\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBsystemd\fR(1), \fBsystemd.service\fR(5), \fBsystemd-networkd.service\fR(8), \fBnetworkctl\fR(1)