.\" -*- coding: UTF-8 -*- '\" t .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH SYSTEMD\-RUN 1 "" "systemd 260.2" systemd\-run .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 الاسم systemd\-run \- تشغيل البرامج في وحدات نطاق عابرة، أو وحدات خدمة، أو وحدات خدمة مفعلة بالمسار أو المقبس أو الموقت .SH موجز .HP \w'\fBsystemd\-run\fR\ 'u \fBsystemd\-run\fP [خيارات...] \fIأمر\fP\ [وسائط...] .HP \w'\fBsystemd\-run\fR\ 'u \fBsystemd\-run\fP [خيارات...] [خيارات\ مسار...] {\fIأمر\fP\ [وسائط...]} .HP \w'\fBsystemd\-run\fR\ 'u \fBsystemd\-run\fP [خيارات...] [خيارات\ مقبس...] {\fIأمر\fP\ [وسائط...]} .HP \w'\fBsystemd\-run\fR\ 'u \fBsystemd\-run\fP [خيارات...] [خيارات\ موقت...] {\fIأمر\fP\ [وسائط...]} .SH الوصف .PP يمكن استخدام \fBsystemd\-run\fP لإنشاء وبدء وحدة \&.service أو \&.scope عابرة وتشغيل \fIالأمر\fP المحدد فيها\&. يمكن استخدامه أيضًا لإنشاء وبدء وحدة \&.path أو \&.socket أو \&.timer عابرة، تقوم بتفعيل وحدة \&.service عند انقضائها\&. .PP إذا شُغّل أمر كوحدة خدمة عابرة، فسيبدأ ويدار بواسطة مدير الخدمة مثل أي خدمة أخرى، وبالتالي يظهر في مخرجات \fBsystemctl list\-units\fP مثل أي وحدة أخرى\&. سيعمل في بيئة تنفيذ نظيفة ومنفصلة، مع مدير الخدمة كعملية أصل له\&. في هذا الوضع، سيبدأ \fBsystemd\-run\fP الخدمة بشكل غير متزامن في الخلفية ويعود بعد بدء تنفيذ الأمر (ما لم يُحدد \fB\-\-no\-block\fP أو \fB\-\-wait\fP أو \fB\-\-pipe\fP أو \fB\-\-pty\fP، انظر أدناه)\&. .PP إذا شُغّل أمر كوحدة نطاق عابرة، فسينفذه \fBsystemd\-run\fP نفسه كعملية أصل وبالتالي سيرث بيئة تنفيذ المتصل\&. ومع ذلك، تدير عمليات الأمر بواسطة مدير الخدمة بشكل مشابه للخدمات العادية، وستظهر في مخرجات \fBsystemctl list\-units\fP\&. التنفيذ في هذه الحالة متزامن، وسيعود فقط عند انتهاء الأمر\&. يُمكّن هذا الوضع عبر المفتاح \fB\-\-scope\fP (انظر أدناه)\&. .PP إذا شُغّل أمر مع خيارات مسار أو مقبس أو موقت مثل \fB\-\-on\-calendar=\fP (انظر أدناه)، فستُنشئ وحدة مسار أو مقبس أو موقت عابرة إلى جانب وحدة الخدمة للأمر المحدد\&. فقط وحدة المسار أو المقبس أو الموقت العابرة تبدأ فورًا، وستُفعل وحدة الخدمة العابرة بواسطة وحدة المسار أو المقبس أو الموقت\&. إذا حُدد الخيار \fB\-\-unit=\fP، فقد يُحذف \fIالأمر\fP\&. في هذه الحالة، ينشئ \fBsystemd\-run\fP فقط وحدة \&.path أو \&.socket أو \&.timer تقوم بتفعيل الوحدة المحددة\&. .PP مبدئيًا، تكون الخدمات المنشأة مع \fBsystemd\-run\fP من النوع \fBsimple\fP مبدئيًا، انظر وصف \fIType=\fP في \fBsystemd.service\fP(5) للتفاصيل\&. لاحظ أنه عند استخدام هذا النوع، يعتبر مدير الخدمة (وبالتالي أمر \fBsystemd\-run\fP) بدء الخدمة ناجحًا بمجرد نجاح \fBfork()\fP لعملية الخدمة الرئيسة، أي قبل استدعاء \fBexecve()\fP، وبالتالي حتى إذا تعذر بدء الأمر المحدد\&. فكر في استخدام نوع الخدمة \fBexec\fP (أي \fB\-\-property=Type=exec\fP) لضمان عودة \fBsystemd\-run\fP بنجاح فقط إذا بُدأ سطر الأوامر المحدد بنجاح\&. .PP بعد أن يمرر \fBsystemd\-run\fP الأمر إلى مدير الخدمة، يقوم المدير بتوسيع المتغيرات\&. هذا يعني أن أحرف الدولار ("$") التي لا ينبغي توسيعها تحتاج إلى الهروب كـ "$$"\&. يمكن أيضًا تعطيل التوسيع باستخدام \fI\-\-expand\-environment=no\fP\&. .SH الخيارات .PP الخيارات التالية مفهومة: .PP \fB\-\-scope\fP .RS 4 إنشاء وحدة \&.scope عابرة بدلاً من وحدة \&.service العابرة المبدئية (انظر أعلاه)\&. .sp أُضيف في الإصدارة 206\&. .RE .PP \fB\-\-unit=\fP, \fB\-u\fP .RS 4 استخدم اسم الوحدة هذا بدلاً من اسم مولد آلياً\&. .sp أُضيف في الإصدارة 206\&. .RE .PP \fB\-\-property=\fP، \fB\-p\fP .RS 4 يضبط خاصية على وحدة النطاق أو الخدمة المنشأة\&. يأخذ هذا الخيار تعيينًا بنفس تنسيق أمر \fBsystemctl\fP(1)\*(Aqs \fBset\-property\fP\&. .sp أُضيف في الإصدارة 211\&. .RE .PP \fB\-\-description=\fP .RS 4 تقديم وصف لوحدة الخدمة أو النطاق أو المسار أو المقبس أو الموقت\&. إذا لم يُحدد، فسيستخدم الأمر نفسه كوصف\&. انظر \fIDescription=\fP في \fBsystemd.unit\fP(5)\&. .sp أُضيف في الإصدارة 206\&. .RE .PP \fB\-\-slice=\fP .RS 4 جعل وحدة \&.service أو \&.scope الجديدة جزءًا من الشريحة المحددة، بدلاً من system\&.slice (عند التشغيل في وضع \fB\-\-system\fP) أو الشريحة الجذرية (عند التشغيل في وضع \fB\-\-user\fP)\&. .sp أُضيف في الإصدارة 206\&. .RE .PP \fB\-\-slice\-inherit\fP .RS 4 جعل وحدة \&.service أو \&.scope الجديدة جزءًا من الشريحة التي اُستدعي \fBsystemd\-run\fP نفسه فيها\&. يمكن دمج هذا الخيار مع \fB\-\-slice=\fP، وفي هذه الحالة توضع الشريحة المحددة عبر \fB\-\-slice=\fP داخل الشريحة التي اُستدعي أمر \fBsystemd\-run\fP فيها\&. .sp مثال: افترض أن \fBsystemd\-run\fP اُستدعي في الشريحة foo\&.slice، ووسيطة \fB\-\-slice=\fP هي bar\&. ستوضع الوحدة بعد ذلك تحت foo\-bar\&.slice\&. .sp أُضيف في الإصدار 246\&. .RE .PP \fB\-\-expand\-environment=\fP\fIقيمة_منطقية\fP .RS 4 توسيع متغيرات البيئة في وسائط الأمر\&. إذا مُكّن (المبدئي)، فستُوسع متغيرات البيئة المحددة كـ "${\fIمتغير\fP}" بنفس الطريقة كما في الأوامر المحددة عبر \fIExecStart=\fP في الوحدات\&. مع \fI\-\-scope\fP، يُوسع هذا بواسطة \fBsystemd\-run\fP نفسه، وفي حالات أخرى بواسطة مدير الخدمة الذي يولد الأمر\&. لاحظ أن هذا مشابه، لكن ليس نفس توسيع المتغيرات في \fBbash\fP(1) والأصداف الأخرى\&. .sp انظر \fBsystemd.service\fP(5) لوصف توسيع المتغيرات\&. تعطيل توسيع المتغيرات مفيد إذا كان الأمر المحدد يتضمن أو قد يتضمن علامة "$"\&. .sp أُضيف في الإصدار 254\&. .RE .PP \fB\-r\fP, \fB\-\-remain\-after\-exit\fP .RS 4 بعد إنهاء عملية الخدمة، أبقِ الخدمة موجودة حتى يُوقف صراحة\&. هذا مفيد لجمع معلومات وقت التشغيل حول الخدمة بعد انتهائها من التشغيل\&. انظر أيضًا \fIRemainAfterExit=\fP في \fBsystemd.service\fP(5)\&. .sp أُضيف في الإصدارة 207\&. .RE .PP \fB\-\-send\-sighup\fP .RS 4 عند إنهاء وحدة النطاق أو الخدمة، أرسل إشارة SIGHUP فورًا بعد SIGTERM\&. هذا مفيد للإشارة إلى الصدفات والعمليات الشبيهة بالصدفة بأن الاتصال قد انقطع\&. انظر أيضًا \fISendSIGHUP=\fP في \fBsystemd.kill\fP(5)\&. .sp أُضيف في الإصدارة 207\&. .RE .PP \fB\-\-service\-type=\fP .RS 4 يضبط نوع الخدمة\&. انظر أيضًا \fIType=\fP في \fBsystemd.service\fP(5)\&. ليس لهذا الخيار أي تأثير مع \fB\-\-scope\fP\&. المبدئي هو \fBsimple\fP\&. .sp أُضيف في الإصدارة 211\&. .RE .PP \fB\-\-uid=\fP, \fB\-\-gid=\fP .RS 4 يشغّل عملية الخدمة تحت المستخدم والمجموعة UNIX المحددين\&. انظر أيضًا \fIUser=\fP و \fIGroup=\fP في \fBsystemd.exec\fP(5)\&. .sp أُضيف في الإصدارة 211\&. .RE .PP \fB\-\-nice=\fP .RS 4 يشغّل عملية الخدمة بمستوى nice المحدد\&. انظر أيضًا \fINice=\fP في \fBsystemd.exec\fP(5)\&. .sp أُضيف في الإصدارة 211\&. .RE .PP \fB\-\-working\-directory=\fP .RS 4 يشغّل عملية الخدمة بدليل العمل المحدد\&. انظر أيضًا \fIWorkingDirectory=\fP في \fBsystemd.exec\fP(5)\&. .sp أُضيف في الإصدار 240\&. .RE .PP \fB\-\-same\-dir\fP, \fB\-d\fP .RS 4 مشابه لـ \fB\-\-working\-directory=\fP، لكنه يستخدم دليل العمل الحالي للمستدعي لتنفيذ الخدمة\&. .sp أُضيف في الإصدار 240\&. .RE .PP \fB\-\-root\-directory=\fP .RS 4 يشغّل عملية الخدمة بدليل الجذر المحدد\&. انظر أيضًا \fIRootDirectory=\fP في \fBsystemd.exec\fP(5)\&. .sp لاحظ أن المسار يُبحث عنه داخل مساحة اسم نظام الملفات التي يعمل فيها systemd\-run، والتي قد تختلف عن مساحة اسم نظام الملفات التي تعمل فيها عملية المدير\&. استخدم الخاصية \fIRootDirectory=\fP مباشرة إذا أردت البحث عن المسار في مساحة اسم نظام الملفات لعملية المدير\&. .sp أُضيف في الإصدار 259\&. .RE .PP \fB\-\-same\-root\-dir\fP, \fB\-R\fP .RS 4 مشابه لـ \fB\-\-root\-directory=\fP، لكنه يستخدم دليل الجذر لعملية systemd\-run كدليل الجذر لتنفيذ الخدمة فيه\&. .sp أُضيف في الإصدار 259\&. .RE .PP \fB\-E \fP\fIالاسم\fP\fB[=\fP\fIالقيمة\fP\fB]\fP، \fB\-\-setenv=\fP\fIالاسم\fP\fB[=\fP\fIالقيمة\fP\fB]\fP .RS 4 يشغّل عملية الخدمة مع تعيين متغير البيئة المحدد\&. يمكن استخدام هذه المعلمة أكثر من مرة لتعيين متغيرات متعددة\&. عند حذف "=" و \fIVALUE\fP، ستُستخدم قيمة المتغير الذي يحمل نفس الاسم في بيئة البرنامج\&. .sp انظر أيضًا \fIEnvironment=\fP في \fBsystemd.exec\fP(5)\&. .sp أُضيف في الإصدارة 211\&. .RE .PP \fB\-\-pty\fP, \fB\-t\fP .RS 4 عند استدعاء الأمر، تصل الخدمة المؤقتة مدخلاتها ومخرجاتها وأخطاءها القياسية بالطرفية التي استُدعي عليها \fBsystemd\-run\fP، عبر جهاز TTY زائف\&. يسمح هذا بتشغيل البرامج التي تتوقع إدخال/إخراج تفاعلي للمستخدم كخدمات، مثل الصدفات التفاعلية\&. .sp سيؤدي هذا الخيار إلى انتظار \fBsystemd\-run\fP بشكل متزامن لإنهاء الخدمة المؤقتة، مشابهًا لتحديد \fB\-\-wait\fP\&. إذا حُدد مع \fB\-\-wait\fP، فلن يخرج \fBsystemd\-run\fP عند قطع الاتصال يدويًا من جهاز TTY الزائف\&. .sp لاحظ أن أمر \fBshell\fP في \fBmachinectl\fP(1) هو عادة بديل أفضل لطلب جلسة ولوج تفاعلية جديدة على المضيف المحلي أو الحاوية المحلية\&. .sp انظر أدناه للتفاصيل حول كيفية دمج هذا المفتاح مع \fB\-\-pipe\fP\&. .sp أُضيف في الإصدارة 219\&. .RE .PP \fB\-\-pty\-late\fP, \fB\-T\fP .RS 4 مشابه جدًا لـ \fB\-\-pty\fP، لكن اتصال PTY يبدأ فقط بعد اكتمال بدء الوحدة\&. هذا يعني فعليًا أن إدخال PTY أثناء \fIExecStartPre=\fP لخدمة غير متاح عند استخدام \fB\-\-pty\-late\fP، بينما هو متاح باستخدام \fB\-\-pty\fP، لمعظم أنواع الخدمات\&. ومع ذلك، إذا استُخدم هذا الخيار، فسيكون الوصول إلى TTY المستدعي متاحًا لاستعلامات كلمة المرور (انظر \fB\-\-no\-ask\-password\fP أدناه) أثناء بدء تشغيل الوحدة\&. .sp أُضيف في الإصدار 258\&. .RE .PP \fB\-\-pipe\fP، \fB\-P\fP .RS 4 إذا حُدد، تُورث المدخلات والمخرجات والأخطاء القياسية للخدمة المؤقتة من أمر \fBsystemd\-run\fP نفسه\&. يسمح هذا باستخدام \fBsystemd\-run\fP داخل خطوط أنابيب الصدفة\&. .sp لاحظ أن هذا الوضع غير مناسب لصدفات الأوامر التفاعلية وما شابه، لأن عملية الخدمة لن تصبح متحكم TTY عند استدعائها على طرفية\&. استخدم \fB\-\-pty\fP بدلاً من ذلك في هذه الحالة\&. .sp عند استخدام كل من \fB\-\-pipe\fP و \fB\-\-pty\fP معًا، يُحدد الخيار الأكثر ملاءمة آليًا ويُستخدم\&. تحديدًا، عند الاستدعاء مع الإدخال والإخراج والخطأ القياسي المتصل بـ TTY، يُستخدم \fB\-\-pty\fP، وإلا يُستخدم \fB\-\-pipe\fP\&. .sp سيؤدي هذا الخيار إلى انتظار \fBsystemd\-run\fP بشكل متزامن لإنهاء الخدمة المؤقتة، على غرار تحديد \fB\-\-wait\fP\&. .sp عند استخدام هذا الخيار، تُمرر واصفات الملفات الأصلية التي يستقبلها \fBsystemd\-run\fP إلى عمليات الخدمة كما هي\&. إذا كانت الخدمة تعمل بصلاحيات مختلفة عن \fBsystemd\-run\fP، فهذا يعني أن الخدمة قد لا تتمكن من إعادة فتح واصفات الملفات الممررة، بسبب قيود الوصول العادية لواصفات الملفات\&. إذا كانت العملية المستدعاة هي سكربت شل يستخدم بناء \fBecho "hello" >/dev/stderr\fP لكتابة الرسائل إلى stderr، فقد يسبب هذا مشاكل، لأن هذا يعمل فقط إذا أمكن إعادة فتح stderr\&. للتخفيف من ذلك، استخدم البناء \fBecho "hello" >&2\fP بدلاً من ذلك، وهو مكافئ إلى حد كبير ويتجنب هذا المأزق\&. .sp أُضيف في الإصدارة 235\&. .RE .PP \fB\-\-shell\fP, \fB\-S\fP .RS 4 اختصار لـ "\-\-pty \-\-same\-dir \-\-wait \-\-collect \-\-service\-type=exec $SHELL"، أي طلب شل تفاعلي في دليل العمل الحالي، يعمل في سياق الخدمة، يمكن الوصول إليه بمفتاح واحد\&. .sp أُضيف في الإصدار 240\&. .RE .PP \fB\-\-quiet\fP،‏ \fB\-q\fP .RS 4 يكبت المخرجات المعلوماتية الإضافية أثناء التشغيل\&. هذا مفيد بشكل خاص مع \fB\-\-pty\fP حيث سيكبت الرسالة الأولية التي تشرح كيفية إنهاء اتصال TTY\&. .sp أُضيف في الإصدارة 219\&. .RE .PP \fB\-v\fP، \fB\-\-verbose\fP .RS 4 عرض مخرجات سجل الوحدة أثناء التشغيل\&. .sp أُضيف في الإصدار 258\&. .RE .PP \fB\-\-on\-active=\fP, \fB\-\-on\-boot=\fP, \fB\-\-on\-startup=\fP, \fB\-\-on\-unit\-active=\fP, \fB\-\-on\-unit\-inactive=\fP .RS 4 يُعرف مؤقتًا رتيبًا بالنسبة لنقاط بدء مختلفة لبدء الأمر المحدد\&. انظر \fIOnActiveSec=\fP, \fIOnBootSec=\fP, \fIOnStartupSec=\fP, \fIOnUnitActiveSec=\fP و \fIOnUnitInactiveSec=\fP في \fBsystemd.timer\fP(5) للتفاصيل\&. هذه الخيارات هي اختصارات لـ \fB\-\-timer\-property=\fP مع الخصائص ذات الصلة\&. لا يجوز دمج هذه الخيارات مع \fB\-\-scope\fP أو \fB\-\-pty\fP\&. .sp أُضيف في الإصدارة 218\&. .RE .PP \fB\-\-on\-calendar=\fP .RS 4 يُعرف مؤقتًا تقويميًا لبدء الأمر المحدد\&. انظر \fIOnCalendar=\fP في \fBsystemd.timer\fP(5)\&. هذا الخيار هو اختصار لـ \fB\-\-timer\-property=OnCalendar=\fP\&. لا يجوز دمج هذا الخيار مع \fB\-\-scope\fP أو \fB\-\-pty\fP\&. .sp أُضيف في الإصدارة 218\&. .RE .PP \fB\-\-on\-clock\-change\fP, \fB\-\-on\-timezone\-change\fP .RS 4 يُعرف مشغلًا بناءً على قفزات ساعة النظام أو تغييرات المنطقة الزمنية لبدء الأمر المحدد\&. انظر \fIOnClockChange=\fP و \fIOnTimezoneChange=\fP في \fBsystemd.timer\fP(5)\&. هذه الخيارات هي اختصارات لـ \fB\-\-timer\-property=OnClockChange=yes\fP و \fB\-\-timer\-property=OnTimezoneChange=yes\fP\&. لا يجوز دمج هذه الخيارات مع \fB\-\-scope\fP أو \fB\-\-pty\fP\&. .sp أُضيف في الإصدارة 242\&. .RE .PP \fB\-\-path\-property=\fP, \fB\-\-socket\-property=\fP, \fB\-\-timer\-property=\fP .RS 4 يضبط خاصية على وحدة المسار أو المقبس أو المؤقت التي تُنشأ\&. هذا الخيار مشابه لـ \fB\-\-property=\fP، لكنه يُطبق على وحدة المسار أو المقبس أو المؤقت المؤقتة بدلاً من وحدة الخدمة المؤقتة المنشأة\&. يأخذ هذا الخيار إسنادًا بنفس تنسيق أمر \fBset\-property\fP في \fBsystemctl\fP(1)\&. لا يجوز دمج هذه الخيارات مع \fB\-\-scope\fP أو \fB\-\-pty\fP\&. .sp أُضيف في الإصدارة 218\&. .RE .PP \fB\-\-no\-block\fP .RS 4 لا تنتظر بشكل متزامن اكتمال عملية بدء الوحدة\&. إذا لم يُحدد هذا الخيار، فسيُتحقق من طلب بدء الوحدة المؤقتة ووضعه في قائمة الانتظار وسينتظر \fBsystemd\-run\fP حتى يكتمل بدء تشغيل الوحدة\&. بتمرير هذه الوسيطة، يُتحقق منها ووضعها في قائمة الانتظار فقط\&. لا يجوز دمج هذا الخيار مع \fB\-\-wait\fP\&. .sp أُضيف في الإصدارة 220\&. .RE .PP \fB\-\-wait\fP .RS 4 انتظر بشكل متزامن إنهاء الخدمة المؤقتة\&. إذا حُدد هذا الخيار، يُتحقق من طلب بدء الوحدة المؤقتة ووضعه في قائمة الانتظار والانتظار له\&. بعد ذلك، تُراقب الوحدة المستدعاة، ويُنتظر حتى تُعطل مرة أخرى (على الأرجح لأن الأمر المحدد اكتمل)\&. عند الخروج، تُعرض معلومات موجزة عن وقت تشغيل الوحدة، بما في ذلك إجمالي وقت التشغيل (بالإضافة إلى بيانات محاسبة وحدة المعالجة المركزية والذاكرة والإدخال/الإخراج وعنوان IP، إذا كانت إعدادات محاسبة cgroup المقابلة مفعلة) ورمز الخروج وحالة العملية الرئيسية\&. يمكن كبت هذا المخرج باستخدام \fB\-\-quiet\fP\&. لا يجوز دمج هذا الخيار مع \fB\-\-no\-block\fP أو \fB\-\-scope\fP أو خيارات المسار أو المقبس أو المؤقت المختلفة\&. .sp أُضيف في الإصدار 232\&. .RE .PP \fB\-G\fP، \fB\-\-collect\fP .RS 4 أفرغ الوحدة المؤقتة بعد اكتمالها، حتى لو فشلت\&. عادةً، بدون هذا الخيار، تُحفظ جميع الوحدات التي شغلت وفشلت في الذاكرة حتى يعيد المستخدم تعيين حالة الفشل الخاصة بها صراحةً باستخدام \fBsystemctl reset\-failed\fP أو أمر مكافئ\&. من ناحية أخرى، تُفرغ الوحدات التي شغلت بنجاح فورًا\&. إذا شُغل هذا الخيار، يصبح "جمع القمامة" للوحدات أكثر عدوانية، ويفرغ الوحدات بغض النظر عما إذا كانت قد خرجت بنجاح أو فشلت\&. هذا الخيار هو اختصار لـ \fB\-\-property=CollectMode=inactive\-or\-failed\fP، انظر شرح \fICollectMode=\fP في \fBsystemd.unit\fP(5) لمزيد من المعلومات\&. .sp أُضيف في الإصدارة 236\&. .RE .PP \fB\-\-job\-mode=\fP\fIMODE\fP .RS 4 عند وضع وظيفة جديدة في قائمة الانتظار، يتحكم هذا الخيار في كيفية التعامل مع الوظائف الموجودة بالفعل في قائمة الانتظار\&. .sp يأخذ الخيار نفس قيم الوضع مثل خيار \fB\-\-job\-mode=\fP في \fBsystemctl\fP(1)\&. وضع الوظيفة المبدئي هو "fail"\&. .sp تشغيل \fB\-\-job\-mode=help\fP يعرض قائمة بأوضاع الوظائف المتاحة\&. .sp أُضيف في الإصدار 258\&. .RE .PP \fB\-\-ignore\-failure\fP .RS 4 مبدئيًا، إذا فشل الأمر المحدد، فستُوضع علامة فشل على الوحدة المستدعاة (على الرغم من احتمال إفراغها، انظر \fB\-\-collect=\fP أعلاه)، ويُبلغ عن ذلك في السجلات\&. إذا حُدد هذا المفتاح، يُكبت ذلك ويُعالج أي حالة/رمز خروج غير ناجح للأمر على أنه نجاح\&. .sp أُضيف في الإصدار 256\&. .RE .PP \fB\-\-background=\fP\fICOLOR\fP .RS 4 غيّر لون خلفية الطرفية إلى لون ANSI المحدد طالما استمرت الجلسة\&. يجب أن يكون اللون المحدد لون خلفية ANSI X3\&.64 SGR، أي سلاسل مثل "40"، "41"، \&...، "47"، "48;2;\&..."، "48;5;\&..."\&. انظر \m[blue]\fBANSI Escape Code (Wikipedia)\fP\m[]\&\s-2\u[1]\d\s+2 للتفاصيل\&. .sp أُضيف في الإصدار 256\&. .RE .PP \fB\-\-user\fP .RS 4 تحدث مع مدير خدمة المستدعِي، بدلاً من مدير خدمة النظام\&. .RE .PP \fB\-\-system\fP .RS 4 تحدث مع مدير خدمة النظام\&. هذا هو المبدئي الضمني\&. .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 نفّذ العملية على حاوية محلية\&. حدد اسم الحاوية للاتصال بها، مسبوقًا اختياريًا باسم مستخدم للاتصال به وحرف "@" كفاصل\&. إذا استُخدمت السلسلة الخاصة "\&.host" بدلاً من اسم الحاوية، فسيُجرى اتصال بالنظام المحلي (وهو أمر مفيد للاتصال بناقل مستخدم معين: "\-\-user \-\-machine=lennart@\&.host")\&. إذا لم تُستخدم صيغة "@"، فسيُتصل كمستخدم جذر (root)\&. إذا استُخدمت صيغة "@"، فيمكن حذف الجانب الأيسر أو الأيمن (ولكن ليس كلاهما) وفي هذه الحالة يُفترض اسم المستخدم المحلي و "\&.host"\&. .RE .PP \fB\-C\fP، \fB\-\-capsule=\fP .RS 4 نفذ العملية على كبسولة\&. حدد اسم الكبسولة للاتصال بها\&. راجع \fBcapsule@.service\fP(5) لمزيد من التفاصيل حول الكبسولات\&. .sp أُضيف في الإصدار 256\&. .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 .PP \fB\-\-json=\fP\fIوضع\fP .RS 4 يظهر المخرجات منسقة بصيغة JSON\&. يتوقع أحد الخيارات: "short" (لأقصر مخرج ممكن دون أي مسافات زائدة أو فواصل أسطر)، أو "pretty" (لنسخة جميلة من المخرج نفسه، مع إزاحة وفواصل أسطر) أو "off" (لإيقاف مخرجات JSON، وهو الخيار المبدئي)\&. .RE .PP \fB\-\-no\-pager\fP .RS 4 لا تقم بتوجيه المخرجات إلى أداة ترقيم الصفحات\&. ينطبق هذا حالياً فقط على \fB\-\-help\fP\&. (لا يبدأ أداة ترقيم الصفحات أثناء التشغيل العادي\&.) .sp أُضيف في الإصدار 258\&. .RE .PP جميع وسائط سطر الأوامر بعد أول وسيطة غير خيار تصبح جزءاً من سطر أوامر العملية المُطلقة\&. .SH "حالة الخروج" .PP عند النجاح، يُرجع 0\&. إذا فشل \fBsystemd\-run\fP في بدء الخدمة، سيُرجع قيمة إرجاع غير صفرية\&. إذا انتظر \fBsystemd\-run\fP إنهاء الخدمة، ستُنشر قيمة الإرجاع من الخدمة\&. سيُرجع 0 عند النجاح، بما في ذلك جميع الحالات التي يعتبرها systemd أن الخدمة قد خرجت بشكل نظيف، انظر مناقشة \fISuccessExitStatus=\fP في \fBsystemd.service\fP(5)\&. .SH أمثلة .PP \fBمثال\ \&1.\ \&تسجيل متغيرات البيئة المقدمة من systemd للخدمات\fP .sp .if n \{\ .RS 4 .\} .nf # systemd\-run env Running as unit: run\-19945\&.service # journalctl \-u run\-19945\&.service Sep 08 07:37:21 bupkis systemd[1]: Starting /usr/bin/env\&.\&.\&. Sep 08 07:37:21 bupkis systemd[1]: Started /usr/bin/env\&. Sep 08 07:37:21 bupkis env[19948]: PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin Sep 08 07:37:21 bupkis env[19948]: LANG=en_US\&.UTF\-8 Sep 08 07:37:21 bupkis env[19948]: BOOT_IMAGE=/vmlinuz\-3\&.11\&.0\-0\&.rc5\&.git6\&.2\&.fc20\&.x86_64 .fi .if n \{\ .RE .\} .PP \fBمثال\ \&2.\ \&تحديد الموارد المتاحة لأمر\fP .sp .if n \{\ .RS 4 .\} .nf # systemd\-run \-p IOWeight=10 updatedb .fi .if n \{\ .RE .\} .PP يستدعي هذا الأمر أداة \fBupdatedb\fP(8)، لكنه يخفض وزن الإدخال/الإخراج للكتلة إلى 10\&. انظر \fBsystemd.resource\-control\fP(5) لمزيد من المعلومات حول الخاصية \fIIOWeight=\fP\&. .PP \fBمثال\ \&3.\ \&تشغيل الأوامر في وقت محدد\fP .PP سيلمس الأمر التالي ملفاً بعد 30 ثانية\&. .sp .if n \{\ .RS 4 .\} .nf # date; systemd\-run \-\-on\-active=30 \-\-timer\-property=AccuracySec=100ms /bin/touch /tmp/foo Mon Dec 8 20:44:24 KST 2014 Running as unit: run\-71\&.timer Will run service as unit: run\-71\&.service # journalctl \-b \-u run\-71\&.timer \-\- Journal begins at Fri 2014\-12\-05 19:09:21 KST, ends at Mon 2014\-12\-08 20:44:54 KST\&. \-\- Dec 08 20:44:38 container systemd[1]: Starting /bin/touch /tmp/foo\&. Dec 08 20:44:38 container systemd[1]: Started /bin/touch /tmp/foo\&. # journalctl \-b \-u run\-71\&.service \-\- Journal begins at Fri 2014\-12\-05 19:09:21 KST, ends at Mon 2014\-12\-08 20:44:54 KST\&. \-\- Dec 08 20:44:48 container systemd[1]: Starting /bin/touch /tmp/foo\&.\&.\&. Dec 08 20:44:48 container systemd[1]: Started /bin/touch /tmp/foo\&. .fi .if n \{\ .RE .\} .PP \fBمثال\ \&4.\ \&السماح بالوصول إلى tty\fP .PP يستدعي الأمر التالي \fBbash\fP(1) كخدمة تمرر مدخلاتها ومخرجاتها وأخطاءها القياسية إلى TTY المُستدعي\&. .sp .if n \{\ .RS 4 .\} .nf # systemd\-run \-t \-\-send\-sighup bash .fi .if n \{\ .RE .\} .PP \fBمثال\ \&5.\ \&بدء screen كخدمة مستخدم\fP .sp .if n \{\ .RS 4 .\} .nf $ systemd\-run \-\-scope \-\-user screen Running scope as unit run\-r14b0047ab6df45bfb45e7786cc839e76\&.scope\&. $ screen \-ls There is a screen on: 492\&.\&.laptop (Detached) 1 Socket in /var/run/screen/S\-fatima\&. .fi .if n \{\ .RE .\} .PP يبدأ هذا عملية \fBscreen\fP كولد لعملية \fBsystemd \-\-user\fP التي بدأتها user@\&.service، في وحدة نطاق\&. تُستخدم وحدة \fBsystemd.scope\fP(5) بدلاً من وحدة \fBsystemd.service\fP(5)، لأن \fBscreen\fP سيخرج عند فصله عن الطرفية، وسيُنهى وحدة الخدمة\&. تشغيل \fBscreen\fP كوحدة مستخدم له ميزة أنه ليس جزءاً من نطاق الجلسة\&. إذا كُون \fIKillUserProcesses=yes\fP في \fBlogind.conf\fP(5)، وهو المبدئي، سيُنهى نطاق الجلسة عندما يسجل المستخدم الخروج من تلك الجلسة\&. .PP يبدأ user@\&.service آلياً عندما يلج المستخدم لأول مرة، ويبقى موجوداً طالما أن جلسة ولوج واحدة على الأقل مفتوحة\&. بعد أن يخرج المستخدم من الجلسة الأخيرة، تُنهى user@\&.service وجميع الخدمات تحتها\&. هذا السلوك هو المبدئي، عندما لا يكون "الاستمرار" ممكناً لذلك المستخدم\&. تمكين الاستمرار يعني أن user@\&.service تُبدأ آلياً أثناء الإقلاع، حتى لو لم يكن المستخدم والجًا، وأن الخدمة لا تُنهى عندما يسجل المستخدم الخروج\&. .PP تمكين الاستمرار يسمح للمستخدم بتشغيل العمليات دون تسجيل الدخول، على سبيل المثال للسماح لـ \fBscreen\fP بالاستمرار بعد أن يسجل المستخدم الخروج، حتى لو أُنهي نطاق الجلسة\&. في التهيئة المبدئية، يمكن للمستخدمين تمكين الاستمرار لأنفسهم: .sp .if n \{\ .RS 4 .\} .nf $ loginctl enable\-linger .fi .if n \{\ .RE .\} .PP \fBمثال\ \&6.\ \&توسيع المتغير بواسطة المدير\fP .sp .if n \{\ .RS 4 .\} .nf $ systemd\-run \-t echo "<${INVOCATION_ID}>" \*(Aq<${INVOCATION_ID}>\*(Aq <> <5d0149bfa2c34b79bccb13074001eb20> .fi .if n \{\ .RE .\} .PP تُوسع الوسيطة الأولى بواسطة الصدفة (علامات اقتباس مزدوجة)، لكن الثانية لا تُوسع بواسطة الصدفة (علامات اقتباس مفردة)\&. يُستدعى \fBecho\fP(1) مع ["/usr/bin/echo", "<>", "<${INVOCATION_ID}>"] كمصفوفة وسائط، ثم يقوم \fBsystemd\fP(1) بتوليد \fI${INVOCATION_ID}\fP واستبداله في سطر الأوامر\&. لا يمكن إجراء هذا الاستبدال على جانب العميل، لأن المعرف الهدف الذي سيُعين للخدمة غير معروف قبل إجراء الاستدعاء\&. .PP \fBمثال\ \&7.\ \&توسيع المتغير وإعادة توجيه المخرجات باستخدام صدفة\fP .PP يمكن تعطيل توسيع المتغيرات بواسطة \fBsystemd\fP(1) باستخدام \fI\-\-expand\-environment=no\fP\&. .PP قد يكون تعطيل توسيع المتغيرات مفيدًا إذا كان الأمر المراد تنفيذه يحتوي على رموز الدولار وكان الهروب منها غير ملائم\&. على سبيل المثال، عند استخدام شِل: .sp .if n \{\ .RS 4 .\} .nf $ systemd\-run \-\-expand\-environment=no \-t bash \e \-c \*(Aqecho $SHELL $$ >/dev/stdout\*(Aq /bin/bash 12345 .fi .if n \{\ .RE .\} .PP يُمرر الوسيط الأخير حرفيًا إلى شِل \fBbash\fP(1) التي تُبدأ بوحدة الخدمة\&. توسع الشِل "$SHELL" إلى مسار الشِل، و"$$" إلى رقم عمليتها، ثم تُمرر هذه السلاسل إلى الأمر المدمج \fBecho\fP وتُطبع إلى المخرج المعياري (الموصل، في هذه الحالة، بالطرفية المستدعية)\&. .PP \fBمثال\ \&8.\ \&قيمة الإرجاع\fP .sp .if n \{\ .RS 4 .\} .nf $ systemd\-run \-\-user \-\-wait true $ systemd\-run \-\-user \-\-wait \-p SuccessExitStatus=11 bash \-c \*(Aqexit 11\*(Aq $ systemd\-run \-\-user \-\-wait \-p SuccessExitStatus=SIGUSR1 \-\-expand\-environment=no \e bash \-c \*(Aqkill \-SIGUSR1 $$\*(Aq .fi .if n \{\ .RE .\} .PP ستنجح هذه الاستدعاءات الثلاثة، أي ستنتهي برمز خروج 0\&. .SH "انظر أيضًا" .PP \fBsystemd\fP(1)، \fBsystemctl\fP(1)، \fBsystemd.unit\fP(5)، \fBsystemd.service\fP(5)، \fBsystemd.scope\fP(5)، \fBsystemd.slice\fP(5)، \fBsystemd.exec\fP(5)، \fBsystemd.resource\-control\fP(5)، \fBsystemd.timer\fP(5)، \fBsystemd\-mount\fP(1)، \fBmachinectl\fP(1)، \fBrun0\fP(1) .SH ملاحظات .IP " 1." 4 رمز هروب ANSI (ويكيبيديا) .RS 4 \%https://en.wikipedia.org/wiki/ANSI_escape_code#SGR_(Select_Graphic_Rendition)_parameters .RE .PP .SH ترجمة تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي . .PP هذه الترجمة هي وثيقة مجانية؛ راجع .UR https://www.gnu.org/licenses/gpl-3.0.html رخصة جنو العامة الإصدار 3 .UE أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات. .PP إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: .MT kde-l10n-ar@kde.org .ME .