.\" -*- coding: UTF-8 -*-
'\" t
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH SYSTEMD\-NOTIFY 1 "" "systemd 260.2" systemd\-notify
.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\-notify \- إعلام مدير الخدمة باكتمال بدء التشغيل وتغييرات حالة الخفي
الأخرى
.SH موجز
.HP \w'\fBsystemd\-notify\fR\ 'u
\fBsystemd\-notify\fP [خيارات...] [متغير=قيمة...]
.HP \w'\fBsystemd\-notify\fR\ 'u
\fBsystemd\-notify\fP \-\-exec [خيارات...] [متغير=قيمة...] ;\ \-\- {سطر أوامر...}
.HP \w'\fBsystemd\-notify\fR\ 'u
\fBsystemd\-notify\fP \-\-fork [خيارات...] \-\- {سطر أوامر...}
.SH الوصف
.PP
قد يُستدعى \fBsystemd\-notify\fP بواسطة نصوص الخدمة لإعلام مدير الخدمة المستدعي
بتغييرات الحالة\&. يمكن استخدامه لإرسال معلومات عشوائية، مشفرة في قائمة
سلاسل تشبه كتلة البيئة\&. الأهم من ذلك، يمكن استخدامه لإعلام اكتمال بدء
التشغيل\&.
.PP
هذا في الغالب مجرد غلاف حول \fBsd_notify()\fP ويجعل هذه الوظيفة متاحة لنصوص
الصدفة\&. للتفاصيل انظر \fBsd_notify\fP(3)\&.
.PP
قد يحمل سطر الأوامر قائمة من متغيرات البيئة لإرسالها كجزء من تحديث الحالة\&.
.PP
لاحظ أن systemd سيرفض استقبال تحديثات الحالة من هذا الأمر ما لم يتم تعيين
\fINotifyAccess=\fP بشكل مناسب لوحدة الخدمة التي يُستدعى منها هذا الأمر\&. انظر
\fBsystemd.service\fP(5) للتفاصيل\&.
.PP
لاحظ أن إشعارات \fBsd_notify()\fP قد تُنسب إلى الوحدات بشكل صحيح فقط إذا كانت
العملية المرسلة لا تزال موجودة في الوقت الذي يعالج فيه مدير الخدمة الرسالة،
أو إذا كانت العملية المرسلة مُتتبعة وقت التشغيل بشكل صريح من قبل مدير
الخدمة\&. الحالة الأخيرة تكون إذا قام مدير الخدمة أصلاً بتفرع العملية، أي
على جميع العمليات التي تطابق \fINotifyAccess=\fP\fBmain\fP أو
\fINotifyAccess=\fP\fBexec\fP\&. بالمقابل، إذا أرسلت عملية مساعدة للوحدة رسالة
\fBsd_notify()\fP وخرجت فوراً، قد لا يتمكن مدير الخدمة من نسب الرسالة إلى
الوحدة بشكل صحيح، وبالتالي سيتجاهلها، حتى لو تم تعيين \fINotifyAccess=\fP\fBall\fP
لها\&. لمعالجة هذا، سينتظر \fBsystemd\-notify\fP حتى تتم معالجة رسالة الإشعار من
قبل مدير الخدمة\&. عند استخدام \fB\-\-no\-block\fP، يتم تعطيل هذا التزامن لاستقبال
الإشعارات، وبالتالي قد يحدث السباق المذكور أعلاه إذا لم تكن العملية
المستدعية هي مدير الخدمة أو مولدة من قبله\&.
.PP
سيحاول \fBsystemd\-notify\fP أولاً استدعاء \fBsd_notify()()\fP متظاهراً بأن لديه
PID العملية الأم لـ \fBsystemd\-notify\fP (أي العملية المستدعية)\&. سينجح هذا
فقط عند الاستدعاء بصلاحيات كافية\&. عند الفشل، سيعود بعد ذلك إلى استدعائها
تحت PID الخاص به\&. هذا السلوك مفيد بحيث عندما يتم استدعاء الأداة من نص
صدفة، تظهر عملية الصدفة \(em وليس عملية \fBsystemd\-notify\fP \(em كمرسل
للرسالة، وهذا بدوره مفيد إذا كانت عملية الصدفة هي العملية الرئيسية لخدمة،
بسبب قيود \fINotifyAccess=\fP\fBall\fP\&. استخدم المفتاح \fB\-\-pid=\fP لضبط هذا
السلوك\&.
.SH الخيارات
.PP
الخيارات التالية مفهومة:
.PP
\fB\-\-ready\fP
.RS 4
أبلغ مدير الخدمة المستدعي باكتمال بدء تشغيل الخدمة أو إعادة تحميل
التهيئة\&. هذا مكافئ لـ \fBsystemd\-notify READY=1\fP\&. للتفاصيل حول دلالات هذا
الخيار انظر \fBsd_notify\fP(3)\&.
.RE
.PP
\fB\-\-reloading\fP
.RS 4
أبلغ مدير الخدمة المستدعي ببدء دورة إعادة تحميل التهيئة\&. هذا مكافئ لـ
\fBsystemd\-notify RELOADING=1\fP (لكنه يحدد أيضًا ضمنياً حقل \fIMONOTONIC_USEC=\fP
كما هو مطلوب لخدمات \fIType=notify\-reload\fP، انظر \fBsystemd.service\fP(5)
للتفاصيل)\&. للتفاصيل حول دلالات هذا الخيار انظر \fBsd_notify\fP(3)\&.
.sp
أُضيف في الإصدار 253\&.
.RE
.PP
\fB\-\-stopping\fP
.RS 4
أبلغ مدير الخدمة المستدعي ببدء مرحلة إيقاف الخدمة\&. هذا مكافئ لـ
\fBsystemd\-notify STOPPING=1\fP\&. للتفاصيل حول دلالات هذا الخيار انظر
\fBsd_notify\fP(3)\&.
.sp
أُضيف في الإصدار 253\&.
.RE
.PP
\fB\-\-pid=\fP
.RS 4
أبلغ مدير الخدمة عن PID الرئيسي للخدمة\&. يأخذ PID كوسيط\&. إذا تم تحديد
الوسيط كـ "auto" أو تم حذفه، يُستخدم PID العملية التي استدعت
\fBsystemd\-notify\fP، إلا إذا كان ذلك هو مدير الخدمة\&. إذا تم تحديد الوسيط كـ
"self"، يُستخدم PID أمر \fBsystemd\-notify\fP نفسه، وإذا تم تحديد "parent"
يُستخدم PID العملية المستدعية \(em حتى لو كان مدير الخدمة\&.  \fB\-\-pid=auto\fP
مكافئ لـ \fBsystemd\-notify \-\-pid=$PID\fP\&. للتفاصيل حول دلالات هذا الخيار انظر
\fBsd_notify\fP(3)\&.
.sp
سيحاول \fBsystemd\-notify\fP أولاً استدعاء \fBsd_notify()()\fP متظاهراً بأن لديه
PID المحدد مع \fB\-\-pid=\fP\&. سينجح هذا فقط عند الاستدعاء بصلاحيات كافية\&. عند
الفشل، سيعود بعد ذلك إلى استدعائها تحت PID الخاص به\&. فعلياً، هذا يعني أن
استدعاءً متميزاً لـ \fBsystemd\-notify \-\-pid=\fP قد يتجاوز قيود
\fINotifyAccess=main\fP أو \fINotifyAccess=exec\fP المفروضة لخدمة\&.
.sp
إذا تم استخدام هذا المفتاح في استدعاء غير متميز لـ \fBsystemd\-notify\fP من
عملية ستصبح العملية الرئيسية الجديدة لخدمة \(em وهي ليست العملية المفرعة من
قبل مدير الخدمة (أو العملية الرئيسية الحالية) \(em، فمن الضروري تعيين
\fINotifyAccess=all\fP في ملف وحدة الخدمة، وإلا سيتم تجاهل الإشعار لأسباب
أمنية\&. انظر \fBsystemd.service\fP(5) للتفاصيل\&.
.RE
.PP
\fB\-\-uid=\fP\fIمستخدم\fP
.RS 4
عيّن معرف المستخدم لإرسال الإشعار منه\&. يأخذ اسم مستخدم UNIX أو UID
رقمي\&. عند التحديد، سيتم إرسال رسالة الإشعار مع UID المحدد كمرسل، بدلاً من
المستخدم الذي تم استدعاء الأمر باسمه\&. يتطلب هذا الخيار صلاحيات كافية
لتتمكن من معالجة هوية المستخدم للعملية\&.
.sp
أُضيف في الإصدارة 237\&.
.RE
.PP
\fB\-\-status=\fP
.RS 4
أرسل سلسلة حالة قابلة للقراءة البشرية حرة الشكل للخفي إلى مدير
الخدمة\&. يأخذ هذا الخيار سلسلة الحالة كوسيط\&. هذا مكافئ لـ
\fBsystemd\-notify STATUS=\&...\fP\&. للتفاصيل حول دلالات هذا الخيار انظر
\fBsd_notify\fP(3)\&. تُعرض هذه المعلومات في مخرج \fBstatus\fP لأمر
\fBsystemctl\fP(1)، من بين أماكن أخرى\&.
.RE
.PP
\fB\-\-booted\fP
.RS 4
يُرجع 0 إذا تم إقلاع النظام مع systemd، غير صفرية بخلاف ذلك\&. إذا تم تمرير
هذا الخيار، لا يتم إرسال أي رسالة\&. هذا الخيار بالتالي غير مرتبط بالخيارات
الأخرى\&. للتفاصيل حول دلالات هذا الخيار، انظر \fBsd_booted\fP(3)\&. طريقة
بديلة للتحقق من هذه الحالة هي استدعاء \fBsystemctl\fP(1) مع الأمر
\fBis\-system\-running\fP\&. سيخرج "offline" إذا لم يتم إقلاع النظام مع systemd،
على الرغم من أن قيمة الإرجاع لها معنى مختلف\&.
.RE
.PP
\fB\-\-no\-block\fP
.RS 4
لا تنتظر بشكل متزامن انتهاء العملية المطلوبة\&. يُوصى باستخدام هذا الخيار
فقط عندما يكون \fBsystemd\-notify\fP مولّداً من قبل مدير الخدمة، أو عندما تكون
العملية المستدعية مولّدة مباشرة من قبل مدير الخدمة ولديها صلاحيات كافية
للسماح لـ \fBsystemd\-notify\fP بإرسال الإشعار نيابة عنها\&. إرسال الإشعارات مع
تعيين هذا الخيار عرضة لظروف السباق في جميع الحالات الأخرى\&.
.sp
أُضيف في الإصدار 246\&.
.RE
.PP
\fB\-\-exec\fP
.RS 4
إذا تم تحديده، سينفذ \fBsystemd\-notify\fP سطر أوامر آخر بعد إكمال عمليته،
مستبدلاً عمليته الخاصة\&. إذا تم استخدامه، يجب أن تتبع قائمة التعيينات
المراد تضمينها في الرسالة المرسلة بحرف ";" (كوسيط منفصل)، متبوعاً بسطر
الأوامر المراد تنفيذه\&. هذا يسمح بـ "تسلسل
.sp
يرجى ملاحظة أن العديد من برامج الصدفة تفسر ”؛“ على أنه الفاصل الخاص بها في
سطور الأوامر؛ ولذلك، عند استدعاء \fBsystemd\-notify\fP من برنامج صدفة، يجب عادةً
تغيير رمز الفاصلة المنقوطة إلى ”\e;“\&.
.sp
أُضيف في الإصدار 254\&.
.RE
.PP
\fB\-\-fd=\fP
.RS 4
إرسال واصف ملف مع رسالة الإشعار\&. وهذا مفيد عند الاستدعاء في الخدمات التي
تم تمكين الإعداد \fIFileDescriptorStoreMax=\fP فيها، انظر \fBsystemd.service\fP(5)
للحصول على التفاصيل\&. يجب تمرير واصف الملف المحدد إلى \fBsystemd\-notify\fP عند
الاستدعاء\&. يمكن استخدام هذا الخيار عدة مرات لتمرير عدة واصفات ملفات في
رسالة إعلام واحدة\&.
.sp
لاستخدام هذه الوظيفة من محطة عمل \fBbash\fP(1)، استخدم تعبيرًا مثل التالي:
.sp
.if  n \{\
.RS 4
.\}
.nf
systemd\-notify \-\-fd=4 \-\-fd=5 4</some/file 5</some/other/file
.fi
.if  n \{\
.RE
.\}
.sp
أُضيف في الإصدار 254\&.
.RE
.PP
\fB\-\-fdname=\fP
.RS 4
يضبط اسماً لتعيينه لموصّفات الملفات الممررة عبر \fB\-\-fd=\fP (انظر
أعلاه)\&. يتحكم هذا في حقل "FDNAME="\&. لا يُحدد هذا الإعداد إلا مرة واحدة،
وينطبق على جميع موصّفات الملفات الممررة\&. استدعِ هذه الأداة عدة مرات في حال
وجب إرسال موصّفات ملفات متعددة بأسماء موصّفات ملفات مختلفة\&.
.sp
أُضيف في الإصدار 254\&.
.RE
.PP
\fB\-\-fork\fP
.RS 4
بدلاً من إرسال رسالة إشعار، يتفرع عن سطر أوامر وينتظر حتى استلام رسالة
"READY=1" منه\&. بعبارة أخرى: يجعل هذا \fBsystemd\-notify\fP مستقبلاً لرسائل
الإشعار بدلاً من المرسل، مبادلاً الأدوار\&. هذا مفيد للتفرع السريع عن عملية
تنفذ بروتوكول \fBsd_notify()\fP من سكريبت شل\&. سيكون لسطر الأوامر المستدعى
إدخال قياسي وإخراج قياسي متصلين بـ /dev/null، لكن الخطأ القياسي سيورث من
العملية المستدعية\&. يُكتب معرف العملية الرقمي إلى الإخراج القياسي بواسطة
\fBsystemd\-notify\fP (ما لم يُحدد \fB\-\-quiet\fP)، والذي قد يُستخدم لإنهاء العملية
المتفرعة عنها لاحقًا\&.
.sp
لاحظ أن العمليات المتفرعة عنها هكذا ستبقى على الأرجح قيد التشغيل بعد أن عاد
\fBsystemd\-notify\fP بالفعل، مما سيؤدي بالتالي إلى إعادة تبعيتها لأقرب عملية
حصادة عمليات، أي عادةً مدير الخدمات لكل مستخدم أو النظام\&.
.sp
لاحظ أن هذا الخيار لا ينبغي استخدامه لاستدعاء خدمات كاملة بشكل مؤقت، استخدم
\fBsystemd\-run\fP لذلك\&.
.sp
لاحظ أيضًا أنه عند استدعائه بهذا المفتاح، سيخرج \fBsystemd\-notify\fP بنجاح في
حالتين مميزتين:
.sp
.RS 4
.ie  n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
استلم \fBsystemd\-notify\fP إشعار "READY=1" من العملية الابنة التي تفرع عنها
للتو\&.
.RE
.sp
.RS 4
.ie  n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
خرجت العملية الابنة بشكل نظيف (بحالة خروج صفرية) قبل إرسال "READY=1"\&.
.RE
.sp
مثال استخدام:
.sp
.if  n \{\
.RS 4
.\}
.nf
# PID=$(systemd\-notify \-\-fork \-\- mycommand)
\&...
kill "$PID"
unset PID
.fi
.if  n \{\
.RE
.\}
.sp
أُضيف في الإصدار 258\&.
.RE
.PP
\fB\-\-quiet\fP،‏ \fB\-q\fP
.RS 4
يُطفئ إخراج معرف العملية الرقمي عند استخدام \fB\-\-fork\fP\&.
.sp
أُضيف في الإصدار 258\&.
.RE
.PP
\fB\-h\fP، \fB\-\-help\fP
.RS 4
اطبع نص مساعدة قصير واخرج\&.
.RE
.PP
\fB\-\-version\fP
.RS 4
اطبع سلسلة إصدار قصيرة واخرج\&.
.RE
.SH "حالة الخروج"
.PP
عند النجاح، يُعاد الرقم 0، وإلا فيُعاد رمز فشل غير صفري\&.
.SH مثال
.PP
\fBمثال\ \&1.\ \&إشعار بدء التشغيل وتحديثات الحالة\fP
.PP
خفي شل بسيط يرسل إشعارات بدء التشغيل بعد إعداد قناة الاتصال الخاصة
به\&. أثناء وقت التشغيل يرسل تحديثات حالة إضافية إلى نظام التهيئة:
.sp
.if  n \{\
.RS 4
.\}
.nf
#!/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
.fi
.if  n \{\
.RE
.\}
.SH "انظر أيضًا"
.PP
\fBsystemd\fP(1), \fBsystemctl\fP(1), \fBsystemd.unit\fP(5), \fBsystemd.service\fP(5),
\fBsd_notify\fP(3), \fBsd_booted\fP(3)
.PP
.SH ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة
زايد السعيدي <zayed.alsaidi@gmail.com>
.
.PP
هذه الترجمة هي وثيقة مجانية؛ راجع
.UR https://www.gnu.org/licenses/gpl-3.0.html 
رخصة جنو العامة الإصدار 3
.UE
أو ما بعده للاطلاع على شروط حقوق النشر.
لا توجد أي ضمانات.
.PP
إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه،
يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين:
.MT kde-l10n-ar@kde.org
.ME .