AMQP-CONSUME(1) | RabbitMQ C Client | AMQP-CONSUME(1) |
NAME¶
amqp-consume - Consume messages from a queue on an AMQP server
SYNOPSIS¶
amqp-consume [OPTION...] {command} [args...]
DESCRIPTION¶
amqp-consume consumes messages from a queue on an AMQP server. For each message that arrives, a receiving command is run, with the message body supplied to it on standard input.
amqp-consume can consume from an existing queue, or it can create a new queue. It can optionally bind the queue to an existing exchange.
By default, messages will be consumed with explicit acknowledgements. A message will only be acknowledged if the receiving command exits successfully (i.e. with an exit code of zero). The AMQP “no ack” mode (a.k.a. auto-ack mode) can be enable with the -A option.
OPTIONS¶
-q, --queue=queue name
If the --queue option is omitted, the AMQP server will assign a unique name to the queue, and that server-assigned name will be dixsplayed on stderr; this case implies that an exclusive queue should be declared.
-e, --exchange=exchange name
-r, --routing-key=routing key
-d, --declare
-x, --exclusive
-A, --no-ack=routing key
-c, --count=limit
-p, --prefetch-count=limit
If any value was passed to --count, the value passed to --prefetch-count should be smaller than that, or otherwise it will be ignored.
If -A/--no-ack is passed, this option has no effect.
EXAMPLES¶
Consume messages from an existing queue “myqueue”, and output the message bodies on standard output via cat:
$ amqp-consume -q myqueue cat
Bind a new exclusive queue to an exchange “myexch”, and send each message body to the script myscript, automatically acknowledging them on the server:
$ amqp-consume -A -e myexch ./myscript
SEE ALSO¶
librabbitmq-tools(7) describes connection-related options common to all the RabbitMQ C Client tools.
AUTHOR¶
The RabbitMQ Team <<info@rabbitmq.com>>
2024-11-22 | RabbitMQ C Client |