| mqttui-clean-retained(1) | General Commands Manual | mqttui-clean-retained(1) |
نام (NAME)
mqttui-clean-retained - پاک‌سازی پیام‌های ماندگار (retained) از کارگزار (broker)
خلاصه دستور (SYNOPSIS)
mqttui clean-retained [--timeout] [--dry-run] [--qos] [-b|--broker] [-u|--username] [--password] [-i|--client-id] [--ca-cert] [--client-cert] [--client-private-key] [--insecure] [-h|--help] <TOPIC>
توضیحات (DESCRIPTION)
پاک‌سازی پیام‌های ماندگار (retained) از broker.
این دستور با اشتراک در موضوع (topic) و انتظار برای دریافت پیام‌هایی با نشانگر retained کار می‌کند. سپس پیامی با محتوای داده‌ای (payload) خالی به‌صورت retained ارسال می‌شود که باعث پاک‌سازی موضوع روی broker می‌گردد. این فرایند با دریافت نخستین پیام غیرretained یا به پایان رسیدن مهلت زمانی (timeout) خاتمه می‌یابد.
گزینه‌ها (OPTIONS)
- --timeout <SECONDS> [پیش‌فرض: 5]
- چنانچه در بازه زمانی تعیین‌شده هیچ پیامی دریافت نشود، عملیات پایان‌یافته در نظر گرفته می‌شود.
- --dry-run
- موضوعات را پاک نمی‌کند، فقط آن‌ها را ثبت (log) می‌کند.
- --qos <LEVEL> [پیش‌فرض: 2]
- حداکثر سطح
کیفیت
خدمات (`QoS`)
برای
اشتراک‌ها
و ارسال
پیام.
سطح پایین‌ترِ کیفیت خدمات بین ارسال‌کننده و مشترک، از سوی broker به مشترک تحویل داده می‌شود. بنابراین، اشتراک با سطح 0 هرگز پیام‌های 1 یا 2 را دریافت نخواهد کرد. انتشار با سطح 2، هنگام اشتراک با سطح 1، به‌صورت 1 دریافت خواهد شد.
- 0: حداکثر یک‌بار (fire and forget)
- 1: حداقل یک‌بار (تحویل تاییدشده با احتمال دریافت تکراری)
- 2: دقیقاً یک‌بار (تحویل تضمین‌شده بدون دریافت تکراری)
- -h, --help
- چاپ راهنما (مشاهده خلاصه با '-h')
- <TOPIC>
- موضوعی (topic) که
پاک‌سازی
می‌شود.
از فیلترهایی مانند 'foo/bar/#' پشتیبانی می‌کند.
اتصال MQTT (MQTT CONNECTION)
- -b, --broker <URL> [پیش‌فرض: mqtt://localhost]
- آدرس URL که
نحوه اتصال
به broker پروتکل
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>
- نام کاربری
برای
دسترسی به broker
پروتکل mqtt.
در صورت ارائه نشدن، دسترسی به‌صورت ناشناس خواهد بود.
- --password <STRING>
- گذرواژه
برای
دسترسی به broker
پروتکل mqtt.
استفاده از اتصال TLS به broker را در نظر داشته باشید؛ در غیر این صورت گذرواژه به‌صورت متن آشکار (plaintext) منتقل خواهد شد.
ارسال گذرواژه از طریق خط فرمان ناامن است زیرا می‌تواند از تاریخچه دستورها خوانده شود! بهتر است آن را از طریق متغیر محیطی ارسال کنید.
- -i, --client-id <STRING>
- مشخص کردن client id برای برقراری اتصال
- --ca-cert <FILEPATH>
- مسیر فایل PEM
گواهی CA
معتبر برای
اعتبارسنجی
broker.
گواهی 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
| clean-retained |