mqttui-publish(1)           General Commands Manual          mqttui-publish(1)

نام (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).
              همچنین می‌تواند از طریق متغیر محیطی MQTTUI_RETAIN مشخص شود.

       -v, --verbose
              نمایش ارتباط کامل MQTT

       --qos <LEVEL> [پیش‌فرض: 2]
              حداکثر سطح کیفیت خدمات (`QoS`) برای اشتراک‌ها و انتشار.

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

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

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

              - 2: دقیقاً یک‌بار (تحویل تضمین‌شده و بدون پیام تکراری)
              همچنین می‌تواند از طریق متغیر محیطی MQTTUI_QOS مشخص شود.

       -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`
              همچنین می‌تواند از طریق متغیر محیطی MQTTUI_BROKER مشخص شود.

       -u, --username <STRING>
              نام کاربری برای دسترسی به کارگزار MQTT.

              در صورت عدم ارائه، دسترسی ناشناس در نظر گرفته می‌شود.
              همچنین می‌تواند از طریق متغیر محیطی MQTTUI_USERNAME مشخص شود.

       --password <STRING>
              گذرواژه برای دسترسی به کارگزار MQTT.

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

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

       -i, --client-id <STRING>
              مشخص کردن شناسه کلاینت برای اتصال
              همچنین می‌تواند از طریق متغیر محیطی MQTTUI_CLIENTID مشخص شود.

       --ca-cert <FILEPATH>
              مسیر فایل PEM گواهی معتبر CA برای تایید هویت کارگزار.

              گواهی CA باید از نوع گواهی X.509 v3 باشد، زیرا rustls از
              گواهی‌های نسخه v1 که امنیت کمتری دارند پشتیبانی نمی‌کند. ببینید:
              <https://github.com/rustls/rustls/issues/2364>
              همچنین می‌تواند از طریق متغیر محیطی MQTTUI_CA_CERTIFICATE مشخص
              شود.

       --client-cert <FILEPATH>
              مسیر فایل گواهی کلاینت TLS.

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

       --client-private-key <FILEPATH>
              مسیر فایل کلید خصوصی کلاینت TLS.

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

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

                                   publish                   mqttui-publish(1)