.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH mqttui-log 1  "log " 
.SH "نام (NAME)"
mqttui\-log \- ثبت مقادیر موضوعات مشترک‌شده در خروجی استاندارد (stdout)
.SH "خلاصه دستور (SYNOPSIS)"
\fBmqttui log\fR [\fB\-j\fR|\fB\-\-json\fR] [\fB\-v\fR|\fB\-\-verbose\fR] [\fB\-\-qos\fR] [\fB\-b\fR|\fB\-\-broker\fR] [\fB\-u\fR|\fB\-\-username\fR] [\fB\-\-password\fR] [\fB\-i\fR|\fB\-\-client\-id\fR] [\fB\-\-ca\-cert\fR] [\fB\-\-client\-cert\fR] [\fB\-\-client\-private\-key\fR] [\fB\-\-insecure\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fITOPIC\fR] 
.SH "توضیحات (DESCRIPTION)"
ثبت مقادیر موضوعات (topics) مشترک‌شده در خروجی استاندارد (stdout)
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-j\fR, \fB\-\-json\fR
خروجی بسته‌های دریافتی به صورت JSON جدا شده با خط جدید (newline\-delimited)
.TP
\fB\-v\fR, \fB\-\-verbose\fR
نمایش کامل ارتباطات MQTT
.TP
\fB\-\-qos\fR \fI<LEVEL>\fR [پیش‌فرض: 2]
حداکثر سطح کیفیت خدمات (`QoS`) برای اشتراک‌ها و ارسال پیام‌ها.

سطح کیفیت خدمات پایین‌تر میان ارسال‌کننده و مشترک، از کارگزار به مشترک تحویل داده می‌شود؛ بنابراین، اشتراک با سطح 0 هرگز پیام‌های با سطح 1 یا 2 را دریافت نخواهد کرد. ارسال با سطح 2، هنگام اشتراک با سطح 1، به عنوان 1 دریافت خواهد شد.

\- 0: حداکثر یک بار (fire and forget یا ارسال بدون پیگیری)

\- 1: حداقل یک بار (تحویل تاییدشده با احتمال وجود نسخه‌های تکراری)

\- 2: دقیقاً یک بار (تحویل تضمین‌شده بدون موارد تکراری)
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBMQTTUI_QOS\fR مشخص شود.
.RE
.TP
\fB\-h\fR, \fB\-\-help\fR
چاپ راهنما (مشاهده خلاصه با \*(Aq\-h\*(Aq)
.TP
[\fITOPIC\fR] [پیش‌فرض: #]
موضوعاتی که باید پایش شوند
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBMQTTUI_TOPIC\fR مشخص شود.
.RE
.SH "اتصال MQTT (MQTT CONNECTION)"
.TP
\fB\-b\fR, \fB\-\-broker\fR \fI<URL>\fR [پیش‌فرض: mqtt://localhost]
نشانی URL که نحوه اتصال به کارگزار MQTT را مشخص می‌کند.

مثال‌ها: `mqtt://localhost` `mqtt://localhost:1883` `mqtts://localhost` `mqtts://localhost:8883` `ws://localhost/path` `ws://localhost:9001/path` `wss://localhost/path` `wss://localhost:9001/path`
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBMQTTUI_BROKER\fR مشخص شود.
.RE
.TP
\fB\-u\fR, \fB\-\-username\fR \fI<STRING>\fR
نام کاربری برای دسترسی به کارگزار MQTT.

در صورت عدم ارائه، دسترسی به صورت ناشناس خواهد بود.
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBMQTTUI_USERNAME\fR مشخص شود.
.RE
.TP
\fB\-\-password\fR \fI<STRING>\fR
گذرواژه برای دسترسی به کارگزار MQTT.

استفاده از یک اتصال مبتنی بر TLS به کارگزار را مد نظر قرار دهید؛ در غیر این صورت گذرواژه در قالب متن آشکار (plaintext) منتقل خواهد شد.

ارسال گذرواژه از طریق خط فرمان ناامن است زیرا گذرواژه می‌تواند از تاریخچه دستورات خوانده شود! باید آن را از طریق متغیر محیطی منتقل کنید.
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBMQTTUI_PASSWORD\fR مشخص شود.
.RE
.TP
\fB\-i\fR, \fB\-\-client\-id\fR \fI<STRING>\fR
مشخص کردن شناسه کلاینت (client id) برای اتصال
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBMQTTUI_CLIENTID\fR مشخص شود.
.RE
.TP
\fB\-\-ca\-cert\fR \fI<FILEPATH>\fR
مسیر فایل PEM گواهی CA معتبر برای تأیید کارگزار.

گواهی CA باید یک گواهی X.509 نسخه ۳ باشد زیرا rustls از گواهی‌های نسخه ۱ که امنیت کمتری دارند پشتیبانی نمی‌کند. ببینید: <https://github.com/rustls/rustls/issues/2364>
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBMQTTUI_CA_CERTIFICATE\fR مشخص شود.
.RE
.TP
\fB\-\-client\-cert\fR \fI<FILEPATH>\fR
مسیر فایل گواهی کلاینت TLS.

همراه با \-\-client\-private\-key برای فعال‌سازی احراز هویت کلاینت TLS استفاده می‌شود. این فایل باید یک گواهی DER\-encoded X.509 باشد که به PEM سریال‌سازی شده است.
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBMQTTUI_CLIENT_CERTIFICATE\fR مشخص شود.
.RE
.TP
\fB\-\-client\-private\-key\fR \fI<FILEPATH>\fR
مسیر فایل کلید خصوصی کلاینت TLS.

همراه با \-\-client\-cert برای فعال‌سازی احراز هویت کلاینت TLS استفاده می‌شود. این فایل باید یک فایل DER\-encoded ASN.1 در قالب PKCS#8 باشد که به PEM سریال‌سازی شده است.
.RS
همچنین می‌تواند از طریق متغیر محیطی \fBMQTTUI_CLIENT_PRIVATE_KEY\fR مشخص شود.
.RE
.TP
\fB\-\-insecure\fR
اجازه برقراری اتصالات ناامن TLS