NETPLAN-DBUS(8) System Manager's Manual NETPLAN-DBUS(8)

netplan-dbus - سرویس پیکربندی شبکه از طریق واسط D-Bus در Netplan

netplan-dbus

دستور netplan-dbus یک دیمن D-Bus است که io.netplan.Netplan را روی گذرگاه سیستم (system bus) فراهم می‌کند. شیء /io/netplan/Netplan یک واسط io.netplan.Netplan ارائه می‌دهد که متدهای زیر را در بر دارد:

•
Apply() -> b: دستور netplan apply را فراخوانی می‌کند و وضعیت موفقیت یا شکست را برمی‌گرداند.
•
Generate() -> b: دستور netplan generate را فراخوانی می‌کند و وضعیت موفقیت یا شکست را برمی‌گرداند.
•
Info() -> a(sv): یک دیکشنری به صورت "Features -> as" برمی‌گرداند که شامل آرایه‌ای از تمام پرچم‌های ویژگی‌های در دسترس است.
•
Config() -> o: یک شیء پیکربندی جدید به صورت /io/netplan/Netplan/config/<ID> با کپی کردن وضعیت فعلی از /{etc,run,lib}/netplan/*.yaml آماده می‌سازد.

اشیاء /io/netplan/Netplan/config/<ID> یک واسط io.netplan.Netplan.Config ارائه می‌دهند که متدهای زیر را در بر دارد:

•
Get() -> s: دستور netplan get --root-dir=/run/netplan/config-ID all را فراخوانی کرده و پیکربندی ادغام‌شدهٔ YAML از وضعیت شیء پیکربندی داده‌شده را برمی‌گرداند.
•
Set(s:CONFIG_DELTA, s:ORIGIN_HINT) -> b: دستور netplan set --root-dir=/run/netplan/config-ID --origin-hint=ORIGIN_HINT CONFIG_DELTA را فراخوانی می‌کند.

مقدار CONFIG_DELTA می‌تواند چیزی مانند network.ethernets.eth0.dhcp4=true و ORIGIN_HINT می‌تواند مانند 70-snapd باشد (در این صورت، پیکربندی در 70-snapd.yaml نوشته خواهد شد). هنگامی که Set() روی یک شیء پیکربندی فراخوانی شود، تمام اشیاء پیکربندی دیگر (فعلی و آینده) به دلیل این وضعیت در انتظارِ تغییریافته (dirty state) باطل می‌شوند و دیگر نمی‌توانند Set() یا Try()/Apply() را اجرا کنند. پس از آنکه شیء پیکربندی تغییریافته از طریق Cancel() رد شد، سایر اشیاء پیکربندی مجدداً معتبر خواهند شد. اگر شیء پیکربندی تغییریافته از طریق Apply() پذیرفته شود، اشیاء پیکربندی تازه ایجادشده معتبر خواهند بود، در حالی که وضعیت‌های قدیمی‌تر همچنان نامعتبر باقی می‌مانند.

•
Try(u:TIMEOUT_SEC) -> b: پیکربندی اصلی Netplan را با وضعیت این شیء پیکربندی جایگزین می‌کند و دستور netplan try --timeout=TIMEOUT_SEC را فراخوانی می‌کند.
•
Cancel() -> b: تلاش در حال اجرای Try() را روی این شیء پیکربندی لغو کرده و/یا شیء پیکربندی را دور می‌اندازد.
•
Apply() -> b: پیکربندی اصلی Netplan را با وضعیت این شیء پیکربندی جایگزین کرده و دستور netplan apply را فراخوانی می‌کند.

برای کسب اطلاعات دربارهٔ قابلیت‌های Apply()/Try()/Get()/Set()، صفحات راهنمای netplan-apply(8)/netplan-try(8)/netplan-get(8)/netplan-set(8) را به تناسب ببینید. برای جزئیات قالب فایل پیکربندی، netplan(5) را ببینید.

netplan(5), netplan-apply(8), netplan-try(8), netplan-get(8), netplan-set(8)

Lukas Märdian (lukas.maerdian@canonical.com).