amqp-declare-queue(1)

1AMQP-DECLARE-QUEUE(1)          RabbitMQ C Client         AMQP-DECLARE-QUEUE(1)
2
3
4

NAME

6       amqp-declare-queue - Declare (create or assert the existence of) a
7       queue on an AMQP server
8

SYNOPSIS

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

DESCRIPTION

13       amqp-declare-queue attempts to create a queue on an AMQP server, and
14       exits. If the empty-string is supplied as the queue name, a fresh queue
15       name is generated by the server and returned. In all cases, if a queue
16       was successfully declared, the (raw binary) name of the queue is
17       printed to standard output, followed by a newline.
18

OPTIONS

20       -q, --queue=queue name
21           The name of the queue to declare. If the empty string is supplied,
22           a fresh queue name is generated by the server.
23
24       -d, --durable
25           Causes the queue to be declared with the "durable" flag set.
26           Durable queues survive server restarts. By default, queues are
27           declared in "transient" mode.
28

EXIT STATUS

30       If the queue was successfully declared, the exit status is 0. If an
31       error occurs, the exit status is 1.
32

EXAMPLES

34       Declare the durable queue “myqueue”, and display the name of the queue
35       on standard output:
36
37               $ amqp-declare-queue -d -q myqueue
38               myqueue
39
40       Declare a fresh, server-named transient queue, and display the name of
41       the queue on standard output (use amqp-delete-queue(1) to delete it
42       from the server once you're done):
43
44               $ amqp-declare-queue -q ""
45               amq.gen-BW/wvociA8g6LFpb1PlqOA==
46

AUTHOR

52       The RabbitMQ Team <<info@rabbitmq.com>>
53
54
55
56RabbitMQ C Client                 2023-07-20             AMQP-DECLARE-QUEUE(1)