AMQP-DECLARE-QUEUE(1) RabbitMQ C Client AMQP-DECLARE-QUEUE(1)

amqp-declare-queue - اعلان (ایجاد یا اطمینان از وجود) یک صف در یک کارساز AMQP

amqp-declare-queue [OPTION...] [-d] {-q queue name}

دستور amqp-declare-queue تلاش می‌کند یک صف در یک کارساز AMQP ایجاد کند و سپس خارج می‌شود. اگر رشته‌ای خالی به عنوان نام صف مشخص شود، نام صف جدیدی توسط کارساز تولید شده و بازگردانده می‌شود. در هر صورت، اگر صف با موفقیت اعلان شده باشد، نام خام (دودویی) صف در خروجی استاندارد چاپ شده و یک خط جدید به دنبال آن می‌آید.

-q, --queue=queue name

نام صفی که باید اعلان شود. اگر یک رشته خالی داده شود، یک نام صف جدید توسط کارساز تولید می‌شود.

-d, --durable

باعث می‌شود صف با پرچم «ماندگار» (durable) اعلان شود. صف‌های ماندگار پس از راه‌اندازی مجدد کارساز باقی می‌مانند. به‌طور پیش‌فرض، صف‌ها در حالت «گذرا» (transient) اعلان می‌شوند.

اگر صف با موفقیت اعلان شده باشد، وضعیت خروج 0 است. در صورت بروز خطا، وضعیت خروج 1 خواهد بود.

اعلان صف ماندگار “myqueue” و نمایش نام صف در خروجی استاندارد:

$ amqp-declare-queue -d -q myqueue
myqueue

اعلان یک صف گذرای جدید با نام تعیین‌شده توسط کارساز، و نمایش نام صف در خروجی استاندارد (پس از اتمام کار، از amqp-delete-queue(1) برای حذف آن از کارساز استفاده کنید):

$ amqp-declare-queue -q ""
amq.gen-BW/wvociA8g6LFpb1PlqOA==

librabbitmq-tools(7) گزینه‌های مرتبط با اتصال را که میان تمام ابزارهای RabbitMQ C Client مشترک است شرح می‌دهد.

تیم RabbitMQ <<info@rabbitmq.com>>

2026-06-15 RabbitMQ C Client