QPID-ROUTE(1)

💅 QPID-ROUTE(1) — ngl this is the manual for qpid-route, straight out of the User Commands section 🦋

okay so bestie, gather round, because this little icon is literally the Management Tool for QPID Routes and it's about to make your whole broker situation make sense 💖

✨ SYNOPSIS ✨

qpid-route [OPTIONS] <commands>

literally that's it. options first, then the command, then whatever the command needs. slay.

🌸 DESCRIPTION 🌸

Manages QPID routes. That's the whole vibe. And because the original page just dumps the command shapes at you with zero chill, here is every single one, verbatim, in one gorgeous little stack — no cap, this is the complete list 👑

qpid-route [OPTIONS] dynamic del <dest-broker> <src-broker> <exchange>

qpid-route [OPTIONS] route add <dest-broker> <src-broker> <exchange> <routing-key> [tag] [exclude-list] [mechanism]

qpid-route [OPTIONS] route del <dest-broker> <src-broker> <exchange> <routing-key>

qpid-route [OPTIONS] queue add <dest-broker> <src-broker> <exchange> <queue> [mechanism]

qpid-route [OPTIONS] queue del <dest-broker> <src-broker> <exchange> <queue>

qpid-route [OPTIONS] route list [<dest-broker>]

qpid-route [OPTIONS] route flush [<dest-broker>]

qpid-route [OPTIONS] route map   [<broker>]

qpid-route [OPTIONS] link add <dest-broker> <src-broker> [mechanism]

qpid-route [OPTIONS] link del <dest-broker> <src-broker>

qpid-route [OPTIONS] link list [<dest-broker>]

🎀 ADDRESS syntax 🎀

the way you write a broker address is this, and only this, iykyk:

[username/password@] hostname ip-address [:<port>]

so: optional username/password@ up front, then a hostname, then an ip-address, then optionally :<port> — all up in there together. yes, it's a lot. no, you don't get to skip any of it 💀

---

🔥 OPTIONS 🔥

every single flag, bestie. nobody gets left behind 🫶

• -h, --help — shows this help message and then dips out (exit).
• --timeout=<secs> — the maximum time to wait for a broker connection, in seconds ⏱️
• -v, --verbose — verbose output. spill everything, queen.
• -q, --quiet — quiet output, and it won't print duplicate warnings. lowkey the polite option tbh 🙈
• -d, --durable — whatever config you're adding shall be durable ✨
• -e, --del-empty-link — deletes the link right after you delete the last route on that link. clean girl aesthetic 🧹
• -s, --src-local — makes the connection to the source broker (i.e. it pushes the route).
• --ack=<n> — acknowledge transfers over the bridge in batches of N.
• --credit=<msgs> — maximum number of messages a sender can have outstanding (0 = unlimited). zero means go feral 🔥
• -t <transport>, --transport=<transport> — the transport to use for links; it defaults to tcp.
• --client-sasl-mechanism=<mech> — SASL mechanism for authentication (e.g. EXTERNAL, ANONYMOUS, PLAIN, CRAM-MD5, DIGEST-MD5, GSSAPI). Used when the client connects to the destination broker — and not for authentication between the source and destination brokers, because that one is specified using the [mechanisms] argument to 'add route'. SASL automatically picks the most secure available mechanism, so use this option if you wanna override it 💅
• --sasl-service-name=SASL_SERVICE_NAME — the SASL service name to use.
• --ssl-certificate=<cert> — Client SSL certificate, in PEM Format 🎀
• --ssl-key=<key> — Client SSL private key, in PEM Format 🔐
• --ha-admin — allows connection to a HA backup broker. main character energy for your failover 👑

⚠️ heads up bestie: that --client-sasl-mechanism note is doing serious work — it is only for the client → destination broker connection. source-to-destination auth is a whole different thing and lives in the [mechanisms] argument. don't mix them up or you'll be sad 😭

---

👑 AUTHOR 👑

The Apache Qpid Project, dev@qpid.apache.org — icons only, fr fr.

🦋 REPORTING BUGS 🦋

Please report bugs to users@qpid.apache.org. they're genuinely nice about it, promise 🌈

---

and that's the page, babe! 🍓 little sign-off for you: this is qpid-route from (qpid-cpp), the version field honestly just reads as version ... in the source page, and the date on it is March 2018. vintage but still slaying 💜✨ </｜DSML｜ parameter>