docs/man/qpid-send.1

.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.6.
.TH QPID-SEND "1" "October 2018" "qpid-send  (qpid-cpp) version 1.40.0" "User Commands"
.SH NAME

qpid-send \- AMQP Message Sender
.SH SYNOPSIS

qpid-send [OPTIONS] -a [ --address ] ADDRESS
.SH DESCRIPTION

Sends AMQP messages to AMQP sources.
.SH OPTIONS
.TP
\fB\-b\fR [ \fB\-\-broker\fR ] URL (127.0.0.1)
url of broker to connect to
.TP
\fB\-a\fR [ \fB\-\-address\fR ] ADDRESS
address to send to
.TP
\fB\-\-connection\-options\fR OPTIONS
options for the connection
.TP
\fB\-m\fR [ \fB\-\-messages\fR ] N (1)
stop after N messages have been sent, 0
means no limit
.TP
\fB\-i\fR [ \fB\-\-id\fR ] ID
use the supplied id instead of
generating one
.TP
\fB\-\-reply\-to\fR REPLY\-TO
specify reply\-to address
.TP
\fB\-\-send\-eos\fR N (0)
Send N EOS messages to mark end of
input
.TP
\fB\-\-durable\fR yes|no (0)
Mark messages as durable.
.TP
\fB\-\-ttl\fR msecs (0)
Time\-to\-live for messages, in
milliseconds
.TP
\fB\-\-priority\fR PRIORITY (0)
Priority for messages (higher value
implies higher priority)
.TP
\fB\-P\fR [ \fB\-\-property\fR ] NAME=VALUE
specify message property
.TP
\fB\-\-correlation\-id\fR ID
correlation\-id for message
.TP
\fB\-\-user\-id\fR USERID
userid for message
.TP
\fB\-\-auto\-user\-id\fR yes| no (0)
set userid for message based on
authenticated identity
.TP
\fB\-\-content\-string\fR CONTENT
use CONTENT as message content
.TP
\fB\-\-content\-size\fR N (0)
create an N\-byte message content
.TP
\fB\-M\fR [ \fB\-\-content\-map\fR ] NAME=VALUE
specify entry for map content
.TP
\fB\-\-content\-stdin\fR
read message content from stdin, one
line per message
.TP
\fB\-\-capacity\fR N (1000)
size of the senders outgoing message
queue
.TP
\fB\-\-tx\fR N (0)
batch size for transactions (0 implies
transaction are not used)
.TP
\fB\-\-rollback\-frequency\fR N (0)
rollback frequency (0 implies no
transaction will be rolledback)
.TP
\fB\-\-failover\-updates\fR
Listen for membership updates
distributed via amq.failover
.TP
\fB\-\-report\-total\fR
Report total throughput statistics
.TP
\fB\-\-report\-every\fR N (0)
Report throughput statistics every N
messages
.TP
\fB\-\-report\-header\fR yes|no (1)
Headers on report.
.TP
\fB\-\-send\-rate\fR N (0)
Send at rate of N messages/second. 0
means send as fast as possible.
.TP
\fB\-\-sequence\fR yes|no (1)
Add a sequence number messages property
(required for duplicate/lost message
detection)
.TP
\fB\-\-timestamp\fR yes|no (1)
Add a time stamp messages property
(required for latency measurement)
.TP
\fB\-\-group\-key\fR KEY
Generate groups of messages using
message header 'KEY' to hold the group
identifier
.TP
\fB\-\-group\-prefix\fR STRING (GROUP\-)
Generate group identifiers with 'STRING'
prefix (if group\-key specified)
.TP
\fB\-\-group\-size\fR N (10)
Number of messages per a group (if
group\-key specified)
.TP
\fB\-\-group\-randomize\-size\fR
Randomize the number of messages per
group to [1...group\-size] (if group\-key
specified)
.TP
\fB\-\-group\-interleave\fR N (1)
Simultaineously interleave messages
from N different groups (if group\-key
specified)
.TP
\fB\-\-help\fR
print this usage statement
.SS "Logging options:"
.TP
\fB\-t\fR [ \fB\-\-trace\fR ]
Enables all logging
.TP
\fB\-\-log\-enable\fR RULE (notice+)
Enables logging for selected levels and
components. RULE is in the form
\&'LEVEL[+\-][:PATTERN]'
LEVEL is one of:
.TP
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:
.TP
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
.TP
\fB\-\-log\-disable\fR RULE
Disables logging for selected levels
and components. RULE is in the form
\&'LEVEL[+\-][:PATTERN]'
LEVEL is one of:
.TP
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:
.TP
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
.TP
\fB\-\-log\-time\fR yes|no (1)
Include time in log messages
.TP
\fB\-\-log\-level\fR yes|no (1)
Include severity level in log messages
.TP
\fB\-\-log\-source\fR yes|no (0)
Include source file:line in log
messages
.TP
\fB\-\-log\-thread\fR yes|no (0)
Include thread ID in log messages
.TP
\fB\-\-log\-function\fR yes|no (0)
Include function signature in log
messages
.TP
\fB\-\-log\-hires\-timestamp\fR yes|no (0)
Use hi\-resolution timestamps in log
messages
.TP
\fB\-\-log\-category\fR yes|no (1)
Include category in log messages
.TP
\fB\-\-log\-prefix\fR STRING
Prefix to prepend to all log messages
.SS "Logging sink options:"
.TP
\fB\-\-log\-to\-stderr\fR yes|no (1)
Send logging output to stderr
.TP
\fB\-\-log\-to\-stdout\fR yes|no (0)
Send logging output to stdout
.TP
\fB\-\-log\-to\-file\fR FILE
Send log output to FILE.
.TP
\fB\-\-log\-to\-syslog\fR yes|no (0)
Send logging output to syslog;
customize using \fB\-\-syslog\-name\fR and
\fB\-\-syslog\-facility\fR
.TP
\fB\-\-syslog\-name\fR NAME
Name to use in syslog messages
.TP
\fB\-\-syslog\-facility\fR LOG_XXX (LOG_DAEMON)
Facility to use in syslog messages
.PP
Address must be specified!
.SH AUTHOR

The Apache Qpid Project, dev@qpid.apache.org
.SH "REPORTING BUGS"

Please report bugs to users@qpid.apache.org