.'\" t
.\"     Title: mosquitto
.\"    Author: [see the "Author" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 04/03/2026
.\"    Manual: Mosquitto
.\"    Source: Mosquitto Project
.\"  Language: Persian
.\"
.TH "MOSQUITTO" "8" "04/03/2026" "Mosquitto Project" "Mosquitto"
.\" -----------------------------------------------------------------
.\" * 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 \- یک کارگزار پیام پروتکل MQTT
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBmosquitto\fR\ 'u
\fBmosquitto\fR [\fB\-c\fR\ \fIپرونده\ پیکربندی\fR] [\fB\-d\fR | \fB\-\-\daemon\fR] [\fB\-p\fR\ \fIشماره\ درگاه\fR] [\fB\-q\fR] [\fB\-v\fR] [\fB\-\-\tls\-keylog\fR\ \fIپرونده\fR]
.SH "توضیحات (DESCRIPTION)"
.PP
\fBmosquitto\fR
یک کارگزار (broker) برای پروتکل MQTT نسخه‌های 5\&.0/3\&.1\&.1/3\&.1 است\&.
.PP
این ابزار بخشی از پروژه کلی mosquitto است\&. برای مروری بر تمامی صفحات راهنما،
\fBmosquitto\fR(7)
را ببینید\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-c\fR, \fB\-\-\config\-file\fR
.RS 4
بارگذاری پیکربندی از یک پرونده\&. در صورت عدم تعیین، کارگزار روی درگاه 1883 متصل به رابط محلی (loopback) گوش فرا می‌دهد و از مقادیر پیش‌فرضی که در
\fBmosquitto.conf\fR(5)
توصیف شده استفاده می‌شود\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBمهم\fR
.ps -1
.br
گزینه
\fB\-p\fR
را برای شرح تغییرات رفتار از نسخه 1\&.6\&.x به 2\&.0 مشاهده کنید\&.
.sp .5v
.RE
.RE
.PP
\fB\-d\fR, \fB\-\-\daemon\fR
.RS 4
اجرای
\fBmosquitto\fR
در پس‌زمینه به‌عنوان یک دیمن (daemon)\&. سایر رفتارها بدون تغییر باقی می‌مانند\&.
.RE
.PP
\fB\-p\fR, \fB\-\-\port\fR
.RS 4
گوش فرا دادن روی درگاه (پورت) مشخص‌شده\&. می‌تواند تا ۱۰ بار تکرار شود تا سوکت‌های متعددی را روی درگاه‌های مختلف باز کند\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBمهم\fR
.ps -1
.br
در نسخه 1\&.6\&.x و نسخه‌های قدیمی‌تر، شنونده‌ای که با
\fB\-p\fR
(یا درگاه پیش‌فرض 1883) تعریف می‌شد به تمامی رابط‌های شبکه متصل می‌شد و بنابراین از هر شبکه‌ای در دسترس بود\&. همچنین می‌توانست در ترکیب با
\fB\-c\fR
استفاده شود\&.
.sp
از نسخه 2\&.0 به بعد، شنوندگانی که با
\fB\-p\fR
تعریف می‌شوند فقط به رابط محلی (loopback) متصل می‌شوند و بنابراین فقط می‌توان از همان ماشین محلی به آن‌ها متصل شد\&. اگر هم از
\fB\-p\fR
استفاده شود و هم یک شنونده در پرونده پیکربندی تعریف شده باشد، گزینه‌های
\fB\-p\fR
نادیده گرفته می‌شوند\&.
.sp .5v
.RE
.RE
.PP
\fB\-q\fR, \fB\-\-\quiet\fR
.RS 4
موجود از نسخه 2\&.1 به بعد\&.
.sp
غیرفعال‌سازی تمامی رویدادنگاری‌ها (لاگ‌ها)\&. این معادل تنظیم
\fBlog_type\fR
روی
\fBnone\fR
در پرونده پیکربندی است\&. این گزینه هرگونه تنظیمات ثبت وقایع داده‌شده در پرونده پیکربندی را نادیده گرفته و همچنین بر
\fB\-\-\verbose\fR
اولویت دارد\&.
.RE
.PP
\fB\-\-\test\-config\fR
.RS 4
موجود از نسخه 2\&.1 به بعد\&.
.sp
بارگذاری پرونده پیکربندی مشخص‌شده با
\fB\-c\fR
و اعتبارسنجی آن بدون راه‌اندازی کارگزار\&. در صورتی که پیکربندی معتبر باشد کد خروج کارگزار 0 خواهد بود، و اگر پرونده پیکربندی تعیین نشده باشد یا نامعتبر باشد کدی غیرصفر بازگردانده می‌شود\&.
.RE
.PP
\fB\-\-\tls\-keylog\fR \fIfile\fR
.RS 4
موجود از نسخه 2\&.1 به بعد\&.
.sp
ثبت اطلاعات نشست TLS در
\fIfile\fR\&. این گزینه به ابزارهایی مانند
\fBtcpdump\fR,
\fBwireshark\fR
و
\fBmqttshark\fR
اجازه می‌دهد تا ترافیک TLS را رمزگشایی کرده و ترافیک MQTT را بازرسی کنند\&. در Wireshark این کار می‌تواند با تنظیم گزینه
\fB(Pre)\-Master\-Secret log filename\fR
برای پروتکل
\fBTransport Layer Security\fR
انجام شود\&.
.sp
این گزینه صرفاً باید برای اشکال‌زدایی استفاده شود و هرگز نباید در محیط عملیاتی به کار رود\&.
.RE
.PP
\fB\-v\fR, \fB\-\-\verbose\fR
.RS 4
استفاده از ثبت وقایع پرگویی (verbose)\&. این معادل تنظیم
\fBlog_type\fR
روی
\fBall\fR
در پرونده پیکربندی است\&. این گزینه بر هرگونه گزینه ثبت وقایع تعیین‌شده در پرونده پیکربندی اولویت دارد\&.
.RE
.SH "پیکربندی (CONFIGURATION)"
.PP
کارگزار را می‌توان با استفاده از یک پرونده پیکربندی همان‌گونه که در
\fBmosquitto.conf\fR(5)
توصیف شده پیکربندی کرد و این نقطه مرجع اصلی اطلاعات برای mosquitto است\&. پرونده‌های مورد نیاز برای پشتیبانی از SSL/TLS در
\fBmosquitto-tls\fR(7)
شرح داده شده‌اند\&.
.SH "محدودیت‌های بستر (PLATFORM LIMITATIONS)"
.PP
برخی از نسخه‌های ویندوز به دلیل API ویندوزی که استفاده می‌شود، محدودیت‌هایی در تعداد اتصالات همزمان دارند\&. در نسخه‌های مدرن ویندوز، مانند Windows 10 یا Windows Server 2019، این مقدار تقریباً ۸۱۹۲ اتصال است\&. در نسخه‌های قدیمی‌تر ویندوز، این حد ۲۰۴۸ اتصال است\&.
.SH "پشتیبانی از MQTT (MQTT SUPPORT)"
.PP
کارگزار Mosquitto از نسخه‌های v5\&.0، v3\&.1\&.1 و v3\&.1 پروتکل MQTT پشتیبانی می‌کند\&.
.SS "MQTT v5\&.0"
.PP
کارگزار Mosquitto پشتیبانی کاملی از MQTT v5\&.0 فراهم می‌کند، اما برخی ویژگی‌ها به‌طور مستقیم استفاده نمی‌شوند\&. بخش‌های زیر ویژگی‌های جدید را توضیح داده و مشخص می‌کنند که Mosquitto در کجا از یک ویژگی استفاده نمی‌کند\&.
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBویژگی‌ها (Features)\fR
.RS 4
.PP
\fBEnhanced authentication (احراز هویت پیشرفته)\fR
.RS 4
احراز هویت پایه MQTT از بررسی نام کاربری/گذرواژه استفاده می‌کند\&. احراز هویت پیشرفته امکان ادغام طرح‌های احراز هویت مختلف در MQTT را فراهم می‌کند، حتی طرح‌هایی با فرآیندهای چندمرحله‌ای\&. کلاینت‌ها درخواست نوع خاصی از احراز هویت را ارسال می‌کنند و اگر کارگزار برای آن طرح پیکربندی شده باشد، احراز هویت ادامه می‌یابد\&. کارگزار Mosquitto از احراز هویت پیشرفته از طریق افزونه‌ها (plugins) پشتیبانی می‌کند\&.
.RE
.PP
\fBError handling (مدیریت خطا)\fR
.RS 4
اکثر بسته‌های MQTT اکنون دارای مفهوم
\fBکد علت (reason code)\fR
هستند که موفقیت یا شکست و دلیل شکست را نشان می‌دهد\&. کارگزار Mosquitto پشتیبانی کاملی از کدهای علت ارائه می‌دهد، اما از ویژگی
\fBرشته علت (reason string)\fR
که می‌تواند برای ارائه یک رشته خطای قابل‌خواندن برای انسان جهت توضیح کد علت استفاده شود، استفاده نمی‌کند\&.
.RE
.PP
\fBFlow control (کنترل جریان)\fR
.RS 4
تعداد پیام‌های «در جریان» (in flight) برای QoS 1 و QoS 2 می‌تواند توسط هر دو سمت کلاینت و کارگزار کنترل شود\&.
.RE
.PP
\fBRequest / response (درخواست / پاسخ)\fR
.RS 4
پروتکل MQTT v5\&.0 یک الگوی درخواست/پاسخ اضافه می‌کند که به یک کلاینت اجازه می‌دهد پیامی را منتشر کند و به مشترکین آن پیام آموزش دهد که پاسخ را در کجا منتشر کنند\&.
.RE
.PP
\fBServer redirection (تغییر مسیر کارگزار)\fR
.RS 4
تغییر مسیر کارگزار مفهومی است که به کلاینت دستور می‌دهد به کارگزار MQTT دیگری متصل شود، چه در زمان CONNECT یا با یک DISCONNECT که توسط کارگزار آغاز شده باشد\&. کارگزار Mosquitto در حال حاضر از این ویژگی استفاده نمی‌کند\&.
.RE
.PP
\fBShared subscriptions (اشتراک‌های اشتراکی)\fR
.RS 4
هنگامی که چندین کلاینت در یک اشتراک اشتراکی یکسان عضو می‌شوند، تنها یک کلاینت از آن گروه هر پیام را دریافت می‌کند که این امکان توزیع بار کاری را فراهم می‌سازد\&.
.RE
.RE
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBویژگی‌های بسته (Packet properties)\fR
.RS 4
.PP
پروتکل MQTT v5\&.0 اجازه می‌دهد ویژگی‌هایی به بسته‌ها اضافه شوند تا رفتار خاصی را کنترل کنند\&. مگر در مواردی که ذکر شده باشد، Mosquitto از ویژگی‌های فهرست‌شده در زیر پشتیبانی می‌کند\&.
.PP
\fBCONNECT\fR
.RS 4
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Authentication data (داده‌های احراز هویت)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Authentication method (روش احراز هویت)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Maximum packet size (حداکثر اندازه بسته)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Receive maximum (حداکثر دریافت)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Request problem information \- پشتیبانی می‌شود اما استفاده نمی‌شود
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Request response information \- پشتیبانی می‌شود اما استفاده نمی‌شود
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Session expiry interval (فاصله انقضای نشست)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Topic alias maximum (حداکثر نام مستعار موضوع)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
User property (ویژگی کاربر)
.RE
.RE
.PP
\fBLast will and testament (وصیت‌نامه و آخرین خواست)\fR
.RS 4
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Content type (نوع محتوا)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Correlation data (داده‌های همبستگی)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Message expiry interval (فاصله انقضای پیام)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Payload format indicator (نشانگر قالب بار مفید)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Response topic (موضوع پاسخ)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
User property (ویژگی کاربر)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Will delay interval (فاصله تاخیر وصیت‌نامه)
.RE
.RE
.PP
\fBCONNACK\fR
.RS 4
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Assigned client identifier (شناسه کلاینت تخصیص‌یافته)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Authentication data (داده‌های احراز هویت)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Authentication method (روش احراز هویت)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Maximum packet size (حداکثر اندازه بسته)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Maximum qos (حداکثر کیفیت خدمات qos)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Reason string \- پشتیبانی می‌شود اما استفاده نمی‌شود
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Receive maximum (حداکثر دریافت)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Response information \- پشتیبانی می‌شود اما استفاده نمی‌شود
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Retain available (نگه‌داری در دسترس)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Server keep alive (زنده نگه‌داشتن سرور)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Server reference \- پشتیبانی می‌شود اما استفاده نمی‌شود
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Session expiry interval (فاصله انقضای نشست)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Shared subscription available (اشتراک اشتراکی در دسترس)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Subscription identifiers available (شناسه‌های اشتراک در دسترس)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Topic alias maximum (حداکثر نام مستعار موضوع)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
User property (ویژگی کاربر)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Wildcard subscription available (اشتراک عامه‌نگاشت در دسترس)
.RE
.RE
.PP
\fBPUBLISH\fR
.RS 4
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Content type (نوع محتوا)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Correlation data (داده‌های همبستگی)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Message expiry interval (فاصله انقضای پیام)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Payload format indicator (نشانگر قالب بار مفید)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Response topic (موضوع پاسخ)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Subscription identifier (شناسه اشتراک)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Topic alias (نام مستعار موضوع)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
User property (ویژگی کاربر)
.RE
.RE
.PP
\fBPUBACK / PUBREC / PUBREL / PUBCOMP / SUBACK / SUBSCRIBE / SUBACK\fR
.RS 4
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Reason string \- پشتیبانی می‌شود اما استفاده نمی‌شود
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
User property (ویژگی کاربر)
.RE
.RE
.PP
\fBSUBSCRIBE\fR
.RS 4
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Subscription identifier (شناسه اشتراک)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
User property (ویژگی کاربر)
.RE
.RE
.PP
\fBDISCONNECT\fR
.RS 4
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Reason string \- پشتیبانی می‌شود اما استفاده نمی‌شود
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Server reference \- پشتیبانی می‌شود اما استفاده نمی‌شود
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Session expiry interval (فاصله انقضای نشست)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
User property (ویژگی کاربر)
.RE
.RE
.PP
\fBAUTH\fR
.RS 4
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Authentication method (روش احراز هویت)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Authentication data (داده‌های احراز هویت)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Reason string \- پشتیبانی می‌شود اما استفاده نمی‌شود
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
User property (ویژگی کاربر)
.RE
.RE
.RE
.SS "MQTT v3\&.1\&.1"
.PP
کارگزار Mosquitto پشتیبانی کاملی از MQTT v3\&.1\&.1 ارائه می‌دهد\&.
.SS "MQTT v3\&.1"
.PP
کارگزار Mosquitto پشتیبانی کاملی از MQTT v3\&.1 ارائه می‌دهد\&.
.SS "MQTT v3"
.PP
نسخه MQTT v3 نگارشی منسوخ‌شده از این پروتکل است که از احراز هویت نام کاربری/گذرواژه پشتیبانی نمی‌کند و از پرچم
\fBشروع تمیز (clean start)\fR
در بسته CONNECT استفاده می‌کرد که تنها در ابتدای یک نشست اعمال می‌شد\&. یک کلاینت MQTT v3 قادر خواهد بود با موفقیت به یک نمونه Mosquitto که نیازی به احراز هویت ندارد متصل شود\&.
.SH "وضعیت کارگزار (BROKER STATUS)"
.PP
کلاینت‌ها می‌توانند با عضویت در موضوعات سلسله‌مراتب $SYS به شرح زیر اطلاعاتی درباره کارگزار به دست آورند\&. موضوعاتی که به‌عنوان ایستا (static) مشخص شده‌اند، تنها یک‌بار به ازای هر کلاینت در زمان عضویت ارسال می‌شوند\&. سایر موضوعات هر
\fBsys_interval\fR
ثانیه یک‌بار به‌روزرسانی می‌شوند\&. اگر
\fBsys_interval\fR
برابر با 0 باشد، به‌روزرسانی‌ها ارسال نخواهند شد\&.
.PP
توجه داشته باشید که اگر از یک کلاینت خط فرمان برای تعامل با موضوعات $SYS استفاده می‌کنید و پوسته شما علامت $ را به‌عنوان متغیر محیطی تفسیر می‌کند، باید موضوع را داخل کوتیشن تکی قرار دهید \*(Aq$SYS/\&.\&.\&.\*(Aq یا علامت دلار را اسکیپ کنید: \e$SYS/\&.\&.\&. در غیر این صورت $SYS به‌عنوان یک متغیر محیطی در نظر گرفته خواهد شد\&.
.PP
\fB$SYS/broker/bytes/received\fR
.RS 4
تعداد کل بایت‌های دریافت شده از زمان شروع به کار کارگزار\&.
.RE
.PP
\fB$SYS/broker/bytes/sent\fR
.RS 4
تعداد کل بایت‌های ارسال شده از زمان شروع به کار کارگزار\&.
.RE
.PP
\fB$SYS/broker/clients/connected\fR, \fB$SYS/broker/clients/active\fR (منسوخ‌شده)
.RS 4
تعداد کلاینت‌های متصل در حال حاضر\&.
.RE
.PP
\fB$SYS/broker/clients/expired\fR
.RS 4
تعداد کلاینت‌های ماندگار قطع‌شده که منقضی شده و از طریق گزینه persistent_client_expiration حذف شده‌اند\&.
.RE
.PP
\fB$SYS/broker/clients/disconnected\fR, \fB$SYS/broker/clients/inactive\fR (منسوخ‌شده)
.RS 4
تعداد کل کلاینت‌های ماندگار (با نشست تمیز غیرفعال) که در کارگزار ثبت شده‌اند اما در حال حاضر قطع هستند\&.
.RE
.PP
\fB$SYS/broker/clients/maximum\fR
.RS 4
حداکثر تعداد کلاینت‌هایی که به‌طور همزمان به کارگزار متصل بوده‌اند\&.
.RE
.PP
\fB$SYS/broker/clients/total\fR
.RS 4
تعداد کل نشست‌های کلاینت متصل و قطع‌شده که در حال حاضر روی کارگزار ثبت شده‌اند\&.
.RE
.PP
\fB$SYS/broker/connection/#\fR
.RS 4
هنگامی که پل‌ها (bridges) به یا از کارگزار پیکربندی می‌شوند، رویه معمول این است که یک موضوع وضعیت که حالت اتصال را نشان می‌دهد ارائه شود\&. این موضوع به‌طور پیش‌فرض در $SYS/broker/connection/ ارائه می‌شود\&. اگر مقدار موضوع 1 باشد اتصال فعال است، و اگر 0 باشد فعال نیست\&. برای اطلاعات بیشتر در مورد پل‌ها، بخش پل‌ها را در ادامه ببینید\&.
.RE
.PP
\fB$SYS/broker/connections/socket/count\fR
.RS 4
تعداد کل اتصالات سوکتی برقرار شده با کارگزار، صرف‌نظر از اینکه آیا اتصالات MQTT در نهایت موفقیت‌آمیز بوده‌اند یا خیر\&.
.RE
.PP
\fB$SYS/broker/heap/current\fR
.RS 4
اندازه فعلی حافظه هیپ (heap) در حال استفاده توسط mosquitto\&. توجه داشته باشید که این موضوع ممکن است بسته به گزینه‌های زمان کامپایل در دسترس نباشد\&.
.RE
.PP
\fB$SYS/broker/heap/maximum\fR
.RS 4
بیشترین میزان حافظه هیپ استفاده‌شده توسط mosquitto\&. توجه داشته باشید که این موضوع ممکن است بسته به گزینه‌های زمان کامپایل در دسترس نباشد\&.
.RE
.PP
\fB$SYS/broker/load/connections/+\fR
.RS 4
میانگین متحرک تعداد بسته‌های CONNECT دریافت شده توسط کارگزار در بازه‌های زمانی مختلف\&. علامت "+" پایانی در سلسله‌مراتب می‌تواند 1min، 5min یا 15min باشد\&. مقدار بازگردانده شده نشان‌دهنده تعداد اتصالات دریافت شده در ۱ دقیقه است که روی بازه ۱، ۵ یا ۱۵ دقیقه میانگین‌گیری شده است\&.
.RE
.PP
\fB$SYS/broker/load/bytes/received/+\fR
.RS 4
میانگین متحرک تعداد بایت‌های دریافت شده توسط کارگزار در بازه‌های زمانی مختلف\&. علامت "+" پایانی در سلسله‌مراتب می‌تواند 1min، 5min یا 15min باشد\&. مقدار بازگردانده شده نشان‌دهنده تعداد بایت‌های دریافت شده در ۱ دقیقه است که روی بازه ۱، ۵ یا ۱۵ دقیقه میانگین‌گیری شده است\&.
.RE
.PP
\fB$SYS/broker/load/bytes/sent/+\fR
.RS 4
میانگین متحرک تعداد بایت‌های ارسال شده توسط کارگزار در بازه‌های زمانی مختلف\&. علامت "+" پایانی در سلسله‌مراتب می‌تواند 1min، 5min یا 15min باشد\&. مقدار بازگردانده شده نشان‌دهنده تعداد بایت‌های ارسال شده در ۱ دقیقه است که روی بازه ۱، ۵ یا ۱۵ دقیقه میانگین‌گیری شده است\&.
.RE
.PP
\fB$SYS/broker/load/messages/received/+\fR
.RS 4
میانگین متحرک تعداد پیام‌های MQTT از تمام انواع دریافت شده توسط کارگزار در بازه‌های زمانی مختلف\&. علامت "+" پایانی در سلسله‌مراتب می‌تواند 1min، 5min یا 15min باشد\&. مقدار بازگردانده شده نشان‌دهنده تعداد پیام‌های دریافت شده در ۱ دقیقه است که روی بازه ۱، ۵ یا ۱۵ دقیقه میانگین‌گیری شده است\&.
.RE
.PP
\fB$SYS/broker/load/messages/sent/+\fR
.RS 4
میانگین متحرک تعداد پیام‌های MQTT از تمام انواع ارسال شده توسط کارگزار در بازه‌های زمانی مختلف\&. علامت "+" پایانی در سلسله‌مراتب می‌تواند 1min، 5min یا 15min باشد\&. مقدار بازگردانده شده نشان‌دهنده تعداد پیام‌های ارسال شده در ۱ دقیقه است که روی بازه ۱، ۵ یا ۱۵ دقیقه میانگین‌گیری شده است\&.
.RE
.PP
\fB$SYS/broker/load/publish/dropped/+\fR
.RS 4
میانگین متحرک تعداد پیام‌های انتشار (publish) رها شده توسط کارگزار در بازه‌های زمانی مختلف\&. این نرخ از دست رفتن پیام‌ها برای کلاینت‌های ماندگاری را نشان می‌دهد که قطع شده‌اند\&. علامت "+" پایانی در سلسله‌مراتب می‌تواند 1min، 5min یا 15min باشد\&. مقدار بازگردانده شده نشان‌دهنده تعداد پیام‌های رها شده در ۱ دقیقه است که روی بازه ۱، ۵ یا ۱۵ دقیقه میانگین‌گیری شده است\&.
.RE
.PP
\fB$SYS/broker/load/publish/received/+\fR
.RS 4
میانگین متحرک تعداد پیام‌های انتشار دریافت شده توسط کارگزار در بازه‌های زمانی مختلف\&. علامت "+" پایانی در سلسله‌مراتب می‌تواند 1min، 5min یا 15min باشد\&. مقدار بازگردانده شده نشان‌دهنده تعداد پیام‌های انتشار دریافت شده در ۱ دقیقه است که روی بازه ۱، ۵ یا ۱۵ دقیقه میانگین‌گیری شده است\&.
.RE
.PP
\fB$SYS/broker/load/publish/sent/+\fR
.RS 4
میانگین متحرک تعداد پیام‌های انتشار ارسال شده توسط کارگزار در بازه‌های زمانی مختلف\&. علامت "+" پایانی در سلسله‌مراتب می‌تواند 1min، 5min یا 15min باشد\&. مقدار بازگردانده شده نشان‌دهنده تعداد پیام‌های انتشار ارسال شده در ۱ دقیقه است که روی بازه ۱، ۵ یا ۱۵ دقیقه میانگین‌گیری شده است\&.
.RE
.PP
\fB$SYS/broker/load/sockets/+\fR
.RS 4
میانگین متحرک تعداد اتصالات سوکت باز شده به کارگزار در بازه‌های زمانی مختلف\&. علامت "+" پایانی در سلسله‌مراتب می‌تواند 1min، 5min یا 15min باشد\&. مقدار بازگردانده شده نشان‌دهنده تعداد اتصالات سوکت در ۱ دقیقه است که روی بازه ۱، ۵ یا ۱۵ دقیقه میانگین‌گیری شده است\&.
.RE
.PP
\fB$SYS/broker/messages/received\fR
.RS 4
تعداد کل پیام‌ها از هر نوع که از زمان شروع به کار کارگزار دریافت شده‌اند\&.
.RE
.PP
\fB$SYS/broker/messages/sent\fR
.RS 4
تعداد کل پیام‌ها از هر نوع که از زمان شروع به کار کارگزار ارسال شده‌اند\&.
.RE
.PP
\fB$SYS/broker/mqtt/connect/received\fR
.RS 4
تعداد کل پیام‌های MQTT CONNECT دریافت شده از زمان شروع به کار کارگزار\&.
.RE
.PP
\fB$SYS/broker/mqtt/connack/sent\fR
.RS 4
تعداد کل پیام‌های MQTT CONNACK ارسال شده از زمان شروع به کار کارگزار\&.
.RE
.PP
\fB$SYS/broker/mqtt/publish/dropped\fR, \fB$SYS/broker/publish/messages/dropped\fR
.RS 4
تعداد کل پیام‌های MQTT PUBLISH که به دلیل محدودیت‌های پیام‌های در جریان/صف‌بندی رها شده‌اند\&. برای اطلاعات بیشتر، گزینه‌های max_inflight_messages و max_queued_messages را در
\fBmosquitto.conf\fR(5)
ببینید\&.
.RE
.PP
\fB$SYS/broker/mqtt/publish/received\fR, \fB$SYS/broker/publish/messages/received\fR
.RS 4
تعداد کل پیام‌های MQTT PUBLISH دریافت شده از زمان شروع به کار کارگزار\&.
.RE
.PP
\fB$SYS/broker/mqtt/publish/sent\fR, \fB$SYS/broker/publish/messages/sent\fR
.RS 4
تعداد کل پیام‌های MQTT PUBLISH ارسال شده از زمان شروع به کار کارگزار\&.
.RE
.PP
\fB$SYS/broker/mqtt/puback/received\fR
.RS 4
تعداد کل پیام‌های MQTT PUBACK دریافت شده از زمان شروع به کار کارگزار\&.
.RE
.PP
\fB$SYS/broker/mqtt/puback/sent\fR
.RS 4
تعداد کل پیام‌های MQTT PUBACK ارسال شده از زمان شروع به کار کارگزار\&.
.RE
.PP
\fB$SYS/broker/mqtt/pubrec/received\fR
.RS 4
تعداد کل پیام‌های MQTT PUBREC دریافت شده از زمان شروع به کار کارگزار\&.
.RE
.PP
\fB$SYS/broker/mqtt/pubrec/sent\fR
.RS 4
تعداد کل پیام‌های MQTT PUBREC ارسال شده از زمان شروع به کار کارگزار\&.
.RE
.PP
\fB$SYS/broker/mqtt/pubrel/received\fR
.RS 4
تعداد کل پیام‌های MQTT PUBREL دریافت شده از زمان شروع به کار کارگزار\&.
.RE
.PP
\fB$SYS/broker/mqtt/pubrel/sent\fR
.RS 4
تعداد کل پیام‌های MQTT PUBREL ارسال شده از زمان شروع به کار کارگزار\&.
.RE
.PP
\fB$SYS/broker/mqtt/pubcomp/received\fR
.RS 4
تعداد کل پیام‌های MQTT PUBCOMP دریافت شده از زمان شروع به کار کارگزار\&.
.RE
.PP
\fB$SYS/broker/mqtt/pubcomp/sent\fR
.RS 4
تعداد کل پیام‌های MQTT PUBCOMP ارسال شده از زمان شروع به کار کارگزار\&.
.RE
.PP
\fB$SYS/broker/mqtt/subscribe/received\fR
.RS 4
تعداد کل پیام‌های MQTT SUBSCRIBE دریافت شده از زمان شروع به کار کارگزار\&.
.RE
.PP
\fB$SYS/broker/mqtt/suback/sent\fR
.RS 4
تعداد کل پیام‌های MQTT SUBACK ارسال شده از زمان شروع به کار کارگزار\&.
.RE
.PP
\fB$SYS/broker/mqtt/unsubscribe/received\fR
.RS 4
تعداد کل پیام‌های MQTT UNSUBSCRIBE دریافت شده از زمان شروع به کار کارگزار\&.
.RE
.PP
\fB$SYS/broker/mqtt/unsuback/sent\fR
.RS 4
تعداد کل پیام‌های MQTT UNSUBACK ارسال شده از زمان شروع به کار کارگزار\&.
.RE
.PP
\fB$SYS/broker/mqtt/pingreq/received\fR
.RS 4
تعداد کل پیام‌های MQTT PINGREQ دریافت شده از زمان شروع به کار کارگزار\&.
.RE
.PP
\fB$SYS/broker/mqtt/pingresp/sent\fR
.RS 4
تعداد کل پیام‌های MQTT PINGRESP ارسال شده از زمان شروع به کار کارگزار\&.
.RE
.PP
\fB$SYS/broker/mqtt/disconnect/received\fR
.RS 4
تعداد کل پیام‌های MQTT DISCONNECT دریافت شده از زمان شروع به کار کارگزار\&.
.RE
.PP
\fB$SYS/broker/mqtt/disconnect/sent\fR
.RS 4
تعداد کل پیام‌های MQTT DISCONNECT ارسال شده از زمان شروع به کار کارگزار\&.
.RE
.PP
\fB$SYS/broker/mqtt/auth/received\fR
.RS 4
تعداد کل پیام‌های MQTT AUTH دریافت شده از زمان شروع به کار کارگزار\&.
.RE
.PP
\fB$SYS/broker/mqtt/auth/sent\fR
.RS 4
تعداد کل پیام‌های MQTT AUTH ارسال شده از زمان شروع به کار کارگزار\&.
.RE
.PP
\fB$SYS/broker/packet/out/count\fR
.RS 4
تعداد فعلی بسته‌های صف‌بندی‌شده برای تحویل در تمام کلاینت‌ها\&. یک مقدار بزرگ و رو به افزایش در اینجا ممکن است نشان دهد پیام‌ها سریع‌تر از توان انتقال شبکه در حال ارسال هستند\&.
.RE
.PP
\fB$SYS/broker/packet/out/bytes\fR
.RS 4
تعداد فعلی بایت‌ها در بسته‌های صف‌بندی‌شده برای تحویل در تمام کلاینت‌ها\&. یک مقدار بزرگ و رو به افزایش در اینجا ممکن است نشان دهد پیام‌ها سریع‌تر از توان انتقال شبکه در حال ارسال هستند\&.
.RE
.PP
\fB$SYS/broker/publish/bytes/received\fR
.RS 4
تعداد کل بایت‌های بار مفید (payload) پیام‌های PUBLISH دریافت شده از زمان شروع به کار کارگزار\&.
.RE
.PP
\fB$SYS/broker/publish/bytes/sent\fR
.RS 4
تعداد کل بایت‌های بار مفید پیام‌های PUBLISH ارسال شده از زمان شروع به کار کارگزار\&.
.RE
.PP
\fB$SYS/broker/retained messages/count\fR
.RS 4
تعداد کل پیام‌های ماندگار (retained) فعال روی کارگزار\&.
.RE
.PP
\fB$SYS/broker/store/messages/count\fR, \fB$SYS/broker/messages/stored\fR (منسوخ‌شده)
.RS 4
تعداد پیام‌هایی که در حال حاضر در مخزن پیام نگهداری می‌شوند\&. این شامل پیام‌های ماندگار و پیام‌های صف‌بندی‌شده برای کلاینت‌های پایدار است\&.
.RE
.PP
\fB$SYS/broker/store/messages/bytes\fR
.RS 4
تعداد بایت‌هایی که در حال حاضر توسط بار مفید پیام‌ها در مخزن پیام اشغال شده است\&. این شامل پیام‌های ماندگار و پیام‌های صف‌بندی‌شده برای کلاینت‌های پایدار است\&.
.RE
.PP
\fB$SYS/broker/shared_subscriptions/count\fR
.RS 4
تعداد کل اشتراک‌های اشتراکی فعال روی کارگزار\&.
.RE
.PP
\fB$SYS/broker/subscriptions/count\fR
.RS 4
تعداد کل اشتراک‌های فعال روی کارگزار\&.
.RE
.PP
\fB$SYS/broker/version\fR
.RS 4
نسخه کارگزار\&. ایستا (Static)\&.
.RE
.SH "اشتراک‌های موضوع با نویسه‌های عام (WILDCARD TOPIC SUBSCRIPTIONS)"
.PP
علاوه بر اجازه دادن به کلاینت‌ها برای عضویت در موضوعات خاص، mosquitto امکان استفاده از دو نویسه عام (wildcard) را نیز در اشتراک‌ها فراهم می‌کند\&.
\fB+\fR
نویسه عامی است که برای تطبیق با یک سطح منفرد از سلسله‌مراتب استفاده می‌شود\&. برای مثال، برای موضوع "a/b/c/d"، نمونه اشتراک‌های زیر مطابقت خواهند داشت:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
a/b/c/d
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
+/b/c/d
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
a/+/c/d
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
a/+/+/d
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
+/+/+/+
.RE
.PP
اشتراک‌های زیر مطابقت نخواهند داشت:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
a/b/c
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
b/+/c/d
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
+/+/+
.RE
.PP
دومین نویسه عام
\fB#\fR
است و برای مطابقت با تمام سطوح بعدی سلسله‌مراتب استفاده می‌شود\&. با موضوع "a/b/c/d"، نمونه اشتراک‌های زیر مطابقت خواهند داشت:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
a/b/c/d
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
#
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
a/#
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
a/b/#
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
a/b/c/#
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
+/b/c/#
.RE
.PP
سلسله‌مراتب $SYS با اشتراک "#" مطابقت ندارد\&. اگر می‌خواهید کل سلسله‌مراتب $SYS را مشاهده کنید، در $SYS/# مشترک شوید\&.
.PP
توجه داشته باشید که نویسه‌های عام همیشه باید به تنهایی استفاده شوند، بنابراین اشتراکی مانند "a/b+/c" استفاده معتبری از یک نویسه عام نیست\&. نویسه عام
\fB#\fR
تنها باید به‌عنوان آخرین نویسه در یک اشتراک استفاده شود\&.
.SH "پل‌ها (BRIDGES)"
.PP
می‌توان چندین کارگزار را با استفاده از قابلیت پل‌زدن (bridging) به یکدیگر متصل کرد\&. این قابلیت در مواردی مفید است که به اشتراک گذاشتن اطلاعات بین مکان‌های مختلف مطلوب باشد، اما نیازی به اشتراک‌گذاری تمام اطلاعات نباشد\&. برای مثال، حالتی را در نظر بگیرید که تعدادی از کاربران برای ثبت میزان مصرف برق و به دلایل متعدد دیگر، یک کارگزار را اجرا می‌کنند\&. مصرف برق می‌تواند از طریق پل زدن کارگزاران تمام کاربران به یک کارگزار مشترک به اشتراک گذاشته شود و امکان جمع‌آوری و مقایسه مصرف برق همه کاربران فراهم آید\&. سایر اطلاعات برای هر کارگزار به‌صورت محلی باقی می‌ماند\&.
.PP
برای اطلاعات بیشتر در مورد پیکربندی پل‌ها،
\fBmosquitto.conf\fR(5)
را ببینید\&.
.SH "سیگنال‌ها (SIGNALS)"
.PP
در سیستم‌های پوزیکس (POSIX)، کارگزار Mosquitto می‌تواند سیگنال‌ها را دریافت کرده و همان‌گونه که در زیر توصیف شده روی آن‌ها عمل کند\&. برای ارسال سیگنال‌ها، برای مثال از دستور زیر استفاده کنید:
\fBkill \-HUP <process id of mosquitto>\fR
.PP
SIGHUP
.RS 4
با دریافت سیگنال SIGHUP، کارگزار mosquitto تلاش خواهد کرد داده‌های پرونده پیکربندی را مجدداً بارگذاری کند، با این فرض که آرگومان
\fB\-c\fR
در زمان شروع mosquitto ارائه شده باشد\&. همه پارامترهای پیکربندی را نمی‌توان بدون راه‌اندازی مجدد بازنشانی کرد\&. برای جزئیات به
\fBmosquitto.conf\fR(5)
مراجعه کنید\&.
.sp
اگر گواهی‌های TLS در حال استفاده باشند، mosquitto با دریافت SIGHUP گواهی‌ها را نیز مجدداً بارگذاری خواهد کرد\&.
.sp
همچنین پرونده‌های لاگ بسته شده و مجدداً باز خواهند شد\&.
.RE
.PP
SIGRTMIN
.RS 4
با دریافت سیگنال SIGRTMIN، کارگزار mosquitto لاگ‌ها را برای پشتیبانی از چرخش لاگ (log rotation) بسته و دوباره باز می‌کند\&.
.RE
.PP
SIGUSR1
.RS 4
با دریافت سیگنال SIGUSR1، کارگزار mosquitto پایگاه‌داده ماندگاری را روی دیسک می‌نویسد\&. این سیگنال تنها در صورتی عمل می‌کند که ماندگاری (persistence) فعال باشد\&.
.RE
.PP
SIGUSR2
.RS 4
سیگنال SIGUSR2 باعث می‌شود mosquitto درخت اشتراک فعلی را به همراه اطلاعات مربوط به محل وجود پیام‌های نگه‌داشته‌شده (retained) چاپ کند\&. این صرفاً به‌عنوان یک قابلیت آزمایشی در نظر گرفته شده و ممکن است در هر زمانی حذف شود\&.
.RE
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.PP
\fBMOSQUITTO_UNSAFE_ALLOW_SYMLINKS\fR
.RS 4
به‌طور پیش‌فرض، از بارگذاری پرونده‌های حساسی که مسیر آن‌ها شامل پیوند نمادین (symlink) باشد خودداری می‌شود\&. این متغیر محیطی را روی هر مقداری تنظیم کنید تا بارگذاری پرونده‌ها از طریق پیوندهای نمادین مجاز شود\&. توجه داشته باشید که استفاده از این متغیر می‌تواند شما را در معرض حملات پیوند نمادین قرار دهد و بنابراین فقط در مواردی باید استفاده شود که کاملاً مطمئن باشید چنین خطری وجود ندارد\&.
.RE
.SH "فایل‌ها (FILES)"
.PP
/etc/mosquitto/mosquitto\&.conf
.RS 4
پرونده پیکربندی\&. مراجعه کنید به
\fBmosquitto.conf\fR(5)\&.
.RE
.PP
/var/lib/mosquitto/mosquitto\&.db
.RS 4
محل ذخیره‌سازی داده‌های پیام‌های ماندگار در صورت فعال بودن ماندگاری\&.
.RE
.PP
/etc/hosts\&.allow, /etc/hosts\&.deny
.RS 4
کنترل دسترسی میزبان از طریق tcp\-wrappers همان‌طور که در
\fBhosts_access\fR(5)
توصیف شده است\&.
.RE
.SH "اشکالات (BUGS)"
.PP
اطلاعات مربوط به اشکالات
\fBmosquitto\fR
را می‌توان در نشانی زیر یافت:
\m[blue]\fB\%https://github.com/eclipse-mosquitto/mosquitto/issues\fR\m[]
.SH "همچنین ببینید (SEE ALSO)"
\fBmosquitto\fR(7), \fBmqtt\fR(7), \fBmosquitto-tls\fR(7), \fBmosquitto.conf\fR(5), \fBmosquitto_ctrl\fR(1), \fBmosquitto_passwd\fR(1), \fBmosquitto_pub\fR(1), \fBmosquitto_rr\fR(1), \fBmosquitto_sub\fR(1), \fBlibmosquitto\fR(3)
.SH "سپاسگزاری (THANKS)"
.PP
با تشکر از Andy Stanford\-Clark برای اینکه یکی از افرادی بود که در وهله اول ایده MQTT را مطرح کرد\&. با تشکر از Andy و Nicholas O\*(AqLeary برای ارائه توضیحات و شفاف‌سازی‌های مربوط به پروتکل\&.
.PP
همچنین با تشکر از همه دست‌اندرکاران پادکست Ubuntu UK Podcast و Linux Outlaws برای سازمان‌دهی رویداد OggCamp، جایی که Andy سخنرانی کرد و الهام‌بخش ساخت mosquitto شد\&.
.SH "نویسنده (AUTHOR)"
.PP
Roger Light
<roger@atchoo\&.org>