'\" t
.\"     Title: mosquitto_signal
.\"    Author: [see the "Author" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 04/03/2026
.\"    Manual: Commands
.\"    Source: Mosquitto Project
.\"  Language: English
.\"
.TH "MOSQUITTO_SIGNAL" "1" "04/03/2026" "Mosquitto Project" "Commands"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
mosquitto_signal \- ابزاری برای ارسال سیگنال‌ها به کارگزارهای Mosquitto در حال اجرا روی رایانهٔ محلی\&.
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBmosquitto_signal\fR\ 'u
\fBmosquitto_signal\fR {\fB\-a\fR | \fB\-p\fR\ \fIpid\fR} \fIsignal\fR
.HP \w'\fBmosquitto_signal\fR\ 'u
\fBmosquitto_signal\fR \fB\-\-help\fR
.SH "توضیحات (DESCRIPTION)"
.PP
\fBmosquitto_signal\fR
ابزاری است که می‌تواند سیگنال‌های نام‌گذاری‌شده را به یک یا تمام نمونه‌های کارگزار Mosquitto در حال اجرا روی رایانهٔ محلی ارسال کند\&.
.PP
در سامانه‌های شبه\-POSIX، این ابزار جایگزینی مناسب برای دستور
\fBkill\fR(1)
است، با این مزیت افزوده که امکان استفاده از سیگنال‌های نام‌گذاری‌شده را به جای سیگنال‌های عمومی سیستم مانند SIGUSR1 فراهم می‌کند، و همچنین قابلیت ارسال هم‌زمان سیگنال به چندین کارگزار را داراست\&.
.PP
در Windows، این ابزار تنها راه ارسال سیگنال به یک کارگزار است\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-a\fR
.RS 4
ارسال سیگنال داده‌شده به تمام فرایندهایی که منطبق با نام
\fBmosquitto\fR
هستند\&. همانند هر ارسال سیگنال دیگری، تنها فرایندهایی که دسترسی لازم برای ارسال سیگنال به آن‌ها را دارید، سیگنال را دریافت خواهند کرد\&.
.RE
.PP
\fB\-p\fR \fIpid\fR
.RS 4
ارسال سیگنال به یک شناسهٔ فرایند (PID) مشخص\&.
ابزار
\fBmosquitto_signal\fR
همواره تلاش خواهد کرد سیگنال متناظر را به فرایند داده‌شده ارسال کند و بررسی نخواهد کرد که آیا آن فرایند یک فرایند mosquitto به نظر می‌رسد یا خیر\&.
.RE
.SH "سیگنال‌ها (SIGNALS)"
.PP
سیگنال‌های نام‌گذاری‌شدهٔ زیر برای استفاده در دسترس هستند\&.
.PP
\fBconfig\-reload\fR
.RS 4
واداشتن کارگزار به بارگذاری مجدد فایل پیکربندی خود، در صورت استفاده\&.
.sp
در سامانه‌های شبه\-POSIX این عمل را می‌توان با استفاده از سیگنال
\fBSIGHUP\fR
نیز تحریک کرد\&. توجه داشته باشید که
\fBSIGHUP\fR
توسط سیگنال‌های نام‌گذاری‌شدهٔ دیگری نیز استفاده می‌شود\&.
.RE
.PP
\fBlog\-rotate\fR
.RS 4
اگر کارگزار از
\fBlog_dest file\fR
استفاده می‌کند، این سیگنال کارگزار را وادار به بستن و بازگشایی مجدد فایل گزارش (log) خواهد کرد\&.
.sp
در سامانه‌های شبه\-POSIX این عمل را می‌توان با استفاده از سیگنال
\fBSIGHUP\fR
نیز تحریک کرد\&. توجه داشته باشید که
\fBSIGHUP\fR
توسط سیگنال‌های نام‌گذاری‌شدهٔ دیگری نیز استفاده می‌شود\&.
.RE
.PP
\fBshutdown\fR
.RS 4
واداشتن کارگزار به بستن و خروج\&.
.sp
در سامانه‌های شبه\-POSIX این عمل را می‌توان با استفاده از سیگنال
\fBSIGINT\fR
نیز تحریک کرد\&.
.RE
.PP
\fBtree\-print\fR
.RS 4
واداشتن کارگزار به چاپ نمایشی از درخت‌های اشتراک (subscription) و نگه‌داری (retain) در stdout\&. این قابلیت صرفاً برای اهداف اشکال‌زدایی در نظر گرفته شده است\&.
.sp
در سامانه‌های شبه\-POSIX این عمل را می‌توان با استفاده از سیگنال
\fBSIGUSR2\fR
نیز تحریک کرد\&. توجه داشته باشید که
\fBSIGUSR2\fR
توسط سیگنال‌های نام‌گذاری‌شدهٔ دیگری نیز استفاده می‌شود\&.
.RE
.PP
\fBxtreport\fR
.RS 4
واداشتن کارگزار به نوشتن برخی اطلاعات وضعیت داخلی در
\fB/tmp/xtmosquitto\&.kcg\&.<pid>\&.<iteration>\fR
در سامانه‌های POSIX یا
\fBxtmosquitto\&.kcg\&.<pid>\&.<iteration>\fR
در سامانه‌های Windows\&. این قابلیت صرفاً برای اهداف اشکال‌زدایی در نظر گرفته شده است\&.
.sp
این سیگنال تنها زمانی توسط کارگزار استفاده می‌شود که پشتیبانی مربوطه در آن کامپایل شده باشد، که به صورت پیش‌فرض چنین نیست\&.
.sp
در سامانه‌های شبه\-POSIX این عمل را می‌توان با استفاده از سیگنال
\fBSIGRTMIN\fR
نیز تحریک کرد\&.
.RE
.SH "گزارش باگ‌ها (BUGS)"
.PP
اطلاعات مربوط به باگ‌های
\fBmosquitto\fR
را می‌توان در نشانی زیر یافت:
\m[blue]\fB\%https://github.com/eclipse-mosquitto/mosquitto/issues\fR\m[]
.SH "همچنین ببینید (SEE ALSO)"
\fBmosquitto\fR(7), \fBmosquitto\fR(8)
.SH "نویسندگان (AUTHORS)"
.PP
Roger Light
<roger@atchoo\&.org>