QPID-RECEIVE(1)

okay so bestie, this is qpid-receive(1) from the User Commands corner of the manual, and it’s giving AMQP message receiver main-character energy. we’re gonna walk every flag, default, and chaotic little detail together, no cap. 💅✨

✨ NAME ✨

qpid-receive — AMQP Message Receiver. that’s the name, that’s the vibe. 🎀

📜 SYNOPSIS 📜

the shape of it is literally:

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

🌸 DESCRIPTION 🌸

It receives AMQP messages from AMQP sources. that’s the whole plot. obsessed. 💖

💅 OPTIONS 💅

okay, flags. there are a lot. don’t panic — we’re going through every single one, in order, with the defaults intact. 🫶

• -b, --broker URL (default 127.0.0.1) — url of broker to connect to.
• -a, --address ADDRESS — address to receive from.
• --connection-options OPTIONS — options for the connection.
• --timeout TIMEOUT (default 0) — timeout in seconds to wait before exiting.
• -f, --forever — ignore timeout and wait forever.
• -m, --messages N (default 0) — Number of messages to receive; 0 means receive indefinitely.
• --ignore-duplicates — Detect and ignore duplicates (by checking 'sn' header).
• --verify-sequence — Verify there are no gaps in the message sequence (by checking 'sn' header).
• --check-redelivered — Fails with exception if a duplicate is not marked as redelivered (only relevant when ignore-duplicates is selected).
• --capacity N (default 1000) — Pre-fetch window (0 implies no pre-fetch).
• --ack-frequency N (default 100) — Ack frequency (0 implies none of the messages will get accepted).
• --tx N (default 0) — batch size for transactions (0 implies transaction are not used).
• --rollback-frequency N (default 0) — rollback frequency (0 implies no transaction will be rolledback).
• --print-content yes|no (default 1) — print out message content.
• --print-object-type yes|no (default 0) — print a description of the content’s object type if relevant.
• --print-headers yes|no (default 0) — print out message headers.
• --failover-updates — Listen for membership updates distributed via amq.failover.
• --report-total — Report total throughput and latency statistics.
• --report-every N (default 0) — Report throughput and latency statistics every N messages.
• --report-header yes|no (default 1) — Headers on report.
• --ready-address ADDRESS — send a message to this address when ready to receive.
• --receive-rate N (default 0) — Receive at rate of N messages/second. 0 means receive as fast as possible.
• --reply-to REPLY-TO — specify reply-to address on response messages.
• --ignore-reply-to — Do not send replies even if reply-to is set.
• --help — print this usage statement.

🪵 Logging options 🪵

• -t, --trace — Enables all logging.
• --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. 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. 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.
• --log-category yes|no (default 1) — Include category in log messages.
• --log-prefix STRING — Prefix to prepend to all log messages.

🪵 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! 🚨

👑 AUTHOR 👑

The Apache Qpid Project, dev@qpid.apache.org. iconic. 💜

🐛 REPORTING BUGS 🐛

Please report bugs to users@qpid.apache.org. do it, bestie. 🫶

that’s the page! source/version roll call: qpid-receive (qpid-cpp) versio..., dated March 2018, manual id QPID-RECEIVE(1). mwah 💋✨