'\" t
.\"     Title: nmcli
.\"    Author:
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 08/21/2026
.\"    Manual: راهنمای دستورات عمومی
.\"    Source: NetworkManager 1\&.58\&.1
.\"  Language: Persian
.\"
.TH "NMCLI" "1" "" "NetworkManager 1\&.58\&.1" "راهنمای دستورات عمومی"
.\" -----------------------------------------------------------------
.\" * 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)"
nmcli \- ابزار خط فرمان برای کنترل NetworkManager
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBnmcli\fR\ 'u
\fBnmcli\fR [\fIگزینه‌ها\fR...] {\fBhelp\fR | \fBgeneral\fR | \fBnetworking\fR | \fBradio\fR | \fBconnection\fR | \fBdevice\fR | \fBagent\fR | \fBmonitor\fR} [\fIدستور\fR] [\fIآرگومان‌ها\fR...]
.SH "توضیحات (DESCRIPTION)"
.PP
\fBnmcli\fR
یک ابزار خط فرمان برای کنترل NetworkManager و گزارش وضعیت شبکه است\&. می‌توان از آن به عنوان جایگزینی برای
\fBnm\-applet\fR
یا سایر برنامه‌های گرافیکی مدیریت شبکه استفاده کرد\&.
\fBnmcli\fR
برای ایجاد، نمایش، ویرایش، حذف، فعال‌سازی و غیرفعال‌سازی اتصالات شبکه و همچنین کنترل و نمایش وضعیت دستگاه‌های شبکه به کار می‌رود\&. برای مشاهده مثال‌های آماده اجرای nmcli به
\fBnmcli-examples\fR(7)
مراجعه کنید\&.
.PP
کاربردهای متداول شامل موارد زیر است:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
اسکریپت‌ها: استفاده از NetworkManager از طریق
\fBnmcli\fR
به جای مدیریت دستی اتصالات شبکه\&.
\fBnmcli\fR
از یک قالب خروجی فشرده پشتیبانی می‌کند که برای پردازش اسکریپت‌ها مناسب‌تر است\&. توجه داشته باشید که NetworkManager همچنین می‌تواند اسکریپت‌هایی موسوم به «اسکریپت‌های توزیع‌کننده» (dispatcher scripts) را در پاسخ به رویدادهای شبکه اجرا کند\&. برای جزئیات بیشتر درباره این اسکریپت‌ها به
\fBNetworkManager\fR(8)
مراجعه کنید\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
سرورها، سیستم‌های بدون نمایشگر (headless) و ترمینال‌ها:
\fBnmcli\fR
می‌تواند برای کنترل NetworkManager بدون رابط گرافیکی استفاده شود، شامل ایجاد، ویرایش، شروع و متوقف کردن اتصالات شبکه و مشاهده وضعیت شبکه\&.
.RE
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-a\fR | \fB\-\-ask\fR
.RS 4
هنگام استفاده از این گزینه،
\fBnmcli\fR
متوقف شده و آرگومان‌های ضروری ناموجود را درخواست می‌کند؛ بنابراین از این گزینه برای مقاصد غیرتعاملی مانند اسکریپت‌ها استفاده نکنید\&. این گزینه برای مثال کنترل می‌کند که آیا در صورت نیاز به گذرواژه برای اتصال به شبکه، از شما رمز عبور درخواست شود یا خیر\&.
.RE
.PP
\fB\-c\fR | \fB\-\-colors\fR {yes | no | auto}
.RS 4
این گزینه خروجی رنگی را (با استفاده از توالی‌های گریز ترمینال) کنترل می‌کند\&.
yes
رنگ‌ها را فعال می‌کند،
no
آن‌ها را غیرفعال می‌کند و
auto
تنها زمانی خروجی رنگی تولید می‌کند که خروجی استاندارد به یک ترمینال متصل باشد\&. مقدار پیش‌فرض
auto
است\&.
.sp
رنگ‌های واقعی استفاده‌شده همان‌طور که در
\fBterminal-colors.d\fR(5)
توضیح داده شده پیکربندی می‌شوند\&. لطفاً برای فهرستی از نام‌های رنگ‌های پشتیبانی‌شده توسط
\fBnmcli\fR
به بخش
COLORS
مراجعه فرمایید\&.
.sp
اگر متغیر محیطی
NO_COLOR
تنظیم شده باشد (روی هر مقدار غیرخالی)، رنگ‌آمیزی در حالت "auto" غیرفعال می‌شود\&. اگر متغیر محیطی
CLICOLOR_FORCE
تنظیم شده باشد (روی هر مقدار غیرخالی)، رنگ‌آمیزی در حالت "auto" فعال می‌شود\&. فعال‌سازی صریح رنگ‌ها متغیرهای محیطی را نادیده می‌گیرد\&.
.RE
.PP
\fB\-\-complete\-args\fR
.RS 4
به جای اجرای عملیات درخواستی،
\fBnmcli\fR
گزینه‌های ممکن برای تکمیل خودکار آخرین آرگومان را فهرست می‌کند\&. این ویژگی برای پیاده‌سازی تکمیل خودکار آرگومان‌ها در شل مفید است\&.
.sp
وضعیت خروج موفقیت را نشان می‌دهد یا کد
65
را برمی‌گرداند تا مشخص کند آخرین آرگومان یک نام فایل است\&.
.sp
NetworkManager همراه با پشتیبانی از تکمیل دستورات برای GNU Bash عرضه می‌شود\&.
.RE
.PP
\fB\-e\fR | \fB\-\-escape\fR {yes | no}
.RS 4
آیا کاراکترهای
:
و
\e
در حالت جدول فشرده اسکیپ شوند یا خیر\&. کاراکتر اسکیپ
\e
است\&.
.sp
در صورت حذف، مقدار پیش‌فرض
yes
است\&.
.RE
.PP
\fB\-f\fR | \fB\-\-fields\fR {\fIfield1\fR,\fIfield2\fR... | all | common}
.RS 4
این گزینه برای تعیین فیلدهایی (نام ستون‌ها) که باید چاپ شوند به کار می‌رود\&. نام‌های معتبر فیلدها برای دستورات مختلف متفاوت است\&. با ارائه یک مقدار نامعتبر به گزینه
\fB\-\-fields\fR
می‌توانید فیلدهای موجود را فهرست کنید\&.
all
برای چاپ تمام مقادیر فیلدهای معتبر دستور استفاده می‌شود\&.
common
برای چاپ مقادیر فیلدهای رایج دستور استفاده می‌شود\&.
.sp
در صورت حذف، مقدار پیش‌فرض
common
است\&.
.RE
.PP
\fB\-g\fR | \fB\-\-get\-values\fR {\fIfield1\fR,\fIfield2\fR... | all | common}
.RS 4
این گزینه برای چاپ مقادیر از فیلدهای خاص استفاده می‌شود\&. این گزینه در اصل یک میانبر برای
\-\-mode tabular \-\-terse \-\-fields
است و روشی مناسب برای دریافت مقادیر مربوط به فیلدهای مشخص به شمار می‌آید\&. مقادیر خط‌به‌خط و بدون سربرگ چاپ می‌شوند\&.
.sp
اگر به جای یک فیلد یک بخش (section) مشخص شود، نام بخش چاپ شده و به دنبال آن مقادیر فیلدهای متعلق به آن بخش که با دونقطه از هم جدا شده‌اند، همگی در یک خط چاپ می‌شوند\&.
.RE
.PP
\fB\-h\fR | \fB\-\-help\fR
.RS 4
چاپ اطلاعات راهنما\&.
.RE
.PP
\fB\-m\fR | \fB\-\-mode\fR {tabular | multiline}
.RS 4
جابه‌جایی بین خروجی جدولی و چندخطی:
.PP
tabular
.RS 4
خروجی یک جدول است که در آن هر خط یک ورودی را توصیف می‌کند\&. ستون‌ها ویژگی‌های خاص آن ورودی را مشخص می‌کنند\&.
.RE
.PP
multiline
.RS 4
هر ورودی شامل چندین خط است و هر ویژگی در خط مربوط به خود قرار دارد\&. مقادیر با نام ویژگی پیشوندگذاری می‌شوند\&.
.RE
.sp
در صورت حذف، مقدار پیش‌فرض برای اکثر دستورات
tabular
است\&. برای دستوراتی که اطلاعات ساختاریافته‌تری تولید می‌کنند و نمی‌توان آن‌ها را در یک خط نمایش داد، پیش‌فرض
multiline
است\&. در حال حاضر، این موارد عبارتند از:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
nmcli connection show \fIID\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
nmcli device show
.RE
.RE
.PP
\fB\-p\fR | \fB\-\-pretty\fR
.RS 4
خروجی زیبا و خوانا\&. این گزینه باعث می‌شود
\fBnmcli\fR
خروجی‌هایی با خوانایی آسان برای انسان تولید کند، یعنی مقادیر تراز شوند، سربرگ‌ها چاپ شوند و غیره\&.
.RE
.PP
\fB\-s\fR | \fB\-\-show\-secrets\fR
.RS 4
هنگام استفاده از این گزینه،
\fBnmcli\fR
گذرواژه‌ها و مقادیر محرمانه‌ای را که ممکن است در خروجی یک عملیات وجود داشته باشند نمایش می‌دهد\&. این گزینه همچنین بر بازتاب (echo) گذرواژه‌های وارد شده توسط کاربر به عنوان ورودی تأثیر می‌گذارد\&.
.RE
.PP
\fB\-t\fR | \fB\-\-terse\fR
.RS 4
خروجی مختصر و فشرده\&. این حالت برای پردازش رایانه‌ای (اسکریپت) طراحی و مناسب است\&.
.RE
.PP
\fB\-\-offline\fR
.RS 4
کارکرد بدون دیمن\&. باعث می‌شود دستورات
\fBconnection add\fR
و
\fBconnection modify\fR
داده‌های اتصال را از طریق ورودی/خروجی استاندارد بپذیرند و تولید کنند\&. در حالت عادی، nmcli با سرویس NetworkManager ارتباط برقرار می‌کند\&.
.sp
قالب داده‌های اتصال (keyfile) در راهنمای
\fBnm-settings-keyfile\fR(5)
شرح داده شده است\&.
.RE
.PP
\fB\-v\fR | \fB\-\-version\fR
.RS 4
نمایش نسخه
\fBnmcli\fR\&.
.RE
.PP
\fB\-w\fR | \fB\-\-wait\fR \fIseconds\fR
.RS 4
این گزینه یک بازه زمانی مهلت (timeout) را تعیین می‌کند که طی آن
\fBnmcli\fR
منتظر می‌ماند تا NetworkManager عملیات را به پایان برساند\&. این گزینه به ویژه برای دستوراتی که ممکن است زمان بیشتری برای اتمام نیاز داشته باشند مفید است، مانند فعال‌سازی اتصال\&.
.sp
تعیین مقدار
0
به
\fBnmcli\fR
دستور می‌دهد که منتظر نماند و بلافاصله با وضعیت موفقیت خارج شود\&. مقدار پیش‌فرض به دستور اجرا شده بستگی دارد\&.
.RE.SH "دستورات عمومی (GENERAL COMMANDS)"
.HP \w'\fBnmcli\ general\fR\ 'u
\fBnmcli general\fR {\fBstatus\fR | \fBhostname\fR | \fBpermissions\fR | \fBlogging\fR | \fBreload\fR} [\fIآرگومان‌ها\fR...]
.PP
از این دستور برای نمایش وضعیت و مجوزهای NetworkManager استفاده کنید\&. همچنین می‌توانید نام میزبان سیستم (hostname) و سطح گزارش‌گیری و دامنه‌های NetworkManager را دریافت کرده و تغییر دهید\&.
.PP
\fBstatus\fR
.RS 4
نمایش وضعیت کلی NetworkManager\&. این عمل پیش‌فرض است، زمانی که هیچ دستور اضافی برای
\fBnmcli general\fR
ارائه نشود\&.
.RE
.PP
\fBhostname\fR [\fIhostname\fR]
.RS 4
دریافت و تغییر نام میزبان سیستم\&. بدون آرگومان، نام میزبان پیکربندی‌شده فعلی را چاپ می‌کند\&. هنگامی که یک نام میزبان ارسال می‌کنید، به NetworkManager تحویل داده می‌شود تا به عنوان نام میزبان جدید سیستم تنظیم شود\&.
.sp
توجه داشته باشید که اصطلاح نام میزبان "سیستم" ممکن است توسط سایر برنامه‌ها یا ابزارها به عنوان "ماندگار" (persistent) یا "ایستا" (static) نیز نامیده شود\&. نام میزبان در بیشتر توزیع‌ها در فایل
/etc/hostname
ذخیره می‌شود\&. به عنوان مثال، سرویس systemd\-hostnamed از اصطلاح نام میزبان "static" استفاده می‌کند و فقط هنگام شروع به کار فایل
/etc/hostname
را می‌خواند\&.
.RE
.PP
\fBpermissions\fR
.RS 4
نمایش مجوزهایی که فراخواننده برای عملیات‌های مختلف احراز هویت‌شده ارائه‌شده توسط NetworkManager دارد، مانند فعال و غیرفعال کردن شبکه، تغییر وضعیت Wi\-Fi و WWAN، ویرایش اتصالات و غیره\&.
.RE
.PP
\fBlogging\fR [\fBlevel\fR\ \fIlevel\fR] [\fBdomains\fR\ \fIdomains\fR...]
.RS 4
دریافت و تغییر سطح ثبت وقایع و دامنه‌های NetworkManager\&. بدون هیچ آرگومانی، سطح گزارش‌گیری و دامنه‌های فعلی نمایش داده می‌شوند\&. برای تغییر وضعیت ثبت وقایع، پارامترهای
\fBlevel\fR
و یا
\fBdomain\fR
را ارائه دهید\&. برای مشاهده مقادیر مجاز سطح و دامنه به
\fBNetworkManager.conf\fR(5)
مراجعه فرمایید\&.
.RE
.PP
\fBreload\fR [\fIflags\fR...]
.RS 4
بارگذاری مجدد پیکربندی NetworkManager و انجام برخی به‌روزرسانی‌ها، مانند پاکسازی حافظه‌های موقت یا بازنویسی وضعیت خارجی روی دیسک\&. این شبیه ارسال سیگنال SIGHUP به NetworkManager است اما از طریق آرگومان flags کنترل دقیق‌تری را بر آنچه باید بارگذاری مجدد شود ارائه می‌دهد\&. همچنین امکان دسترسی غیر-ریشه را از طریق PolicyKit فراهم می‌کند و برخلاف سیگنال‌ها، همگام (synchronous) است\&. فلگ‌های موجود عبارتند از:
.PP
\fBconf\fR
.RS 4
بارگذاری مجدد پیکربندی NetworkManager\&.conf از روی دیسک\&. توجه داشته باشید که این شامل اتصالات نمی‌شود، که می‌توان آن‌ها را در عوض از طریق
\fBnmcli connection reload\fR
مجدداً بارگذاری کرد\&.
.RE
.PP
\fBdns\-rc\fR
.RS 4
به‌روزرسانی پیکربندی DNS که معمولاً شامل بازنویسی مجدد /etc/resolv\&.conf است\&. این معادل ارسال سیگنال SIGUSR1 به فرآیند NetworkManager است\&.
.RE
.PP
\fBdns\-full\fR
.RS 4
راه‌اندازی مجدد افزونه DNS\&. این مورد به عنوان مثال هنگام استفاده از افزونه dnsmasq مفید است که از پیکربندی‌های اضافی در
/etc/NetworkManager/dnsmasq\&.d
استفاده می‌کند\&. اگر آن فایل‌ها را ویرایش کنید، می‌توانید افزونه DNS را مجدداً راه‌اندازی کنید\&. این عمل به مدت کوتاهی وضوح نام‌ها را قطع می‌کند\&.
.RE
.sp
بدون هیچ فلگی، تمام مواردی که پشتیبانی می‌شوند مجدداً بارگذاری خواهند شد که معادل ارسال یک SIGHUP است\&. برای جزئیات بیشتر درباره سیگنال‌ها به
\fBNetworkManager\fR(8)
مراجعه کنید\&.
.RE
.SH "دستورات کنترل شبکه (NETWORKING CONTROL COMMANDS)"
.HP \w'\fBnmcli\ networking\fR\ 'u
\fBnmcli networking\fR {\fBon\fR | \fBoff\fR | \fBconnectivity\fR} [\fIآرگومان‌ها\fR...]
.PP
استعلام وضعیت شبکه NetworkManager، فعال و غیرفعال کردن شبکه\&.
.PP
\fBon\fR, \fBoff\fR
.RS 4
فعال یا غیرفعال کردن کنترل شبکه توسط NetworkManager\&. با غیرفعال شدن شبکه، تمام رابط‌های مدیریت‌شده توسط NetworkManager غیرفعال می‌شوند\&.
.RE
.PP
\fBconnectivity\fR [check]
.RS 4
دریافت وضعیت اتصال شبکه\&. آرگومان اختیاری
\fBcheck\fR
به NetworkManager می‌گوید که اتصال را مجدداً بررسی کند، در غیر این صورت آخرین وضعیت شناخته‌شده اتصال بدون بررسی مجدد نمایش داده می‌شود\&.
.sp
وضعیت‌های ممکن عبارتند از:
.PP
none
.RS 4
میزبان به هیچ شبکه‌ای متصل نیست\&.
.RE
.PP
portal
.RS 4
میزبان پشت یک پورتال محصور (captive portal) قرار دارد و نمی‌تواند به کل اینترنت دسترسی داشته باشد\&.
.RE
.PP
limited
.RS 4
میزبان به یک شبکه متصل است، اما دسترسی به اینترنت ندارد\&.
.RE
.PP
full
.RS 4
میزبان به یک شبکه متصل است و دسترسی کامل به اینترنت دارد\&.
.RE
.PP
unknown
.RS 4
وضعیت اتصال قابل تشخیص نیست\&.
.RE
.RE
.SH "دستورات کنترل انتقال رادیویی (RADIO TRANSMISSION CONTROL COMMANDS)"
.HP \w'\fBnmcli\ radio\fR\ 'u
\fBnmcli radio\fR {\fBall\fR | \fBwifi\fR | \fBwwan\fR} [\fIآرگومان‌ها\fR...]
.PP
نمایش وضعیت کلیدهای رادیویی، یا فعال و غیرفعال کردن کلیدها\&.
.PP
\fBwifi\fR [on | off]
.RS 4
نمایش یا تنظیم وضعیت Wi\-Fi در NetworkManager\&. اگر هیچ آرگومانی ارائه نشود، وضعیت Wi\-Fi چاپ می‌شود؛
\fBon\fR
وای‌فای را فعال می‌کند؛
\fBoff\fR
وای‌فای را غیرفعال می‌کند\&.
.RE
.PP
\fBwwan\fR [on | off]
.RS 4
نمایش یا تنظیم وضعیت WWAN (پهن‌باند همراه) در NetworkManager\&. اگر هیچ آرگومانی ارائه نشود، وضعیت پهن‌باند همراه چاپ می‌شود؛
\fBon\fR
پهن‌باند همراه را فعال می‌کند،
\fBoff\fR
آن را غیرفعال می‌کند\&.
.RE
.PP
\fBall\fR [on | off]
.RS 4
نمایش یا تنظیم همزمان تمام کلیدهای رادیویی ذکر شده قبلی\&.
.RE
.SH "پایش فعالیت (ACTIVITY MONITOR)"
.HP \w'\fBnmcli\ monitor\fR\ 'u
\fBnmcli monitor\fR
.PP
مشاهده فعالیت NetworkManager\&. تغییرات در وضعیت اتصال، دستگاه‌ها یا نمایه‌های اتصال را زیر نظر می‌گیرد\&.
.PP
همچنین ببینید
\fBnmcli connection monitor\fR
و
\fBnmcli device monitor\fR
را برای نظارت بر تغییرات در دستگاه‌ها یا اتصالات خاص\&..SH "دستورات مدیریت اتصال (CONNECTION MANAGEMENT COMMANDS)"
.HP \w'\fBnmcli\ connection\fR\ 'u
\fBnmcli connection\fR {\fBshow\fR | \fBup\fR | \fBdown\fR | \fBmodify\fR | \fBadd\fR | \fBedit\fR | \fBclone\fR | \fBdelete\fR | \fBmonitor\fR | \fBreload\fR | \fBload\fR | \fBimport\fR | \fBexport\fR | \fBmigrate\fR} [\fIآرگومان‌ها\fR...]
.PP
برنامه NetworkManager تمام پیکربندی‌های شبکه را به عنوان «اتصال» (connection) ذخیره می‌کند؛ این اتصالات مجموعه‌ای از داده‌ها (جزئیات لایه ۲، آدرس‌دهی IP و غیره) هستند که نحوه ایجاد یا اتصال به یک شبکه را توصیف می‌کنند\&. یک اتصال زمانی «فعال» (active) است که یک دستگاه از پیکربندی آن اتصال برای ایجاد یا اتصال به یک شبکه استفاده کند\&. ممکن است چندین اتصال برای یک دستگاه وجود داشته باشد، اما در هر لحظه تنها یکی از آن‌ها می‌تواند روی آن دستگاه فعال باشد\&. اتصالات اضافی می‌توانند برای جابه‌جایی سریع میان شبکه‌ها و پیکربندی‌های مختلف به کار روند\&.
.PP
سیستمی را در نظر بگیرید که معمولاً به یک شبکه مجهز به DHCP متصل است، اما گاهی اوقات به یک شبکه آزمایشی که از آدرس‌دهی IP ایستا استفاده می‌کند متصل می‌شود\&. به جای پیکربندی مجدد دستی eth0 در هر بار تغییر شبکه، می‌توان تنظیمات را به عنوان دو اتصال که هر دو برای eth0 اعمال می‌شوند ذخیره کرد؛ یکی برای DHCP (به نام
default)
و دیگری با جزئیات آدرس‌دهی ایستا (به نام
testing)\&.
هنگام اتصال به شبکه دارای DHCP، کاربر دستور
\fBnmcli con up default\fR
را اجرا می‌کند و هنگام اتصال به شبکه ایستا، کاربر دستور
\fBnmcli con up testing\fR
را اجرا خواهد کرد\&.
.PP
\fBshow\fR [\fB\-\-active\fR] [\fB\-\-order\fR\ [+\-]\fIcategory\fR:...]
.RS 4
نمایش نمایه‌های اتصال در حافظه و روی دیسک، که ممکن است در صورت استفاده توسط یک دستگاه، برخی از آن‌ها فعال نیز باشند\&. بدون پارامتر، تمام نمایه‌ها فهرست می‌شوند\&. هنگامی که گزینه
\fB\-\-active\fR
مشخص شود، فقط نمایه‌های فعال نمایش داده می‌شوند\&.
.sp
گزینه
\fB\-\-order\fR
می‌تواند برای مرتب‌سازی سفارشی اتصالات استفاده شود\&. اتصالات را می‌توان بر اساس وضعیت فعال بودن (active)، نام (name)، نوع (type) یا مسیر D\-Bus (مسیر یا path) مرتب کرد\&. اگر اتصالات بر اساس یک دسته مرتب‌سازی برابر باشند، می‌توان یک دسته اضافی مشخص کرد\&. ترتیب مرتب‌سازی پیش‌فرض معادل
\-\-order active:name:path
است\&.
+
یا نبود پیشوند به معنای مرتب‌سازی صعودی (بر اساس حروف الفبا یا اعداد) است،
\-
به معنای ترتیب معکوس (نزولی) می‌باشد\&. نام دسته‌ها را می‌توان به صورت اختصاری نیز نوشت (مانند
\-\-order \-a:na)\&.
.RE
.PP
\fBshow\fR [\fB\-\-active\fR] [\fBid\fR | \fBuuid\fR | \fBpath\fR | \fBapath\fR] \fIID\fR...
.RS 4
نمایش جزئیات اتصالات مشخص‌شده\&. به طور پیش‌فرض، هم پیکربندی ایستا و هم داده‌های اتصال فعال نمایش داده می‌شوند\&. هنگامی که گزینه
\fB\-\-active\fR
مشخص شود، فقط نمایه‌های فعال در نظر گرفته می‌شوند\&. از گزینه سراسری
\fB\-\-show\-secrets\fR
برای نمایش رمزهای عبور و اسرار مرتبط با نمایه استفاده کنید\&.
.sp
کلیدواژه‌های
\fBid\fR،
\fBuuid\fR،
\fBpath\fR
و
\fBapath\fR
می‌توانند در صورتی که
\fIID\fR
مبهم باشد استفاده شوند\&. کلیدواژه‌های اختیاری تعیین‌کننده
\fIID\fR
عبارتند از:
.PP
\fBid\fR
.RS 4
شناسه
\fIID\fR
بیانگر نام اتصال است\&.
.RE
.PP
\fBuuid\fR
.RS 4
شناسه
\fIID\fR
بیانگر UUID اتصال است\&.
.RE
.PP
\fBpath\fR
.RS 4
شناسه
\fIID\fR
بیانگر یک مسیر D\-Bus اتصال ایستا در قالب /org/freedesktop/NetworkManager/Settings/\fInum\fR
یا صرفاً
\fInum\fR
است\&.
.RE
.PP
\fBapath\fR
.RS 4
شناسه
\fIID\fR
بیانگر یک مسیر D\-Bus اتصال فعال در قالب /org/freedesktop/NetworkManager/ActiveConnection/\fInum\fR
یا صرفاً
\fInum\fR
است\&.
.RE
.sp
فیلتر کردن خروجی با استفاده از گزینه سراسری
\fB\-\-fields\fR
امکان‌پذیر است\&. از مقادیر زیر استفاده کنید:
.PP
\fBprofile\fR
.RS 4
فقط پیکربندی نمایه ایستا را نشان می‌دهد\&.
.RE
.PP
\fBactive\fR
.RS 4
فقط داده‌های اتصال فعال را (زمانی که نمایه فعال است) نشان می‌دهد\&.
.RE
.sp
همچنین می‌توانید فیلدهای خاصی را مشخص کنید\&. برای پیکربندی ایستا، از نام‌های تنظیمات و ویژگی‌ها همان‌طور که در صفحه راهنمای
\fBnm-settings-nmcli\fR(5)
شرح داده شده استفاده کنید\&. برای داده‌های فعال از GENERAL، IP4، DHCP4، IP6، DHCP6، VPN استفاده نمایید\&.
.sp
هنگامی که هیچ دستوری به
\fBnmcli connection\fR
داده نشود، اقدام پیش‌فرض
\fBnmcli connection show\fR
است\&.
.RE
.PP
\fBup\fR [\fBid\fR | \fBuuid\fR | \fBpath\fR] \fIID\fR [\fBifname\fR\ \fIifname\fR] [\fBap\fR\ \fIBSSID\fR] [\fBpasswd\-file\fR\ \fIfile\fR]
.RS 4
فعال‌سازی یک اتصال\&. اتصال با نام، UUID یا مسیر D\-Bus آن شناسایی می‌شود\&. اگر
\fIID\fR
مبهم باشد، می‌توان از کلیدواژه‌های
\fBid\fR،
\fBuuid\fR
یا
\fBpath\fR
استفاده کرد\&. هنگام نیاز به یک دستگاه خاص برای فعال‌سازی اتصال روی آن، باید گزینه
\fBifname\fR
همراه با نام رابط ارائه شود\&. اگر
\fIID\fR
داده نشود، ارائه
\fBifname\fR
الزامی است و NetworkManager بهترین اتصال موجود را برای
\fBifname\fR
داده‌شده فعال خواهد کرد\&. در مورد اتصال VPN، گزینه
\fBifname\fR
دستگاه اتصال پایه را مشخص می‌کند\&. گزینه
\fBap\fR
مشخص می‌کند در صورت اتصال Wi\-Fi از کدام نقطه دسترسی (AP) خاص باید استفاده شود\&.
.sp
اگر گزینه
\fB\-\-wait\fR
مشخص نشود، مهلت زمانی پیش‌فرض ۹۰ ثانیه خواهد بود\&.
.sp
برای توضیحات مربوط به کلیدواژه‌های تعیین‌کننده
\fIID\fR
به
\fBconnection show\fR
در بالا مراجعه کنید\&.
.sp
گزینه‌های موجود عبارتند از:
.PP
\fBifname\fR
.RS 4
رابطی که برای فعال‌سازی استفاده خواهد شد\&.
.RE
.PP
\fBap\fR
.RS 4
شناسه BSSID نقطه دسترسی (AP) که دستور باید به آن متصل شود (برای اتصالات Wi\-Fi)\&.
.RE
.PP
\fBpasswd\-file\fR
.RS 4
برخی شبکه‌ها ممکن است هنگام فعال‌سازی به اطلاعات احراز هویت نیاز داشته باشند\&. می‌توانید این اعتبارنامه‌ها را با استفاده از این گزینه ارائه دهید\&. هر خط از فایل باید حاوی یک گذرواژه در قالب زیر باشد:
.sp
.if n \{\
.RS 4
.\}
.nf
setting_name\&.property_name:the password
.fi
.if n \{\
.RE
.\}
.sp
برای مثال، برای Wi\-Fi از نوع WPA با PSK، خط مربوطه به صورت زیر خواهد بود:
.sp
.if n \{\
.RS 4
.\}
.nf
802\-11\-wireless\-security\&.psk:secret12345
.fi
.if n \{\
.RE
.\}
.sp
برای گذرواژه 802\&.1X، خط به صورت زیر است:
.sp
.if n \{\
.RS 4
.\}
.nf
802\-1x\&.password:my 1X password
.fi
.if n \{\
.RE
.\}
.sp
\fBnmcli\fR
همچنین رشته‌های
wifi\-sec
و
wifi
را به جای
802\-11\-wireless\-security
می‌پذیرد\&. هنگامی که NetworkManager به یک گذرواژه نیاز دارد و ارائه نشده باشد،
\fBnmcli\fR
در صورت اجرا با گزینه
\fB\-\-ask\fR
آن را درخواست خواهد کرد\&. اگر
\fB\-\-ask\fR
ارسال نشده باشد، NetworkManager می‌تواند از یک عامل محرمانه دیگر که ممکن است در حال اجرا باشد (معمولاً یک عامل گرافیکی مانند nm\-applet یا gnome\-shell) درخواست کند\&.
.RE
.RE
.PP
\fBdown\fR [\fBid\fR | \fBuuid\fR | \fBpath\fR | \fBapath\fR] \fIID\fR...
.RS 4
غیرفعال‌سازی یک اتصال از روی یک دستگاه بدون جلوگیری از فعال‌سازی خودکار بعدی دستگاه\&. می‌توان چندین اتصال را به دستور ارسال کرد\&.
.sp
توجه داشته باشید که این دستور اتصال فعال مشخص‌شده را غیرفعال می‌کند، اما دستگاهی که اتصال روی آن فعال بوده است، همچنان آماده اتصال می‌ماند و با جستجو برای یک اتصال مناسب که فلگ \(Aqautoconnect\(Aq آن تنظیم شده باشد، فعال‌سازی خودکار را انجام می‌دهد\&. توجه داشته باشید که نمایه اتصال غیرفعال‌شده به صورت داخلی از اتصال خودکار مجدد مسدود می‌شود؛ بنابراین تا زمان راه‌اندازی مجدد سیستم یا تا زمانی که کاربر اقدامی برای رفع انسداد اتصال خودکار انجام دهد (مانند ویرایش نمایه یا فعال‌سازی صریح آن)، به طور خودکار متصل نخواهد شد\&.
.sp
در بیشتر موارد ممکن است ترجیح دهید از دستور
\fBdevice down\fR
استفاده کنید\&.
.sp
اتصال با نام، UUID یا مسیر D\-Bus آن شناسایی می‌شود\&. اگر
\fIID\fR
مبهم باشد، می‌توان از کلیدواژه‌های
\fBid\fR،
\fBuuid\fR،
\fBpath\fR
یا
\fBapath\fR
استفاده کرد\&.
.sp
برای توضیحات مربوط به کلیدواژه‌های تعیین‌کننده
\fIID\fR
به
\fBconnection show\fR
در بالا مراجعه فرمایید\&.
.sp
اگر گزینه
\fB\-\-wait\fR
مشخص نشود، مهلت زمانی پیش‌فرض ۱۰ ثانیه خواهد بود\&.
.RE
.PP
\fBmodify\fR [\fB\-\-temporary\fR] [\fBid\fR | \fBuuid\fR | \fBpath\fR] [\fIID\fR] {\fIoption\fR\ \fIvalue\fR\ |\ [+|\-]\fIsetting\fR\&.\fIproperty\fR\ \fIvalue\fR}...
.RS 4
افزودن، ویرایش یا حذف ویژگی‌ها در نمایه اتصال\&.
.sp
برای تنظیم ویژگی کافی است نام ویژگی و به دنبال آن مقدار را مشخص کنید\&. یک مقدار خالی ("") مقدار ویژگی را به حالت پیش‌فرض بازمی‌گرداند\&.
.sp
برای مشاهده مرجع کامل نام‌های تنظیمات و ویژگی‌ها، توضیحات و مقادیر پیش‌فرض آن‌ها به
\fBnm-settings-nmcli\fR(5)
مراجعه کنید\&.
\fIsetting\fR
و
\fIproperty\fR
را می‌توان در صورتی که یکتا باشند به صورت اختصاری نیز نوشت\&.
.sp
اگر می‌خواهید یک مورد یا فلگ را به مقدار موجود اضافه کنید، از پیشوند
+
برای نام ویژگی یا نام مستعار استفاده کنید\&. اگر می‌خواهید مواردی را از یک ویژگی کانتینری یا فلگ حذف کنید، از پیشوند
\-
استفاده نمایید\&. برای برخی ویژگی‌ها همچنین می‌توانید عناصر را با تعیین اندیس‌های مبتنی بر صفر حذف کنید\&. اصلاح‌کننده‌های
+
و
\-
تنها برای ویژگی‌هایی که از آن‌ها پشتیبانی می‌کنند اثر واقعی دارند\&. این موارد به عنوان مثال شامل ویژگی‌های چندمقداری (کانتینر) یا فلگ‌هایی مانند
ipv4\&.dns،
ip4،
ipv4\&.addresses،
bond\&.options،
802\-1x\&.phase1\-auth\-flags
و غیره هستند\&.
.sp
اتصال با نام، UUID یا مسیر D\-Bus آن شناسایی می‌شود\&. اگر
\fIID\fR
مبهم باشد، می‌توان از کلیدواژه‌های
\fBid\fR،
\fBuuid\fR
یا
\fBpath\fR
استفاده کرد\&. شناسه
\fIID\fR
با گزینه سراسری
\fB\-\-offline\fR
استفاده نمی‌شود\&.
.sp
هنگامی که گزینه سراسری
\fB\-\-offline\fR
استفاده شود، دستور اتصال را از ورودی استاندارد می‌خواند و اتصال ویرایش‌شده را به جای اعمال روی دیمن NetworkManager، در خروجی استاندارد چاپ می‌کند\&.
.RE
.PP
\fBmodify\fR [\fB\-\-temporary\fR] [\fBid\fR | \fBuuid\fR | \fBpath\fR] \fIID\fR \fBremove\fR\ \fIsetting\fR
.RS 4
یک تنظیم را از نمایه اتصال حذف می‌کند\&.
.RE.PP
\fBadd\fR [\fBsave\fR\ {yes\ |\ no}] {\fIoption\fR\ \fIvalue\fR\ |\ [+|\-]\fIsetting\fR\&.\fIproperty\fR\ \fIvalue\fR}...
.RS 4
ایجاد یک اتصال جدید با استفاده از ویژگی‌های مشخص‌شده\&.
.sp
باید اتصالات جدید را با جفت‌های ویژگی و مقدار توصیف کنید\&. برای مشاهده مرجع کامل به
\fBnm-settings-nmcli\fR(5)
مراجعه فرمایید\&. نحوه نگارش مشابه دستور
\fBnmcli connection modify\fR
است\&.
.sp
برای ساخت یک اتصال معنادار، دست‌کم باید ویژگی
\fBconnection\&.type\fR
(یا نام مستعار
\fBtype\fR)
را روی یکی از انواع شناخته‌شده اتصال NetworkManager تنظیم کنید:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
6lowpan
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
802\-11\-olpc\-mesh
(نام مستعار
olpc\-mesh)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
802\-11\-wireless
(نام مستعار
wifi)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
802\-3\-ethernet
(نام مستعار
ethernet)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
adsl
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
bluetooth
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
bond
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
bond\-slave
(منسوخ‌شده به نفع ethernet با کنترل‌کننده)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
bridge
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
bridge\-slave
(منسوخ‌شده به نفع ethernet با کنترل‌کننده)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
cdma
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
dummy
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
generic
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
gsm
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
hsr
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
infiniband
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ip\-tunnel
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ipvlan
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
loopback
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
macsec
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
macvlan
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
olpc\-mesh
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ovs\-bridge
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ovs\-interface
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ovs\-port
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
pppoe
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
team
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
team\-slave
(منسوخ‌شده به نفع ethernet با کنترل‌کننده)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
tun
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
veth
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
vlan
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
vpn
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
vrf
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
vxlan
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
wifi\-p2p
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
wimax
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
wireguard
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
wpan
.RE
.sp
متداول‌ترین کاربردها در بخش
EXAMPLES
شرح داده شده‌اند\&.
.sp
به غیر از ویژگی‌ها و مقادیر، دو گزینه ویژه نیز پذیرفته می‌شوند:
.PP
\fBsave\fR
.RS 4
کنترل می‌کند که آیا اتصال باید ماندگار باشد یا خیر، یعنی NetworkManager باید آن را روی دیسک ذخیره کند (پیش‌فرض:
yes)\&.
.RE
.PP
\fB\-\-\fR
.RS 4
اگر یک آرگومان تکی
\fB\-\-\fR
مشاهده شود، نادیده گرفته می‌شود\&. این مورد برای سازگاری با نسخه‌های قدیمی‌تر
\fBnmcli\fR
است\&.
.RE
.sp
هنگامی که گزینه سراسری
\fB\-\-offline\fR
استفاده شود، دستور اتصال حاصل را به جای افزودن واقعی از طریق دیمن NetworkManager، در خروجی استاندارد چاپ می‌کند\&.
.RE.PP
\fBedit\fR {[\fBid\fR\ |\ \fBuuid\fR\ |\ \fBpath\fR]\ \fIID\fR | [\fBtype\fR\ \fItype\fR]\ [\fBcon\-name\fR\ \fIname\fR] }
.RS 4
ویرایش یک اتصال موجود یا افزودن یک اتصال جدید با استفاده از ویرایشگر تعاملی\&.
.sp
اتصال موجود با نام، UUID یا مسیر D\-Bus آن شناسایی می‌شود\&. اگر
\fIID\fR
مبهم باشد، می‌توان از یک کلیدواژه
\fBid\fR،
\fBuuid\fR
یا
\fBpath\fR
استفاده کرد\&. برای توضیحات مربوط به کلیدواژه‌های تعیین‌کننده
\fIID\fR
به
\fBconnection show\fR
در بالا مراجعه کنید\&. ارائه نکردن یک
\fIID\fR
به این معنی است که یک اتصال جدید اضافه خواهد شد\&.
.sp
ویرایشگر تعاملی شما را در مراحل ویرایش اتصال راهنمایی می‌کند و به شما امکان می‌دهد با استفاده از یک رابط کاربری ساده مبتنی بر منو، پارامترهای اتصال را مطابق با نیازهای خود تغییر دهید\&. ویرایشگر مشخص می‌کند چه تنظیمات و ویژگی‌هایی قابل تغییر هستند و راهنمایی‌های درون‌خطی ارائه می‌دهد\&.
.sp
گزینه‌های موجود:
.PP
\fBtype\fR
.RS 4
نوع اتصال جدید؛ انواع معتبر همان مواردی هستند که برای دستور
\fBconnection add\fR
بیان شد\&.
.RE
.PP
\fBcon\-name\fR
.RS 4
نام اتصال جدید\&. بعداً می‌توان آن را در ویرایشگر تغییر داد\&.
.RE
.sp
همچنین برای مشاهده تمام نام‌های تنظیمات و ویژگی‌های NetworkManager و توضیحات آن‌ها به
\fBnm-settings-nmcli\fR(5)
و برای نشست‌های نمونه در ویرایشگر به
\fBnmcli-examples\fR(7)
مراجعه نمایید\&.
.RE
.PP
\fBclone\fR [\fB\-\-temporary\fR] [\fBid\fR | \fBuuid\fR | \fBpath\fR] \fIID\fR \fInew_name\fR
.RS 4
شبیه‌سازی (کپی) یک اتصال\&. اتصالی که باید شبیه‌سازی شود با نام، UUID یا مسیر D\-Bus آن شناسایی می‌شود\&. اگر
\fIID\fR
مبهم باشد، می‌توان از یک کلیدواژه
\fBid\fR،
\fBuuid\fR
یا
\fBpath\fR
استفاده کرد\&. برای توضیحات کلیدواژه‌های تعیین‌کننده
\fIID\fR
به
\fBconnection show\fR
در بالا مراجعه فرمایید\&.
\fInew_name\fR
نام اتصال شبیه‌سازی‌شده جدید است\&. اتصال جدید یک رونوشت دقیق خواهد بود، به جز ویژگی‌های connection\&.id
(\fInew_name\fR)
و connection\&.uuid (تولیدشده به صورت خودکار)\&.
.sp
نمایه اتصال جدید به صورت ماندگار ذخیره می‌شود مگر اینکه گزینه
\fB\-\-temporary\fR
مشخص شده باشد، که در این صورت نمایه جدید پس از راه‌اندازی مجدد NetworkManager وجود نخواهد داشت\&.
.RE
.PP
\fBdelete\fR [\fBid\fR | \fBuuid\fR | \fBpath\fR] \fIID\fR...
.RS 4
حذف یک اتصال پیکربندی‌شده\&. اتصال مورد نظر برای حذف با نام، UUID یا مسیر D\-Bus آن شناسایی می‌شود\&. اگر
\fIID\fR
مبهم باشد، می‌توان از یک کلیدواژه
\fBid\fR،
\fBuuid\fR
یا
\fBpath\fR
استفاده کرد\&. برای توضیحات کلیدواژه‌های تعیین‌کننده
\fIID\fR
به
\fBconnection show\fR
در بالا مراجعه کنید\&.
.sp
اگر گزینه
\fB\-\-wait\fR
مشخص نشود، مهلت زمانی پیش‌فرض ۱۰ ثانیه خواهد بود\&.
.RE
.PP
\fBmonitor\fR [\fBid\fR | \fBuuid\fR | \fBpath\fR] \fIID\fR...
.RS 4
پایش فعالیت نمایه اتصال\&. این دستور هر زمان که اتصال مشخص‌شده تغییر کند یک خط چاپ می‌کند\&. اتصالی که باید پایش شود با نام، UUID یا مسیر D\-Bus آن شناسایی می‌شود\&. اگر
\fIID\fR
مبهم باشد، می‌توان از یک کلیدواژه
\fBid\fR،
\fBuuid\fR
یا
\fBpath\fR
استفاده کرد\&. برای توضیحات کلیدواژه‌های تعیین‌کننده
\fIID\fR
به
\fBconnection show\fR
در بالا مراجعه نمایید\&.
.sp
در صورتی که هیچ اتصالی مشخص نشود، تمام نمایه‌های اتصال را پایش می‌کند\&. این دستور زمانی پایان می‌یابد که تمام اتصالات تحت نظارت ناپدید شوند\&. اگر می‌خواهید ایجاد اتصالات جدید را پایش کنید، استفاده از پایشگر سراسری با دستور
\fBnmcli monitor\fR
را در نظر بگیرید\&.
.RE
.PP
\fBreload\fR
.RS 4
بارگذاری مجدد تمام فایل‌های اتصال از روی دیسک\&. برنامه NetworkManager تغییرات اعمال‌شده در فایل‌های اتصالات را پایش نمی‌کند؛ بنابراین باید از این دستور استفاده کنید تا به NetworkManager بگویید هنگام ایجاد تغییر در فایل‌ها، نمایه‌های اتصال را مجدداً از روی دیسک بخواند\&.
.RE
.PP
\fBload\fR \fIfilename\fR...
.RS 4
بارگذاری / بارگذاری مجدد یک یا چند فایل اتصال از روی دیسک\&. پس از ویرایش دستی یک فایل اتصال، از این دستور استفاده کنید تا مطمئن شوید NetworkManager از آخرین وضعیت آن مطلع است\&.
.RE
.PP
\fBimport\fR [\fB\-\-temporary\fR] \fBtype\fR\ \fItype\fR \fBfile\fR\ \fIfile\fR
.RS 4
وارد کردن (ایمپورت) یک پیکربندی خارجی به عنوان نمایه اتصال NetworkManager\&. نوع فایل ورودی توسط گزینه
\fBtype\fR
مشخص می‌شود\&.
.sp
در حال حاضر تنها پیکربندی‌های VPN پشتیبانی می‌شوند\&. این پیکربندی توسط افزونه‌های VPN برنامه NetworkManager وارد می‌شود\&. مقادیر
\fBtype\fR
همان مقادیر گزینه
\fBvpn\-type\fR
در دستور
\fBnmcli connection add\fR
هستند\&. پیکربندی‌های VPN توسط افزونه‌های VPN ایمپورت می‌شوند، بنابراین افزونه مناسب VPN باید نصب شده باشد تا
\fBnmcli\fR
بتواند داده‌ها را وارد کند\&.
.sp
نمایه اتصال واردشده به صورت ماندگار ذخیره می‌شود مگر اینکه گزینه
\fB\-\-temporary\fR
مشخص شده باشد، که در این صورت نمایه جدید پس از راه‌اندازی مجدد NetworkManager وجود نخواهد داشت\&.
.RE
.PP
\fBexport\fR [\fBid\fR | \fBuuid\fR | \fBpath\fR] \fIID\fR [\fIfile\fR]
.RS 4
صادر کردن (اکسپورت) یک اتصال\&.
.sp
در حال حاضر تنها اتصالات VPN پشتیبانی می‌شوند\&. باید یک افزونه مناسب VPN نصب شده باشد تا
\fBnmcli\fR
بتواند اتصال را صادر کند\&. اگر هیچ فایلی
(\fIfile\fR)
ارائه نشود، داده‌های پیکربندی VPN در خروجی استاندارد چاپ خواهند شد\&.
.RE
.PP
\fBmigrate\fR [\fB\-\-plugin\fR\ \fIplugin\fR...] [\fBid\fR | \fBuuid\fR | \fBpath\fR] [\fIID\fR...]
.RS 4
مهاجرت دادن نمایه‌های اتصال به یک افزونه تنظیمات دیگر، مانند
keyfile
(پیش‌فرض) یا
ifcfg\-rh\&.
.sp
اتصالی که باید مهاجرت داده شود با نام، UUID یا مسیر D\-Bus آن شناسایی می‌شود\&. اگر
\fIID\fR
مبهم باشد، می‌توان از یک کلیدواژه
\fBid\fR،
\fBuuid\fR
یا
\fBpath\fR
استفاده کرد\&. برای توضیحات کلیدواژه‌های تعیین‌کننده
\fIID\fR
به
\fBconnection show\fR
در بالا مراجعه کنید\&.
.sp
اگر هیچ اتصالی مشخص نشود، دستور روی تمام اتصالات موجود عمل می‌کند\&. بنابراین، بدون هیچ آرگومانی، دستور تمام نمایه‌های اتصال را به افزونه
keyfile
مهاجرت می‌دهد\&.
.sp
اگر گزینه
\fB\-\-wait\fR
مشخص نشود، مهلت زمانی پیش‌فرض ۱۰ ثانیه خواهد بود\&.
.RE.SH "دستورات مدیریت دستگاه (DEVICE MANAGEMENT COMMANDS)"
.HP \w'\fBnmcli\ device\fR\ 'u
\fBnmcli device\fR {\fBstatus\fR | \fBshow\fR | \fBset\fR | \fBup\fR | \fBconnect\fR | \fBreapply\fR | \fBmodify\fR | \fBdown\fR | \fBdisconnect\fR | \fBdelete\fR | \fBmonitor\fR | \fBwifi\fR | \fBlldp\fR | \fBcheckpoint\fR} [\fIآرگومان‌ها\fR...]
.PP
نمایش و مدیریت رابط‌های شبکه\&.
.PP
\fBstatus\fR
.RS 4
چاپ وضعیت دستگاه‌ها\&.
.sp
این عمل پیش‌فرض است اگر هیچ دستوری برای
\fBnmcli device\fR
مشخص نشود\&.
.RE
.PP
\fBshow\fR [\fIifname\fR]
.RS 4
نمایش اطلاعات تفصیلی درباره دستگاه‌ها\&. بدون آرگومان، تمام دستگاه‌ها بررسی می‌شوند\&. برای دریافت اطلاعات یک دستگاه خاص، باید نام رابط ارائه شود\&.
.RE
.PP
\fBset\fR [ifname] \fIifname\fR [\fBautoconnect\fR\ {yes\ |\ no}] [\fBmanaged\fR\ [\-\-permanent\ |\ \-\-permanent\-only]\ {yes\ |\ no\ |\ up\ |\ down\ |\ reset}]
.RS 4
تنظیم ویژگی‌های دستگاه\&.
.sp
ویژگی
\fBmanaged\fR
گزینه
\fB\-\-permanent\fR
را برای ماندگاری وضعیت مدیریت‌شده روی دیسک (و نه تنها در زمان اجرا) می‌پذیرد\&. با
\fB\-\-permanent\-only\fR
تنها وضعیت مدیریت‌شده دائمی تنظیم می‌شود و نه وضعیت در زمان اجرا\&. مقادیر ویژه
\fBup\fR
و
\fBdown\fR
می‌توانند برای تنظیم وضعیت مدیریتی دستگاه همزمان با وضعیت مدیریت‌شده در زمان اجرا استفاده شوند\&. مقدار
\fBreset\fR
تنظیم صریح مدیریت‌شده را پاک می‌کند و همراه با
\fB\-\-permanent\fR
یا
\fB\-\-permanent\-only\fR
تنظیم ذخیره‌شده ماندگار را نیز حذف می‌نماید\&.
.RE
.PP
\fBup\fR \fIifname\fR
.RS 4
اتصال دستگاه\&. برنامه NetworkManager تلاش خواهد کرد یک اتصال مناسب را پیدا کند که فعال شود\&. همچنین اتصالاتی را که روی اتصال خودکار تنظیم نشده‌اند در نظر خواهد گرفت\&.
.sp
اگر هیچ اتصال سازگاری وجود نداشته باشد، یک نمایه جدید با تنظیمات پیش‌فرض ایجاد و فعال می‌شود\&. این مورد تفاوت میان
\fBnmcli connection up ifname "$DEVICE"\fR
و
\fBnmcli device up "$DEVICE"\fR
را مشخص می‌کند\&.
.sp
اگر گزینه
\fB\-\-wait\fR
مشخص نشود، مهلت زمانی پیش‌فرض ۹۰ ثانیه خواهد بود\&.
.RE
.PP
\fBconnect\fR \fIifname\fR
.RS 4
نام مستعار برای دستور
\fBup\fR\&.
پیش از نسخه 1\&.34\&.0 دستور
\fBup\fR
پشتیبانی نمی‌شد\&.
.RE
.PP
\fBreapply\fR \fIifname\fR
.RS 4
تلاش برای به‌روزرسانی دستگاه با تغییراتی که از زمان آخرین اعمال روی اتصال فعال فعلی ایجاد شده است\&.
.RE
.PP
\fBmodify\fR \fIifname\fR {\fIoption\fR\ \fIvalue\fR\ |\ [+|\-]\fIsetting\fR\&.\fIproperty\fR\ \fIvalue\fR}...
.RS 4
تغییر تنظیمات فعلی فعال روی دستگاه\&.
.sp
این دستور به شما امکان می‌دهد تغییرات موقتی را در پیکربندی فعال روی یک دستگاه خاص اعمال کنید\&. این تغییرات در نمایه اتصال ذخیره نمی‌شوند\&.
.sp
برای فهرستی از ویژگی‌های موجود به
\fBnm-settings-nmcli\fR(5)
مراجعه کنید\&. لطفاً توجه داشته باشید که برخی از ویژگی‌ها را نمی‌توان روی دستگاهی که از قبل متصل است تغییر داد\&.
.RE
.PP
\fBdown\fR \fIifname\fR...
.RS 4
قطع اتصال یک دستگاه و جلوگیری از فعال‌سازی خودکار اتصالات بعدی توسط دستگاه بدون دخالت دستی کاربر\&. توجه داشته باشید که قطع اتصال دستگاه‌های نرم‌افزاری ممکن است باعث ناپدید شدن آن‌ها شود\&.
.sp
اگر گزینه
\fB\-\-wait\fR
مشخص نشود، مهلت زمانی پیش‌فرض ۱۰ ثانیه خواهد بود\&.
.RE
.PP
\fBdisconnect\fR \fIifname\fR...
.RS 4
نام مستعار برای دستور
\fBdown\fR\&.
پیش از نسخه 1\&.34\&.0 دستور
\fBdown\fR
پشتیبانی نمی‌شد\&.
.RE
.PP
\fBdelete\fR \fIifname\fR...
.RS 4
حذف یک دستگاه\&. این دستور رابط را از سیستم حذف می‌کند\&. توجه داشته باشید که این دستور فقط برای دستگاه‌های نرم‌افزاری مانند bond، bridge، team و غیره کار می‌کند\&. دستگاه‌های سخت‌افزاری (مانند اترنت) را نمی‌توان با این دستور حذف کرد\&.
.sp
اگر گزینه
\fB\-\-wait\fR
مشخص نشود، مهلت زمانی پیش‌فرض ۱۰ ثانیه خواهد بود\&.
.RE
.PP
\fBmonitor\fR [\fIifname\fR...]
.RS 4
پایش فعالیت دستگاه\&. این دستور هر زمان که دستگاه‌های مشخص‌شده تغییر وضعیت دهند، یک خط چاپ می‌کند\&.
.sp
در صورتی که هیچ رابطی مشخص نشود، تمام دستگاه‌ها را پایش می‌کند\&. پایشگر زمانی پایان می‌یابد که تمام دستگاه‌های مشخص‌شده ناپدید شوند\&. اگر می‌خواهید اضافه شدن دستگاه‌های جدید را پایش کنید، استفاده از پایشگر سراسری با دستور
\fBnmcli monitor\fR
را در نظر بگیرید\&.
.RE
.PP
\fBwifi\fR [\fBlist\fR\ [\fB\-\-rescan\fR\ |\ \fBauto\fR\ |\ \fBno\fR\ |\ \fByes\fR]\ [\fBifname\fR\ \fIifname\fR]\ [\fBbssid\fR\ \fIBSSID\fR]]
.RS 4
فهرست کردن نقاط دسترسی (AP) موجود Wi\-Fi\&. گزینه‌های
\fBifname\fR
و
\fBbssid\fR
می‌توانند به ترتیب برای فهرست کردن نقاط دسترسی برای یک رابط خاص یا با یک BSSID مشخص استفاده شوند\&.
.sp
به طور پیش‌فرض،
\fBnmcli\fR
اطمینان حاصل می‌کند که فهرست نقاط دسترسی قدیمی‌تر از ۳۰ ثانیه نباشد و در صورت لزوم یک اسکن شبکه را راه‌اندازی می‌کند\&. گزینه
\fB\-\-rescan\fR
می‌تواند برای اجبار یا غیرفعال کردن اسکن، بدون توجه به تازگی فهرست نقاط دسترسی استفاده شود\&.
.RE
.PP
\fBwifi\fR \fBconnect\fR \fI(B)SSID\fR [\fBpassword\fR\ \fIpassword\fR] [\fBwep\-key\-type\fR\ {key\ |\ phrase}] [\fBifname\fR\ \fIifname\fR] [\fBbssid\fR\ \fIBSSID\fR] [\fBname\fR\ \fIname\fR] [\fBprivate\fR\ {yes\ |\ no}] [\fBhidden\fR\ {yes\ |\ no}]
.RS 4
اتصال به یک شبکه Wi\-Fi مشخص‌شده توسط SSID یا BSSID\&. این دستور یک اتصال منطبق را پیدا کرده یا ایجاد می‌کند و سپس آن را روی یک دستگاه فعال می‌سازد\&. این معادل خط فرمانی کلیک روی یک SSID در یک کلاینت گرافیکی است\&. اگر اتصالی برای شبکه از قبل وجود داشته باشد، می‌توان نمایه موجود را به صورت زیر فعال کرد:
\fBnmcli con up id \fR\fB\fIname\fR\fR\&.
توجه داشته باشید که اگر اتصال قبلی وجود نداشته باشد، تنها شبکه‌های باز (open)، WEP و WPA\-PSK پشتیبانی می‌شوند\&. همچنین فرض می‌شود که پیکربندی IP از طریق DHCP به دست می‌آید\&.
.sp
اگر گزینه
\fB\-\-wait\fR
مشخص نشود، مهلت زمانی پیش‌فرض ۹۰ ثانیه خواهد بود\&.
.sp
گزینه‌های موجود عبارتند از:
.PP
\fBpassword\fR
.RS 4
گذرواژه برای شبکه‌های امن (WEP یا WPA)\&.
.RE
.PP
\fBwep\-key\-type\fR
.RS 4
نوع کلید محرمانه WEP، یا
\fBkey\fR
برای کلید ASCII/HEX یا
\fBphrase\fR
برای عبارت عبور (passphrase)\&.
.RE
.PP
\fBifname\fR
.RS 4
رابطی که برای فعال‌سازی استفاده خواهد شد\&.
.RE
.PP
\fBbssid\fR
.RS 4
در صورت تعیین، اتصال ایجادشده تنها به این BSSID محدود خواهد شد\&.
.RE
.PP
\fBname\fR
.RS 4
در صورت تعیین، اتصال از این نام استفاده خواهد کرد (در غیر این صورت NetworkManager خود یک نام ایجاد می‌کند)\&.
.RE
.PP
\fBprivate\fR
.RS 4
اگر روی
yes
تنظیم شود، اتصال فقط برای کاربری که آن را ایجاد کرده قابل مشاهده خواهد بود\&. در غیر این صورت، اتصال در سطح کل سیستم است که حالت پیش‌فرض می‌باشد\&.
.RE
.PP
\fBhidden\fR
.RS 4
هنگام اتصال برای نخستین بار به یک نقطه دسترسی که SSID خود را پخش نمی‌کند (مخفی است)، روی
yes
تنظیم کنید\&. در غیر این صورت SSID پیدا نشده و تلاش برای اتصال ناموفق خواهد بود\&.
.RE
.RE
.PP
\fBwifi\fR \fBhotspot\fR [\fBifname\fR\ \fIifname\fR] [\fBcon\-name\fR\ \fIname\fR] [\fBssid\fR\ \fISSID\fR] [\fBband\fR\ {a\ |\ bg\ |\ 6GHz}] [\fBchannel\fR\ \fIchannel\fR] [\fBpassword\fR\ \fIpassword\fR]
.RS 4
ایجاد یک نقطه اتصال (هات‌اسپات) Wi\-Fi\&. این دستور یک نمایه اتصال نقطه اتصال را بر اساس قابلیت‌های دستگاه Wi\-Fi ایجاد کرده و آن را روی دستگاه فعال می‌کند\&. اگر دستگاه/درایور پشتیبانی کند، نقطه اتصال با WPA ایمن می‌شود، در غیر این صورت از WEP استفاده خواهد شد\&. از
\fBconnection down\fR
یا
\fBdevice down\fR
برای متوقف کردن هات‌اسپات استفاده کنید\&.
.sp
پارامترهای نقطه اتصال می‌توانند تحت تأثیر پارامترهای اختیاری زیر قرار گیرند:
.PP
\fBifname\fR
.RS 4
کدام دستگاه Wi\-Fi استفاده شود\&.
.RE
.PP
\fBcon\-name\fR
.RS 4
نام نمایه اتصال نقطه اتصال ایجادشده\&.
.RE
.PP
\fBssid\fR
.RS 4
شناسه SSID نقطه اتصال\&.
.RE
.PP
\fBband\fR
.RS 4
باند Wi\-Fi مورد استفاده\&.
.RE
.PP
\fBchannel\fR
.RS 4
کانال Wi\-Fi مورد استفاده\&.
.RE
.PP
\fBpassword\fR
.RS 4
گذرواژه مورد استفاده برای نقطه اتصال ایجادشده\&. اگر ارائه نشود،
\fBnmcli\fR
یک گذرواژه تولید خواهد کرد\&. گذرواژه یا کلید پیش‌اشتراکی WPA است یا کلید WEP\&.
.sp
توجه داشته باشید که گزینه سراسری
\fB\-\-show\-secrets\fR
می‌تواند برای چاپ گذرواژه نقطه اتصال استفاده شود؛ به ویژه زمانی که گذرواژه تولید شده باشد بسیار مفید است\&.
.RE
.RE
.PP
\fBwifi\fR \fBrescan\fR [\fBifname\fR\ \fIifname\fR] [\fBssid\fR\ \fISSID\fR...]
.RS 4
درخواست از NetworkManager برای اسکن فوری نقاط دسترسی موجود\&. برنامه NetworkManager شبکه‌های Wi\-Fi را به طور دوره‌ای اسکن می‌کند، اما در برخی موارد ممکن است شروع اسکن به صورت دستی مفید باشد (مانند پس از بیدار شدن رایانه از خواب)\&. با استفاده از
\fBssid\fR،
امکان اسکن برای یک SSID خاص وجود دارد که برای نقاط دسترسی با SSID مخفی کاربرد دارد\&. می‌توانید چندین پارامتر
\fBssid\fR
را برای اسکن SSIDهای بیشتر ارائه دهید\&.
.sp
این دستور نقاط دسترسی را نشان نمی‌دهد، برای این منظور از
\fBnmcli device wifi list\fR
استفاده کنید\&.
.RE
.PP
\fBwifi\fR \fBshow\-password\fR [\fBifname\fR\ \fIifname\fR]
.RS 4
نمایش جزئیات شبکه‌های فعال Wi\-Fi، شامل اطلاعات محرمانه و رمزهای عبور\&.
.RE
.PP
\fBlldp\fR [\fBlist\fR\ [\fBifname\fR\ \fIifname\fR]]
.RS 4
نمایش اطلاعات درباره دستگاه‌های همسایه که از طریق پروتکل کشف لایه پیوند (LLDP) دریافت شده‌اند\&. گزینه
\fBifname\fR
می‌تواند برای فهرست کردن همسایه‌ها فقط برای یک رابط خاص استفاده شود\&. این پروتکل باید در تنظیمات اتصال فعال شده باشد\&.
.RE
.PP
\fBcheckpoint\fR [\fB\-\-timeout\fR\ \fIseconds\fR] [\fIifname\fR...] \fB\-\-\fR \fICOMMAND\fR...
.RS 4
دستور را با ثبت یک نقطه بازرسی (checkpoint) پیکربندی اجرا می‌کند و پس از اتمام درخواست تأیید می‌نماید\&. هنگامی که تأیید داده نشود، نقطه بازرسی پس از پایان مهلت زمانی به طور خودکار بازیابی می‌شود\&.
.sp
این ویژگی امکان اعمال تغییرات پیکربندی مخرب یا پرریسک را روی اتصالات از راه دور فراهم می‌کند، با این قابلیت که در صورت بروز خطا، پیکربندی شبکه به یک وضعیت پایدار و خوب شناخته‌شده قبلی بازگردد\&.
.sp
اگر فهرستی از نام‌های رابط مشخص شود، نقطه بازرسی تنها روی دستگاه‌های مشخص‌شده ثبت می‌شود؛ در غیر این صورت یک نقطه بازرسی برای تمام دستگاه‌ها گرفته خواهد شد\&.
.sp
در حال حاضر مهلت زمانی به طور پیش‌فرض ۱۵ ثانیه است\&. این مقدار ممکن است در نسخه‌های بعدی تغییر کند\&.
.RE.SH "عامل محرمانه (SECRET AGENT)"
.HP \w'\fBnmcli\ agent\fR\ 'u
\fBnmcli agent\fR {\fBsecret\fR | \fBpolkit\fR | \fBall\fR}
.PP
اجرای
\fBnmcli\fR
به عنوان یک عامل محرمانه (secret agent) یا عامل polkit برای NetworkManager\&.
.PP
\fBsecret\fR
.RS 4
ثبت
\fBnmcli\fR
به عنوان عامل محرمانه NetworkManager و گوش دادن به درخواست‌های اطلاعات محرمانه و رمزهای عبور\&. شما معمولاً به این دستور نیازی ندارید، زیرا
\fBnmcli\fR
می‌تواند اسرار را هنگام اتصال به شبکه‌ها مدیریت کند\&. با این حال، ممکن است این دستور را زمانی مفید بیابید که از ابزار دیگری برای فعال‌سازی اتصالات استفاده می‌کنید و هیچ عامل محرمانه‌ای (مانند nm\-applet) در دسترس ندارید\&.
.RE
.PP
\fBpolkit\fR
.RS 4
ثبت
\fBnmcli\fR
به عنوان یک عامل polkit برای نشست کاربر و گوش دادن به درخواست‌های مجوز\&. شما معمولاً به این دستور نیازی ندارید، زیرا
\fBnmcli\fR
می‌تواند اقدامات polkit مربوط به عملیات‌های NetworkManager را (هنگامی که با
\fB\-\-ask\fR
اجرا شود) مدیریت کند\&. با این حال، ممکن است این دستور زمانی مفید باشد که بخواهید یک عامل متنی ساده polkit اجرا کنید و هیچ عاملی از یک محیط دسکتاپ ندارید\&. توجه داشته باشید که اجرای این دستور باعث می‌شود
\fBnmcli\fR
تمام درخواست‌های polkit را مدیریت کند و نه فقط موارد مربوط به NetworkManager، زیرا تنها یک عامل polkit می‌تواند برای یک نشست اجرا شود\&.
.RE
.PP
\fBall\fR
.RS 4
اجرای
\fBnmcli\fR
هم به عنوان عامل محرمانه NetworkManager و هم به عنوان عامل polkit\&.
.RE
.SH "رنگ‌ها (COLORS)"
.PP
رنگ‌آمیزی ضمنی را می‌توان با یک فایل خالی
/etc/terminal\-colors\&.d/nmcli\&.disable
غیرفعال کرد\&.
.PP
برای مشاهده جزئیات بیشتر درباره پیکربندی رنگ‌آمیزی به
\fBterminal-colors.d\fR(5)
مراجعه کنید\&. نام‌های منطقی رنگ‌های پشتیبانی‌شده توسط
\fBnmcli\fR
عبارتند از:
.PP
\fBconnection\-activated\fR
.RS 4
اتصالی که فعال است\&.
.RE
.PP
\fBconnection\-activating\fR
.RS 4
اتصالی که در حال فعال شدن است\&.
.RE
.PP
\fBconnection\-disconnecting\fR
.RS 4
اتصالی که در حال قطع شدن است\&.
.RE
.PP
\fBconnection\-external\fR
.RS 4
اتصالی که نمایانگر پیکربندی ایجادشده در خارج از NetworkManager است\&.
.RE
.PP
\fBconnection\-invisible\fR
.RS 4
اتصالی که کاربر مجاز به دیدن جزئیات آن نیست\&.
.RE
.PP
\fBconnection\-deprecated\fR
.RS 4
اتصالی که از تنظیمات منسوخ‌شده استفاده می‌کند\&. ممکن است فعال‌سازی آن امکان‌پذیر نباشد\&.
.RE
.PP
\fBconnectivity\-full\fR
.RS 4
وضعیت اتصال هنگامی که اینترنت در دسترس است\&.
.RE
.PP
\fBconnectivity\-limited\fR
.RS 4
وضعیت اتصال هنگامی که تنها شبکه محلی در دسترس است\&.
.RE
.PP
\fBconnectivity\-none\fR
.RS 4
وضعیت اتصال هنگامی که اتصال شبکه قطع است\&.
.RE
.PP
\fBconnectivity\-portal\fR
.RS 4
وضعیت اتصال زمانی که یک پورتال محصور (captive portal) اتصال را رهگیری کرده است\&.
.RE
.PP
\fBconnectivity\-unknown\fR
.RS 4
وضعیت اتصال هنگامی که بررسی اتصال اجرا نشده باشد\&.
.RE
.PP
\fBdevice\-activated\fR
.RS 4
دستگاهی که متصل است\&.
.RE
.PP
\fBdevice\-activating\fR
.RS 4
دستگاهی که در حال پیکربندی است\&.
.RE
.PP
\fBdevice\-disconnected\fR
.RS 4
دستگاهی که متصل نیست\&.
.RE
.PP
\fBdevice\-external\fR
.RS 4
دستگاهی که در خارج از NetworkManager پیکربندی شده است\&.
.RE
.PP
\fBdevice\-firmware\-missing\fR
.RS 4
هشدار در مورد میان‌افزار (firmware) ناموجود دستگاه\&.
.RE
.PP
\fBdevice\-plugin\-missing\fR
.RS 4
هشدار در مورد افزونه ناموجود دستگاه\&.
.RE
.PP
\fBdevice\-unavailable\fR
.RS 4
دستگاهی که برای فعال‌سازی در دسترس نیست\&.
.RE
.PP
\fBdevice\-disabled\fR
.RS 4
دستگاه توسط کلید قطع نرم‌افزاری یا سخت‌افزاری غیرفعال شده است\&.
.RE
.PP
\fBmanager\-running\fR
.RS 4
اعلام اینکه دیمن NetworkManager در دسترس است\&.
.RE
.PP
\fBmanager\-starting\fR
.RS 4
اعلام اینکه دیمن NetworkManager در حال اتصال اولیه است\&.
.RE
.PP
\fBmanager\-stopped\fR
.RS 4
اعلام اینکه دیمن NetworkManager در دسترس نیست\&.
.RE
.PP
\fBpermission\-auth\fR
.RS 4
اقدامی که برای دریافت مجوز به احراز هویت کاربر نیاز دارد\&.
.RE
.PP
\fBpermission\-no\fR
.RS 4
اقدامی که مجاز نیست\&.
.RE
.PP
\fBpermission\-yes\fR
.RS 4
اقدامی که مجاز است\&.
.RE
.PP
\fBprompt\fR
.RS 4
اعلان در حالت تعاملی\&.
.RE
.PP
\fBstate\-asleep\fR
.RS 4
نشان‌دهنده قرار داشتن NetworkManager در وضعیت تعلیق (suspended)\&.
.RE
.PP
\fBstate\-connected\-global\fR
.RS 4
نشان‌دهنده اتصال NetworkManager به اینترنت\&.
.RE
.PP
\fBstate\-connected\-local\fR
.RS 4
نشان‌دهنده قرار داشتن NetworkManager در شبکه محلی\&.
.RE
.PP
\fBstate\-connected\-site\fR
.RS 4
نشان‌دهنده اتصال NetworkManager به شبکه‌هایی غیر از اینترنت\&.
.RE
.PP
\fBstate\-connecting\fR
.RS 4
نشان‌دهنده در حال برقراری اتصال شبکه بودن NetworkManager\&.
.RE
.PP
\fBstate\-disconnected\fR
.RS 4
نشان‌دهنده قطع بودن NetworkManager از شبکه\&.
.RE
.PP
\fBstate\-disconnecting\fR
.RS 4
نشان‌دهنده در حال قطع اتصال بودن NetworkManager از یک شبکه\&.
.RE
.PP
\fBwifi\-signal\-excellent\fR
.RS 4
شبکه Wi\-Fi با سطح سیگنال عالی\&.
.RE
.PP
\fBwifi\-signal\-fair\fR
.RS 4
شبکه Wi\-Fi با سطح سیگنال متوسط\&.
.RE
.PP
\fBwifi\-signal\-good\fR
.RS 4
شبکه Wi\-Fi با سطح سیگنال خوب\&.
.RE
.PP
\fBwifi\-signal\-poor\fR
.RS 4
شبکه Wi\-Fi با سطح سیگنال ضعیف\&.
.RE
.PP
\fBwifi\-signal\-unknown\fR
.RS 4
شبکه Wi\-Fi که عملاً دیده نشده است (یک نقطه دسترسی مخفی)\&.
.RE
.PP
\fBwifi\-deprecated\fR
.RS 4
شبکه Wi\-Fi که ممکن است به دلیل استفاده از قابلیت‌های منسوخ‌شده، اتصال به آن غیرممکن باشد\&.
.RE
.PP
\fBdisabled\fR
.RS 4
ویژگی‌ای که خاموش (غیرفعال) است\&.
.RE
.PP
\fBenabled\fR
.RS 4
ویژگی‌ای که روشن (فعال) است\&.
.RE.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.PP
رفتار
\fBnmcli\fR
تحت تأثیر متغیرهای محیطی زیر قرار دارد\&.
.PP
\fBLC_ALL\fR
.RS 4
اگر روی یک مقدار رشته‌ای غیرخالی تنظیم شود، مقادیر تمام متغیرهای بین‌المللی‌سازی دیگر را نادیده می‌گیرد\&.
.RE
.PP
\fBLC_MESSAGES\fR
.RS 4
محلی‌سازی (locale) مورد استفاده برای پیام‌های بین‌المللی را تعیین می‌کند\&.
.RE
.PP
\fBLANG\fR
.RS 4
یک مقدار پیش‌فرض برای متغیرهای بین‌المللی‌سازی که تنظیم نشده یا تهی (null) هستند ارائه می‌دهد\&.
.RE
.PP
\fBNO_COLOR\fR
.RS 4
پیش‌فرض برای عدم تولید خروجی رنگی و صفحه‌بندی‌شده\&. گزینه
\fB\-\-colors\fR
در صورت استفاده اولویت دارد\&.
.RE
.PP
\fBPAGER\fR
.RS 4
فیلتری برای هدایت خروجی از طریق لوله (pipe) در صورتی که در یک صفحه جا نشود\&. می‌تواند نام فایل یک برنامه اجرایی یا یک دستور شل باشد\&. رشته خالی برای غیرفعال کردن این قابلیت استفاده می‌شود\&.
.sp
توجه داشته باشید که انتظار می‌رود دستور صفحه‌بند کاراکترهای عریض و توالی‌های گریز ANSI برای تغییر رنگ‌ها را (مگر اینکه غیرفعال شده باشند) مدیریت کند\&. برنامه
\fBnmcli\fR
متغیرهای محیطی
\fBLESS\fR
و
\fBLESSCHARSET\fR
را به طور مناسب برای صفحه‌بند
\fBless\fR(1)
تنظیم می‌کند؛ سایر صفحه‌بندها ممکن است به پیکربندی اضافی نیاز داشته باشند یا نداشته باشند\&.
.sp
در صورت عدم تعیین، دستورات
\fBpager\fR(1)،
\fBless\fR(1)
و
\fBmore\fR(1)
(به همین ترتیب) امتحان خواهند شد\&.
.RE
.PP
\fBTERM\fR
.RS 4
نوع ترمینال\&. اگر روی
dumb
تنظیم شده باشد،
\fBnmcli\fR
از یک صفحه‌بند استفاده نخواهد کرد و توالی‌های گریز ANSI را برای رنگ‌آمیزی تولید نمی‌کند\&.
.sp
فرض می‌شود که انواع ترمینال به غیر از
dumb
از توالی‌های گریز ASCII برای تنظیم رنگ خروجی پشتیبانی می‌کنند\&.
.RE
.SH "نکات بین‌المللی‌سازی (INTERNATIONALIZATION NOTES)"
.PP
توجه داشته باشید که
\fBnmcli\fR
بومی‌سازی شده است و به همین دلیل خروجی آن به محیط شما بستگی دارد\&. درک این موضوع به ویژه هنگامی که خروجی را پردازش و تحلیل می‌کنید (parse) اهمیت دارد\&.
.PP
برای اطمینان از اینکه زبان (locale) هنگام اجرا در اسکریپت روی
C
تنظیم شده است،
\fBnmcli\fR
را به صورت زیر فراخوانی کنید:
.PP
\fBLC_ALL=C nmcli\fR
.PP
متغیرهای
\fBLC_ALL\fR،
\fBLC_MESSAGES\fR
و
\fBLANG\fR
دسته محلی‌سازی
\fBLC_MESSAGES\fR
را (به همین ترتیب) مشخص می‌کنند، که زبانی را که
\fBnmcli\fR
برای پیام‌ها استفاده می‌کند تعیین می‌نماید\&. در صورتی که هیچ‌یک از این متغیرها تنظیم نشده باشند، از محلی‌سازی
C
استفاده می‌شود و این محلی‌سازی از پیام‌های انگلیسی استفاده می‌کند\&.
.SH "وضعیت خروج (EXIT STATUS)"
.PP
برنامه
\fBnmcli\fR
در صورت موفقیت با وضعیت 0 خارج می‌شود، و در صورت بروز خطا مقداری بزرگتر از 0 برگردانده خواهد شد\&.
.PP
\fB0\fR
.RS 4
موفقیت \(en نشان می‌دهد که عملیات با موفقیت انجام شد\&.
.RE
.PP
\fB1\fR
.RS 4
خطای ناشناخته یا نامشخص\&.
.RE
.PP
\fB2\fR
.RS 4
ورودی نامعتبر کاربر، فراخوانی نادرست
\fBnmcli\fR\&.
.RE
.PP
\fB3\fR
.RS 4
پایان مهلت زمانی (گزینه
\fB\-\-wait\fR
را ببینید)\&.
.RE
.PP
\fB4\fR
.RS 4
فعال‌سازی اتصال ناموفق بود\&.
.RE
.PP
\fB5\fR
.RS 4
غیرفعال‌سازی اتصال ناموفق بود\&.
.RE
.PP
\fB6\fR
.RS 4
قطع ارتباط دستگاه ناموفق بود\&.
.RE
.PP
\fB7\fR
.RS 4
حذف اتصال ناموفق بود\&.
.RE
.PP
\fB8\fR
.RS 4
برنامه NetworkManager در حال اجرا نیست\&.
.RE
.PP
\fB10\fR
.RS 4
اتصال، دستگاه یا نقطه دسترسی وجود ندارد\&.
.RE
.PP
\fB65\fR
.RS 4
هنگام استفاده با گزینه
\fB\-\-complete\-args\fR،
انتظار می‌رود یک نام فایل به دنبال آن بیاید\&.
.RE.SH "مثال‌ها (EXAMPLES)"
.PP
این بخش مثال‌های مختلفی از نحوه استفاده از
\fBnmcli\fR
را ارائه می‌دهد\&. اگر به مثال‌های بیشتری نیاز دارید، لطفاً به صفحه راهنمای
\fBnmcli-examples\fR(7)
مراجعه فرمایید\&.
.PP
\fBnmcli \-t \-f RUNNING general\fR
.RS 4
به شما می‌گوید که آیا NetworkManager در حال اجرا است یا خیر\&.
.RE
.PP
\fBnmcli \-t \-f STATE general\fR
.RS 4
وضعیت کلی NetworkManager را نشان می‌دهد\&.
.RE
.PP
\fBnmcli radio wifi off\fR
.RS 4
وای‌فای (Wi\-Fi) را خاموش می‌کند\&.
.RE
.PP
\fBnmcli connection show\fR
.RS 4
تمام اتصالات موجود در NetworkManager را فهرست می‌کند\&.
.RE
.PP
\fBnmcli \-p \-m multiline \-f all con show\fR
.RS 4
تمام اتصالات پیکربندی‌شده را در حالت چندخطی نشان می‌دهد\&.
.RE
.PP
\fBnmcli connection show \-\-active\fR
.RS 4
تمام اتصالات فعال فعلی را فهرست می‌کند\&.
.RE
.PP
\fBnmcli \-f name,autoconnect c s\fR
.RS 4
تمام نام‌های نمایه‌های اتصال و ویژگی اتصال خودکار (autoconnect) آن‌ها را نشان می‌دهد\&.
.RE
.PP
\fBnmcli \-p connection show "My default em1"\fR
.RS 4
جزئیات نمایه اتصال "My default em1" را نشان می‌دهد\&.
.RE
.PP
\fBnmcli \-\-show\-secrets connection show "My Home Wi\-Fi"\fR
.RS 4
جزئیات نمایه اتصال "My Home Wi\-Fi" را همراه با تمام گذرواژه‌ها نشان می‌دهد\&. بدون گزینه
\fB\-\-show\-secrets\fR،
داده‌های محرمانه و رمزها نمایش داده نخواهند شد\&.
.RE
.PP
\fBnmcli \-f active connection show "My default em1"\fR
.RS 4
جزئیات اتصال فعال "My default em1"، مانند IP، اطلاعات DHCP و غیره را نشان می‌دهد\&.
.RE
.PP
\fBnmcli \-f profile con s "My wired connection"\fR
.RS 4
جزئیات پیکربندی ایستای نمایه اتصال با نام "My wired connection" را نشان می‌دهد\&.
.RE
.PP
\fBnmcli \-p con up "My wired connection" ifname eth0\fR
.RS 4
نمایه اتصال با نام "My wired connection" را روی رابط eth0 فعال می‌کند\&. گزینه \-p باعث می‌شود
\fBnmcli\fR
پیشرفت فعال‌سازی را نشان دهد\&.
.RE
.PP
\fBnmcli con up 6b028a27\-6dc9\-4411\-9886\-e9ad1dd43761 ap 00:3A:98:7C:42:D3\fR
.RS 4
اتصال Wi\-Fi با شناسه UUID معادل 6b028a27\-6dc9\-4411\-9886\-e9ad1dd43761 را به نقطه دسترسی (AP) با BSSID مشخص 00:3A:98:7C:42:D3 متصل می‌کند\&.
.RE
.PP
\fBnmcli device status\fR
.RS 4
وضعیت تمام دستگاه‌ها را نشان می‌دهد\&.
.RE
.PP
\fBnmcli dev down em2\fR
.RS 4
اتصال روی رابط em2 را قطع کرده و دستگاه را برای اتصال خودکار غیرقابل دسترس علامت‌گذاری می‌کند\&. در نتیجه، تا زمانی که ویژگی \(Aqautoconnect\(Aq دستگاه روی TRUE تنظیم نشود یا کاربر اتصال را به صورت دستی فعال نکند، هیچ اتصالی به طور خودکار روی دستگاه فعال نخواهد شد\&.
.RE
.PP
\fBnmcli \-f GENERAL,WIFI\-PROPERTIES dev show wlan0\fR
.RS 4
جزئیات رابط wlan0 را نشان می‌دهد؛ فقط بخش‌های GENERAL و WIFI\-PROPERTIES نمایش داده خواهند شد\&.
.RE
.PP
\fBnmcli \-f CONNECTIONS device show wlp3s0\fR
.RS 4
تمام نمایه‌های اتصال موجود برای رابط Wi\-Fi شما (wlp3s0) را نشان می‌دهد\&.
.RE
.PP
\fBnmcli dev wifi\fR
.RS 4
نقاط دسترسی Wi\-Fi شناخته‌شده برای NetworkManager را فهرست می‌کند\&.
.RE
.PP
\fBnmcli dev wifi con "Cafe Hotspot 1" password caffeine name "My cafe"\fR
.RS 4
یک اتصال جدید به نام "My cafe" ایجاد کرده و سپس با استفاده از گذرواژه "caffeine" آن را به نقطه دسترسی با SSID به نام "Cafe Hotspot 1" متصل می‌کند\&. این دستور به ویژه هنگام اتصال برای اولین بار به "Cafe Hotspot 1" مفید است\&. دفعه بعد، بهتر است از
\fBnmcli con up id "My cafe"\fR
استفاده شود تا از نمایه اتصال موجود استفاده شده و اتصال اضافی ایجاد نگردد\&.
.RE
.PP
\fBnmcli \-s dev wifi hotspot con\-name QuickHotspot\fR
.RS 4
یک نمایه نقطه اتصال (هات‌اسپات) ایجاد کرده و آن را متصل می‌کند\&. گذرواژه نقطه اتصال را چاپ می‌کند که کاربر باید از آن برای اتصال به هات‌اسپات از طریق سایر دستگاه‌ها استفاده کند\&.
.RE
.PP
\fBnmcli dev modify em1 ipv4\&.method shared\fR
.RS 4
اشتراک‌گذاری اتصال IPv4 را با استفاده از دستگاه em1 آغاز می‌کند\&. این اشتراک‌گذاری تا زمانی که اتصال دستگاه قطع شود فعال خواهد بود\&.
.RE
.PP
\fBnmcli dev modify em1 ipv6\&.address 2001:db8::a:bad:c0de\fR
.RS 4
به صورت موقت یک آدرس IP به یک دستگاه اضافه می‌کند\&. این آدرس زمانی که همان اتصال مجدداً فعال شود حذف خواهد شد\&.
.RE
.PP
\fBnmcli connection add type ethernet autoconnect no ifname eth0\fR
.RS 4
به صورت غیرتعاملی یک اتصال اترنت متصل به رابط eth0 با پیکربندی خودکار IP (از طریق DHCP) اضافه کرده و فلگ
autoconnect
اتصال را غیرفعال می‌کند\&.
.RE
.PP
\fBnmcli c a ifname Maxipes\-fik type vlan dev eth0 id 55\fR
.RS 4
به صورت غیرتعاملی یک اتصال VLAN با شناسه 55 اضافه می‌کند\&. این اتصال از eth0 استفاده خواهد کرد و رابط VLAN به نام Maxipes\-fik نام‌گذاری خواهد شد\&.
.RE
.PP
\fBnmcli c a ifname eth0 type ethernet ipv4\&.method disabled ipv6\&.method link\-local\fR
.RS 4
به صورت غیرتعاملی اتصالی اضافه می‌کند که از رابط اترنت eth0 استفاده کرده و تنها یک آدرس محلی پیوند (link\-local) IPv6 روی آن پیکربندی شده است\&.
.RE
.PP
\fBnmcli connection edit ethernet\-em1\-2\fR
.RS 4
اتصال موجود "ethernet\-em1\-2" را در ویرایشگر تعاملی ویرایش می‌کند\&.
.RE
.PP
\fBnmcli connection edit type ethernet con\-name "yet another Ethernet connection"\fR
.RS 4
یک اتصال اترنت جدید در ویرایشگر تعاملی اضافه می‌کند\&.
.RE
.PP
\fBnmcli con mod ethernet\-2 connection\&.autoconnect no\fR
.RS 4
ویژگی \(Aqautoconnect\(Aq را در تنظیم \(Aqconnection\(Aq مربوط به اتصال \(Aqethernet\-2\(Aq ویرایش می‌کند\&.
.RE
.PP
\fBnmcli con mod "Home Wi\-Fi" wifi\&.mtu 1350\fR
.RS 4
ویژگی \(Aqmtu\(Aq را در تنظیم \(Aqwifi\(Aq مربوط به اتصال \(AqHome Wi\-Fi\(Aq ویرایش می‌کند\&.
.RE
.PP
\fBnmcli con mod em1\-1 ipv4\&.method manual ipv4\&.addr "192\&.168\&.1\&.23/24 192\&.168\&.1\&.1, 10\&.10\&.1\&.5/8, 10\&.0\&.0\&.11"\fR
.RS 4
آدرس‌دهی دستی و آدرس‌ها را در نمایه em1\-1 تنظیم می‌کند\&.
.RE
.PP
\fBnmcli con modify ABC +ipv4\&.dns 8\&.8\&.8\&.8\fR
.RS 4
یک سرور عمومی DNS گوگل را به سرورهای DNS در نمایه ABC اضافه می‌کند\&.
.RE
.PP
\fBnmcli con modify ABC \-ipv4\&.addresses "192\&.168\&.100\&.25/24 192\&.168\&.1\&.1"\fR
.RS 4
آدرس IP مشخص‌شده را از نمایه (ایستای) ABC حذف می‌کند\&.
.RE
.PP
\fBnmcli con import type openvpn file ~/Downloads/frootvpn\&.ovpn\fR
.RS 4
یک پیکربندی OpenVPN را به NetworkManager وارد می‌کند\&.
.RE
.PP
\fBnmcli con export corp\-vpnc /home/joe/corpvpn\&.conf\fR
.RS 4
نمایه VPN مربوط به corp\-vpnc در NetworkManager را به عنوان پیکربندی استاندارد سیسکو (vpnc) صادر می‌کند\&.
.RE
.SH "نکات (NOTES)"
.PP
\fBnmcli\fR
نام‌های اختصاری را می‌پذیرد، به شرطی که یک پیشوند یکتا در مجموعه گزینه‌های ممکن باشند\&. با اضافه شدن گزینه‌های جدید، تضمینی وجود ندارد که این اختصارات یکتا باقی بمانند\&. بنابراین برای اسکریپت‌نویسی و سازگاری طولانی‌مدت، قویاً توصیه می‌شود نام‌های کامل گزینه‌ها را بنویسید\&.
.SH "ایرادات (BUGS)"
.PP
احتمالاً اشکالاتی وجود دارد\&. اگر باگی پیدا کردید، لطفاً آن را به توزیع خود یا به پروژه اصلی در آدرس زیر گزارش دهید:
https://gitlab\&.freedesktop\&.org/NetworkManager/NetworkManager
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBnmcli-examples\fR(7)،
\fBnm-settings-nmcli\fR(5)،
\fBnm-online\fR(1)،
\fBNetworkManager\fR(8)،
\fBNetworkManager.conf\fR(5)،
\fBnm-applet\fR(1)،
\fBnm-connection-editor\fR(1)،
\fBterminal-colors.d\fR(5)\&.