.\" -*- coding: UTF-8 -*- '\" t .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH SYSUPDATE\&.FEATURES 5 "" "systemd 260.2" sysupdate.features .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 الاسم sysupdate.features \- ملفات تعريف الميزات الاختيارية .SH موجز .PP .RS 4 /etc/sysupdate\&.d/*\&.feature .RE .RS 4 /run/sysupdate\&.d/*\&.feature .RE .RS 4 /usr/local/lib/sysupdate\&.d/*\&.feature .RE .RS 4 /usr/lib/sysupdate\&.d/*\&.feature .RE .SH الوصف .PP "الميزات الاختيارية" هي وظائف يوفرها \fBsystemd\-sysupdate\fP(8)، تسمح للتوزيعة بتعريف مجموعات من تعريفات النقل لـ \fBsysupdate.d\fP(5) والتي يراد تمكينها أو تعطيلها بواسطة مدير النظام\&. .PP عند تمكين ميزة ما، ستؤخذ عمليات النقل التابعة لها في الحسبان عند التحقق من التحديثات وتنزيلها، وعند إفراغ المساحة (vacuuming)، وفي جميع الحالات الأخرى\&. وفي الواقع، ستُحدث عمليات النقل التابعة لميزة ما دائمًا بالتزامن التام مع بقية هدفها\&. هذا هو الفرق الرئيس بين الميزة الاختيارية ومكون \fBsystemd\-sysupdate\fP(8)\&. وعند تعطيل ميزة ما، لن تؤخذ عمليات النقل الخاصة بها في الحسبان عند التحقق من التحديثات وتنزيلها، ولكن سيظل \fBsystemd\-sysupdate\fP يأخذها في الحسبان أثناء إفراغ المساحة وفي الحالات الأخرى التي يحتاج فيها إلى تحديد ملكية موارد النظام المنزلة مسبقًا\&. سينظف \fBsystemd\-sysupdate\fP جميع نسخ عمليات النقل الخاصة بالميزة عندما تُعطّل، مما يؤدي فعليًا إلى إزالتها\&. .PP تُوصَف الميزات الاختيارية بواسطة ملفات sysupdate\&.d/*\&.feature، المعرّفة أدناه\&. يمكن لعمليات النقل الإعلان عن انتمائها لميزة ما عبر إعداد \fIFeatures=\fP\&. تدعم تعريفات الميزات ملفات الإقحام (drop\-in)، والتي تُستخدم غالبًا لتخطي إعداد \fIEnabled=\fP\&. ويمكن أيضًا قناعها (masked) لإخفاء توفر الميزة تمامًا\&. .PP يحتوي كل ملف *\&.feature على قسم واحد: [Feature]\&. .SH "خيارات قسم [FEATURE]" .PP يعرّف هذا القسم الخصائص العامة لهذه الميزة\&. .PP \fIDescription=\fP .RS 4 وصف قصير لهذه الميزة يمكن للبشر قراءته\&. قد يُستخدم هذا كلصيقة لهذه الميزة، لذا يجب أن يحدد النص الميزة بوضوح من بين الميزات المتوفرة في sysupdate\&.d/\&. .sp أُضيف في الإصدار 257\&. .RE .PP \fIDocumentation=\fP .RS 4 رابط مسار (URL) يُعرض للمستخدم يوجه إلى توثيق هذه الميزة\&. يدعم هذا الإعداد توسيع المحددات؛ انظر أدناه للحصول على تفاصيل حول المحددات المدعومة\&. .sp أُضيف في الإصدار 257\&. .RE .PP \fIAppStream=\fP .RS 4 رابط مسار (URL) لملف XML الخاص بـ \m[blue]\fBكتالوج AppStream\fP\m[]\&\s-2\u[1]\d\s+2\&. قد يُستخدم هذا بواسطة مراكز البرمجيات (مثل برمجيات جنوم أو استكشف كيدي) لتقديم بيانات وصفية غنية عن هذه الميزة\&. يتضمن ذلك أسماء العرض، وسجلات التغيير، والأيقونات، والمزيد\&. يدعم هذا الإعداد توسيع المحددات؛ انظر أدناه للحصول على تفاصيل حول المحددات المدعومة\&. .sp أُضيف في الإصدار 257\&. .RE .PP \fIEnabled=\fP .RS 4 ما إذا كانت هذه الميزة مُمكّنة أم لا\&. إذا لم تُحدّد، تُعطّل الميزة مبدئيًا\&. .sp أُضيف في الإصدار 257\&. .RE .SH المحددات .PP يمكن استخدام المحددات في إعدادات \fIDocumentation=\fP و \fIAppStream=\fP\&. تُفهم التوسيعات التالية: .sp .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br \fBالجدول\ \&1.\ \&المحددات المتاحة\fP .TS allbox tab(:); lB lB lB. T{ المحدد T}:T{ المعنى T}:T{ التفاصيل T} .T& l l l l l l l l l l l l l l l l l l l l l l l l l l l l l l l l l l l l l l l l l l l l l. T{ "%a" T}:T{ المعمارية T}:T{ سلسلة نصية قصيرة تحدد معمارية النظام المحلي\&. سلسلة مثل \fBx86\fP أو \fBx86\-64\fP أو \fBarm64\fP\&. انظر المعماريات المحددة لـ \fIConditionArchitecture=\fP في \fBsystemd.unit\fP(5) للحصول على قائمة كاملة\&. T} T{ "%A" T}:T{ إصدار صورة نظام التشغيل T}:T{ معرف إصدار صورة نظام التشغيل للنظام المشغل، كما يُقرأ من حقل \fIIMAGE_VERSION=\fP في /etc/os\-release\&. إذا لم يُضبط، يُحل إلى سلسلة فارغة\&. انظر \fBos\-release\fP(5) لمزيد من المعلومات\&. T} T{ "%b" T}:T{ معرف الإقلاع T}:T{ معرف الإقلاع للنظام المشغل، منسق كسلسلة نصية\&. انظر \fBrandom\fP(4) لمزيد من المعلومات\&. T} T{ "%B" T}:T{ معرف بناء نظام التشغيل T}:T{ معرف بناء نظام التشغيل للنظام المشغل، كما يُقرأ من حقل \fIBUILD_ID=\fP في /etc/os\-release\&. إذا لم يُضبط، يُحل إلى سلسلة فارغة\&. انظر \fBos\-release\fP(5) لمزيد من المعلومات\&. T} T{ "%H" T}:T{ اسم المضيف T}:T{ اسم مضيف النظام المشغل\&. T} T{ "%l" T}:T{ اسم المضيف القصير T}:T{ اسم مضيف النظام المشغل، مقتطعًا عند النقطة الأولى لإزالة أي مكون نطاق\&. T} T{ "%m" T}:T{ معرف الآلة T}:T{ معرف الجهاز للنظام المشغل، منسق كسلسلة نصية\&. انظر \fBmachine\-id\fP(5) لمزيد من المعلومات\&. T} T{ "%M" T}:T{ معرف صورة نظام التشغيل T}:T{ معرف صورة نظام التشغيل للنظام المشغل، كما يُقرأ من حقل \fIIMAGE_ID=\fP في /etc/os\-release\&. إذا لم يُضبط، يُحل إلى سلسلة فارغة\&. انظر \fBos\-release\fP(5) لمزيد من المعلومات\&. T} T{ "%o" T}:T{ معرف نظام التشغيل T}:T{ معرف نظام التشغيل للنظام المشغل، كما يُقرأ من حقل \fIID=\fP في /etc/os\-release\&. انظر \fBos\-release\fP(5) لمزيد من المعلومات\&. T} T{ "%v" T}:T{ إصدار النواة T}:T{ مطابق لمخرجات \fBuname \-r\fP\&. T} T{ "%w" T}:T{ معرف إصدار نظام التشغيل T}:T{ معرف إصدار نظام التشغيل للنظام المشغل، كما يُقرأ من حقل \fIVERSION_ID=\fP في /etc/os\-release\&. إذا لم يُضبط، يُحل إلى سلسلة فارغة\&. انظر \fBos\-release\fP(5) لمزيد من المعلومات\&. T} T{ "%W" T}:T{ معرف نوع نظام التشغيل T}:T{ معرف تنويعة نظام التشغيل للنظام المشغل، كما يُقرأ من حقل \fIVARIANT_ID=\fP في /etc/os\-release\&. إذا لم يُضبط، يُحل إلى سلسلة فارغة\&. انظر \fBos\-release\fP(5) لمزيد من المعلومات\&. T} T{ "%T" T}:T{ مجلد للملفات المؤقتة T}:T{ هذا إما /tmp أو المسار الذي ضُبطت إليه "$TMPDIR" أو "$TEMP" أو "$TMP"\&. (لاحظ أن الدليل قد يُحدد بدون شرطة مائلة لاحقة\&.) T} T{ "%V" T}:T{ مجلد للملفات المؤقتة الأكبر حجمًا والمستمرة T}:T{ هذا إما /var/tmp أو المسار الذي ضُبطت إليه "$TMPDIR" أو "$TEMP" أو "$TMP"\&. (لاحظ أن الدليل قد يُحدد بدون شرطة مائلة لاحقة\&.) T} T{ "%%" T}:T{ علامة مئوية مفردة T}:T{ استخدم "%%" بدلاً من "%" لتحديد علامة مئوية مفردة\&. T} .TE .sp 1 .SH أمثلة .PP \fBمثال\ \&1.\ \&أدوات التطوير لنظام التشغيل المعتمد على الصور\fP .PP سنستخدم نظام التشغيل الافتراضي "foobarOS" الموصوف في \fBsysupdate.d\fP(5) كمثال لنظام التشغيل الأساسي لدينا\&. لا تحتاج الغالبية العظمى من مستخدمي foobarOS إلى وجود مجمع (compiler)، ونظام بناء، ومنقح (debugger)، وأدوات تطوير أخرى من هذا القبيل لتكون جزءًا من نظام تشغيلهم\&. ومع ذلك، يحتاج مطورو foobarOS أنفسهم إلى توفر أدوات البناء هذه\&. لذلك، يحتاج foobarOS إلى توفير صورة امتداد للنظام (انظر \fBsystemd\-sysext\fP(8)) تحتوي على أدوات التطوير هذه، ويجب تحديث هذه الصورة بالتزامن التام مع نظام التشغيل الأساسي التحتي\&. هذه حالة استخدام ممتازة لميزة نظام تشغيل اختيارية، لذا دعنا نعرّف واحدة: .PP .if n \{\ .RS 4 .\} .nf # /usr/lib/sysupdate\&.d/devel\&.feature [Feature] Description=Development Tools Documentation=https://developer\&.example\&.com/foobarOS/getting\-started Enabled=false .fi .if n \{\ .RE .\} .PP يعرّف ما ورد أعلاه ميزة "devel"، ويُعطّلها مبدئيًا\&. الآن دعنا نعرّف عملية نقل مرتبطة بهذه الميزة: .PP .if n \{\ .RS 4 .\} .nf # /usr/lib/sysupdate\&.d/50\-devel\&.transfer [Transfer] Features=devel ProtectVersion=%A [Source] Type=url\-file Path=https://download\&.example\&.com/ MatchPattern=foobarOS_@v_devel\&.raw\&.xz [Target] Type=regular\-file Path=/var/lib/extensions MatchPattern=foobarOS_@v_devel\&.raw Mode=0444 InstancesMax=2 .fi .if n \{\ .RE .\} .PP باستخدام هذين الملفين، أنشأنا ميزة تسمى "devel" والتي، عند تمكينها، ستنزل وتفك ضغط الإصدار المناسب من "https://download\&.example\&.com/foobarOS_@v_devel\&.raw\&.xz" إلى "/var/lib/extensions/foobarOS_@v_devel\&.raw" أثناء كل تحديث لنظام التشغيل\&. .PP يمكن لمطوري foobarOS تمكين ميزة "devel" على محطات عملهم عن طريق إنشاء ملف الإقحام التالي: .PP .if n \{\ .RS 4 .\} .nf # /etc/sysupdate\&.d/devel\&.feature\&.d/enable\&.conf [Feature] Enabled=true .fi .if n \{\ .RE .\} .PP \fBمثال\ \&2.\ \&برامج التشغيل احتكارية الملكية\fP .PP افترض أن العديد من مستخدمي foobarOS لديهم معالج رسوميات (GPU) مصنع من قبل شركة MVISUAL\&. ونظرًا لقلة التوثيق وصعوبة الهندسة العكسية للعتاد، فإن برامج التشغيل مفتوحة المصدر لمعالجات الرسوميات MVISUAL غير قادرة على الاستفادة الصحيحة من أداء الرسوميات والحوسبة المتاح\&. توفر MVISUAL برنامج تشغيل احتكاريًا قابلًا لإعادة التوزيع لبطاقاتها، ويوزعها مطورو foobarOS لتلبية احتياجات مستخدميهم\&. .PP يتكون برنامج تشغيل MVISUAL من عدة أجزاء مختلفة يجب تثبيتها لكي يعمل: إضافة UKI لاضبط سطر الأوامر للنواة، وصورة امتداد نظام initrd لإضافة وحدة نواة MVISUAL إلى initrd، وصورة امتداد نظام عادية لإضافة برامج تشغيل OpenGL و Vulkan الاحتكارية لفضاء المستخدم\&. ينبغي قفل إصدارات كل هذه الأجزاء لتتطابق مع نظام التشغيل الرئيس\&. .PP لنبدأ بتعريف ميزة اختيارية باسم "mvisual\-driver": .PP .if n \{\ .RS 4 .\} .nf # /usr/lib/sysupdate\&.d/mvisual\-driver\&.feature [Feature] Description=MVISUAL Proprietary GPU Driver Documentation=https://support\&.example\&.com/foobarOS/mvisual AppStream=https://metadata\&.example\&.com/mvisual\-driver\-%A\&.xml\&.gz .fi .if n \{\ .RE .\} .PP لاحظ أننا نعرف بيانات AppStream الوصفية لهذه الميزة، لأننا نريد لمراكز البرامج عرضها على المستخدمين النهائيين\&. بعد ذلك، دعنا نعرف التحويلات المقابلة: .PP .if n \{\ .RS 4 .\} .nf # /usr/lib/sysupdate\&.d/50\-mvisual\-userspace\&.transfer [Transfer] Features=mvisual\-driver ProtectVersion=%A [Source] Type=url\-file Path=https://download\&.example\&.com/ MatchPattern=foobarOS_@v_mvisual_userspace\&.raw\&.xz [Target] Type=regular\-file Path=/var/lib/extensions MatchPattern=foobarOS_@v_mvisual\&.raw Mode=0444 InstancesMax=2 .fi .if n \{\ .RE .\} .PP .if n \{\ .RS 4 .\} .nf # /usr/lib/sysupdate\&.d/70\-mvisual\-initrd\&.transfer [Transfer] Features=mvisual\-driver ProtectVersion=%A [Source] Type=url\-file Path=https://download\&.example\&.com/ MatchPattern=foobarOS_@v_mvisual_initrd\&.raw\&.xz [Target] Type=regular\-file Path=/EFI/Linux PathRelativeTo=boot MatchPattern=foobarOS_@v\&.efi\&.extra\&.d/foobarOS_mvisual\&.raw Mode=0444 InstancesMax=2 .fi .if n \{\ .RE .\} .PP .if n \{\ .RS 4 .\} .nf # /usr/lib/sysupdate\&.d/90\-mvisual\-addon\&.transfer [Transfer] Features=mvisual\-driver ProtectVersion=%A [Source] Type=url\-file Path=https://download\&.example\&.com/ MatchPattern=foobarOS_@v_mvisual_addon\&.efi\&.xz [Target] Type=regular\-file Path=/EFI/Linux PathRelativeTo=boot MatchPattern=foobarOS_@v\&.efi\&.extra\&.d/foobarOS_mvisual\&.addon\&.efi Mode=0444 InstancesMax=2 .fi .if n \{\ .RE .\} .PP \fBمثال\ \&3.\ \&الميزات المتقاطعة\fP .PP افترض أن MVISUAL تصدر أدوات خاصة لمساعدة مطور توزيعة في استكشاف أعطال برنامج التشغيل الخاص بهم\&. دعنا نعرف تحويلاً: .PP .if n \{\ .RS 4 .\} .nf # /usr/lib/sysupdate\&.d/50\-mvisual\-debugger\&.transfer [Transfer] RequisiteFeatures=devel mvisual\-driver ProtectVersion=%A [Source] Type=url\-file Path=https://download\&.example\&.com/ MatchPattern=foobarOS_@v_devel\&.raw\&.xz [Target] Type=regular\-file Path=/var/lib/extensions MatchPattern=foobarOS_@v_devel\&.raw Mode=0444 InstancesMax=2 .fi .if n \{\ .RE .\} .PP سيُستخدم هذا التحويل فقط إذا تم تفعيل كلتا الميزتين "devel" و"mvisual\-driver"\&. .SH "انظر أيضًا" .PP \fBsystemd\fP(1), \fBsystemd\-sysupdate\fP(8), \fBsysupdate.d\fP(5) .SH ملاحظات .IP " 1." 4 فهرس AppStream .RS 4 \%https://www.freedesktop.org/software/appstream/docs/chap\-CatalogData.html .RE .PP .SH ترجمة تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي . .PP هذه الترجمة هي وثيقة مجانية؛ راجع .UR https://www.gnu.org/licenses/gpl-3.0.html رخصة جنو العامة الإصدار 3 .UE أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات. .PP إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: .MT kde-l10n-ar@kde.org .ME .