'\" t .TH "ORG\&.FREEDESKTOP\&.NETWORK1" "5" "" "systemd 261.2" "org.freedesktop.network1" .\" ----------------------------------------------------------------- .\" * 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)" org.freedesktop.network1 \- رابط کاربری D-Bus سرویس systemd-networkd .SH "توضیحات (DESCRIPTION)" .PP \fBsystemd-networkd.service\fR(8) یک سرویس سیستمی است که رابط‌های شبکه را مدیریت و پیکربندی می‌کند\&. این صفحه رابط کاربری D\-Bus آن را شرح می‌دهد\&. .SH "رابط D-BUS (THE D-BUS INTERFACE)" .PP سرویس \fBsystemd-networkd\fR اشیاء و رابط‌های D\-Bus متعددی را در گذرگاه سیستمی ارائه می‌دهد که در بخش‌های زیر شرح داده شده‌اند\&. .SH "شیء مدیر (THE MANAGER OBJECT)" .PP این سرویس رابط‌های زیر را روی شیء Manager در گذرگاه ارائه می‌دهد: .sp .if n \{\ .RS 4 .\} .nf node /org/freedesktop/network1 { interface org\&.freedesktop\&.network1\&.Manager { methods: ListLinks(out a(iso) links); GetLinkByName(in s name, out i ifindex, out o path); GetLinkByIndex(in i ifindex, out s name, out o path); SetLinkNTP(in i ifindex, in as servers); SetLinkDNS(in i ifindex, in a(iay) addresses); SetLinkDNSEx(in i ifindex, in a(iayqs) addresses); SetLinkDomains(in i ifindex, in a(sb) domains); SetLinkDefaultRoute(in i ifindex, in b enable); SetLinkLLMNR(in i ifindex, in s mode); SetMulticastDNS(in i ifindex, in s mode); SetLinkDNSOverTLS(in i ifindex, in s mode); SetLinkDNSSEC(in i ifindex, in s mode); SetLinkDNSSECNegativeTrustAnchors(in i ifindex, in as names); RevertLinkNTP(in i ifindex); RevertLinkDNS(in i ifindex); RenewLink(in i ifindex); ForceRenewLink(in i ifindex); ReconfigureLink(in i ifindex); Reload(); DescribeLink(in i ifindex, out s json); Describe(out s json); properties: readonly s OperationalState = \*(Aq\&.\&.\&.\*(Aq; readonly s CarrierState = \*(Aq\&.\&.\&.\*(Aq; readonly s AddressState = \*(Aq\&.\&.\&.\*(Aq; readonly s IPv4AddressState = \*(Aq\&.\&.\&.\*(Aq; readonly s IPv6AddressState = \*(Aq\&.\&.\&.\*(Aq; readonly s OnlineState = \*(Aq\&.\&.\&.\*(Aq; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const") readonly t NamespaceId = \&.\&.\&.; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly u NamespaceNSID = \&.\&.\&.; }; interface org\&.freedesktop\&.DBus\&.Peer { \&.\&.\&. }; interface org\&.freedesktop\&.DBus\&.Introspectable { \&.\&.\&. }; interface org\&.freedesktop\&.DBus\&.Properties { \&.\&.\&. }; }; .fi .if n \{\ .RE .\} .sp .PP اطلاعاتی درباره مدیر (manager) ارائه می‌دهد\&. .SS "ویژگی‌ها (Properties)" .PP \fINamespaceId\fR شامل شماره اینود (inode) مربوط به فضای نام شبکه (network namespace) است که سرویس شبکه در آن اجرا می‌شود\&. کلاینت می‌تواند این مقدار را با شماره اینود فضای نام شبکه خود مقایسه کند تا تأیید نماید که آیا این سرویس همان فضای نام شبکه را مدیریت می‌کند یا خیر\&. .PP \fINamespaceNSID\fR شامل شناسه «nsid» است که هسته لینوکس برای فضای نام شبکه نگهداری می‌کند، در صورتی که شناسه‌ای اختصاص داده شده باشد\&. .SH "شیء پیوند (LINK OBJECT)" .sp .if n \{\ .RS 4 .\} .nf node /org/freedesktop/network1/link/_1 { interface org\&.freedesktop\&.network1\&.Link { methods: SetNTP(in as servers); SetDNS(in a(iay) addresses); SetDNSEx(in a(iayqs) addresses); SetDomains(in a(sb) domains); SetDefaultRoute(in b enable); SetLLMNR(in s mode); SetMulticastDNS(in s mode); SetDNSOverTLS(in s mode); SetDNSSEC(in s mode); SetDNSSECNegativeTrustAnchors(in as names); RevertNTP(); RevertDNS(); Renew(); ForceRenew(); Reconfigure(); Describe(out s json); properties: readonly s OperationalState = \*(Aq\&.\&.\&.\*(Aq; readonly s CarrierState = \*(Aq\&.\&.\&.\*(Aq; readonly s AddressState = \*(Aq\&.\&.\&.\*(Aq; readonly s IPv4AddressState = \*(Aq\&.\&.\&.\*(Aq; readonly s IPv6AddressState = \*(Aq\&.\&.\&.\*(Aq; readonly s OnlineState = \*(Aq\&.\&.\&.\*(Aq; readonly s AdministrativeState = \*(Aq\&.\&.\&.\*(Aq; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("false") readonly (tt) BitRates = \&.\&.\&.; }; interface org\&.freedesktop\&.DBus\&.Peer { \&.\&.\&. }; interface org\&.freedesktop\&.DBus\&.Introspectable { \&.\&.\&. }; interface org\&.freedesktop\&.DBus\&.Properties { \&.\&.\&. }; }; .fi .if n \{\ .RE .\} .sp .PP اطلاعاتی درباره رابط‌ها ارائه می‌دهد\&. .SH "شیء شبکه (NETWORK OBJECT)" .sp .if n \{\ .RS 4 .\} .nf node /org/freedesktop/network1/network/_1 { interface org\&.freedesktop\&.network1\&.Network { properties: @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const") readonly s Description = \*(Aq\&.\&.\&.\*(Aq; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const") readonly s SourcePath = \*(Aq\&.\&.\&.\*(Aq; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const") readonly as MatchMAC = [\*(Aq\&.\&.\&.\*(Aq, \&.\&.\&.]; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const") readonly as MatchPath = [\*(Aq\&.\&.\&.\*(Aq, \&.\&.\&.]; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const") readonly as MatchDriver = [\*(Aq\&.\&.\&.\*(Aq, \&.\&.\&.]; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const") readonly as MatchType = [\*(Aq\&.\&.\&.\*(Aq, \&.\&.\&.]; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const") readonly as MatchName = [\*(Aq\&.\&.\&.\*(Aq, \&.\&.\&.]; }; interface org\&.freedesktop\&.DBus\&.Peer { \&.\&.\&. }; interface org\&.freedesktop\&.DBus\&.Introspectable { \&.\&.\&. }; interface org\&.freedesktop\&.DBus\&.Properties { \&.\&.\&. }; }; .fi .if n \{\ .RE .\} .sp .PP اطلاعاتی درباره فایل‌های \fB.network\fR ارائه می‌دهد\&. .SH "شیء سرور DHCP (DHCP SERVER OBJECT)" .sp .if n \{\ .RS 4 .\} .nf node /org/freedesktop/network1/link/_1 { interface org\&.freedesktop\&.network1\&.DHCPServer { properties: readonly a(uayayayayt) Leases = [\&.\&.\&.]; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const") readonly u PoolSize = \&.\&.\&.; @org\&.freedesktop\&.DBus\&.Property\&.EmitsChangedSignal("const") readonly u PoolOffset = \&.\&.\&.; }; interface org\&.freedesktop\&.DBus\&.Peer { \&.\&.\&. }; interface org\&.freedesktop\&.DBus\&.Introspectable { \&.\&.\&. }; interface org\&.freedesktop\&.DBus\&.Properties { \&.\&.\&. }; interface org\&.freedesktop\&.network1\&.Link { \&.\&.\&. }; }; .fi .if n \{\ .RE .\} .sp .PP اطلاعاتی درباره سرور DHCP ارائه می‌دهد\&. ویژگی \fILeases\fR شامل اجاره‌های (leases) در حال حاضر فعال است\&. ویژگی \fIPoolSize\fR شامل تعداد کل نشانی‌ها در استخر نشانی پویا است\&. ویژگی \fIPoolOffset\fR شامل آفست از نشانی پایه زیرشبکه است که استخر از آنجا شروع می‌شود\&. این موارد متناظر با تنظیمات \fIPoolSize=\fR و \fIPoolOffset=\fR در \fBsystemd.network\fR(5) هستند\&. مقدار \fBUINT32_MAX\fR به عنوان یک مقدار نگهبان (sentinel) برای \fIPoolSize\fR و \fIPoolOffset\fR استفاده می‌شود تا نشان دهد اطلاعات در دسترس نیست (یعنی هیچ سرور DHCP پیکربندی نشده یا پیوند در حالت بازپخش/relay است)، نه اینکه یک اندازه استخر یا آفست معتبر باشد\&. .SH "شیء کلاینت DHCPv4 (DHCPV4 CLIENT OBJECT)" .sp .if n \{\ .RS 4 .\} .nf node /org/freedesktop/network1/link/_1 { interface org\&.freedesktop\&.network1\&.DHCPv4Client { properties: readonly s State = \*(Aq\&.\&.\&.\*(Aq; }; interface org\&.freedesktop\&.DBus\&.Peer { \&.\&.\&. }; interface org\&.freedesktop\&.DBus\&.Introspectable { \&.\&.\&. }; interface org\&.freedesktop\&.DBus\&.Properties { \&.\&.\&. }; interface org\&.freedesktop\&.network1\&.Link { \&.\&.\&. }; }; .fi .if n \{\ .RE .\} .sp .PP اطلاعاتی درباره وضعیت کلاینت DHCPv4 ارائه می‌دهد\&. .SH "شیء کلاینت DHCPv6 (DHCPV6 CLIENT OBJECT)" .sp .if n \{\ .RS 4 .\} .nf node /org/freedesktop/network1/link/_1 { interface org\&.freedesktop\&.network1\&.DHCPv6Client { properties: readonly s State = \*(Aq\&.\&.\&.\*(Aq; }; interface org\&.freedesktop\&.DBus\&.Peer { \&.\&.\&. }; interface org\&.freedesktop\&.DBus\&.Introspectable { \&.\&.\&. }; interface org\&.freedesktop\&.DBus\&.Properties { \&.\&.\&. }; interface org\&.freedesktop\&.network1\&.Link { \&.\&.\&. }; }; .fi .if n \{\ .RE .\} .sp .PP اطلاعاتی درباره وضعیت کلاینت DHCPv6 ارائه می‌دهد\&. .SH "مثال‌ها (EXAMPLES)" .PP \fBمثال\ \&۱.\ \&درون‌نگری org\&.freedesktop\&.network1\&.Manager در گذرگاه\fR .sp .if n \{\ .RS 4 .\} .nf $ gdbus introspect \-\-system \e \-\-dest org\&.freedesktop\&.network1 \e \-\-object\-path /org/freedesktop/network1 .fi .if n \{\ .RE .\} .PP \fBمثال\ \&۲.\ \&درون‌نگری org\&.freedesktop\&.network1\&.Link در گذرگاه\fR .sp .if n \{\ .RS 4 .\} .nf $ gdbus introspect \-\-system \e \-\-dest org\&.freedesktop\&.network1 \e \-\-object\-path /org/freedesktop/network1/link/_11 .fi .if n \{\ .RE .\} .SH "سازگاری نسخه (VERSION COMPATIBILITY)" .PP این رابط‌های D\-Bus از \m[blue]\fBدستورالعمل‌های معمول نسخه‌بندی رابط\fR\m[]\&\s-2\u[1]\d\s+2 پیروی می‌کنند\&. .SH "تاریخچه (HISTORY)" .SS "شیء سرور DHCP" .PP \fIPoolSize\fR و \fIPoolOffset\fR در نسخه ۲۶۱ اضافه شدند\&. .SS "شیء کلاینت DHCPv4" .PP \fIState\fR در نسخه ۲۵۵ اضافه شد\&. .SS "شیء کلاینت DHCPv6" .PP \fIState\fR در نسخه ۲۵۵ اضافه شد\&. .SS "شیء مدیر" .PP \fINamespaceNSID\fR در نسخه ۲۵۶ اضافه شد\&. .SH "همچنین ببینید (SEE ALSO)" .PP \fBsystemd\fR(1), \fBsystemd-networkd.service\fR(8), \fBnetworkctl\fR(1) .SH "نکات (NOTES)" .IP " 1." 4 دستورالعمل‌های معمول نسخه‌بندی رابط .RS 4 \%https://0pointer.de/blog/projects/versioning-dbus.html .RE