نام (NAME)

mosquitto_signal - ابزاری برای ارسال سیگنال‌ها به کارگزارهای Mosquitto در حال اجرا روی رایانهٔ محلی.

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

mosquitto_signal {-a | -p pid} signal

mosquitto_signal --help

توضیحات (DESCRIPTION)

mosquitto_signal ابزاری است که می‌تواند سیگنال‌های نام‌گذاری‌شده را به یک یا تمام نمونه‌های کارگزار Mosquitto در حال اجرا روی رایانهٔ محلی ارسال کند.

در سامانه‌های شبه-POSIX، این ابزار جایگزینی مناسب برای دستور kill(1) است، با این مزیت افزوده که امکان استفاده از سیگنال‌های نام‌گذاری‌شده را به جای سیگنال‌های عمومی سیستم مانند SIGUSR1 فراهم می‌کند، و همچنین قابلیت ارسال هم‌زمان سیگنال به چندین کارگزار را داراست.

در Windows، این ابزار تنها راه ارسال سیگنال به یک کارگزار است.

گزینه‌ها (OPTIONS)

-a

ارسال سیگنال داده‌شده به تمام فرایندهایی که منطبق با نام mosquitto هستند. همانند هر ارسال سیگنال دیگری، تنها فرایندهایی که دسترسی لازم برای ارسال سیگنال به آن‌ها را دارید، سیگنال را دریافت خواهند کرد.

-p pid

ارسال سیگنال به یک شناسهٔ فرایند (PID) مشخص. ابزار mosquitto_signal همواره تلاش خواهد کرد سیگنال متناظر را به فرایند داده‌شده ارسال کند و بررسی نخواهد کرد که آیا آن فرایند یک فرایند mosquitto به نظر می‌رسد یا خیر.

سیگنال‌ها (SIGNALS)

سیگنال‌های نام‌گذاری‌شدهٔ زیر برای استفاده در دسترس هستند.

config-reload

واداشتن کارگزار به بارگذاری مجدد فایل پیکربندی خود، در صورت استفاده.

در سامانه‌های شبه-POSIX این عمل را می‌توان با استفاده از سیگنال SIGHUP نیز تحریک کرد. توجه داشته باشید که SIGHUP توسط سیگنال‌های نام‌گذاری‌شدهٔ دیگری نیز استفاده می‌شود.

log-rotate

اگر کارگزار از log_dest file استفاده می‌کند، این سیگنال کارگزار را وادار به بستن و بازگشایی مجدد فایل گزارش (log) خواهد کرد.

در سامانه‌های شبه-POSIX این عمل را می‌توان با استفاده از سیگنال SIGHUP نیز تحریک کرد. توجه داشته باشید که SIGHUP توسط سیگنال‌های نام‌گذاری‌شدهٔ دیگری نیز استفاده می‌شود.

shutdown

واداشتن کارگزار به بستن و خروج.

در سامانه‌های شبه-POSIX این عمل را می‌توان با استفاده از سیگنال SIGINT نیز تحریک کرد.

tree-print

واداشتن کارگزار به چاپ نمایشی از درخت‌های اشتراک (subscription) و نگه‌داری (retain) در stdout. این قابلیت صرفاً برای اهداف اشکال‌زدایی در نظر گرفته شده است.

در سامانه‌های شبه-POSIX این عمل را می‌توان با استفاده از سیگنال SIGUSR2 نیز تحریک کرد. توجه داشته باشید که SIGUSR2 توسط سیگنال‌های نام‌گذاری‌شدهٔ دیگری نیز استفاده می‌شود.

xtreport

واداشتن کارگزار به نوشتن برخی اطلاعات وضعیت داخلی در /tmp/xtmosquitto.kcg.<pid>.<iteration> در سامانه‌های POSIX یا xtmosquitto.kcg.<pid>.<iteration> در سامانه‌های Windows. این قابلیت صرفاً برای اهداف اشکال‌زدایی در نظر گرفته شده است.

این سیگنال تنها زمانی توسط کارگزار استفاده می‌شود که پشتیبانی مربوطه در آن کامپایل شده باشد، که به صورت پیش‌فرض چنین نیست.

در سامانه‌های شبه-POSIX این عمل را می‌توان با استفاده از سیگنال SIGRTMIN نیز تحریک کرد.

گزارش باگ‌ها (BUGS)

اطلاعات مربوط به باگ‌های mosquitto را می‌توان در نشانی زیر یافت: https://github.com/eclipse-mosquitto/mosquitto/issues

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

mosquitto(7), mosquitto(8)

نویسندگان (AUTHORS)

Roger Light <roger@atchoo.org>