.\" -*- coding: UTF-8 -*- '\" t .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH VARLINKCTL 1 "" "systemd 260.2" varlinkctl .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH الاسم varlinkctl \- استكشف واستدعِ خدمات Varlink .SH موجز .HP \w'\fBvarlinkctl\fR\ 'u \fBvarlinkctl\fP [خيارات...] معلومات \fIالعنوان\fP .HP \w'\fBvarlinkctl\fR\ 'u \fBvarlinkctl\fP [خيارات...] قائمة\-الواجهات \fIالعنوان\fP .HP \w'\fBvarlinkctl\fR\ 'u \fBvarlinkctl\fP [خيارات...] قائمة\-الطرق \fIالعنوان\fP [\fIالواجهة\fP...] .HP \w'\fBvarlinkctl\fR\ 'u \fBvarlinkctl\fP [خيارات...] استكشف \fIالعنوان\fP [\fIالواجهة\fP...] .HP \w'\fBvarlinkctl\fR\ 'u \fBvarlinkctl\fP [خيارات...] استدعِ \fIالعنوان\fP \fIالطريقة\fP [\fIالوسائط\fP] .HP \w'\fBvarlinkctl\fR\ 'u \fBvarlinkctl\fP [خيارات...] \-\-exec call \fIعنوان\fP \fIطريقة\fP \fIمعطيات\fP \-\- \fICMDLINE\fP .HP \w'\fBvarlinkctl\fR\ 'u \fBvarlinkctl\fP [خيارات...] تحقق\-من\-idl [\fIالملف\fP] .SH الوصف .PP يمكن استخدام \fBvarlinkctl\fP لاستكشاف واستدعاء خدمات \m[blue]\fBVarlink\fP\m[]\&\s-2\u[1]\d\s+2. .PP يتم الإشارة إلى الخدمات بواحد مما يلي: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} مرجع خدمة Varlink يبدأ بالسلسلة "unix:"، متبوعًا بمسار مأخذ \fBAF_UNIX\fP مطلق، أو بـ "@" وسلسلة عشوائية (الأخير للإشارة إلى مآخذ في النطاق المجرد)\&. في هذه الحالة، يتم إنشاء اتصال مأخذ تدفق بالمأخذ المحدد\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} مرجع خدمة Varlink يبدأ بالسلسلة "exec:"، متبوعًا بمسار مطلق لملف ثنائي للتنفيذ\&. في هذه الحالة، يتم تفريع العملية المحددة محليًا، مع تمرير مأخذ تدفق متصل\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} مرجع خدمة Varlink يبدأ بالسلسلة "ssh\-unix:"، متبوعًا بمواصفات مضيف SSH، ثم ":"، ثم مسار مأخذ \fBAF_UNIX\fP مطلق\&. (يتطلب هذا OpenSSH 9\&.4 أو أحدث على جانب الخادم، ولا تدعم مآخذ النطاق المجرد\&.) .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} مرجع خدمة Varlink يبدأ بالسلسلة "ssh\-exec:"، متبوعًا بمواصفات مضيف SSH، ثم ":"، ثم سطر أوامر\&. في هذه الحالة، يتم استدعاء الأمر ويتم التحدث ببروتوكول Varlink على الإدخال والإخراج القياسيين للأمر المستدعى\&. .RE .PP للتسهيل، يتم دعم هاتين الصيغتين الأبسط (المكررة) لعنوان الخدمة أيضًا: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} مسار نظام ملفات إلى مأخذ \fBAF_UNIX\fP، إما مطلق (أي يبدأ بـ "/") أو نسبي (وفي هذه الحالة يجب أن يبدأ بـ "\&./")\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} مسار نظام ملفات إلى ملف قابل للتنفيذ، إما مطلق أو نسبي (كما سبق، يجب أن يبدأ بـ "/" أو "\&./" على التوالي)\&. .RE .SH الأوامر .PP الأوامر التالية مفهومة: .PP \fBinfo\fP \fIالعنوان\fP .RS 4 يعرض معلومات موجزة عن الخدمة المحددة، بما في ذلك اسم البائع وقائمة الواجهات المنفذة\&. يتوقع عنوان خدمة بأحد التنسيقات الموصوفة أعلاه\&. .sp أُضيف في الإصدار 255\&. .RE .PP \fBlist\-interfaces\fP \fIالعنوان\fP .RS 4 يعرض قائمة بالواجهات المنفذة بواسطة الخدمة المحددة\&. يتوقع عنوان خدمة بأحد التنسيقات الموصوفة أعلاه\&. .sp أُضيف في الإصدار 255\&. .RE .PP \fBlist\-methods\fP \fIADDRESS\fP [\fIINTERFACE\&...\fP] .RS 4 يعرض قائمة بالطرق المنفذة بواسطة الخدمة المحددة\&. يتوقع عنوان خدمة بأحد التنسيقات الموصوفة أعلاه بالإضافة إلى اسم واجهة واحد أو أكثر\&. إذا لم يتم تحديد اسم واجهة، يسرد جميع طرق جميع الواجهات المنفذة بواسطة الخدمة، وإلا فقط الطرق في الواجهات المحددة\&. .sp أُضيف في الإصدار 257\&. .RE .PP \fBintrospect\fP \fIADDRESS\fP [\fIINTERFACE\&...\fP] .RS 4 يعرض تعريفات الواجهة للواجهات المحددة المقدمة بواسطة الخدمة المحددة\&. يتوقع عنوان خدمة بأحد التنسيقات الموصوفة أعلاه واختياريًا اسم واجهة Varlink واحد أو أكثر\&. إذا لم يتم تحديد أسماء واجهات، يعرض جميع الواجهات المقدمة بواسطة الخدمة\&. .sp أُضيف في الإصدار 255\&. .RE .PP \fBcall\fP \fIADDRESS\fP \fIMETHOD\fP [\fIARGUMENTS\fP] .RS 4 يستدعي الطريقة المحددة للخدمة المحددة\&. يتوقع عنوان خدمة بالتنسيق الموصوف أعلاه، واسم طريقة Varlink مؤهل بالكامل، وكائن وسائط JSON\&. إذا لم يتم تحديد كائن الوسائط، يتم قراءته من STDIN بدلاً من ذلك\&. لتمرير قائمة فارغة من المعاملات، حدد الكائن الفارغ "{}"\&. .sp تتم كتابة معاملات الرد ككائنات JSON إلى STDOUT\&. .sp أُضيف في الإصدار 255\&. .RE .PP \fBlist\-registry\fP .RS 4 يعرض قائمة بخدمات Varlink المسجلة حالياً في سجل الخدمة، بالإضافة إلى مقابس نقاط الدخول الخاصة بها. (حالياً، يقوم هذا ببساطة بتعداد المقابس والمقابس المرتبطة رمزياً في /run/varlink/registry/، انظر أدناه.) .sp أُضيف في الإصدار 260\&. .RE .PP \fBvalidate\-idl\fP [\fIFILE\fP] .RS 4 يقرأ ملف تعريف واجهة Varlink، ويحلله ويتحقق من صحته، ثم يخرجه مع إبراز بناء الجملة. يتحقق هذا من بناء الجملة والاتساق الداخلي للواجهة. يتوقع اسم ملف لقراءة تعريف الواجهة منه. إذا تم حذفه، يقرأ تعريف الواجهة من STDIN. .sp أُضيف في الإصدار 255\&. .RE .PP \fBhelp\fP .RS 4 يعرض مساعدة بناء جملة الأمر. .sp أُضيف في الإصدار 255\&. .RE .SH الخيارات .PP الخيارات التالية مفهومة: .PP \fB\-\-more\fP .RS 4 عند استخدامه مع \fBcall\fP: توقع ردود طريقة متعددة. إذا تم تعيين هذه العلامة، يتم إرسال استدعاء الطريقة مع تعيين علامة \fBmore\fP، والتي تخبر الخدمة بتوليد ردود متعددة، إذا لزم الأمر. يظل الأمر قيد التشغيل حتى ترسل الخدمة رسالة رد تشير إلى أنها الأخيرة في السلسلة (أو إذا تم الوصول إلى المهلة المكونة، انظر أدناه). يجب تعيين هذه العلامة فقط لاستدعاءات الطريقة التي تدعم هذه الآلية. .sp إذا تم تمكين هذا الوضع، يتم تحويل الإخراج آلياً إلى وضع JSON\-SEQ، بحيث يمكن تمييز كائنات الرد الفردية بسهولة. .sp ليس لهذا المفتاح أي تأثير على مهلة استدعاء الطريقة المطبقة مبدئياً. بغض النظر عما إذا تم تحديد \fB\-\-more\fP أم لا، ستكون المهلة المبدئية 45 ثانية. استخدم \fB\-\-timeout=\fP (انظر أدناه) لتغيير أو تعطيل المهلة. عند استدعاء استدعاء طريقة يعيد التحديثات باستمرار، من المرغوب عادةً تعطيل المهلة باستخدام \fB\-\-timeout=infinity\fP. من ناحية أخرى، عند استدعاء استدعاء طريقة \fB\-\-more\fP لغرض تعداد الكائنات (والذي من المحتمل أن يكتمل بسرعة)، من المفيد عادةً ترك منطق المهلة ممكناً، لأسباب تتعلق بالمتانة. .sp أُضيف في الإصدار 255\&. .RE .PP \fB\-E\fP .RS 4 اختصار لـ \fB\-\-more \-\-timeout=infinity\fP. هذا المفتاح مفيد لاستدعاءات الطريقة التي تنفذ الاشتراك في تدفق مستمر من التحديثات. .sp أُضيف في الإصدار 257\&. .RE .PP \fB\-\-collect\fP .RS 4 هذا مشابه لـ \fB\-\-more\fP، لكنه يجمع كل الردود في مصفوفة JSON، ويطبعها، بدلاً من وضع JSON\-SEQ. .sp أُضيف في الإصدار 256\&. .RE .PP \fB\-\-oneway\fP .RS 4 عند استخدامه مع \fBcall\fP: لا تتوقع رد طريقة. إذا تم تعيين هذه العلامة، يتم إرسال استدعاء الطريقة مع تعيين علامة \fBoneway\fP (يخرج الأمر فوراً بعد ذلك)، والتي تخبر الخدمة بعدم توليد رد. .sp أُضيف في الإصدار 255\&. .RE .PP \fB\-\-json=\fP\fIوضع\fP .RS 4 يختار تنسيق إخراج JSON، إما "pretty" لإخراج ملون وذو مسافة بادئة جيدة، أو "short" لإخراج موجز مع حد أدنى من المسافات البيضاء وبدون أسطر جديدة. المبدئي هو "short". .sp أُضيف في الإصدار 255\&. .RE .PP \fB\-j\fP .RS 4 مكافئ لـ \fB\-\-json=pretty\fP عند استدعائه تفاعلياً من طرفية. بخلاف ذلك، فهو مكافئ لـ \fB\-\-json=short\fP، خاصة عندما يتم توجيه الإخراج إلى برنامج آخر. .sp أُضيف في الإصدار 255\&. .RE .PP \fB\-\-quiet\fP،‏ \fB\-q\fP .RS 4 قم بكتم إخراج ردود استدعاء الطريقة. .sp أُضيف في الإصدار 257\&. .RE .PP \fB\-\-graceful=\fP .RS 4 يأخذ اسم خطأ Varlink مؤهلاً، أي اسم واجهة، متبوعاً باسم خطأ، مفصولاً بنقطة، على سبيل المثال "org.varlink.service.InvalidParameter". يضمن أنه إذا فشل استدعاء طريقة بالخطأ المحدد، فسيتم التعامل معه كنجاح، أي سيتسبب في خروج استدعاء \fBvarlinkctl\fP بحالة خروج صفرية. يمكن استخدام هذا الخيار أكثر من مرة لمعالجة أخطاء متعددة مختلفة كنجاحات. .sp أُضيف في الإصدار 257\&. .RE .PP \fB\-\-timeout=\fP .RS 4 يتوقع مهلة بالثواني كمعامل. مبدئياً، يتم فرض مهلة 45 ثانية. لإيقاف تشغيل المهلة، حدد "infinity" أو سلسلة فارغة. .sp أُضيف في الإصدار 257\&. .RE .PP \fB\-\-exec\fP .RS 4 بمجرد اكتمال استدعاء الطريقة الصادر عبر \fBcall\fP بنجاح، قم بتحميل سلسلة الأوامر المحددة، مع معاملات إخراج استدعاء الطريقة المسلسلة إلى JSON التي تم تمريرها إلى الإدخال القياسي (والإخراج القياسي والخطأ القياسي الموروث من العملية المستدعية). علاوة على ذلك، يتم تمرير أي واصفات ملفات يتم إرجاعها على مقبس الاتصال الأساسي إلى العملية المستدعاة عبر بروتوكول \fI$LISTEN_FDS\fP المعتاد. يمكن استخدام هذه الوظيفة لاستهلاك الردود التي تأتي مع واصفات ملفات مرتبطة بطريقة معقولة. .sp الآن إذا تم تحديد \fB\-\-exec\fP، فإن المعامل الثالث لـ \fBcall\fP ليس اختيارياً (أي معاملات استدعاء الطريقة). .sp أُضيف في الإصدار 258\&. .RE .PP \fB\-\-push\-fd=\fP .RS 4 يأخذ رقمًا رقميًا لمؤشر الملف كمعلمة\&. يمكن استخدامه لتمرير مؤشر ملف مع استدعاء الأسلوب، إذا كان نظام النقل الأساسي يدعم ذلك\&. يمكن استخدامه عدة مرات لتمرير مؤشرات ملفات متعددة، مع الحفاظ على الترتيب المُحدد لها\&. يجب تمرير مؤشرات الملفات المحددة إلى استدعاء \fBvarlinkctl\fP\&. اختياريًا، بدلاً من رقم واصف الملف الرقمي، يمكن تحديد مسار نظام ملفات مطلق أو نسبي (يجب أن يسبق الأخير بـ ”\&./“)، ويُفتح في وضع القراءة فقط\&. .sp أُضيف في الإصدار 258\&. .RE .PP \fB\-\-system\fP، \fB\-\-user\fP .RS 4 يحدد ما إذا كان سيتم الاستعلام إلى السجل لكل نظام أو لكل مستخدم عند استخدام أمر \fBlist\-registry\fP. مبدئياً، يتم الاستعلام عن السجل لكل نظام. .PP أُضيف في الإصدار 260\&. .RE .PP \fB\-\-no\-ask\-password\fP .RS 4 لا تسأل المستخدم عن الاستيثاق للعمليات ذات الامتيازات\&. .RE .PP \fB\-\-no\-pager\fP .RS 4 لا تمرر المخرجات إلى برنامج عرض (pager)\&. .RE .PP \fB\-h\fP، \fB\-\-help\fP .RS 4 اطبع نص مساعدة قصير واخرج\&. .RE .PP \fB\-\-version\fP .RS 4 اطبع سلسلة إصدار قصيرة واخرج\&. .RE .SH "الملفات والأدلة" .PP /run/varlink/registry/ .RS 4 دليل يحتوي على عقد مقبس نقطة دخول \fBAF_UNIX\fP (أو روابط رمزية لها) لواجهات Varlink العامة المعروفة على النظام المحلي. يتم تسميتها على اسم واجهة Varlink التي تنفذها. .sp استخدم \fBvarlinkctl list\-registry\fP لعرض محتويات هذا الدليل. .sp (سيتم تجاهل العقد التي لا تعتبر عقد مقبس ولا روابط رمزية لها. قد يقدم امتداد مستقبلي ملفات وأدلة عادية لتعزيز وظيفة السجل.) .sp أُضيف في الإصدار 260\&. .RE .SH أمثلة .PP \fBمثال\ \&1.\ \&التحقيق في خدمة\fP .PP تفحص الأوامر الثلاثة التالية خدمة "io.systemd.Resolve" المنفذة بواسطة \fBsystemd\-resolved.service\fP(8)، وتسرد معلومات الخدمة العامة والواجهات المنفذة، ثم تعرض تعريف الواجهة للواجهة الرئيسية الخاصة بها: .sp .if n \{\ .RS 4 .\} .nf $ varlinkctl info /run/systemd/resolve/io\&.systemd\&.Resolve Vendor: The systemd Project Product: systemd (systemd\-resolved) Version: 254 (254\-1522\-g4790521^) URL: https://systemd\&.io/ Interfaces: io\&.systemd io\&.systemd\&.Resolve org\&.varlink\&.service $ varlinkctl list\-interfaces /run/systemd/resolve/io\&.systemd\&.Resolve io\&.systemd io\&.systemd\&.Resolve org\&.varlink\&.service $ varlinkctl introspect /run/systemd/resolve/io\&.systemd\&.Resolve io\&.systemd\&.Resolve interface io\&.systemd\&.Resolve type ResolvedAddress( ifindex: ?int, \&... .fi .if n \{\ .RE .\} .PP (تم اقتطاع تعريف الواجهة في المثال أعلاه، من أجل الإيجاز.) .PP \fBمثال\ \&2.\ \&استدعاء طريقة\fP .PP الأمر التالي يحل اسم مضيف عبر استدعاء الأسلوب \fBResolveHostname\fP الخاص بـ \fBsystemd\-resolved.service\fP(8)\&. .sp .if n \{\ .RS 4 .\} .nf $ varlinkctl call /run/systemd/resolve/io\&.systemd\&.Resolve io\&.systemd\&.Resolve\&.ResolveHostname \*(Aq{"name":"systemd\&.io","family":2}\*(Aq \-j { "addresses" : [ { "ifindex" : 2, "family" : 2, "address" : [ 185, 199, 111, 153 ] } ], "name" : "systemd\&.io", "flags" : 1048577 } .fi .if n \{\ .RE .\} .PP \fBمثال\ \&3.\ \&التحقيق في ملف تنفيذي لخدمة\fP .PP الأمر التالي يفحص الملف التنفيذي /usr/lib/systemd/systemd\-pcrextend وواجهات برمجة التطبيقات IPC التي يوفرها\&. ثم يستدعي أسلوبًا عليه: .sp .if n \{\ .RS 4 .\} .nf # varlinkctl info /usr/lib/systemd/systemd\-pcrextend Vendor: The systemd Project Product: systemd (systemd\-pcrextend) Version: 254 (254\-1536\-g97734fb) URL: https://systemd\&.io/ Interfaces: io\&.systemd io\&.systemd\&.PCRExtend org\&.varlink\&.service # varlinkctl introspect /usr/lib/systemd/systemd\-pcrextend io\&.systemd\&.PCRExtend interface io\&.systemd\&.PCRExtend method Extend( pcr: int, text: ?string, data: ?string ) \-> () # varlinkctl call /usr/lib/systemd/systemd\-pcrextend io\&.systemd\&.PCRExtend\&.Extend \*(Aq{"pcr":15,"text":"foobar"}\*(Aq {} .fi .if n \{\ .RE .\} .PP \fBمثال\ \&4.\ \&استدعاء أسلوب عن بُعد عبر SSH\fP .PP الأمر التالي يحصل على تقرير حول هوية مضيف بعيد "somehost" من \fBsystemd\-hostnamed.service\fP(8) عبر الاتصال عبر SSH بمقبس \fBAF_UNIX\fP الذي تستمع عليه الخدمة: .sp .if n \{\ .RS 4 .\} .nf # varlinkctl call ssh\-unix:somehost:/run/systemd/io\&.systemd\&.Hostname io\&.systemd\&.Hostname\&.Describe \*(Aq{}\*(Aq .fi .if n \{\ .RE .\} .PP لاستدعاء ملف ثنائي لخدمة Varlink مباشرة على المضيف البعيد، بدلاً من التحدث إلى خدمة عبر \fBAF_UNIX\fP، يمكن القيام بذلك كالتالي: .sp .if n \{\ .RS 4 .\} .nf # varlinkctl call ssh\-exec:somehost:systemd\-creds org\&.varlink\&.service\&.GetInfo \*(Aq{}\*(Aq .fi .if n \{\ .RE .\} .SH "انظر أيضًا" .PP \fBbusctl\fP(1), \m[blue]\fBVarlink\fP\m[]\&\s-2\u[1]\d\s+2 .SH ملاحظات .IP " 1." 4 Varlink .RS 4 \%https://varlink.org/ .RE .PP .SH ترجمة تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي . .PP هذه الترجمة هي وثيقة مجانية؛ راجع .UR https://www.gnu.org/licenses/gpl-3.0.html رخصة جنو العامة الإصدار 3 .UE أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات. .PP إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: .MT kde-l10n-ar@kde.org .ME .