.TH "amqp-declare-queue" "1" 
 
 
 
.SH "NAME" 
amqp-declare-queue          \(em Declare (create or assert the existence of) a queue on an AMQP server 
 
 
.SH "SYNOPSIS" 
 
.PP 
\fBamqp-declare-queue\fR                             \fIOPTION\fR                           \-d              \-q \fIqueue name\fR           
 
 
 
.SH "Description" 
 
.PP 
\fBamqp-declare-queue\fR 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. 
 
 
 
.SH "Options" 
 
.IP "\fB-q\fP" 10 
 
.IP "\fB\-\-queue\fP=\fIqueue name\fR" 10 
The name of the queue to declare.  If the 
empty string is supplied, a fresh queue name 
is generated by the server. 
 
.IP "\fB-d\fP" 10 
 
.IP "\fB\-\-durable\fP" 10 
Causes the queue to be declared with the 
"durable" flag set. Durable queues survive 
server restarts. By default, queues are declared 
in "transient" mode. 
 
 
 
.SH "Exit Status" 
 
.PP 
If the queue was successfully declared, the exit status is 
0. If an error occurs, the exit status is 1. 
 
 
 
.SH "Examples" 
 
.IP "Declare the durable queue ``\fI\fBmyqueue\fP\fP'', and 
display the name of the queue on standard output:" 10 
 
.PP 
.nf 
$  
.ft B 
amqp-declare-queue \-d \-q myqueue 
.ft myqueue 
.fi 
 
.IP "Declare a fresh, server-named transient queue, 
and display the name of the queue on standard output 
(use \fBamqp-delete-queue\fP 		    \fB(1)\fP to delete 
it from the server once you're done):" 10 
 
.PP 
.nf 
$  
.ft B 
amqp-declare-queue \-q "" 
.ft amq.gen-BW/wvociA8g6LFpb1PlqOA== 
.fi 
 
 
 
.SH "See also" 
 
.PP 
\fBlibrabbitmq-tools\fP\fB(7)\fP             describes connection-related options common to all the 
RabbitMQ C Client tools. 
 
.\" created by instant / docbook-to-man