'\" t
.\"     Title: mosquitto_rr
.\"    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_RR" "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_rr \- کلاینت MQTT نسخهٔ 5/3\&.1\&.1 برای پیام‌رسانی درخواست/پاسخ
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBmosquitto_rr\fR\ 'u
\fBmosquitto_rr\fR [options] \fB\-e\fR\ \fIresponse\-topic\fR \fB\-t\fR\ \fImessage\-topic\fR... {payload\-options}
.HP \w'\fBoptions:\fR\ 'u
\fBoptions:\fR
.br
[auth\-options] [connection\-options] [misc\-options] [mqtt\-options] [output\-options] [tls\-certificate\-options | tls\-psk\-options]
.HP \w'\fBauth\-options:\fR\ 'u
\fBauth\-options:\fR
.br
[\fB\-u\fR\ \fIusername\fR] [\fB\-P\fR\ \fIpassword\fR]
.HP \w'\fBconnection\-options:\fR\ 'u
\fBconnection\-options:\fR
.br
{[\fB\-h\fR\ \fIhostname\fR]\ [\fB\-\-unix\fR\ \fIsocket\ path\fR]\ [\fB\-p\fR\ \fIport\-number\fR]  | \fB\-L\fR\ \fIURL\fR }
.br
[\fB\-A\fR\ \fIbind\-address\fR] [\fB\-\-nodelay\fR] [\fB\-S\fR] [\fB\-\-ws\fR] [\fB\-\-proxy\fR\ \fIsocks\-url\fR]
.HP \w'\fBmisc\-options:\fR\ 'u
\fBmisc\-options:\fR
.br
[\fB\-\-latency\fR] [\fB\-o\fR\ \fIconfig\-file\fR] [\fB\-W\fR\ \fImessage\-processing\-timeout\fR]
.HP \w'\fBmqtt\-options:\fR\ 'u
\fBmqtt\-options:\fR
.br
[\fB\-c\fR] [\fB\-D\fR\ \fIcommand\fR\ \fIidentifier\fR\ \fIvalue\fR] [\fB\-i\fR\ \fIclient\-id\fR] [\fB\-I\fR\ \fIclient\-id\-prefix\fR] [\fB\-k\fR\ \fIkeepalive\-time\fR] [\fB\-q\fR\ \fImessage\-QoS\fR] [\fB\-\-retain\-handling\fR\ always\ |\ new\ |\ never] [\fB\-V\fR\ \fIprotocol\-version\fR] [\fB\-x\fR\ \fIsession\-expiry\-interval\fR]
.br
[\fB\-\-will\-topic\fR\ \fItopic\fR\ [\fB\-\-will\-payload\fR\ \fIpayload\fR]\ [\fB\-\-will\-qos\fR\ \fIqos\fR]\ [\fB\-\-will\-retain\fR]]
.HP \w'\fBoutput\-options:\fR\ 'u
\fBoutput\-options:\fR
.br
[\fB\-d\fR] [\fB\-N\fR] [\fB\-\-pretty\fR] [\fB\-\-quiet\fR] [\fB\-R\fR] [\fB\-v\fR]
.HP \w'\fBpayload\-options:\fR\ 'u
\fBpayload\-options:\fR
.br
\fB\-f\fR\ \fIfile\fR | \fB\-m\fR\ \fImessage\fR | \fB\-n\fR | \fB\-s\fR 
.HP \w'\fBtls\-certificate\-options:\fR\ 'u
\fBtls\-certificate\-options:\fR
.br
[\fB\-\-no\-tls\fR]
.br
{\fB\-\-cafile\fR\ \fIfile\fR | \fB\-\-capath\fR\ \fIdir\fR}
.br
[\fB\-\-tls\-use\-os\-certs\fR]
.br
[\fB\-\-cert\fR\ \fIfile\fR] [\fB\-\-key\fR\ \fIfile\fR]
.br
[\fB\-\-ciphers\fR\ \fIciphers\fR] [\fB\-\-insecure\fR] [\fB\-\-tls\-alpn\fR\ \fIprotocol\fR] [\fB\-\-tls\-keylog\fR\ \fIfile\fR] [\fB\-\-tls\-version\fR\ \fIversion\fR]
.br
[\fB\-\-tls\-engine\fR\ \fIengine\fR] [\fB\-\-keyform\fR\ {\fIpem\fR\ |\ \fIengine\fR}] [\fB\-\-tls\-engine\-kpass\-sha1\fR\ \fIkpass\-sha1\fR]
.br

.HP \w'\fBtls\-psk\-options:\fR\ 'u
\fBtls\-psk\-options:\fR
.br
\fB\-\-psk\fR\ \fIhex\-key\fR \fB\-\-psk\-identity\fR\ \fIidentity\fR [\fB\-\-ciphers\fR\ \fIciphers\fR] [\fB\-\-tls\-version\fR\ \fIversion\fR]
.HP \w'\fBmosquitto_rr\fR\ 'u
\fBmosquitto_rr\fR [\fB\-\-help\fR] 
.SH "توضیحات (DESCRIPTION)"
.PP
\fBmosquitto_rr\fR
یک کلاینت MQTT نسخهٔ 5/3\&.1\&.1 است که می‌توان از آن برای انتشار پیام درخواست و انتظار برای دریافت پاسخ استفاده کرد\&. هنگام استفاده از MQTT v5 که پیش‌فرض است،
\fBmosquitto_rr\fR
از قابلیت Request\-Response استفاده خواهد کرد\&.
.PP
گزینه‌های مهم عبارتند از
\fB\-t\fR،
\fB\-e\fR و یکی از گزینه‌های
\fB\-f\fR،
\fB\-m\fR،
\fB\-n\fR و
\fB\-s\fR\&.
.PP
مثال:
mosquitto_rr \-t request\-topic \-e response\-topic \-m message
.SH "اتصالات رمزنگاری‌شده (ENCRYPTED CONNECTIONS)"
.PP
این کلاینت از اتصالات رمزنگاری‌شدهٔ TLS پشتیبانی می‌کند\&. اکیداً توصیه می‌شود که برای هر پیکربندی فراتر از ساده‌ترین حالت‌ها، از یک اتصال رمزنگاری‌شده استفاده کنید\&.
.PP
برای فعال‌سازی اتصالات TLS هنگام استفاده از گواهی‌های x509، یکی از گزینه‌های
\fB\-\-cafile\fR
یا
\fB\-\-capath\fR
می‌تواند مشخص شود\&.
.PP
همچنین، در صورتی که از گزینهٔ
\fB\-p 8883\fR
استفاده شود، گواهی‌های ارائه‌شده توسط سیستم‌عامل بارگذاری خواهند شد و نیازی به هیچ‌یک از گزینه‌های
\fB\-\-cafile\fR
یا
\fB\-\-capath\fR
نخواهد بود\&.
.PP
برای فعال‌سازی اتصالات TLS هنگام استفاده از TLS\-PSK، باید از گزینه‌های
\fB\-\-psk\fR
و
\fB\-\-psk\-identity\fR
استفاده کنید\&..SH "گزینه‌ها (OPTIONS)"
.PP
سه روش برای تعیین گزینه‌ها در mosquitto_rr وجود دارد: فایل پیکربندی پیش‌فرض، یک فایل پیکربندی مشخص‌شده، یا گزینه‌ها در خط فرمان\&.
.SS "فایل پیکربندی پیش‌فرض (Default Config File)"
.PP
فایل پیکربندی پیش‌فرض در سیستم‌های پوزیکس (POSIX) در مسیر
\fB$XDG_CONFIG_HOME/mosquitto_rr\fR
یا
\fB$HOME/\&.config/mosquitto_rr\fR
و در ویندوز در مسیر
\fB%USERPROFILE%\emosquitto_rr\fR
قرار دارد\&.
.PP
محتوای فایل پیکربندی باید شامل گزینه‌ها باشد، هر خط یک گزینه در قالب:
\fB\-option \fR\fB\fIvalue\fR\fR\&. اگر گزینه‌ها در خط فرمان نیز مشخص شده باشند، این گزینه‌ها بر همان گزینه‌های تنظیم‌شده در فایل پیکربندی اولویت خواهند داشت و جایگزین آن‌ها می‌شوند\&. استثنای این قاعده گزینه‌های نوع پیام هستند که تنها یکی از آن‌ها را می‌توان مشخص کرد\&. همچنین توجه داشته باشید که در حال حاضر برخی گزینه‌ها را نمی‌توان نفی (غیرفعال) کرد، مانند
\fB\-S\fR\&. گزینه‌های رمزنگاری TLS را می‌توان با گزینهٔ
\fB\-\-no\-tls\fR
نفی (غیرفعال) کرد\&.
.PP
خطوطی از فایل پیکربندی که اولین نویسهٔ آن‌ها
\fB#\fR
باشد، به‌عنوان توضیح (کامنت) در نظر گرفته شده و پردازش نمی‌شوند\&.
.PP
پیشنهاد می‌شود که فایل‌های پیکربندی عمدتاً برای اهداف احراز هویت استفاده شوند\&. استفاده از یک فایل پیکربندی به شما اجازه می‌دهد بدون نیاز به نمایش نام کاربری و گذرواژه در خط فرمان، احراز هویت را انجام دهید\&.
.SS "فایل پیکربندی (Config File)"
.PP
از نسخهٔ 2\&.1 در دسترس است\&.
.PP
یک فایل پیکربندی را می‌توان در خط فرمان با استفاده از
\fB\-o \fR\fB\fIconfig\-file\fR\fR
مشخص کرد\&. در صورت استفاده از گزینهٔ
\fB\-o\fR،
فایل پیکربندی پیش‌فرض بارگذاری نخواهد شد\&.
.PP
قالب آن دقیقاً همانند فایل پیکربندی پیش‌فرض است\&.
.SS "گزینه‌ها (The options)"
.PP
\fB\-A\fR
.RS 4
پیوند دادن اتصال خروجی به یک نشانی IP یا نام میزبان محلی\&. در صورتی که نیاز به محدود کردن ارتباطات شبکه به یک رابط شبکهٔ خاص دارید از این آرگومان استفاده کنید\&.
.RE
.PP
\fB\-c\fR, \fB\-\-disable\-clean\-session\fR
.RS 4
غیرفعال کردن \*(Aqclean session\*(Aq / فعال کردن حالت کلاینت ماندگار (persistent client mode)\&. هنگامی که از این آرگومان استفاده شود، به کارگزار (broker) دستور داده می‌شود که هنگام اتصال کلاینت، نشست‌های موجود برای همان شناسهٔ کلاینت (client id) را پاک نکند، و نشست‌ها با قطع ارتباط کلاینت هرگز منقضی نخواهند شد\&. کلاینت‌های MQTT نسخهٔ ۵ می‌توانند فاصلهٔ زمانی انقضای نشست خود را با آرگومان
\fB\-x\fR
تغییر دهند\&.
.sp
هنگامی که یک نشست روی کارگزار ماندگار شود، اشتراک‌های کلاینت پس از قطع ارتباط، به همراه پیام‌های بعدی QoS 1 و QoS 2 که دریافت می‌شوند حفظ خواهند شد\&. با اتصال مجدد کلاینت و در صورتی که نشست پاک نشود، تمام پیام‌های صف‌بندی‌شده را دریافت خواهد کرد\&.
.sp
در صورت استفاده از این گزینه، شناسهٔ کلاینت باید به‌صورت دستی با
\fB\-\-id\fR
تنظیم شود\&.
.RE
.PP
\fB\-\-cafile\fR
.RS 4
تعیین مسیر فایلی حاوی گواهی‌های CA معتبر با کدگذاری PEM\&. برای فعال‌سازی ارتباطات SSL استفاده می‌شود\&.
.sp
همچنین ببینید:
\fB\-\-capath\fR
.RE
.PP
\fB\-\-capath\fR
.RS 4
تعیین مسیر پوشه‌ای حاوی گواهی‌های CA معتبر با کدگذاری PEM\&. برای فعال‌سازی ارتباطات SSL استفاده می‌شود\&.
.sp
برای اینکه
\fB\-\-capath\fR
به‌درستی کار کند، فایل‌های گواهی باید پسوند "\&.crt" داشته باشند و شما باید هر بار که گواهی‌ای را اضافه یا حذف می‌کنید، دستور "openssl rehash <path to capath>" را اجرا نمایید\&.
.sp
همچنین ببینید:
\fB\-\-cafile\fR
.RE
.PP
\fB\-\-cert\fR
.RS 4
تعیین مسیر فایلی حاوی یک گواهی با کدگذاری PEM برای این کلاینت، در صورتی که سرور آن را الزامی کرده باشد\&.
.sp
همچنین ببینید:
\fB\-\-key\fR
و بخش اتصالات رمزنگاری‌شده (Encrypted Connections)\&.
.RE
.PP
\fB\-\-ciphers\fR
.RS 4
فهرستی از الگوریتم‌های رمزنگاری TLS سازگار با openssl برای پشتیبانی در کلاینت\&. برای اطلاعات بیشتر به
\fBciphers\fR(1)
مراجعه کنید\&.
.RE
.PP
\fB\-d\fR, \fB\-\-debug\fR
.RS 4
فعال‌سازی پیام‌های اشکال‌زدایی (debug)\&.
.RE
.PP
\fB\-D\fR, \fB\-\-property\fR
.RS 4
تنظیم ویژگی‌های MQTT v5 برای این کلاینت\&. اگر از این گزینه استفاده کنید، کلاینت طوری تنظیم می‌شود که کلاینت MQTT v5 باشد\&. این گزینه به دو صورت است:
.sp
\fB\-D command identifier value\fR
.sp
\fB\-D command identifier name value\fR
.sp
\fBcommand\fR
شناسهٔ بسته/دستور MQTT است و می‌تواند یکی از موارد CONNECT، PUBLISH، PUBACK، PUBREC، PUBCOMP، SUBSCRIBE، UNSUBSCRIBE، DISCONNECT، AUTH، یا WILL باشد\&. ویژگی‌های موجود برای هر دستور در بخش ویژگی‌ها (Properties) فهرست شده‌اند\&.
.sp
\fBidentifier\fR
نام ویژگی مورد نظر برای افزودن است\&. این نام همان‌طور که در مشخصات آمده نوشته می‌شود، اما با \*(Aq\-\*(Aq به‌عنوان جداکنندهٔ کلمات\&. برای مثال:
\fBpayload\-format\-indicator\fR\&. جزئیات بیشتر در بخش
ویژگی‌ها (Properties)
آمده است\&.
.sp
\fBvalue\fR
مقدار ویژگی مورد نظر برای افزودن است، با نوع داده‌ای که مختص به آن ویژگی است\&.
.sp
\fBname\fR
تنها برای ویژگی
\fBuser\-property\fR
به‌عنوان اولین رشته از جفت‌رشته‌ها استفاده می‌شود\&. در این حالت،
\fBvalue\fR
رشتهٔ دوم از این جفت خواهد بود\&.
.RE
.PP
\fB\-e\fR
.RS 4
موضوع پاسخ (response topic)\&. کلاینت برای منتظر ماندن جهت دریافت پاسخ، در این موضوع مشترک خواهد شد\&.
.RE
.PP
\fB\-f\fR, \fB\-\-file\fR
.RS 4
ارسال محتویات یک فایل به‌عنوان پیام\&.
.RE
.PP
\fB\-F\fR
.RS 4
مشخص کردن قالب چاپ خروجی\&. این گزینه به شما امکان می‌دهد انتخاب کنید چه اطلاعاتی از هر پیام بر روی صفحه چاپ شود\&. برای جزئیات کامل، بخش
قالب خروجی (Output Format)
را در زیر مشاهده کنید\&.
.sp
این گزینه بر گزینهٔ
\fB\-v\fR
اولویت دارد، اما جایگزین گزینهٔ
\fB\-N\fR
نمی‌شود\&.
.RE
.PP
\fB\-\-help\fR
.RS 4
نمایش اطلاعات نحوهٔ استفاده\&.
.RE
.PP
\fB\-h\fR, \fB\-\-host\fR
.RS 4
مشخص کردن میزبانی که باید به آن متصل شد\&. پیش‌فرض localhost است\&.
.RE
.PP
\fB\-i\fR, \fB\-\-id\fR
.RS 4
شناسه‌ای که برای این کلاینت استفاده می‌شود\&. اگر داده نشود، بسته به نسخهٔ MQTT مورد استفاده، یک شناسهٔ کلاینت ایجاد خواهد شد\&. برای v3\&.1\&.1/v3\&.1، کلاینت یک شناسه با قالب
\fBmosq\-XXXXXXXXXXXXXXXXXX\fR
تولید می‌کند که در آن
\fBX\fRها
با نویسه‌های تصادفی الفبایی-عددی جایگزین می‌شوند\&. برای v5\&.0، کلاینت یک شناسه با طول صفر می‌فرستد و سرور یک شناسه برای کلاینت تولید خواهد کرد\&.
.RE
.PP
\fB\-I\fR, \fB\-\-id\-prefix\fR
.RS 4
پیشوندی ارائه می‌دهد که شناسهٔ کلاینت با الحاق شناسهٔ فرایند (PID) کلاینت به انتهای آن ساخته می‌شود\&. این گزینه زمانی مفید است که کارگزار از گزینهٔ clientid_prefixes استفاده می‌کند\&. نمی‌توان آن را هم‌زمان با آرگومان
\fB\-\-id\fR
استفاده کرد\&.
.RE
.PP
\fB\-\-insecure\fR
.RS 4
هنگام استفاده از رمزنگاری مبتنی بر گواهی، این گزینه اعتبارسنجی نام میزبان سرور در گواهی سرور را غیرفعال می‌کند\&. این می‌تواند هنگام آزمایش پیکربندی‌های اولیهٔ سرور مفید باشد اما برای یک شخص ثالث مخرب این امکان را فراهم می‌کند که مثلاً از طریق جعل DNS (DNS spoofing) خود را به جای سرور شما جا بزند\&. از این گزینه تنها در محیط آزمایش استفاده کنید\&. اگر ناچار به استفاده از این گزینه در یک محیط عملیاتی شدید، راه‌اندازی و پیکربندی شما ایراد دارد و استفاده از رمزنگاری بی‌فایده است\&.
.RE
.PP
\fB\-k\fR, \fB\-\-keepalive\fR
.RS 4
تعداد ثانیه‌های بین ارسال دستورات PING به کارگزار به‌منظور مطلع ساختن آن از اتصال و عملکرد صحیح ما\&. پیش‌فرض ۶۰ ثانیه است\&.
.RE
.PP
\fB\-\-key\fR
.RS 4
تعیین مسیر فایلی حاوی یک کلید خصوصی با کدگذاری PEM برای این کلاینت، جهت انجام TLS دوطرفه (mutual TLS) با سرور\&.
.sp
همچنین ببینید:
\fB\-\-cert\fR
و بخش اتصالات رمزنگاری‌شده (Encrypted Connections)\&.
.RE
.PP
\fB\-\-keyform\fR
.RS 4
نوع کلید خصوصی مورد استفاده هنگام برقراری اتصالات TLS را مشخص می‌کند\&. این می‌تواند "pem" یا "engine" باشد\&. این پارامتر زمانی مفید است که از ماژول TPM استفاده می‌شود و کلید خصوصی با آن ایجاد شده باشد\&. مقدار پیش‌فرض "pem" است، که به معنی استفاده از فایل‌های کلید خصوصی معمولی است\&.
.sp
همچنین ببینید:
\fB\-\-tls\-engine\fR\&.
.RE
.PP
\fB\-L\fR, \fB\-\-url\fR
.RS 4
مشخص کردن هم‌زمان کاربر، گذرواژه، نام میزبان، پورت و موضوع (topic) در قالب یک URL\&. این URL باید به شکل mqtt(s)://[username[:password]@]host[:port]/topic یا ws(s)://[username[:password]@]host[:port]/path باشد\&.
.sp
بسته به طرح‌واره (scheme)، پورت به‌طور پیش‌فرض مقادیر متفاوتی خواهد داشت: mqtt:// \- 1883، mqtts:// \- 8883، ws:// \- 80، wss:// \- 443\&.
.RE.PP
\fB\-\-latency\fR
.RS 4
از نسخهٔ 2\&.1 موجود است\&.
.sp
اگر این گزینه مشخص شود، mosquitto_rr تاخیر بین شروع انتشار درخواست و رسیدن پاسخ را چاپ خواهد کرد\&. این عدد شامل زمان‌های پردازش کارگزار و کلاینت، و همچنین هرگونه تاخیر ذاتی شبکه است\&.
.sp
می‌توان از این قابلیت برای اندازه‌گیری بسیار سادهٔ تاخیر تحویل پیام با تعیین یک موضوع (topic) یکسان برای درخواست و پاسخ استفاده کرد\&.
.sp
هنگام استفاده از
\fB\-\-latency\fR،
گزینهٔ
\fB\-\-nodelay\fR
به‌طور خودکار استفاده خواهد شد\&.
.RE
.PP
\fB\-m\fR, \fB\-\-message\fR
.RS 4
ارسال یک پیام درخواست تکی از خط فرمان\&.
.RE
.PP
\fB\-N\fR
.RS 4
عدم افزودن نویسهٔ پایان خط به بار داده (payload) هنگام چاپ\&. این کار امکان جاری‌سازی داده‌های بار داده از چندین پیام را به‌طور مستقیم و بدون تغییر به برنامه‌ای دیگر فراهم می‌کند\&. تنها زمانی که از
\fB\-v\fR
استفاده نشود واقعاً معنادار است\&.
.RE
.PP
\fB\-n\fR, \fB\-\-null\-message\fR
.RS 4
ارسال یک پیام تهی (طول صفر)\&.
.RE
.PP
\fB\-\-nodelay\fR
.RS 4
غیرفعال کردن الگوریتم Nagle برای سوکت\&. این بدان معناست که تاخیر پیام‌های ارسالی کاهش می‌یابد، که به‌ویژه برای پیام‌های کوچک و نسبتاً کم‌تکرار مشهود است\&. استفاده از این گزینه ممکن است منجر به ارسال بسته‌های بیشتری نسبت به حالت عادی شود\&.
.RE
.PP
\fB\-\-no\-tls\fR
.RS 4
از نسخهٔ 2\&.1 موجود است\&.
.sp
غیرفعال کردن تمام موارد استفاده از رمزنگاری TLS\&. این در صورتی مفید است که گزینه‌های TLS را در یک فایل پیکربندی مشخص کرده باشید اما بخواهید آن گزینه‌ها را غیرفعال کنید\&. همچنین استفادهٔ خودکار از TLS را هنگام اتصال به درگاه 8883 متوقف می‌کند\&.
.RE
.PP
\fB\-o\fR \fIconfig\-file\fR
.RS 4
از نسخهٔ 2\&.1 موجود است\&.
.sp
بارگیری گزینه‌ها از یک فایل پیکربندی\&. بخش‌های Default Config File و Config File را در ابتدای بخش گزینه‌ها ببینید\&.
.RE
.PP
\fB\-p\fR, \fB\-\-port\fR
.RS 4
اتصال به درگاه مشخص‌شده\&. در صورت مشخص نشدن، مقدار پیش‌فرض 1883 برای MQTT ساده یا 8883 برای MQTT بر بستر TLS استفاده خواهد شد\&.
.RE
.PP
\fB\-P\fR, \fB\-\-pw\fR
.RS 4
ارائهٔ گذرواژه‌ای برای استفاده در احراز هویت با کارگزار\&. استفاده از این آرگومان بدون تعیین نام کاربری هنگام استفاده از MQTT نسخهٔ 3\&.1 یا 3\&.1\&.1 نامعتبر است\&.
.sp
همچنین گزینهٔ
\fB\-\-username\fR
را ببینید\&.
.RE
.PP
\fB\-\-pretty\fR
.RS 4
هنگام استفاده از قالب خروجی JSON یعنی %j یا %J، پیش‌فرض چاپ به‌صورت قالب‌بندی‌نشده است\&. مشخص کردن
\fB\-\-pretty\fR
پیام‌ها را در قالبی زیباتر و خواناتر برای انسان چاپ می‌کند\&.
.RE
.PP
\fB\-\-proxy\fR
.RS 4
مشخص کردن یک پراکسی SOCKS5 برای اتصال از طریق آن\&. انواع احراز هویت "None" و "username" پشتیبانی می‌شوند\&. مقدار
\fBsocks\-url\fR
باید به فرم
\fBsocks5h://[username[:password]@]host[:port]\fR
باشد\&. پیشوند پروتکل
\fBsocks5h\fR
بدان معناست که نام‌های میزبان توسط پراکسی تحلیل (resolve) می‌شوند\&. نمادهای %25، %3A و %40 در صورت وجود در نام کاربری یا گذرواژه، به‌ترتیب به %، : و @ تبدیل می‌شوند\&.
.sp
اگر نام کاربری داده نشود، تلاشی برای احراز هویت انجام نمی‌شود\&. اگر درگاه داده نشود، پیش‌فرض 1080 استفاده خواهد شد\&.
.sp
اگر میزبان به‌صورت نشانی IPv6 داده شود، باید داخل قلاب‌ها قرار گیرد، مثلاً
\fBsocks5h://[::1]:1080\fR\&.
توجه داشته باشید که قلاب‌ها در برخی پوسته‌ها معنای خاصی دارند، بنابراین ممکن است لازم باشد نشانی url پراکسی داخل علامت نقل‌قول تکی یا دوتایی قرار گیرد\&.
.sp
نسخه‌های بیشتری از SOCKS ممکن است بسته به تقاضا در آینده در دسترس قرار گیرند، و همان‌طور که در
\fBcurl\fR(1)
توضیح داده شده است از پیشوندهای پروتکل متفاوتی استفاده خواهند کرد\&.
.RE
.PP
\fB\-\-psk\fR
.RS 4
ارائهٔ کلید از پیش اشتراک‌گذاشته‌شده (pre\-shared\-key) در مبنای شانزده (بدون 0x در ابتدا) منطبق بر کلید استفاده‌شده در کارگزار جهت استفاده از پشتیبانی رمزنگاری TLS\-PSK\&.
برای فعال‌سازی TLS\-PSK باید
\fB\-\-psk\-identity\fR
نیز ارائه شود\&.
.RE
.PP
\fB\-\-psk\-identity\fR
.RS 4
شناسهٔ کلاینت برای استفاده همراه با پشتیبانی TLS\-PSK\&. در صورتی که کارگزار برای این کار پیکربندی شده باشد، این مورد می‌تواند به‌جای نام کاربری استفاده شود\&.
.RE
.PP
\fB\-q\fR, \fB\-\-qos\fR
.RS 4
تعیین کیفیت خدمات (QoS) مورد نظر برای پیام‌های دریافتی، از میان 0، 1 و 2\&. پیش‌فرض 0 است\&. برای اطلاعات بیشتر دربارهٔ QoS به
\fBmqtt\fR(7)
مراجعه کنید\&.
.sp
این QoS برای تمام موضوعاتی که در یک نمونهٔ تکی از این کلاینت مشترک شده‌اند اعمال می‌شود\&.
.RE
.PP
\fB\-\-quiet\fR
.RS 4
اگر این آرگومان داده شود، هیچ خطای زمان اجرایی چاپ نخواهد شد\&. این مورد پیام‌های خطایی که در صورت ورودی نامعتبر کاربر داده می‌شوند (مانند استفاده از
\fB\-\-port\fR
بدون درگاه) را شامل نمی‌شود\&.
.RE
.PP
\fB\-R\fR
.RS 4
اگر این آرگومان داده شود، پیام‌های دریافتی که بیت retain آن‌ها تنظیم شده است چاپ نخواهند شد\&. پیام‌های دارای retain تنظیم‌شده «کهنه» هستند، از این جهت که معلوم نیست در ابتدا چه زمانی منتشر شده‌اند\&. هنگام اشتراک در یک موضوع عامه‌منظور (wildcard)، ممکن است تعداد زیادی پیام نگه‌داشته‌شده وجود داشته باشد\&. این آرگومان نمایش آن‌ها را متوقف می‌کند\&.
.sp
همچنین
\fB\-\-retain\-handling\fR
را ببینید\&.
.RE
.PP
\fB\-\-retain\-handling\fR always | new | never
.RS 4
از نسخهٔ 2\&.1 موجود است\&.
.sp
از این گزینه برای کنترل نحوهٔ مدیریت نگه‌داری (retain handling) هنگام ایجاد اشتراک استفاده کنید\&. این گزینه کنترل می‌کند که یک پیام نگه‌داشته‌شدهٔ (retained) موجود تحت چه شرایطی هنگام اشتراک به کلاینت فرستاده شود\&.
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBalways\fR
\- همیشه پیام‌های نگه‌داشته‌شده تحویل داده شوند
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBnew\fR
\- پیام‌های نگه‌داشته‌شده در اولین باری که اشتراک ایجاد می‌شود تحویل داده شوند، اما در اشتراک‌های بعدی خیر\&. این گزینه برای حالتی مفید است که کلاینتی با اجرای طولانی‌مدت دارید که از یک نشست غیرپاک (non\-clean session) استفاده می‌کند\&. اگر اتصال برای مدت کوتاهی قطع شود، هنگام اتصال مجدد کلاینت، پیام‌های نگه‌داشته‌شده را دوباره دریافت نخواهید کرد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBnever\fR
\- هرگز پیام‌های نگه‌داشته‌شده تحویل داده نشوند
.RE
.RE
.PP
\fB\-S\fR
.RS 4
استفاده از جستجوهای SRV برای تعیین میزبان جهت اتصال به آن\&. در صورت استفاده در ترکیب با
\fB\-h\fR،
جستجوها را برای
\fB_mqtt\&._tcp\&.<host>\fR
انجام می‌دهد، در غیر این صورت از
\fB_mqtt\&._tcp\&.<local dns domain>\fR
استفاده می‌کند\&.
.RE
.PP
\fB\-s\fR, \fB\-\-stdin\-file\fR
.RS 4
ارسال یک پیام درخواست خوانده‌شده از stdin، با ارسال کل محتوا به‌صورت یک پیام تکی\&.
.RE
.PP
\fB\-t\fR, \fB\-\-topic\fR
.RS 4
موضوع (topic) در MQTT که پیام درخواست به آن ارسال خواهد شد\&.
.RE
.PP
\fB\-\-tls\-alpn\fR
.RS 4
ارائهٔ پروتکلی برای استفاده هنگام اتصال به کارگزاری که چندین پروتکل را روی یک درگاه منفرد ارائه می‌دهد، مانند MQTT و WebSockets\&.
.RE
.PP
\fB\-\-tls\-engine\fR
.RS 4
یک شناسهٔ موتور معتبر openssl\&. این شناسه‌ها را می‌توان با دستور
\fBopenssl engine\fR
فهرست کرد\&.
.sp
همچنین
\fB\-\-keyform\fR
را ببینید\&.
.RE.PP
\fB\-\-tls\-engine\-kpass\-sha1\fR
.RS 4
هش SHA1 گذرواژهٔ کلید خصوصی هنگام استفاده از یک موتور TLS\&. برخی از موتورهای TLS مانند موتور TPM ممکن است برای دسترسی نیازمند گذرواژه باشند\&. این گزینه اجازه می‌دهد هش SHA1 کدگذاری‌شده در مبنای ۱۶ (hex) گذرواژه مستقیماً به موتور ارسال شود، به جای اینکه از کاربر درخواست گذرواژه شود\&.
.sp
همچنین ببینید
\fB\-\-tls\-engine\fR\&.
.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\-\-tls\-use\-os\-certs\fR
.RS 4
در صورت استفاده، گواهی‌های CA ارائه‌شده توسط سیستم‌عامل بارگذاری شده و مورد اعتماد قرار می‌گیرند\&. این گزینه می‌تواند در کنار
\fB\-\-cafile\fR
و
\fB\-\-capath\fR
استفاده شود، یا می‌تواند به تنهایی برای فعال‌سازی حالت TLS به کار رود\&. در صورتی که از
\fB\-L mqtts://\&.\&.\&.\fR
استفاده شود، یا اگر درگاه 8883 باشد و هیچ گزینهٔ گواهی دیگری استفاده نشده باشد، این گزینه به طور پیش‌فرض تنظیم خواهد شد\&.
.RE
.PP
\fB\-\-tls\-version\fR
.RS 4
انتخاب اینکه از کدام نسخهٔ پروتکل TLS هنگام ارتباط با کارگزار استفاده شود\&. گزینه‌های معتبر عبارتند از
\fBtlsv1\&.3\fR
و
\fBtlsv1\&.2\fR\&. مقدار پیش‌فرض
\fBtlsv1\&.2\fR
است\&. باید با نسخهٔ پروتکل استفاده‌شده توسط کارگزار مطابقت داشته باشد\&.
.RE
.PP
\fB\-u\fR, \fB\-\-username\fR
.RS 4
ارائهٔ یک نام کاربری برای احراز هویت با کارگزار\&.
.sp
همچنین آرگومان
\fB\-\-pw\fR
را ببینید\&.
.RE
.PP
\fB\-\-unix\fR
.RS 4
اتصال به کارگزار از طریق یک سوکت دامنهٔ یونیکس (unix domain socket) محلی به جای سوکت TCP\&. این یک جایگزین برای
\fB\-h\fR
و
\fB\-L\fR
است\&. برای مثال:
\fBmosquitto_pub \-\-unix /tmp/mosquitto\&.sock \&.\&.\&.\fR
.sp
گزینهٔ
\fBsocket_domain\fR
در
\m[blue]\fBmosquitto\&.conf\fR\m[](5)
را برای پیکربندی Mosquitto جهت گوش دادن روی یک سوکت یونیکس ببینید\&.
.RE
.PP
\fB\-v\fR, \fB\-\-verbose\fR
.RS 4
چاپ پیام‌های دریافت شده با جزئیات کامل (verbose)\&. با این آرگومان، پیام‌ها به صورت "topic payload" چاپ خواهند شد\&. وقتی این آرگومان داده نشود، پیام‌ها به صورت "payload" چاپ می‌شوند\&.
.sp
همچنین ببینید
\fB\-F\fR\&.
.RE
.PP
\fB\-V\fR, \fB\-\-protocol\-version\fR
.RS 4
مشخص کردن اینکه کدام نسخه از پروتکل MQTT باید هنگام اتصال به کارگزار راه دور استفاده شود\&. می‌تواند
\fB5\fR،
\fB311\fR،
\fB31\fR
یا مقادیر مفصل‌ترِ
\fBmqttv5\fR،
\fBmqttv311\fR
یا
\fBmqttv31\fR
باشد\&. پیش‌فرض آن
\fB311\fR
است\&.
.RE
.PP
\fB\-W\fR
.RS 4
تعیین یک مهلت زمانی (timeout) به صورت یک عدد صحیح از ثانیه‌ها\&. کلاینت پس از سپری شدن این تعداد ثانیه، پردازش پیام‌ها را متوقف کرده و اتصال را قطع می‌کند\&. شمارش مهلت زمانی درست پس از اتصال کلاینت به کارگزار آغاز می‌شود\&.
.RE
.PP
\fB\-\-will\-payload\fR
.RS 4
مشخص کردن پیامی که توسط کارگزار ذخیره شده و در صورتی که اتصال این کلاینت به‌طور غیرمنتظره قطع شود ارسال خواهد شد\&. این گزینه باید همراه با
\fB\-\-will\-topic\fR
استفاده شود\&.
.RE
.PP
\fB\-\-will\-qos\fR
.RS 4
سطح کیفیت خدمات (QoS) مورد استفاده برای پیام وصیت (Will)\&. پیش‌فرض 0 است\&. این گزینه باید همراه با
\fB\-\-will\-topic\fR
استفاده شود\&.
.RE
.PP
\fB\-\-will\-retain\fR
.RS 4
در صورت تعیین، اگر کلاینت به‌طور غیرمنتظره قطع شود، پیام ارسال‌شده به عنوان یک پیام ماندگار (retained message) در نظر گرفته خواهد شد\&. این گزینه باید همراه با
\fB\-\-will\-topic\fR
استفاده شود\&.
.RE
.PP
\fB\-\-will\-topic\fR
.RS 4
موضوعی (topic) که در صورت قطع اتصال غیرمنتظرهٔ کلاینت، پیام وصیت (Will) روی آن ارسال خواهد شد\&.
.RE
.PP
\fB\-\-ws\fR
.RS 4
اتصال با استفاده از وب‌سوکت‌ها (WebSockets) به جای TCP ساده\&.
.RE
.PP
\fB\-x\fR
.RS 4
تنظیم مشخصهٔ session\-expiry\-interval روی بستهٔ CONNECT\&. اگر از این گزینه استفاده کنید، کلاینت به عنوان یک کلاینت MQTT v5 تنظیم خواهد شد\&. برای مشخص کردن اینکه نشست (session) پس از قطع اتصال کلاینت تا چند ثانیه بعد منقضی شود، آن را بین 0\-4294967294 تنظیم کنید، یا از \-1، 4294967295 یا ∞ برای نشستی که هرگز منقضی نمی‌شود استفاده کنید\&. در صورتی که \-c نیز مشخص شده باشد، پیش‌فرض \-1 و در صورت عدم تعیین \-c برابر با 0 است\&.
.sp
اگر نشست طوری تنظیم شده باشد که هرگز منقضی نشود (خواه با \-x یا با \-c)، باید یک شناسهٔ کلاینت (client id) ارائه گردد\&.
.RE.SH "قالب خروجی (OUTPUT FORMAT)"
.PP
سه روش برای قالب‌بندی خروجی چاپ‌شده وجود دارد\&. در تمام حالات، یک نویسهٔ خط‌جدید (newline) به ازای هر پیام دریافت‌شده اضافه می‌شود، مگر اینکه آرگومان
\fB\-N\fR
داده شده باشد\&.
.PP
حالت «فقط بار داده» (Payload\-only) قالب خروجی پیش‌فرض است و بار داده (payload) را دقیقاً همان‌گونه که دریافت شده است چاپ می‌کند\&.
.PP
حالت پرگو (verbose) با
\fB\-v\fR
فعال می‌شود و موضوع (topic) پیام و بار داده را، جداشده با یک فاصله، چاپ می‌کند\&.
.PP
گزینهٔ نهایی خروجی قالب‌بندی‌شده است که به کاربر اجازه می‌دهد یک قالب خروجی سفارشی تعیین کند\&. این رفتار با گزینهٔ
\fB\-F format\-string\fR
کنترل می‌شود\&. رشتهٔ قالب (format string) یک رشته متنی آزاد است که در آن دنباله‌های تفسیری با پارامترهای مختلف جایگزین می‌شوند\&. دنباله‌های تفسیری موجود در زیر شرح داده شده‌اند\&.
.PP
سه نویسه برای شروع یک دنبالهٔ تفسیری استفاده می‌شوند:
\fB%\fR،
\fB@\fR
و
\fB\e\fR\&. دنباله‌هایی که با
\fB%\fR
آغاز می‌شوند یا پارامترهای مربوط به پیام MQTT در حال چاپ هستند، یا دنباله‌های کمکی هستند تا برای مثال از لزوم نوشتن رشته‌های طولانی قالب تاریخ جلوگیری شود\&. دنباله‌هایی که با
\fB@\fR
آغاز می‌شوند به تابع
\fBstrftime\fR(3)
منتقل می‌شوند (با جایگزین شدن @ با یک % \- توجه داشته باشید که تنها نویسهٔ بلافاصله پس از @ به strftime فرستاده می‌شود)\&. این قابلیت امکان ساخت طیف گسترده‌ای از خروجی‌های مبتنی بر زمان را فراهم می‌کند\&. گزینه‌های خروجی strftime از سکویی به سکوی دیگر متفاوت است، بنابراین لطفاً موارد موجود برای سکوی خود را بررسی کنید\&. یک افزونه برای strftime ارائه شده است که
\fB@N\fR
می‌باشد و می‌توان از آن برای به‌دست آوردن تعداد نانوثانیه‌های سپری‌شده از ثانیهٔ فعلی استفاده کرد\&. تفکیک‌پذیری (resolution) این گزینه بسته به سکو متغیر است\&. آخرین نویسهٔ دنباله
\fB\e\fR
است که برای وارد کردن برخی نویسه‌ها به کار می‌رود که در غیر این صورت درج آن‌ها دشوار می‌بود\&.
.SS "نویسه‌های پرچم (Flag characters)"
.PP
پارامترهای %A، %C، %d، %E، %F، %f، %I، %l، %m، %p، %R، %S، %t، %x و %X می‌توانند بلافاصله پس از نویسهٔ % پرچم‌های اختیاری داشته باشند\&.
.PP
\fB0\fR
.RS 4
مقدار باید با صفر پر شود (zero-padded)\&. این مورد برای پارامترهای %A، %E، %d، %F، %f، %l، %m، %S، %X و %x اعمال می‌شود\&. برای سایر پارامترها نادیده گرفته خواهد شد\&. اگر به همراه پرچم
\fB\-\fR
استفاده شود، پرچم
\fB0\fR
نادیده گرفته خواهد شد\&.
.RE
.PP
\fB\-\fR
.RS 4
مقدار نسبت به عرض فیلد، چپ‌چین شده و با نویسه‌های خالی (فاصله‌ها) پر خواهد شد\&. حالت پیش‌فرض راست‌چین است، که با 0 یا با فاصله پر می‌شود\&.
.RE
.SS "عرض فیلد (Field width)"
.PP
برخی از پارامترهای مربوط به MQTT را می‌توان با گزینه‌ای برای تعیین عرض فیلد آن‌ها به شیوه‌ای مشابه با قالب‌های معمول سبک printf قالب‌بندی کرد، یعنی این گزینه حداقل عرض را هنگام چاپ این پارامتر تعیین می‌کند\&. اگر طول خروجی کوچک‌تر از این عرض باشد، فیلد برای رسیدن به این عرض پر (pad) می‌شود\&. این مورد برای گزینه‌های %A، %C، %d، %E، %F، %f، %I، %l، %m، %p، %R، %S، %t، %x و %X اعمال می‌گردد\&.
.PP
برای مثال
\fB%10t\fR
حداقل عرض فیلد موضوع (topic) را روی ۱۰ نویسه تنظیم می‌کند\&.
.SS "حداکثر عرض (Maximum width)"
.PP
برخی از پارامترهای مربوط به MQTT را می‌توان با گزینه‌ای برای تعیین حداکثر عرض فیلد به شیوه‌ای مشابه با قالب‌های معمول سبک printf قالب‌بندی کرد، برای مثال
\fB%\&.20t\fR
برای حداکثر عرض ۲۰\&. این مورد برای گزینه‌های %C، %I، %R و %t اعمال می‌شود\&.
.PP
برای مثال
\fB%10\&.10t\fR
حداقل عرض فیلد موضوع را روی ۱۰ نویسه و حداکثر عرض موضوع را روی ۱۰ نویسه تنظیم می‌کند، یعنی این فیلد همواره دقیقاً ۱۰ نویسه طول خواهد داشت\&.
.SS "عرض فیلد دودویی هگزادسیمال (Hexadecimal binary field width)"
.PP
پارامترهای %x و %X بار داده را به طور پیش‌فرض به عنوان یک رشتهٔ هگزادسیمال تکی خروجی می‌دهند\&. همچنین می‌توان بار دادهٔ هگزادسیمال را بر اساس طول انتخابی از نیم‌بایت‌ها (nibble) به فیلدهایی تقسیم کرد\&. برای مثال،
\fB%\&.2x\fR
بار داده را به مقادیر دو نیم‌بایتی یا یک‌بایتی، جداشده با فاصله، تقسیم می‌کند و ممکن است خروجی‌ای مانند
18 83
تولید کند\&.
.PP
نویسهٔ جداکننده به طور پیش‌فرض یک فاصله است، اما می‌توان با افزودن آن نویسه پس از عرض فیلد دودویی، آن را به یکی از
\fB!"#$&\*(Aq()*+,\-\&./:;<=>?@[\e]^_`{|}~\fR
تغییر داد\&. برای مثال
\fB%\&.2:x\fR
ممکن است خروجی‌ای مانند
18:83
تولید کند\&.
.SS "ملاحظات چاپ اعداد ممیز شناور (Floating point number printing consideration)"
.PP
قالب خروجی تنها از استاندارد ممیز شناور IEEE 754 به همان صورتی که در پیوست F از ISO/IEC 9899:1999 شرح داده شده، پشتیبانی می‌کند\&. اگر سکوی منتشرکننده از استاندارد نمایش ممیز شناور دیگری به جز IEEE 754 استفاده می‌کند، سعی نکنید از %f یا %d استفاده کنید، چرا که داده‌های نامعتبر دریافت خواهید کرد\&. اگر مطمئن نیستید سکوی شما از چه نمایش ممیز شناوری استفاده می‌کند، به احتمال بسیار زیاد IEEE 754 است\&. اگر با مقادیر ناهنجار یا غیرمنتظره مواجه شدید، بررسی کنید که آیا عدد ممیز شناور در بار دادهٔ ارسال‌شده از سمت منتشرکننده در استاندارد IEEE 754 کدگذاری شده است یا خیر\&.
.PP
اگر می‌خواهید اعداد اعشاری شناور را چاپ کنید، مطمئن شوید که تنها در موضوعاتی مشترک می‌شوید که فقط اعداد اعشاری با قالب‌بندی IEEE 754 ارسال می‌کنند\&. پردازش در مورد اعداد اعشاری بسیار سخت‌گیرانه است و در صورت دریافت هر چیزی به جز ممیز شناور، یک پیام خطا چاپ خواهد شد\&.
.SS "پارامترهای مربوط به MQTT (MQTT related parameters)"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB%%\fR
یک نویسهٔ واقعی %\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB%A\fR
ویژگی topic\-alias در MQTT v5، در صورت وجود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB%C\fR
ویژگی content\-type در MQTT v5، در صورت وجود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB%D\fR
ویژگی correlation\-data در MQTT v5، در صورت وجود\&. توجه داشته باشید که این ویژگی به عنوان دادهٔ دودویی مشخص شده است، بنابراین ممکن است نویسه‌های غیرقابل‌چاپ تولید کند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB%d\fR
بار داده به عنوان یک عدد ممیز شناور ۸ بایتی IEEE 754 (دوبل/double) در نظر گرفته می‌شود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB%E\fR
ویژگی message\-expiry\-interval در MQTT v5، در صورت وجود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB%F\fR
ویژگی payload\-format\-indicator در MQTT v5، در صورت وجود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB%f\fR
بار داده به عنوان یک عدد ممیز شناور ۴ بایتی IEEE 754 در نظر گرفته می‌شود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB%l\fR
طول بار داده به بایت\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB%m\fR
شناسهٔ پیام (تنها برای پیام‌های با QoS>0 مربوط است)\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1.IP \(bu 2.3
.\}
\fB%P\fR
ویژگی user\-property در MQTT v5 در صورت وجود\&. این ویژگی در قالب key:value چاپ خواهد شد\&. ممکن است هر تعدادی از ویژگی‌های کاربر به یک پیام پیوست شده باشند و کلیدهای تکراری وجود داشته باشد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB%p\fR
بایت‌های خام محموله (payload) (بسته به محموله ممکن است نویسه‌های غیرقابل‌چاپ تولید کند)\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB%q\fR
سطح کیفیت خدمات (QoS) پیام\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB%R\fR
ویژگی response\-topic در MQTT v5 در صورت وجود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB%r\fR
پرچم نگه‌داشته‌شده (retained flag) برای پیام\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB%S\fR
ویژگی subscription\-identifier در MQTT v5 در صورت وجود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB%t\fR
موضوع (topic) پیام\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB%x\fR
محموله (payload) همراه با هر بایت به صورت یک عدد هگزادسیمال (حروف کوچک)\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB%X\fR
محموله (payload) همراه با هر بایت به صورت یک عدد هگزادسیمال (حروف بزرگ)\&.
.RE
.SS "کمکی‌ها (Helpers)"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB%I\fR
تاریخ و زمان در قالب ISO\-8601، برای نمونه 2016\-08\-10T09:47:38+0100
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB%j\fR
خروجی JSON از پارامترهای پیام و مهر زمانی (timestamp)، همراه با محموله‌ای داخل نقل‌قول و گریز داده شده (escaped)\&. برای نمونه:
{"tst":"2020\-05\-06T22:12:00\&.000000+0100","topic":"greeting","qos":0,"retain":0,"payload":"hello world"}
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB%J\fR
خروجی JSON از پارامترهای پیام و مهر زمانی (timestamp)، همراه با محموله‌ای بدون علامت نقل‌قول و بدون گریز \- بدین معنی که خود محموله باید JSON معتبر باشد\&. برای نمونه:
{"tst":"2020\-05\-06T22:12:00\&.000000+0100","topic":"foo","qos":0,"retain":0,"payload":{"temperature":27\&.0,"humidity":57}}\&.
.sp
اگر محموله یک JSON معتبر نباشد، پیام خطای "Error: Message payload is not valid JSON on topic <topic>" در stderr چاپ خواهد شد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB%U\fR
مهر زمانی یونیکس (Unix timestamp) با نانوثانیه، برای نمونه 1470818943\&.786368637
.RE.SS "پارامترهای مرتبط با زمان (Time related parameters)"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB@@\fR
یک نویسه صریح @\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB@X\fR
نویسه نشان‌داده‌شده توسط
\fBX\fR
را به عنوان
\fB%X\fR
به تابع strftime ارسال می‌کند\&. گزینه‌های پشتیبانی‌شده وابسته به پلتفرم هستند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB@N\fR
تعداد نانوثانیه‌های سپری‌شده در ثانیه جاری، با تفکیک‌پذیری زمانی متغیر بسته به پلتفرم\&.
.RE
.SS "نویسه‌های گریز (Escape characters)"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\e\e\fR
یک نویسه صریح \e\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\e0\fR
یک نویسه پوچ (null)\&. می‌تواند برای جداسازی پارامترهای مختلفی که ممکن است حاوی فاصله باشند (مانند topic، payload) استفاده شود تا پردازش با ابزارهایی مانند
\fBxargs\fR(1)
ساده‌تر گردد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\ea\fR
هشدار/زنگ (alert/bell)\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\ee\fR
توالی گریز، که برای نمونه می‌تواند همراه با کدهای رنگی ANSI برای ارائه خروجی رنگی استفاده شود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\en\fR
پایان خط (newline)\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\er\fR
بازگشت به ابتدای سطر (carriage return)\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\et\fR
تب افقی\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\ev\fR
تب عمودی\&.
.RE.SH "وصیت‌ها (WILLS)"
.PP
کلاینت می‌تواند پیامی را نزد کارگزار (broker) ثبت کند که در صورت قطع ارتباط غیرمنتظره ارسال خواهد شد\&. برای اطلاعات بیشتر
\fBmqtt\fR(7)
را ببینید\&.
.PP
حداقل پیش‌نیاز برای این کار، استفاده از
\fB\-\-will\-topic\fR
جهت تعیین موضوعی (topic) است که وصیت باید روی آن ارسال شود\&. این کار منجر به ارسال پیامی بدون ماندگاری (non\-retained)، با طول صفر و با QoS 0 می‌شود\&.
.PP
برای تغییر سایر پارامترهای وصیت از آرگومان‌های
\fB\-\-will\-retain\fR،
\fB\-\-will\-payload\fR
و
\fB\-\-will\-qos\fR
استفاده کنید\&.
.SH "ویژگی‌ها (PROPERTIES)"
.PP
گزینهٔ
\fB\-D\fR
/
\fB\-\-property\fR
امکان افزودن ویژگی‌ها به مراحل مختلف اجرای mosquitto_rr را فراهم می‌کند\&. ویژگی‌های پشتیبانی‌شده برای هر دستور به شرح زیر است:
.SS "اتصال (Connect)"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBauthentication\-data\fR
(دادهٔ دودویی \- توجه: به عنوان یک رشته در نظر گرفته می‌شود)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBauthentication\-method\fR
(جفت رشتهٔ UTF\-8)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBmaximum\-packet\-size\fR
(عدد صحیح ۳۲ بیتی بدون علامت)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBreceive\-maximum\fR
(عدد صحیح ۱۶ بیتی بدون علامت)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBrequest\-problem\-information\fR
(عدد صحیح ۸ بیتی بدون علامت)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBrequest\-response\-information\fR
(عدد صحیح ۸ بیتی بدون علامت)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBsession\-expiry\-interval\fR
(عدد صحیح ۳۲ بیتی بدون علامت، توجه کنید که به جای آن از
\fB\-x\fR
استفاده کنید)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBtopic\-alias\-maximum\fR
(عدد صحیح ۱۶ بیتی بدون علامت)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBuser\-property\fR
(جفت رشتهٔ UTF\-8)
.RE.SS "انتشار (Publish)"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBcontent\-type\fR
(رشته UTF\-8)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBcorrelation\-data\fR
(داده باینری \- توجه: به عنوان یک رشته در نظر گرفته می‌شود)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBmessage\-expiry\-interval\fR
(عدد صحیح بدون علامت ۳۲ بیتی)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBpayload\-format\-indicator\fR
(عدد صحیح بدون علامت ۸ بیتی)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBresponse\-topic\fR
(رشته UTF\-8)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBtopic\-alias\fR
(عدد صحیح بدون علامت ۱۶ بیتی)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBuser\-property\fR
(جفت رشته UTF\-8)
.RE
.SS "اشتراک (Subscribe)"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBuser\-property\fR
(جفت رشته UTF\-8)
.RE
.SS "لغو اشتراک (Unsubscribe)"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBuser\-property\fR
(جفت رشته UTF\-8)
.RE
.SS "قطع اتصال (Disconnect)"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBsession\-expiry\-interval\fR
(عدد صحیح بدون علامت ۳۲ بیتی)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBuser\-property\fR
(جفت رشته UTF\-8)
.RE.SS "ویژگی‌های وصیت (Will properties)"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBcontent\-type\fR
(رشته UTF\-8)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBcorrelation\-data\fR
(داده‌های دودویی \- توجه: به عنوان رشته با آن رفتار می‌شود)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBmessage\-expiry\-interval\fR
(عدد صحیح ۳۲ بیتی بدون علامت)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBpayload\-format\-indicator\fR
(عدد صحیح ۸ بیتی بدون علامت)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBresponse\-topic\fR
(رشته UTF\-8)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBuser\-property\fR
(جفت‌رشته UTF\-8)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBwill\-delay\-interval\fR
(عدد صحیح ۳۲ بیتی بدون علامت)
.RE
.SH "وضعیت خروج (EXIT STATUS)"
.PP
در صورت موفقیت صفر، یا در صورت بروز خطا غیرصفر است\&. اگر اتصال در سطح MQTT توسط کارگزار رد شود، کد خروج همان کد دلیل CONNACK خواهد بود\&. اگر خطای دیگری رخ دهد، کد خروج مقدار بازگشتی libmosquitto است\&.
.PP
کدهای CONNACK در MQTT v3\&.1\&.1:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB0\fR
موفقیت
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB1\fR
اتصال رد شد: نسخه پروتکل نامعتبر
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB2\fR
اتصال رد شد: شناسه پذیرفته نشد
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB3\fR
اتصال رد شد: سرور در دسترس نیست
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB4\fR
اتصال رد شد: نام کاربری/گذرواژه نادرست
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB5\fR
اتصال رد شد: غیرمجاز
.RE
.PP
کدهای CONNACK در MQTT v5:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB0\fR
موفقیت
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB128\fR
خطای نامشخص
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB129\fR
بسته با ساختار نادرست
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1.IP \(bu 2.3
.\}
\fB130\fR
خطای پروتکل
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB131\fR
خطای خاص پیاده‌سازی
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB132\fR
نسخهٔ پشتیبانی‌نشدهٔ پروتکل
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB133\fR
شناسهٔ کلاینت نامعتبر است
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB134\fR
نام کاربری یا گذرواژه نامعتبر است
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB135\fR
فاقد دسترسی (غیرمجاز)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB136\fR
سرور در دسترس نیست
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB137\fR
سرور مشغول است
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB138\fR
مسدودشده
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB139\fR
سرور در حال خاموش شدن است
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB140\fR
روش احراز هویت نامعتبر است
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB141\fR
اتمام مهلت زنده نگه‌داشتن (Keep alive)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB142\fR
نشست تصاحب شده است
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB143\fR
فیلتر موضوع نامعتبر است
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB144\fR
نام موضوع نامعتبر است
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB147\fR
فراتر رفتن از بیشینهٔ دریافت
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB148\fR
نام مستعار موضوع نامعتبر است
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1.IP \(bu 2.3
.\}
\fB149\fR
بسته بیش از حد بزرگ است
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB148\fR
نرخ پیام بیش از حد بالا است
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB151\fR
سهمیه بیش از حد مجاز است
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB152\fR
اقدام مدیریتی
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB153\fR
قالب محموله (Payload) نامعتبر است
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB154\fR
ویژگی Retain پشتیبانی نمی‌شود
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB155\fR
سطح خدمات (QoS) پشتیبانی نمی‌شود
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB156\fR
از سرور دیگری استفاده کنید
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB157\fR
سرور منتقل شده است
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB158\fR
اشتراک‌های مشترک (Shared subscriptions) پشتیبانی نمی‌شوند
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB159\fR
نرخ اتصال بیش از حد مجاز است
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB160\fR
حداکثر زمان اتصال
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB161\fR
شناسه‌های اشتراک (Subscription IDs) پشتیبانی نمی‌شوند
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB162\fR
اشتراک‌های عام (Wildcard subscriptions) پشتیبانی نمی‌شوند
.RE
.PP
سایر کدها:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB27\fR
مهلت زمانی در انتظار دریافت پیام به پایان رسید
.RE.SH "فایل‌ها (FILES)"
.PP
$XDG_CONFIG_HOME/mosquitto_rr, $HOME/\&.config/mosquitto_rr, $HOME/snap/mosquitto/current/\&.config/mosquitto_rr (برای نصب‌های snap)
.RS 4
فایل پیکربندی برای گزینه‌های پیش‌فرض\&.
.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_pub\fR(1), \fBmosquitto_sub\fR(1), \fBmosquitto\fR(8), \fBlibmosquitto\fR(3), \fBmosquitto-tls\fR(7)
.SH "نویسندگان (AUTHORS)"
.PP
Roger Light
<roger@atchoo\&.org>