.\" -*- coding: UTF-8 -*- '\" t .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH IMPORTCTL 1 "" "systemd 260.2" importctl .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 الاسم importctl \- تنزيل أو استيراد أو تصدير صور الأقراص .SH موجز .HP \w'\fBimportctl\fR\ 'u \fBimportctl\fP [خيارات...] {أمر} [اسم...] .SH الوصف .PP يمكن استخدام \fBimportctl\fP لتنزيل واستيراد وتصدير صور الأقراص عبر \fBsystemd\-importd.service\fP(8)\&. .PP تعمل \fBimportctl\fP على كل من صور الأقراص على مستوى الكتل (مثل DDIs)، وصور مستوى نظام الملفات (ملفات tar)، بالإضافة إلى صور OCI\&. وهي تدعم صور الأقراص في إحدى الفئات الأربع التالية: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} صور الآلات الافتراضية أو صور حاويات نظام التشغيل الكاملة، التي يمكن تشغيلها عبر \fBsystemd\-vmspawn\fP(1) أو \fBsystemd\-nspawn\fP(1)، وإدارتها عبر \fBmachinectl\fP(1)\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} صور الخدمات المحمولة، التي يمكن إرفاقها وإدارتها عبر \fBportablectl\fP(1)\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} صور إضافات النظام (sysext)، التي يمكن تفعيلها عبر \fBsystemd\-sysext\fP(8)\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} صور إضافات التهيئة (confext)، التي يمكن تفعيلها عبر \fBsystemd\-confext\fP(8)\&. .RE .PP عند تنزيل الصور أو استيرادها، توضع في الدلائل التالية، اعتمادًا على معامل \fB\-\-class=\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. T{ الفئة T}:T{ الدليل T} .T& l l l l l l l l. T{ "machine" T}:T{ /var/lib/machines/ T} T{ "portable" T}:T{ /var/lib/portables/ T} T{ "sysext" T}:T{ /var/lib/extensions/ T} T{ "confext" T}:T{ /var/lib/confexts/ T} .TE .sp 1 .SH الأوامر .PP الأوامر التالية مفهومة: .PP \fBpull\-tar\fP \fIURL\fP [\fINAME\fP] .RS 4 ينزل صورة \&.tar من الرابط المحدد، ويجعلها متاحة تحت الاسم المحلي المحدد في دليل الصور للفئة المختارة \fB\-\-class=\fP\&. يجب أن يكون الرابط من نوع "http://" أو "https://"، ويجب أن يشير إلى ملف أرشيف \&.tar أو \&.tar\&.gz أو \&.tar\&.xz أو \&.tar\&.bz2\&. إذا حُذف اسم الصورة المحلي، يُشتق آليًا من آخر مكون للرابط، مع إزالة لاحقته\&. .sp تُتحقق الصورة قبل جعلها متاحة، ما لم يُحدد \fB\-\-verify=no\fP\&. يُتحقق إما عبر ملف باسم الصورة واللاحقة \&.sha256 وتوقيع منفصل \&.sha256\&.asc أو \&.sha256\&.gpg، أو عبر ملفات SHA256SUMS وSHA256SUMS\&.asc أو SHA256SUMS\&.gpg منفصلة\&. يجب أن تكون ملفات التوقيع متاحة على نفس خادم الويب، تحت نفس رابط ملف \&.tar\&. مع \fB\-\-verify=checksum\fP، يُتحقق فقط من المجموع الاختباري SHA256 للملف، بناءً على الملف ذي اللاحقة \&.sha256 أو ملف SHA256SUMS\&. مع \fB\-\-verify=signature\fP، يُتحقق أولاً من ملف المجموع الاختباري sha مع التوقيع GPG المنفصل لـ \&.sha256 أو SHA256SUMS\&. يجب أن يكون المفتاح العام لهذه الخطوة متاحًا في /usr/lib/systemd/import\-pubring\&.pgp أو /etc/systemd/import\-pubring\&.pgp\&. .sp إذا حُدد \fB\-keep\-download=yes\fP، تُنزل الصورة وتُخزن في مجلد فرعي/دليل للقراءة فقط في دليل الصور يُسمى باسم الرابط المحدد وعلامة HTTP etag الخاصة به (انظر \m[blue]\fBHTTP ETag\fP\m[]\&\s-2\u[1]\d\s+2 لمزيد من المعلومات)\&. ثم تُؤخذ لقطة قابلة للكتابة من هذا المجلد الفرعي، وتُسمى باسم محلي محدد\&. يضمن هذا السلوك أن إنشاء مثيلات متعددة لنفس الرابط فعال، حيث لا حاجة لتنزيلات متعددة\&. لإنشاء الصورة للقراءة فقط فقط، وتجنب إنشاء لقطة قابلة للكتابة، حدد "\-" كاسم محلي\&. .sp لاحظ أن الضغط على Control\-c أثناء تنفيذ هذا الأمر لن يلغي التنزيل\&. استخدم \fBإلغاء\-نقل\fP، الموضح أدناه\&. .sp أُضيف في الإصدار 256\&. .RE .PP \fBpull\-raw\fP \fIرابط\fP [\fIاسم\fP] .RS 4 ينزل صورة قرص \&.raw من الرابط المحدد، ويجعلها متاحة تحت الاسم المحلي المحدد في دليل الصور للفئة المختارة \fB\-\-class=\fP\&. يجب أن يكون الرابط من نوع "http://" أو "https://"\&. يجب أن تكون الصورة إما صورة قرص qcow2 أو raw، مضغوطة اختياريًا بصيغة \&.gz أو \&.xz أو \&.bz2\&. إذا حُذف الاسم المحلي، يُشتق آليًا من آخر مكون للرابط، مع إزالة لاحقته\&. .sp التحقق من الصورة متطابق لصور raw وtar (انظر أعلاه)\&. .sp إذا كانت الصورة المُنزلة بتنسيق qcow2، فستُحول إلى ملف صورة خام قبل إتاحتها\&. .sp إذا حُدد \fB\-keep\-download=yes\fP، فستُنزل الصورة وتُخزن في ملف للقراءة فقط في دليل الصورة، ويُسمى بناءً على عنوان URL المحدد وعلامة HTTP الخاصة به\&. ثم يُنشئ نسخة قابلة للكتابة من هذا الملف، وتسمى بالاسم المحلي المحدد\&. يضمن هذا السلوك أن إنشاء مثيلات متعددة لنفس عنوان URL يكون فعالاً، حيث لا تكون عمليات التنزيل المتعددة ضرورية\&. لإنشاء الصورة للقراءة فقط فقط، وتجنب إنشاء نسختها القابلة للكتابة، حدد "\-" كاسم محلي\&. .sp لاحظ أن الضغط على Control\-c أثناء تنفيذ هذا الأمر لن يلغي التنزيل\&. استخدم \fBإلغاء\-نقل\fP، الموضح أدناه\&. .sp أُضيف في الإصدار 256\&. .RE .PP \fBpull\-oci\fP \fIREF\fP [\fINAME\fP] .RS 4 يقوم بتنزيل صورة حاوية OCI المحددة، ويجعلها متاحة تحت الاسم المحلي المحدد في دليل الصورة للفئة المختارة \fB\-\-class=\fP\&. يجب أن تكون الوسيطة الأولى مرجع حاوية OCI، مثل "library/nginx". إذا حُذف الاسم المحلي، فسيُشتق آليًا من المكون الأخير لعنوان URL، مع إزالة لاحقته\&. .sp عند تنزيل صور من هذا النوع، لا يُجرى أي تحقق من الصورة يتجاوز الاستيثاق المعتاد لشهادات HTTPS\&. .sp لاحظ أن الضغط على Control\-c أثناء تنفيذ هذا الأمر لن يلغي التنزيل\&. استخدم \fBإلغاء\-نقل\fP، الموضح أدناه\&. .sp أُضيف في الإصدار 260\&. .RE .PP \fBimport\-tar\fP \fIFILE\fP [\fINAME\fP], \fBimport\-raw\fP \fIFILE\fP [\fINAME\fP] .RS 4 يستورد صورة TAR أو RAW، ويضعها تحت الاسم المحدد في دليل الصورة للفئة المحددة عبر \fB\-\-class=\fP\&. عند استخدام \fBimport\-tar\fP، يجب أن يكون الملف المحدد كوسيطة أولى أرشيف \fBtar\fP(1)، وربما مضغوطًا باستخدام \fBxz\fP(1) أو \fBgzip\fP(1) أو \fBzstd\fP(1) أو \fBbzip2\fP(1)\&. ثم يُفك ضغطه في مجلد/دليل فرعي خاص به\&. عند استخدام \fBimport\-raw\fP، يجب أن يكون الملف صورة قرص qcow2 أو خام، وربما مضغوطًا باستخدام xz أو gzip أو zstd أو bzip2\&. إذا لم يُحدد الوسيطة الثانية (اسم الصورة الناتجة)، فستُشتق آليًا من اسم الملف\&. إذا مُرر اسم الملف كـ "\-"، فستُقرأ الصورة من الإدخال القياسي، وفي هذه الحالة تكون الوسيطة الثانية إلزامية\&. .sp لا يُجرى أي تحقق تشفيري عند استيراد الصور\&. .sp تمامًا مثل تنزيلات الصور، يمكن سرد عمليات الاستيراد الجارية باستخدام \fBlist\fP وإلغاؤها باستخدام \fBcancel\-transfer\fP\&. .sp أُضيف في الإصدار 256\&. .RE .PP \fBimport\-fs\fP \fIDIRECTORY\fP [\fINAME\fP] .RS 4 يستورد صورة مخزنة في دليل محلي إلى دليل الصورة للفئة المحددة عبر \fB\-\-class=\fP ويعمل بشكل مشابه لـ \fBimport\-tar\fP أو \fBimport\-raw\fP، ولكن الوسيطة الأولى هي الدليل المصدر\&. إذا كان مدعومًا، فسينشئ هذا الأمر لقطة \fBbtrfs\fP(8) أو مجلدًا فرعيًا للصورة الجديدة\&. .sp أُضيف في الإصدار 256\&. .RE .PP \fBexport\-tar\fP \fINAME\fP [\fIFILE\fP], \fBexport\-raw\fP \fINAME\fP [\fIFILE\fP] .RS 4 يصدر صورة TAR أو RAW ويخزنها في الملف المحدد\&. يجب أن تكون المعلمة الأولى اسم صورة\&. يجب أن تكون المعلمة الثانية مسار ملف تُكتب إليه صورة TAR أو RAW\&. إذا انتهى المسار بـ "\&.gz"، يُضغط الملف باستخدام \fBgzip\fP(1)، وإذا انتهى بـ "\&.xz"، باستخدام \fBxz\fP(1)، وإذا انتهى بـ "\&.zst"، باستخدام \fBzstd\fP(1)، وإذا انتهى بـ "\&.bz2"، باستخدام \fBbzip2\fP(1)\&. إذا لم ينته المسار بأي منها، يُترك الملف غير مضغوط\&. إذا كانت الوسيطة الثانية مفقودة، تُكتب الصورة إلى الإخراج القياسي\&. يمكن أيضًا تحديد الضغط بشكل صريح باستخدام المفتاح \fB\-\-format=\fP\&. هذا مفيد بشكل خاص إذا تركت المعلمة الثانية غير محددة\&. .sp تمامًا مثل تنزيلات الصور وعمليات الاستيراد، يمكن سرد عمليات التصدير الجارية باستخدام \fBlist\fP وإلغاؤها باستخدام \fBcancel\-transfer\fP\&. .sp لاحظ أنه، حاليًا، يمكن فقط تصدير صور الدليل والمجلدات الفرعية كصور TAR، وصور القرص الخام فقط كصور RAW\&. .sp أُضيف في الإصدار 256\&. .RE .PP \fBlist\-transfer\fP .RS 4 يعرض قائمة بتنزيلات الصور وعمليات الاستيراد والتصدير الجارية حاليًا\&. .sp أُضيف في الإصدار 256\&. .RE .PP \fBcancel\-transfer\fP \fIID\fP\&... .RS 4 يلغي تنزيل أو استيراد أو تصدير الصورة بالمعرف المحدد\&. لسرد عمليات النقل الجارية ومعرفاتها، استخدم \fBlist\fP\&. .sp أُضيف في الإصدار 256\&. .RE .PP \fBlist\-images\fP .RS 4 يعرض قائمة بالصور المنزلة/المستوردة فعلًا\&. .sp أُضيف في الإصدار 256\&. .RE .SH الخيارات .PP الخيارات التالية مفهومة: .PP \fB\-\-read\-only\fP .RS 4 عند استخدامه مع \fBpull\-raw\fP أو \fBpull\-tar\fP أو \fBimport\-raw\fP أو \fBimport\-tar\fP أو \fBimport\-fs\fP، تُنشئ صورة للقراءة فقط\&. .sp أُضيف في الإصدار 256\&. .RE .PP \fB\-\-verify=\fP .RS 4 عند تنزيل صورة، حدد ما إذا كان يجب التحقق من الصورة قبل إتاحتها\&. يأخذ أحد القيم "no" أو "checksum" أو "signature"\&. إذا كان "no"، فلا يُجرى أي تحقق\&. إذا حُدد "checksum"، يُفحص سلامة التنزيل بعد اكتمال النقل، ولكن لا يُتحقق من التوقيعات\&. إذا حُدد "signature"، يُتحقق من المجموع الاختباري ويُفحص توقيع الصورة مقابل سلسلة مفاتيح محلية من البائعين الموثوقين\&. يُوصى بشدة بتعيين هذا الخيار إلى "signature" إذا كان الخادم والبروتوكول يدعمان ذلك\&. المبدئي هو "signature"\&. .sp أُضيف في الإصدار 256\&. .RE .PP \fB\-\-force\fP .RS 4 عند تنزيل صورة، وإذا كانت نسخة محلية بالاسم المحلي المحدد موجودة فعلًا، فاحذفها أولاً واستبدلها بالصورة المنزلة حديثًا\&. .sp أُضيف في الإصدار 256\&. .RE .PP \fB\-\-format=\fP .RS 4 عند استخدامه مع الأمرين \fBexport\-tar\fP أو \fBexport\-raw\fP، يحدد تنسيق الضغط لاستخدامه في الملف الناتج\&. يأخذ أحد القيم "uncompressed" أو "xz" أو "gzip" أو "zst" أو "bzip2"\&. بشكل مبدئي، يُحدد التنسيق آليًا من اسم ملف الصورة الناتج المُمرر\&. .sp أُضيف في الإصدار 256\&. .RE .PP \fB\-q\fP، \fB\-\-quiet\fP .RS 4 يكتم مخرجات المعلومات الإضافية أثناء التشغيل\&. .sp أُضيف في الإصدار 256\&. .RE .PP \fB\-H\fP، \fB\-\-host=\fP .RS 4 نفّذ العملية عن بُعد\&. حدد اسم مضيف، أو اسم مستخدم واسم مضيف يفصل بينهما "@" للاتصال به\&. يمكن اختيارياً إلحاق اسم المضيف بمنفذ يستمع إليه ssh، مفصولاً بـ ":"، ثم اسم حاوية، مفصولاً بـ "/"، مما يوصل مباشرة بحاوية معينة على المضيف المحدد\&. سيستخدم هذا SSH للتحدث إلى نسخة مدير الحاسوب البعيد\&. يمكن سرد أسماء الحاويات باستخدام \fBmachinectl \-H \fP\fIالمضيف\fP\&. ضع عناوين IPv6بين قوسين\&. .RE .PP \fB\-M\fP، \fB\-\-machine=\fP .RS 4 الاتصال بـ \fBsystemd\-importd.service\fP(8) الجاري في حاوية محلية، لتنفيذ العملية المحددة داخل الحاوية\&. .sp أُضيف في الإصدار 256\&. .RE .PP \fB\-\-class=\fP, \fB\-m\fP, \fB\-P\fP, \fB\-S\fP, \fB\-C\fP .RS 4 يختار فئة الصورة للصور المنزّلة\&. يختار هذا بشكل أساسي الدليل الذي سيُنزل إليه\&. يأخذ المفتاح \fB\-\-class=\fP "machine" أو "portable" أو "sysext" أو "confext" كوسيط\&. الخيارات المختصرة \fB\-m\fP و \fB\-P\fP و \fB\-S\fP و \fB\-C\fP هي اختصارات لـ \fB\-\-class=machine\fP و \fB\-\-class=portable\fP و \fB\-\-class=sysext\fP و \fB\-\-class=confext\fP\&. .sp لاحظ أن \fB\-\-keep\-download=\fP يكون مبدئيًا صحيحًا لـ \fB\-\-class=machine\fP وخاطئًا فيما عدا ذلك، انظر أدناه\&. .sp أُضيف في الإصدار 256\&. .RE .PP \fB\-\-keep\-download=\fP, \fB\-N\fP .RS 4 يأخذ وسيطًا منطقيًا\&. عند تحديده مع \fBpull\-raw\fP أو \fBpull\-tar\fP، يختار ما إذا كان سيُنزل مباشرة إلى اسم الصورة المحلية المحدد، أو ما إذا كان سيُنزل إلى نسخة للقراءة فقط أولاً لعمل نسخة قابلة للكتابة بعد اكتمال التنزيل\&. يكون مبدئيًا صحيحًا لـ \fB\-\-class=machine\fP، وخاطئًا فيما عدا ذلك\&. .sp المفتاح \fB\-N\fP هو اختصار لـ \fB\-\-keep\-download=no\fP\&. .sp أُضيف في الإصدار 256\&. .RE .PP \fB\-\-json=\fP\fIوضع\fP .RS 4 يظهر المخرجات منسقة بصيغة JSON\&. يتوقع أحد الخيارات: "short" (لأقصر مخرج ممكن دون أي مسافات زائدة أو فواصل أسطر)، أو "pretty" (لنسخة جميلة من المخرج نفسه، مع إزاحة وفواصل أسطر) أو "off" (لإيقاف مخرجات JSON، وهو الخيار المبدئي)\&. .RE .PP \fB\-j\fP .RS 4 يكافئ \fB\-\-json=pretty\fP إذا كان يعمل على طرفية، و \fB\-\-json=short\fP في الحالات الأخرى\&. .RE .PP \fB\-\-no\-pager\fP .RS 4 لا تمرر المخرجات إلى برنامج عرض (pager)\&. .RE .PP \fB\-\-no\-legend\fP .RS 4 لا تطبع مفتاح الرموز، أي ترويسات الأعمدة والتذييل المزود بالتلميحات\&. .RE .PP \fB\-\-no\-ask\-password\fP .RS 4 لا تسأل المستخدم عن الاستيثاق للعمليات ذات الامتيازات\&. .RE .PP \fB\-h\fP، \fB\-\-help\fP .RS 4 اطبع نص مساعدة قصير واخرج\&. .RE .PP \fB\-\-version\fP .RS 4 اطبع سلسلة إصدار قصيرة واخرج\&. .RE .SH أمثلة .PP \fBالمثال\ \&1.\ \&نزّل صورة TAR لأوبونتو وافتح صدفة فيها\fP .sp .if n \{\ .RS 4 .\} .nf # importctl pull\-tar \-mN https://cloud\-images\&.ubuntu\&.com/jammy/current/jammy\-server\-cloudimg\-amd64\-root\&.tar\&.xz # systemd\-nspawn \-M jammy\-server\-cloudimg\-amd64\-root .fi .if n \{\ .RE .\} .PP ينزل هذا صورة \&.tar المحددة ويتحقق منها، ثم يستخدم \fBsystemd\-nspawn\fP(1) لفتح صدفة فيها\&. .PP \fBمثال\ \&2.\ \&تنزيل صورة RAW لأوبونتو، تعيين كلمة مرور الجذر فيها، تشغيلها كخدمة\fP .sp .if n \{\ .RS 4 .\} .nf # importctl pull\-raw \-mN \e https://cloud\-images\&.ubuntu\&.com/jammy/current/jammy\-server\-cloudimg\-amd64\-disk\-kvm\&.img \e jammy # systemd\-firstboot \-\-image=/var/lib/machines/jammy\&.raw \-\-prompt\-root\-password \-\-force # machinectl start jammy # machinectl login jammy .fi .if n \{\ .RE .\} .PP ينزل هذا صورة \&.raw المحددة ويجعلها متاحة تحت الاسم المحلي "jammy"\&. ثم، تُضبط كلمة سر الجذر باستخدام \fBsystemd\-firstboot\fP(1)\&. وبعد ذلك تُشغل الآلة كخدمة نظام\&. وباستخدام الأمر الأخير يُطلب حث دخول إلى الحاوية\&. .PP \fBمثال\ \&3.\ \&تصدير صورة حاوية كملف tar\fP .sp .if n \{\ .RS 4 .\} .nf # importctl export\-tar \-m fedora myfedora\&.tar\&.xz .fi .if n \{\ .RE .\} .PP يصدّر الحاوية "fedora" كملف tar مضغوط بـ xz باسم myfedora\&.tar\&.xz إلى الدليل الحالي\&. .SH "حالة الخروج" .PP عند النجاح، يُعاد الرقم 0، وإلا فيُعاد رمز فشل غير صفري\&. .SH البيئة .PP \fI$SYSTEMD_LOG_LEVEL\fP .RS 4 الحد الأقصى لمستوى السجل للرسائل الصادرة (تُكتم الرسائل ذات مستوى السجل الأعلى، أي الأقل أهمية)\&. يأخذ قائمة قيم مفصولة بفواصل\&. يمكن أن تكون القيمة إما واحدة من (بترتيب تنازلي للأهمية) \fBemerg\fP، أو \fBalert\fP، أو \fBcrit\fP، أو \fBerr\fP، أو \fBwarning\fP، أو \fBnotice\fP، أو \fBinfo\fP، أو \fBdebug\fP، أو رقمًا صحيحًا في النطاق من 0 إلى 7\&. راجع \fBsyslog\fP(3) لمزيد من المعلومات\&. يمكن اختياريًا سبق كل قيمة بأحد الخيارات \fBconsole\fP، أو \fBsyslog\fP، أو \fBkmsg\fP أو \fBjournal\fP متبوعة بنقطتين لضبط الحد الأقصى لمستوى السجل لهذا الهدف المحدد (مثلاً: \fBSYSTEMD_LOG_LEVEL=debug,console:info\fP يحدد التسجيل بمستوى debug باستثناء التسجيل في الطرفية الذي يجب أن يكون بمستوى info)\&. لاحظ أن الحد الأقصى العالمي لمستوى السجل له الأولوية على أي حدود مستويات سجل لكل هدف على حدة\&. .RE .PP \fI$SYSTEMD_LOG_COLOR\fP .RS 4 قيمة منطقية\&. إذا كانت صحيحة، فستُلون الرسائل المكتوبة في الـ tty حسب الأولوية\&. .sp هذا الإعداد مفيد فقط عندما تُكتب الرسائل مباشرة إلى الطرفية، لأن \fBjournalctl\fP(1) والأدوات الأخرى التي تعرض السجلات ستلون الرسائل بناءً على مستوى السجل من تلقاء نفسها\&. .RE .PP \fI$SYSTEMD_LOG_TIME\fP .RS 4 قيمة منطقية\&. إذا كانت صحيحة، فستُسبق رسائل سجل الطرفية بختم زمني\&. .sp هذا الإعداد مفيد فقط عندما تُكتب الرسائل مباشرة إلى الطرفية أو إلى ملف، لأن \fBjournalctl\fP(1) والأدوات الأخرى التي تعرض السجلات ستُرفق طوابع زمنية بناءً على البيانات الوصفية للمدخلات من تلقاء نفسها\&. .RE .PP \fI$SYSTEMD_LOG_LOCATION\fP .RS 4 قيمة منطقية\&. إذا كانت صحيحة، فستُسبق الرسائل باسم الملف ورقم السطر في الشيفرة المصدرية حيث نشأت الرسالة\&. .sp لاحظ أن موقع السجل غالبًا ما يُرفق كبيانات وصفية بمدخلات اليوميات على أي حال\&. ومع ذلك، قد يكون تضمينه مباشرة في نص الرسالة مفيدًا عند تنقيح البرامج\&. .RE .PP \fI$SYSTEMD_LOG_TID\fP .RS 4 قيمة منطقية\&. إذا كانت صحيحة، فستُسبق الرسائل بمعرّف الخيط الرقمي الحالي (TID)\&. .sp لاحظ أن هذه المعلومات تُرفق كبيانات وصفية بمدخلات اليوميات على أي حال\&. ومع ذلك، قد يكون تضمينه مباشرة في نص الرسالة مفيدًا عند تنقيح البرامج\&. .RE .PP \fI$SYSTEMD_LOG_TARGET\fP .RS 4 وجهة رسائل السجل\&. أحد الخيارات: \fBconsole\fP (التسجيل في الطرفية المرفقة)، أو \fBconsole\-prefixed\fP (التسجيل في الطرفية المرفقة ولكن مع بادئات ترميز مستوى السجل و"المرفق"، راجع \fBsyslog\fP(3)، أو \fBkmsg\fP (التسجيل في ذاكرة السجل الدائرية للنواة)، أو \fBjournal\fP (التسجيل في اليوميات)، أو \fBjournal\-or\-kmsg\fP (التسجيل في اليوميات إذا كانت متاحة، وفي kmsg بخلاف ذلك)، أو \fBauto\fP (تحديد هدف السجل المناسب آليًا، وهو المبدئي)، أو \fBnull\fP (تعطيل مخرج السجل)\&. .RE .PP \fI$SYSTEMD_LOG_RATELIMIT_KMSG\fP .RS 4 فيما إذا كان سيُحد معدل kmsg أم لا\&. يأخذ قيمة منطقية\&. القيمة المبدئية هي "true"\&. إذا عُطّل، فلن يحد systemd من معدل الرسائل المكتوبة في kmsg\&. .RE .PP \fI$SYSTEMD_PAGER\fP، \fI$PAGER\fP .RS 4 مستعرض الصفحات المراد استخدامه عندما لا يُعطى الخيار \fB\-\-no\-pager\fP\&. يُستخدم \fI$SYSTEMD_PAGER\fP إذا كان مضبوطًا؛ وإلا فيُستخدم \fI$PAGER\fP\&. إذا لم يُضبط أي من \fI$SYSTEMD_PAGER\fP أو \fI$PAGER\fP، فتُجرب مجموعة من التطبيقات المعروفة لمستعرضات الصفحات تباعًا، بما في ذلك \fBless\fP(1) و \fBmore\fP(1)، حتى يُعثر على أحدها\&. إذا لم يُكتشف أي تطبيق لمستعرض الصفحات، فلا يُستدعى أي مستعرض\&. ضبط متغيرات البيئة هذه على سلسلة فارغة أو القيمة "cat" يعادل تمرير الخيار \fB\-\-no\-pager\fP\&. .sp ملاحظة: إذا لم يُضبط \fI$SYSTEMD_PAGERSECURE\fP، فلا يمكن استخدام \fI$SYSTEMD_PAGER\fP و \fI$PAGER\fP إلا لتعطيل مستعرض الصفحات (باستخدام "cat" أو "")، ويُتجاهل فيما عدا ذلك\&. .RE .PP \fI$SYSTEMD_LESS\fP .RS 4 تجاوز الخيارات الممررة إلى \fBless\fP (مبدئيًا "FRSXMK")\&. .sp قد يرغب المستخدمون في تغيير خيارين على وجه الخصوص: .PP \fBK\fP .RS 4 يوجه هذا الخيار مستعرض الصفحات بالخروج فورًا عند الضغط على Ctrl+C\&. للسماح لـ \fBless\fP بالتعامل مع Ctrl+C بنفسه للعودة إلى محث أوامر المستعرض، قم بإلغاء ضبط هذا الخيار\&. .sp إذا لم تتضمن قيمة \fI$SYSTEMD_LESS\fP الحرف "K"، وكان المستعرض المستدعى هو \fBless\fP، فسيُتجاهل Ctrl+C من قبل الملف التنفيذي، ويجب معالجته من قبل المستعرض\&. .RE .PP \fBX\fP .RS 4 يوجه هذا الخيار مستعرض الصفحات بعدم إرسال سلاسل تهيئة وإنهاء termcap إلى الطرفية\&. يُضبط مبدئيًا للسماح لمخرجات الأوامر بالبقاء مرئية في الطرفية حتى بعد خروج المستعرض\&. ومع ذلك، فإن هذا يمنع بعض وظائف المستعرض من العمل، لا سيما أن المخرجات المفصولة بصفحات لا يمكن تمريرها باستخدام الفأرة\&. .RE .sp لاحظ أن ضبط متغير البيئة العادي \fI$LESS\fP ليس له أي تأثير عند استدعاء \fBless\fP بواسطة أدوات systemd\&. .sp راجع \fBless\fP(1) لمزيد من النقاش\&. .RE .PP \fI$SYSTEMD_LESSCHARSET\fP .RS 4 يتجاوز طقم المحارف الممرر إلى \fBless\fP (مبدئيًا "utf\-8"، إذا حُدّد أن الطرفية المستدعية متوافقة مع UTF\-8)\&. .sp لاحظ أن ضبط متغير البيئة العادي \fI$LESSCHARSET\fP ليس له أي تأثير عند استدعاء \fBless\fP بواسطة أدوات systemd\&. .RE .PP \fI$SYSTEMD_PAGERSECURE\fP .RS 4 تدعم أوامر المستعرض (pager) الشائعة مثل \fBless\fP(1)، بالإضافة إلى "التصفح"، أي التمرير عبر المخرجات، فتح ملفات أخرى أو الكتابة إليها وتشغيل أوامر صدفة عشوائية\&. عند استدعاء الأوامر بامتيازات مرفوعة، على سبيل المثال تحت \fBsudo\fP(8) أو \fBpkexec\fP(1)، يصبح المستعرض حدًا أمنيًا\&. يجب الحرص على استخدام البرامج ذات الوظائف المحدودة للغاية فقط كمستعرضات، وعدم السماح بالميزات التفاعلية غير المقصودة مثل فتح ملفات جديدة أو إنشائها أو بدء عمليات فرعية\&. يمكن تمكين "الوضع الآمن" للمستعرض كما هو موضح أدناه، \fIإذا كان المستعرض يدعم ذلك\fP (معظم المستعرضات لم تُكتب بطريقة تأخذ هذا في الاعتبار)\&. يوصى إما بتمكين "الوضع الآمن" صراحةً أو تعطيل المستعرض تمامًا باستخدام \fB\-\-no\-pager\fP أو \fIPAGER=cat\fP عند السماح للمستخدمين غير الموثوق بهم بتنفيذ أوامر بامتيازات مرفوعة\&. .sp يأخذ هذا الخيار وسيطًا منطقيًا\&. عند ضبطه على صحيح (true)، يُمكن "الوضع الآمن" لمستعرض الصفحات\&. في "الوضع الآمن"، سيُضبط \fBLESSSECURE=1\fP عند استدعاء المستعرض، مما يوجه المستعرض لتعطيل الأوامر التي تفتح أو تنشئ ملفات جديدة أو تبدأ عمليات فرعية جديدة\&. حاليًا، يُعرف فقط \fBless\fP(1) بقدرته على فهم هذا المتغير وتطبيق "الوضع الآمن"\&. .sp عند الضبط إلى false، لا توضع قيود على أداة التصفح (pager)\&. إن ضبط \fISYSTEMD_PAGERSECURE=0\fP أو عدم إزالته من البيئة الموروثة قد يسمح للمستخدم باستدعاء أوامر اعتباطية\&. .sp عندما لا يُضبط \fI$SYSTEMD_PAGERSECURE\fP، تحاول أدوات systemd استنتاج ما إذا كان ينبغي تمكين "الوضع الآمن" آليًا وما إذا كان المستعرض يدعمه\&. يُمكن "الوضع الآمن" إذا كان معرف المستخدم الفعلي (UID) ليس هو نفسه مالك جلسة الولوج، انظر \fBgeteuid\fP(2) و \fBsd_pid_get_owner_uid\fP(3)، أو عند التشغيل تحت \fBsudo\fP(8) أو أدوات مماثلة (\fI$SUDO_UID\fP مضبوط \&\s-2\u[2]\d\s+2)\&. في تلك الحالات، سيُضبط \fISYSTEMD_PAGERSECURE=1\fP ولن تُستخدم المستعرضات التي لا يُعرف عنها تطبيق "الوضع الآمن" على الإطلاق\&. لاحظ أن هذا الاستكشاف الآلي يغطي فقط الآليات الأكثر شيوعًا لرفع الامتيازات وهو مخصص للتسهيل\&. يوصى بضبط \fI$SYSTEMD_PAGERSECURE\fP صراحةً أو تعطيل المستعرض\&. .sp لاحظ أنه إذا أُريد احترام المتغيرات \fI$SYSTEMD_PAGER\fP أو \fI$PAGER\fP، لغير غرض تعطيل مستعرض الصفحات، فيجب ضبط \fI$SYSTEMD_PAGERSECURE\fP أيضًا\&. .RE .PP \fI$SYSTEMD_COLORS\fP .RS 4 يأخذ وسيطًا منطقيًا (boolean)، أو قيمة خاصة\&. مبدئيًا (عند عدم الضبط)، سيستخدم \fBsystemd\fP والأدوات المرتبطة به الألوان في مخرجاتها إذا أمكن ذلك\&. إذا ضُبط \fI$COLORTERM\fP على "truecolor" أو "24bit"، فستُمكّن ألوان 24 بت، وإلا فستُستخدم 256 لونًا، ما لم يشر \fI$NO_COLOR\fP أو \fI$TERM\fP إلى تعطيل الألوان\&. .PP \fBtrue\fP .RS 4 نفس حالة عدم الضبط، باستثناء تجاهل \fI$NO_COLOR\fP\&. .RE .PP \fBfalse\fP .RS 4 سيكون المخرج أحادي اللون\&. .RE .PP "16"، "256"، "24bit" .RS 4 استخدم دائمًا ألوان ANSI الـ 16 الأساسية، أو 256 لونًا، أو لون 24 بت، على التوالي\&. .RE .PP "auto\-16"، "auto\-256"، "auto\-24bit" .RS 4 استخدم كمية الألوان المعطاة، بشرط \fI$TERM\fP، وما هو متصل بالطرفية\&. .RE .RE .PP \fI$SYSTEMD_URLIFY\fP .RS 4 يجب أن تكون القيمة منطقية\&. تتحكم فيما إذا كان يجب توليد روابط قابلة للنقر في المخرج لمحاكيات الطرفية التي تدعم ذلك\&. يمكن تحديد هذا لتجاوز القرار الذي يتخذه \fBsystemd\fP بناءً على \fI$TERM\fP وشروط أخرى\&. .RE .SH "انظر أيضًا" .PP \fBsystemd\fP(1), \fBsystemd\-importd.service\fP(8), \fBsystemd\-nspawn\fP(1), \fBsystemd\-vmspawn\fP(1), \fBmachinectl\fP(1), \fBportablectl\fP(1), \fBsystemd\-sysext\fP(8), \fBsystemd\-confext\fP(8), \fBtar\fP(1), \fBxz\fP(1), \fBgzip\fP(1), \fBzstd\fP(1), \fBbzip2\fP(1) .SH ملاحظات .IP " 1." 4 HTTP ETag .RS 4 \%https://en.wikipedia.org/wiki/HTTP_ETag .RE .IP " 2." 4 يوصى للأدوات الأخرى بضبط والتحقق من \fI$SUDO_UID\fP حسب الاقتضاء، ومعاملته كواجهة مشتركة. .PP .SH ترجمة تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي . .PP هذه الترجمة هي وثيقة مجانية؛ راجع .UR https://www.gnu.org/licenses/gpl-3.0.html رخصة جنو العامة الإصدار 3 .UE أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات. .PP إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: .MT kde-l10n-ar@kde.org .ME .