'\" t
.\"     Title: nm-online
.\"    Author: 
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 08/21/2026
.\"    Manual: General Commands Manual
.\"    Source: NetworkManager 1.58.1
.\"  Language: Persian
.\"
.TH "NM\-ONLINE" "1" "" "NetworkManager 1\&.58\&.1" "General Commands Manual"
.\" -----------------------------------------------------------------
.\" * 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)"
nm-online \- پرسش از NetworkManager درباره متصل بودن شبکه
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBnm\-online\fR\ 'u
\fBnm\-online\fR [\fIگزینه‌ها\fR...]
.SH "توضیحات (DESCRIPTION)"
.PP
دستور
\fBnm\-online\fR
ابزاری برای آگاهی از متصل بودن سیستم به اینترنت و شبکه (آنلاین بودن) است\&. این کار با استعلام وضعیت از NetworkManager انجام می‌پذیرد\&. هنگام اجرا،
\fBnm\-online\fR
منتظر می‌ماند تا NetworkManager یک اتصال فعال را گزارش دهد، یا مهلت زمانی مشخص‌شده منقضی شود\&. هنگام خروج، کد وضعیت بازگردانده‌شده باید بررسی شود (کدهای بازگشتی را در ادامه مشاهده کنید)\&.
.PP
فراخوانی مستقیم این ابزار چندان متداول نیست\&. با این حال، توسط سرویس
NetworkManager\-wait\-online\&.service
همراه با آرگومان
\-\-wait\-for\-startup
استفاده می‌شود (به
\fBNetworkManager-wait-online.service\fR(8)
مراجعه کنید)\&.
.PP
به طور پیش‌فرض، اتصالات دارای ویژگی‌های
ipv4\&.may\-fail
و
ipv6\&.may\-fail
تنظیم‌شده روی
yes
هستند؛ این بدان معناست که NetworkManager منتظر می‌ماند تا پیکربندی یکی از این دو خانواده آدرس کامل شود و سپس اتصال را فعال‌شده تلقی می‌کند\&. اگر نیاز دارید که قبل از رسیدن به
network\-online\&.target
یک خانواده آدرس خاص پیکربندی شده باشد، ویژگی
may\-fail
مربوطه را روی
no
تنظیم کنید\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-h\fR | \fB\-\-help\fR
.RS 4
چاپ اطلاعات راهنما\&.
.RE
.PP
\fB\-q\fR | \fB\-\-quiet\fR
.RS 4
عدم چاپ هرگونه خروجی در ترمینال\&.
.RE
.PP
\fB\-s\fR | \fB\-\-wait\-for\-startup\fR
.RS 4
انتظار برای تکمیل فرایند راه‌اندازی NetworkManager، به جای انتظار اختصاصی برای برقراری اتصال شبکه\&. راه‌اندازی زمانی کامل تلقی می‌شود که NetworkManager تمام اتصال‌های خودفعال‌شونده‌ای (auto\-activate) را که با توجه به وضعیت فعلی شبکه در دسترس هستند، فعال کرده باشد (یا برای فعال‌سازی آن‌ها تلاش کرده باشد)\&. این لحظه منطبق بر زمانی است که NetworkManager پیام
"startup complete"
را ثبت می‌کند\&. این حالت معمولاً فقط در زمان بالا آمدن سیستم (بوت) کاربرد دارد\&. پس از اتمام فرایند راه‌اندازی اولیه، اجرای
\fBnm\-online \-s\fR
صرف‌نظر از وضعیت فعلی شبکه بلافاصله بازمی‌گردد\&.
.sp
روش‌های گوناگونی برای تاثیرگذاری بر زمان رسیدن به startup complete وجود دارد\&. برای جزئیات بیشتر به
\fBNetworkManager-wait-online.service\fR(8)
مراجعه کنید\&.
.RE
.PP
\fB\-t\fR | \fB\-\-timeout\fR \fIثانیه\fR
.RS 4
مدت زمان انتظار برای برقراری اتصال بر حسب ثانیه\&. اگر این گزینه تعیین نشود، متغیر محیطی
NM_ONLINE_TIMEOUT
در نظر گرفته می‌شود\&. مهلت پیش‌فرض ۳۰ ثانیه است\&.
.RE
.PP
\fB\-x\fR | \fB\-\-exit\fR
.RS 4
اگر NetworkManager در حال اجرا نباشد یا در حال اتصال نباشد، فوراً خارج شود\&.
.RE
.SH "وضعیت خروج (EXIT STATUS)"
.PP
دستور
\fBnm\-online\fR
در صورت موفقیت با وضعیت 0 خارج می‌شود؛ در صورتی که خطایی رخ دهد مقداری بزرگ‌تر از 0 بازگردانده می‌شود\&.
.PP
\fB0\fR
.RS 4
موفقیت \(en سیستم از قبل آنلاین بوده یا اتصال در مدت زمان مشخص‌شده برقرار گردیده است\&.
.RE
.PP
\fB1\fR
.RS 4
آفلاین یا عدم برقراری اتصال در مدت زمان تعیین‌شده\&.
.RE
.PP
\fB2\fR
.RS 4
خطای ناشناخته یا نامشخص\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBnmcli\fR(1),
\fBNetworkManager\fR(8),
\fBNetworkManager-wait-online.service\fR(8)\&.