نام (NAME)

mqttui-publish - انتشار سریع یک مقدار

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

mqttui publish [-r|--retain] [-v|--verbose] [--qos] [-b|--broker] [-u|--username] [--password] [-i|--client-id] [--ca-cert] [--client-cert] [--client-private-key] [--insecure] [-h|--help] <TOPIC> [PAYLOAD]

توضیحات (DESCRIPTION)

انتشار سریع یک مقدار در پروتکل MQTT.

گزینه‌ها (OPTIONS)

-r, --retain

انتشار پیام MQTT به صورت ماندگار (retained).

-v, --verbose

نمایش ارتباط کامل MQTT

--qos <LEVEL> [پیش‌فرض: 2]

حداکثر سطح کیفیت خدمات (`QoS`) برای اشتراک‌ها و انتشار.

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

- 0: حداکثر یک‌بار (ارسال بدون انتظار تایید)

- 1: حداقل یک‌بار (تحویل تاییدشده با احتمال پیام‌های تکراری)

- 2: دقیقاً یک‌بار (تحویل تضمین‌شده و بدون پیام تکراری)

-h, --help

چاپ راهنما (مشاهده خلاصه با '-h')

<TOPIC>

موضوع (Topic) مورد نظر برای انتشار

[PAYLOAD]

بار داده (Payload) جهت انتشار.

در صورت عدم تعیین، از ورودی استاندارد (stdin) خوانده می‌شود. این قابلیت امکان ارسال محتوای فایل را از طریق لوله (pipe) به این شکل فراهم می‌کند (در bash):

`mqttui publish some/topic </etc/hostname`

`cowsay "I was here" | mqttui publish some/topic`

اتصال به MQTT (MQTT CONNECTION)

-b, --broker <URL> [پیش‌فرض: 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`

-u, --username <STRING>

نام کاربری برای دسترسی به کارگزار MQTT.

در صورت عدم ارائه، دسترسی ناشناس در نظر گرفته می‌شود.

--password <STRING>

گذرواژه برای دسترسی به کارگزار MQTT.

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

ارسال گذرواژه از طریق خط فرمان ناامن است زیرا گذرواژه ممکن است از طریق تاریخچه دستورات خوانده شود! بهتر است آن را با متغیر محیطی منتقل کنید.

-i, --client-id <STRING>

مشخص کردن شناسه کلاینت برای اتصال

--ca-cert <FILEPATH>

مسیر فایل PEM گواهی معتبر CA برای تایید هویت کارگزار.

گواهی CA باید از نوع گواهی X.509 v3 باشد، زیرا rustls از گواهی‌های نسخه v1 که امنیت کمتری دارند پشتیبانی نمی‌کند. ببینید: https://github.com/rustls/rustls/issues/2364

--client-cert <FILEPATH>

مسیر فایل گواهی کلاینت TLS.

همراه با --client-private-key برای فعال‌سازی احراز هویت کلاینت TLS استفاده می‌شود. این فایل باید یک گواهی X.509 با کدگذاری DER و سریال‌شده در قالب PEM باشد.

--client-private-key <FILEPATH>

مسیر فایل کلید خصوصی کلاینت TLS.

همراه با --client-cert برای فعال‌سازی احراز هویت کلاینت TLS استفاده می‌شود. این فایل باید یک فایل ASN.1 با کدگذاری DER در ساختار PKCS#8 و سریال‌شده در قالب PEM باشد.

--insecure

مجاز دانستن اتصالات ناامن TLS