amqp-declare-queue - Declare (create or assert the existence of) a queue on an AMQP server
Contents
Description
amqp-declare-queue attempts to create a queue on an AMQP server, and exits. If the empty-string is
supplied as the queue name, a fresh queue name is generated by the server and returned. In all cases, if
a queue was successfully declared, the (raw binary) name of the queue is printed to standard output,
followed by a newline.
Examples
Declare the durable queue “myqueue”, and display the name of the queue on standard output:
$ amqp-declare-queue-d-qmyqueue
myqueue
Declare a fresh, server-named transient queue, and display the name of the queue on standard output (use
amqp-delete-queue(1) to delete it from the server once you're done):
$ amqp-declare-queue-q""
amq.gen-BW/wvociA8g6LFpb1PlqOA==
Exit Status
If the queue was successfully declared, the exit status is 0. If an error occurs, the exit status is 1.
Name
amqp-declare-queue - Declare (create or assert the existence of) a queue on an AMQP server
Options
-q, --queue=queuename
The name of the queue to declare. If the empty string is supplied, a fresh queue name is generated by
the server.
-d, --durable
Causes the queue to be declared with the "durable" flag set. Durable queues survive server restarts.
By default, queues are declared in "transient" mode.
See Also
librabbitmq-tools(7) describes connection-related options common to all the RabbitMQ C Client tools.
Synopsis
amqp-declare-queue [OPTION...] [-d] {-q queuename}
