AMQP-GET(1)

💖 AMQP-GET(1) 💖

okay bestie, welcome to amqp-get — a lil tool from the RabbitMQ C Client and she is so good at exactly one thing: snatching a single message off an AMQP server and dipping. ✨

---

🌸 NAME 🌸

amqp-get — get a message from a queue on an AMQP server 🫶

---

🎀 SYNOPSIS 🎀

amqp-get [OPTION...] {-q queue name}

---

🦋 DESCRIPTION 🦋

so like. amqp-get rolls up to a queue on an AMQP server, tries to consume one single message, and then peaces out immediately. one (1) message. that's the whole vibe. 💅

unless the queue was empty (in which case, no message for us 😭), the body of the message it grabbed gets sent straight to standard output. slay.

---

✨ OPTIONS ✨

• -q, --queue=queue name — the name of the queue we're consuming messages from. literally just tell her where to look, bestie. 👑

---

👑 EXIT STATUS 👑

the exit status is the whole story arc here, so pay attention:

• if the queue is not empty and a message was successfully retrieved → exit status is 0 🎉 (ate, no crumbs)
• if an error occurs → exit status is 1 💀
• if the queue is found to be empty → exit status is 2 😭 (not a failure, just a lil "nothing here!" vibe)

bestie fr fr, check that exit status. 2 is not the same as 0. iykyk. 🚨

---

🌈 EXAMPLES 🌈

get a message from the queue myqueue, and display its body on standard output:

$ amqp-get -q myqueue

look at her go ✨ main character energy.

---

💜 SEE ALSO 💜

librabbitmq-tools(7) — describes connection-related options common to all the RabbitMQ C Client tools. so if you're wondering about the connection stuff, that's where it lives. 🧚

---

🍓 AUTHOR 🍓

The RabbitMQ Team <info@rabbitmq.com> 🫶

---

and that's the page!! this beauty is part of the RabbitMQ C Client, version dated 2026-10-13. go get that message, bestie, you got this 💖✨🎀