'\" t
.\"     Title: amqp-declare-queue
.\"    Author: The RabbitMQ Team <\m[blue]\fBinfo@rabbitmq.com\fR\m[]>
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\"      Date: 2011-01-01
.\"    Manual: RabbitMQ C Client
.\"    Source: RabbitMQ C Client
.\"  Language: English
.\"
.TH "AMQP\-DECLARE\-QUEUE" "1" "2011\-01\-01" "RabbitMQ C Client" "RabbitMQ C Client"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
amqp-declare-queue \- Declare (create or assert the existence of) a queue on an AMQP server
.SH "SYNOPSIS"
.HP \w'\fBamqp\-declare\-queue\fR\ 'u
\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"
.PP
\fB\-q\fR, \fB\-\-queue\fR=\fIqueue name\fR
.RS 4
The name of the queue to declare\&. If the empty string is supplied, a fresh queue name is generated by the server\&.
.RE
.PP
\fB\-d\fR, \fB\-\-durable\fR
.RS 4
Causes the queue to be declared with the "durable" flag set\&. Durable queues survive server restarts\&. By default, queues are declared in "transient" mode\&.
.RE
.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"
.PP
Declare the durable queue \(lqmyqueue\(rq, and display the name of the queue on standard output:
.RS 4
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBamqp\-declare\-queue \-d \-q myqueue\fR
myqueue
.fi
.if n \{\
.RE
.\}
.RE
.PP
Declare a fresh, server\-named transient queue, and display the name of the queue on standard output (use \fBamqp-delete-queue\fR(1) to delete it from the server once you\*(Aqre done):
.RS 4
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBamqp\-declare\-queue \-q ""\fR
amq\&.gen\-BW/wvociA8g6LFpb1PlqOA==
.fi
.if n \{\
.RE
.\}
.RE
.SH "SEE ALSO"
.PP

\fBlibrabbitmq-tools\fR(7)
describes connection\-related options common to all the RabbitMQ C Client tools\&.
.SH "AUTHOR"
.PP
\fBThe RabbitMQ Team <\fR\fB\m[blue]\fBinfo@rabbitmq\&.com\fR\m[]\fR\fB>\fR