الاسم¶

systemd-notify - إعلام مدير الخدمة باكتمال بدء التشغيل وتغييرات حالة الخفي الأخرى

موجز¶

systemd-notify [خيارات...] [متغير=قيمة...]

systemd-notify --exec [خيارات...] [متغير=قيمة...] ; -- {سطر أوامر...}

systemd-notify --fork [خيارات...] -- {سطر أوامر...}

الوصف¶

قد يُستدعى systemd-notify بواسطة نصوص الخدمة لإعلام مدير الخدمة المستدعي بتغييرات الحالة. يمكن استخدامه لإرسال معلومات عشوائية، مشفرة في قائمة سلاسل تشبه كتلة البيئة. الأهم من ذلك، يمكن استخدامه لإعلام اكتمال بدء التشغيل.

هذا في الغالب مجرد غلاف حول sd_notify() ويجعل هذه الوظيفة متاحة لنصوص الصدفة. للتفاصيل انظر sd_notify(3).

قد يحمل سطر الأوامر قائمة من متغيرات البيئة لإرسالها كجزء من تحديث الحالة.

لاحظ أن systemd سيرفض استقبال تحديثات الحالة من هذا الأمر ما لم يتم تعيين NotifyAccess= بشكل مناسب لوحدة الخدمة التي يُستدعى منها هذا الأمر. انظر systemd.service(5) للتفاصيل.

لاحظ أن إشعارات sd_notify() قد تُنسب إلى الوحدات بشكل صحيح فقط إذا كانت العملية المرسلة لا تزال موجودة في الوقت الذي يعالج فيه مدير الخدمة الرسالة، أو إذا كانت العملية المرسلة مُتتبعة وقت التشغيل بشكل صريح من قبل مدير الخدمة. الحالة الأخيرة تكون إذا قام مدير الخدمة أصلاً بتفرع العملية، أي على جميع العمليات التي تطابق NotifyAccess=main أو NotifyAccess=exec. بالمقابل، إذا أرسلت عملية مساعدة للوحدة رسالة sd_notify() وخرجت فوراً، قد لا يتمكن مدير الخدمة من نسب الرسالة إلى الوحدة بشكل صحيح، وبالتالي سيتجاهلها، حتى لو تم تعيين NotifyAccess=all لها. لمعالجة هذا، سينتظر systemd-notify حتى تتم معالجة رسالة الإشعار من قبل مدير الخدمة. عند استخدام --no-block، يتم تعطيل هذا التزامن لاستقبال الإشعارات، وبالتالي قد يحدث السباق المذكور أعلاه إذا لم تكن العملية المستدعية هي مدير الخدمة أو مولدة من قبله.

سيحاول systemd-notify أولاً استدعاء sd_notify()() متظاهراً بأن لديه PID العملية الأم لـ systemd-notify (أي العملية المستدعية). سينجح هذا فقط عند الاستدعاء بصلاحيات كافية. عند الفشل، سيعود بعد ذلك إلى استدعائها تحت PID الخاص به. هذا السلوك مفيد بحيث عندما يتم استدعاء الأداة من نص صدفة، تظهر عملية الصدفة — وليس عملية systemd-notify — كمرسل للرسالة، وهذا بدوره مفيد إذا كانت عملية الصدفة هي العملية الرئيسية لخدمة، بسبب قيود NotifyAccess=all. استخدم المفتاح --pid= لضبط هذا السلوك.

الخيارات¶

الخيارات التالية مفهومة:

--ready

--reloading

--stopping

--pid=

--uid=مستخدم

--status=

--booted

--no-block

--exec

--fd=

systemd-notify --fd=4 --fd=5 4</some/file 5</some/other/file

--fdname=

--fork

# PID=$(systemd-notify --fork -- mycommand)
...
kill "$PID"
unset PID

--quiet،‏ -q

-h، --help

--version

حالة الخروج¶

عند النجاح، يُعاد الرقم 0، وإلا فيُعاد رمز فشل غير صفري.

مثال¶

مثال 1. إشعار بدء التشغيل وتحديثات الحالة

خفي شل بسيط يرسل إشعارات بدء التشغيل بعد إعداد قناة الاتصال الخاصة به. أثناء وقت التشغيل يرسل تحديثات حالة إضافية إلى نظام التهيئة:

#!/bin/sh
mkfifo /tmp/waldo
systemd-notify --ready --status="Waiting for data..."
while : ; do


        read -r a < /tmp/waldo


        systemd-notify --status="Processing $a"


        # Do something with $a ...


        systemd-notify --status="Waiting for data..."
done

انظر أيضًا¶

systemd(1), systemctl(1), systemd.unit(5), systemd.service(5), sd_notify(3), sd_booted(3)

ترجمة¶

تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.