.\" Automatically generated by Pandoc 3.6.1
.\"
.TH "NETPLAN\-DBUS" "8" "" ""
.SH "نام (NAME)"
netplan\-dbus \- سرویس پیکربندی شبکه از طریق واسط D-Bus در Netplan
.SH "خلاصه دستور (SYNOPSIS)"
\f[B]\f[CB]netplan\-dbus\f[B]\f[R]
.SH "توضیحات (DESCRIPTION)"
دستور
\f[B]\f[CB]netplan\-dbus\f[B]\f[R]
یک دیمن D\-Bus است که
\f[CR]io.netplan.Netplan\f[R]
را روی گذرگاه سیستم (system bus) فراهم می‌کند.
شیء
\f[CR]/io/netplan/Netplan\f[R]
یک واسط
\f[CR]io.netplan.Netplan\f[R]
ارائه می‌دهد که متدهای زیر را در بر دارد:
.IP \[bu] 2
\f[CR]Apply() \-> b\f[R]:
دستور
\f[CR]netplan apply\f[R]
را فراخوانی می‌کند و وضعیت موفقیت یا شکست را برمی‌گرداند.
.IP \[bu] 2
\f[CR]Generate() \-> b\f[R]:
دستور
\f[CR]netplan generate\f[R]
را فراخوانی می‌کند و وضعیت موفقیت یا شکست را برمی‌گرداند.
.IP \[bu] 2
\f[CR]Info() \-> a(sv)\f[R]:
یک دیکشنری به صورت
\[dq]Features \-> as\[dq]
برمی‌گرداند که شامل آرایه‌ای از تمام پرچم‌های ویژگی‌های در دسترس است.
.IP \[bu] 2
\f[CR]Config() \-> o\f[R]:
یک شیء پیکربندی جدید به صورت
\f[CR]/io/netplan/Netplan/config/<ID>\f[R]
با کپی کردن وضعیت فعلی از
\f[CR]/{etc,run,lib}/netplan/*.yaml\f[R]
آماده می‌سازد.
.PP
اشیاء
\f[CR]/io/netplan/Netplan/config/<ID>\f[R]
یک واسط
\f[CR]io.netplan.Netplan.Config\f[R]
ارائه می‌دهند که متدهای زیر را در بر دارد:
.IP \[bu] 2
\f[CR]Get() \-> s\f[R]:
دستور
\f[CR]netplan get \-\-root\-dir=/run/netplan/config\-ID all\f[R]
را فراخوانی کرده و پیکربندی ادغام‌شدهٔ YAML از وضعیت شیء پیکربندی داده‌شده را برمی‌گرداند.
.IP \[bu] 2
\f[CR]Set(s:CONFIG_DELTA, s:ORIGIN_HINT) \-> b\f[R]:
دستور
\f[CR]netplan set \-\-root\-dir=/run/netplan/config\-ID \-\-origin\-hint=ORIGIN_HINT CONFIG_DELTA\f[R]
را فراخوانی می‌کند.
.RS 2
.PP
مقدار
\f[CR]CONFIG_DELTA\f[R]
می‌تواند چیزی مانند
\f[CR]network.ethernets.eth0.dhcp4=true\f[R]
و
\f[CR]ORIGIN_HINT\f[R]
می‌تواند مانند
\f[CR]70\-snapd\f[R]
باشد (در این صورت، پیکربندی در
\f[CR]70\-snapd.yaml\f[R]
نوشته خواهد شد).
هنگامی که
\f[CR]Set()\f[R]
روی یک شیء پیکربندی فراخوانی شود، تمام اشیاء پیکربندی دیگر (فعلی و آینده) به دلیل این وضعیت در انتظارِ تغییریافته (dirty state) باطل می‌شوند و دیگر نمی‌توانند
\f[CR]Set()\f[R]
یا
\f[CR]Try()/Apply()\f[R]
را اجرا کنند.
پس از آنکه شیء پیکربندی تغییریافته از طریق
\f[CR]Cancel()\f[R]
رد شد، سایر اشیاء پیکربندی مجدداً معتبر خواهند شد.
اگر شیء پیکربندی تغییریافته از طریق
\f[CR]Apply()\f[R]
پذیرفته شود، اشیاء پیکربندی تازه ایجادشده معتبر خواهند بود، در حالی که وضعیت‌های قدیمی‌تر همچنان نامعتبر باقی می‌مانند.
.RE
.IP \[bu] 2
\f[CR]Try(u:TIMEOUT_SEC) \-> b\f[R]:
پیکربندی اصلی Netplan را با وضعیت این شیء پیکربندی جایگزین می‌کند و دستور
\f[CR]netplan try \-\-timeout=TIMEOUT_SEC\f[R]
را فراخوانی می‌کند.
.IP \[bu] 2
\f[CR]Cancel() \-> b\f[R]:
تلاش در حال اجرای
\f[CR]Try()\f[R]
را روی این شیء پیکربندی لغو کرده و/یا شیء پیکربندی را دور می‌اندازد.
.IP \[bu] 2
\f[CR]Apply() \-> b\f[R]:
پیکربندی اصلی Netplan را با وضعیت این شیء پیکربندی جایگزین کرده و دستور
\f[CR]netplan apply\f[R]
را فراخوانی می‌کند.
.PP
برای کسب اطلاعات دربارهٔ قابلیت‌های
\f[CR]Apply()\f[R]/\f[CR]Try()\f[R]/\f[CR]Get()\f[R]/\f[CR]Set()\f[R]،
صفحات راهنمای
\f[B]\f[CB]netplan\-apply\f[B]\f[R](8)/\f[B]\f[CB]netplan\-try\f[B]\f[R](8)/\f[B]\f[CB]netplan\-get\f[B]\f[R](8)/\f[B]\f[CB]netplan\-set\f[B]\f[R](8)
را به تناسب ببینید.
برای جزئیات قالب فایل پیکربندی،
\f[B]\f[CB]netplan\f[B]\f[R](5)
را ببینید.
.SH "همچنین ببینید (SEE ALSO)"
\f[B]\f[CB]netplan\f[B]\f[R](5), \f[B]\f[CB]netplan\-apply\f[B]\f[R](8),
\f[B]\f[CB]netplan\-try\f[B]\f[R](8),
\f[B]\f[CB]netplan\-get\f[B]\f[R](8),
\f[B]\f[CB]netplan\-set\f[B]\f[R](8)
.SH "نویسندگان (AUTHORS)"
Lukas Märdian (\c
.MT lukas.maerdian@canonical.com
.ME \c
).