نام (NAME)

systemd-notify - اطلاع‌رسانی به مدیر سرویس درباره تکمیل راه‌اندازی و سایر تغییرات وضعیت دیمن

خلاصه دستور (SYNOPSIS)

systemd-notify [OPTIONS...] [VARIABLE=VALUE...]

systemd-notify --exec [OPTIONS...] [VARIABLE=VALUE...] ; -- {CMDLINE...}

systemd-notify --fork [OPTIONS...] -- {CMDLINE...}

توضیحات (DESCRIPTION)

systemd-notify می‌تواند توسط اسکریپت‌های سرویس فراخوانی شود تا تغییرات وضعیت را به مدیر سرویس فراخواننده اطلاع دهد. این ابزار می‌تواند برای ارسال اطلاعات دلخواه، کدگذاری‌شده در قالبی شبیه به فهرست رشته‌های بلوک متغیرهای محیطی، استفاده شود. مهم‌تر از همه، می‌توان از آن برای اعلان تکمیل راه‌اندازی استفاده کرد.

این ابزار در واقع عمدتاً یک پوسته (wrapper) پیرامون sd_notify() است و این قابلیت را در دسترس اسکریپت‌های پوسته قرار می‌دهد. برای جزئیات sd_notify(3) را ببینید.

خط فرمان ممکن است حاوی فهرستی از متغیرهای محیطی باشد تا به عنوان بخشی از به‌روزرسانی وضعیت ارسال شوند.

توجه داشته باشید که سیستم‌دی از پذیرش به‌روزرسانی‌های وضعیت از این دستور خودداری خواهد کرد مگر اینکه NotifyAccess= به‌طور مناسب برای واحد سرویسی که این دستور از آن فراخوانی می‌شود تنظیم شده باشد. برای جزئیات systemd.service(5) را ببینید.

توجه داشته باشید که اعلان‌های sd_notify() تنها در صورتی می‌توانند به درستی به واحدها منتسب شوند که فرآیند ارسال‌کننده در زمان پردازش پیام توسط مدیر سرویس هنوز فعال باشد، یا اینکه فرآیند ارسال‌کننده صراحتاً در زمان اجرا توسط مدیر سرویس ردیابی شود. حالت دوم زمانی رخ می‌دهد که مدیر سرویس در ابتدا فرآیند را منشعب (fork) کرده باشد، یعنی در تمام فرآیندهایی که با NotifyAccess=main یا NotifyAccess=exec مطابقت دارند. برعکس، اگر یک فرآیند کمکیِ واحد پیامی از طریق sd_notify() ارسال کند و بلافاصله خارج شود، مدیر سرویس ممکن است نتواند پیام را به درستی به آن واحد منتسب کند و بنابراین آن را نادیده خواهد گرفت، حتی اگر NotifyAccess=all برای آن تنظیم شده باشد. برای رفع این مشکل، systemd-notify تا زمانی که پیام اعلان توسط مدیر سرویس پردازش شود منتظر خواهد ماند. هنگامی که --no-block استفاده شود، این همگام‌سازی برای دریافت اعلان‌ها غیرفعال می‌گردد و از این رو ممکن است شرایط رقابتی (race condition) یادشده رخ دهد، در صورتی که فرآیند فراخواننده، خودِ مدیر سرویس نبوده یا توسط مدیر سرویس ایجاد نشده باشد.

systemd-notify ابتدا تلاش خواهد کرد تا با وانمود کردن به داشتن PID فرآیند والدِ systemd-notify (یعنی فرآیند فراخواننده)، sd_notify() را فراخوانی کند. این کار تنها زمانی موفقیت‌آمیز خواهد بود که با دسترسی‌ها و اختیارات کافی فراخوانی شده باشد. در صورت عدم موفقیت، سپس به فراخوانی آن با PID خود بازمی‌گردد. این رفتار از این جهت مفید است که وقتی این ابزار از یک اسکریپت پوسته فراخوانی می‌شود، فرآیند پوسته — و نه فرآیند systemd-notify — به عنوان فرستنده پیام ظاهر می‌شود؛ که این به نوبه خود، به دلیل محدودیت‌های NotifyAccess=all، در صورتی که فرآیند پوسته فرآیند اصلی یک سرویس باشد، مفید خواهد بود. از سوییچ --pid= برای دستکاری این رفتار استفاده کنید.

گزینه‌ها (OPTIONS)

گزینه‌های زیر پشتیبانی می‌شوند:

--ready

--reloading

--stopping

--pid=

--uid=USER

--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

کدهای خروج (EXIT STATUS)

در صورت موفقیت، 0 برگردانده می‌شود؛ در غیر این صورت یک کد خطای غیر صفر برگردانده خواهد شد.

مثال‌ها (EXAMPLES)

مثال 1. اعلان راه‌اندازی و به‌روزرسانی‌های وضعیت

یک دیمن ساده پوسته که پس از آماده‌سازی کانال ارتباطی خود، اعلان‌های راه‌اندازی را ارسال می‌کند. در طول زمان اجرا به‌روزرسانی‌های وضعیت بیشتری را به سیستم init ارسال می‌کند:

#!/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

همچنین ببینید (SEE ALSO)

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