QPID-SEND(1)

📦 version 1.39.0, in nixos 26.05, nixpkgs unstable

💌 qpid-send — AMQP Message Sender 💌

okay bestie, so this is the qpid-send manual page (from the qpid-cpp world, User Commands section, no big deal) and honestly? it's giving "little tool that does a LOT." let's get into it 💅

✨ NAME ✨

qpid-send — the AMQP Message Sender, aka your girl that just sends things. 📨

🦋 SYNOPSIS 🦋

qpid-send [OPTIONS] -a [ --address ] ADDRESS

like, you do need to give it an address. that part is not optional, iykyk.

🌸 DESCRIPTION 🌸

It sends AMQP messages to AMQP sources. that's the whole vibe. simple, iconic, does exactly what it says on the tin. 🎀

💖 OPTIONS 💖

  • -b, --broker URL (default 127.0.0.1) — the url of the broker you're connecting to. defaults to hanging out at 127.0.0.1 like it lives there.
  • -a, --address ADDRESS — the address to send to. yes, this one is mandatory. no address = no slay.
  • --connection-options OPTIONS — options for the connection itself.
  • -m, --messages N (default 1) — stop after N messages have been sent. and 0? 0 means no limit, go off, send forever bestie 🔥
  • -i, --id ID — use the id you supply instead of generating one. main character energy: you pick the id.
  • --reply-to REPLY-TO — specify the reply-to address. so people know where to slide back into your DMs.
  • --send-eos N (default 0) — send N EOS messages to mark end of input. the polite way to say "ok bye 👋"
  • --durable yes|no (default 0) — mark messages as durable. built different, built to last.
  • --ttl msecs (default 0) — time-to-live for messages, in milliseconds. their little lifespan 🥀
  • --priority PRIORITY (default 0) — priority for messages. higher value implies higher priority, so yes, the popular girls go first 💅
  • -P, --property NAME=VALUE — specify a message property. one bullet per property, no cap.
  • --correlation-id ID — the correlation-id for the message. it's how messages find their person 🫶
  • --user-id USERID — the userid for the message.
  • --auto-user-id yes|no (default 0) — set the userid for the message based on the authenticated identity. it just knows.
  • --content-string CONTENT — use CONTENT as the message content.
  • --content-size N (default 0) — create an N-byte message content. make it big, make it byte-y.
  • -M, --content-map NAME=VALUE — specify an entry for map content.
  • --content-stdin — read message content from stdin, one line per message. very demure, very pipeline 🧚
  • --capacity N (default 1000) — size of the sender's outgoing message queue.
  • --tx N (default 0) — batch size for transactions. and 0 implies transactions are not used, so don't come for me if nothing's transactional.
  • --rollback-frequency N (default 0) — rollback frequency. 0 implies no transaction will be rolled back.
  • --failover-updates — listen for membership updates distributed via amq.failover. staying in the loop fr fr.
  • --report-total — report total throughput statistics.
  • --report-every N (default 0) — report throughput statistics every N messages.
  • --report-header yes|no (default 1) — headers on the report. yep, on by default.
  • --send-rate N (default 0) — send at a rate of N messages/second. 0 means send as fast as possible, no chill whatsoever 💀
  • --sequence yes|no (default 1) — add a sequence number messages property. required for duplicate/lost message detection, so don't skip it.
  • --timestamp yes|no (default 1) — add a time stamp messages property. required for latency measurement, so yeah, keep it.
  • --group-key KEY — generate groups of messages using the message header 'KEY' to hold the group identifier.
  • --group-prefix STRING (default GROUP-) — generate group identifiers with the 'STRING' prefix (if group-key is specified 👀).
  • --group-size N (default 10) — number of messages per group (if group-key is specified).
  • --group-randomize-size — randomize the number of messages per group to [1...group-size] (if group-key is specified). chaotic. love that.
  • --group-interleave N (default 1) — simultaneously interleave messages from N different groups (if group-key is specified).
  • --help — print this usage statement. the classic.

🌈 Logging options 🌈

  • -t, --trace — enables all logging. all of it. every last crumb.
  • --log-enable RULE (default notice+) — enables logging for selected levels and components. RULE is in the form 'LEVEL[+-][:PATTERN]'. LEVEL is one of:
trace debug info notice warning error critical

PATTERN is a logging category name, or a namespace-qualified function name or name fragment. the logging category names are:

Security Broker Management Protocol System HA Messaging Store
Network Test Client Application Model Unspecified

for example: --log-enable warning+ logs all warning, error and critical messages. --log-enable trace+:Broker logs all category Broker messages. --log-enable debug:framing logs debug messages from all functions with framing in the namespace or function name. this option can be used multiple times ✨

  • --log-disable RULE — disables logging for selected levels and components. RULE is in the form 'LEVEL[+-][:PATTERN]'. LEVEL is one of:
trace debug info notice warning error critical

PATTERN is a logging category name, or a namespace-qualified function name or name fragment. the logging category names are:

Security Broker Management Protocol System HA Messaging Store
Network Test Client Application Model Unspecified

for example: --log-disable warning- disables logging all warning, notice, info, debug, and trace messages. --log-disable trace:Broker disables all category Broker trace messages. --log-disable debug-:qmf:: disables logging debug and trace messages from all functions with qmf:: in the namespace. this option can be used multiple times ✨

  • --log-time yes|no (default 1) — include time in log messages.
  • --log-level yes|no (default 1) — include severity level in log messages.
  • --log-source yes|no (default 0) — include source file:line in log messages.
  • --log-thread yes|no (default 0) — include thread ID in log messages.
  • --log-function yes|no (default 0) — include function signature in log messages.
  • --log-hires-timestamp yes|no (default 0) — use hi-resolution timestamps in log messages. fancy.
  • --log-category yes|no (default 1) — include category in log messages.
  • --log-prefix STRING — prefix to prepend to all log messages. a little signature on every line 🎀

🫶 Logging sink options 🫶

  • --log-to-stderr yes|no (default 1) — send logging output to stderr.
  • --log-to-stdout yes|no (default 0) — send logging output to stdout.
  • --log-to-file FILE — send log output to FILE.
  • --log-to-syslog yes|no (default 0) — send logging output to syslog; customize using --syslog-name and --syslog-facility.
  • --syslog-name NAME — name to use in syslog messages.
  • --syslog-facility LOG_XXX (default LOG_DAEMON) — facility to use in syslog messages.
⚠️ Address must be specified! I'm not kidding bestie, the tool literally says it. no address, no messages. periodt.

👑 AUTHOR 👑

The Apache Qpid Project, dev@qpid.apache.org 🦋

🍓 REPORTING BUGS 🍓

Please report bugs to users@qpid.apache.org. be nice, they're doing their best 💖

okay that's the whole page! this is qpid-send from qpid-cpp, version 1..., dated March 2018 — vintage but still serving, and we love her for it. mwah 💋✨

📦 where this page comes from