---
name: "qpidd"
section: "1"
platform: "linux"
package: "qpidd"
version: "0.16-6+deb7u1"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://new.carta.tech/qpidd"
---

# qpidd(1)

the Qpid AMQP Message Broker Daemon

## NAME

qpidd - the Qpid AMQP Message Broker Daemon

## SYNOPSIS

qpidd \[-p port\] \[--config config\_file\] \[--data-dir directory\]

## DESCRIPTION

An AMQP message broker daemon that stores, routes and forwards messages using the Advanced Message Queueing Protocol (AMQP).

## OPTIONS

The options below are built-in to qpidd. Installing add-on modules provides additional options. To see the full set of options available type "qpidd --help"

Options may be specified via command line, environment variable or configuration file. See FILES and ENVIRONMENT below for details.

- **-h** \[ **--help** \]

  Displays the help message

- **-v** \[ **--version** \]

  Displays version information

- **--config** FILE (/etc/qpidd.conf)

  Reads configuration from FILE

### Module options:

- **--module-dir** DIR (/usr/lib/qpid/daemon)

  Load all shareable modules in this directory

- **--load-module** FILE

  Specifies additional module(s) to be loaded

- **--no-module-dir**

  Don't load modules from module directory

### Broker Options:

- **--data-dir** DIR (/home/cajus/.qpidd)

  Directory to contain persistent data generated by the broker

- **--no-data-dir**

  Don't use a data directory.  No persistent configuration will be loaded or stored

- **-p** \[ **--port** \] PORT (5672)

  Tells the broker to listen on PORT

- **--worker-threads** N (2)

  Sets the broker thread pool size

- **--max-connections** N (500)

  Sets the maximum allowed connections

- **--connection-backlog** N (10)

  Sets the connection backlog limit for the server socket

- **-m** \[ **--mgmt-enable** \] yes\|no (1)

  Enable Management

- **--mgmt-publish** yes\|no (1)

  Enable Publish of Management Data ('no' implies query-only)

- **--mgmt-qmf2** yes\|no (1)

  Enable broadcast of management information over QMF v2

- **--mgmt-qmf1** yes\|no (1)

  Enable broadcast of management information over QMF v1

- **--mgmt-pub-interval** SECONDS (10)

  Management Publish Interval

- **--queue-purge-interval** SECONDS (600)

  Interval between attempts to purge any expired messages from queues

- **--auth** yes\|no (1)

  Enable authentication, if disabled all incoming connections will be trusted

- **--realm** REALM (QPID)

  Use the given realm when performing authentication

- **--default-queue-limit** BYTES (104857600)

  Default maximum size for queues (in bytes)

- **--tcp-nodelay**

  Set TCP\_NODELAY on TCP connections

- **--require-encryption**

  Only accept connections that are encrypted

- **--known-hosts-url** URL or 'none'

  URL to send as 'known-hosts' to clients ('none' implies empty list)

- **--sasl-config** DIR

  gets sasl config info from nonstandard location

- **--async-queue-events** yes\|no (0)

  Set Queue Events async, used for services like replication

- **--default-flow-stop-threshold** PERCENT (80)

  Percent of queue's maximum capacity at which flow control is activated.

- **--default-flow-resume-threshold** PERCENT (70)

  Percent of queue's maximum capacity at which flow control is de-activated.

- **--default-event-threshold-ratio** %age of limit (80)

  The ratio of any specified queue limit at which an event will be raised

- **--default-message-group** GROUP-IDENTIFER (qpid.no-group)

  Group identifier to assign to messages delivered to a message group queue that do not contain an identifier.

- **--enable-timestamp** yes\|no (0)

  Add current time to each received message.

**--link-maintenace-interval** SECONDS (2)

### Logging options:

- **-t** \[ **--trace** \]

  Enables all logging

- **--log-enable** RULE (notice+)

  Enables logging for selected levels and components. RULE is in the form 'LEVEL\[+\]\[:PATTERN\]' Levels are one of:

-

  trace debug info notice warning error

-

  critical For example: '--log-enable warning+' logs all warning, error and critical messages. '--log-enable debug:framing' logs debug messages from the framing namespace. This option can be used multiple times

- **--log-time** yes\|no (1)

  Include time in log messages

- **--log-level** yes\|no (1)

  Include severity level in log messages

- **--log-source** yes\|no (0)

  Include source file:line in log messages

- **--log-thread** yes\|no (0)

  Include thread ID in log messages

- **--log-function** yes\|no (0)

  Include function signature in log messages

- **--log-hires-timestamp** yes\|no (0)

  Use hi-resolution timestamps in log messages

- **--log-prefix** STRING

  Prefix to append to all log messages

### Logging sink options:

- **--log-to-stderr** yes\|no (1)

  Send logging output to stderr

- **--log-to-stdout** yes\|no (0)

  Send logging output to stdout

- **--log-to-file** FILE

  Send log output to FILE.

- **--log-to-syslog** yes\|no (0)

  Send logging output to syslog; customize using **--syslog-name** and **--syslog-facility**

- **--syslog-name** NAME (lt-qpidd)

  Name to use in syslog messages

- **--syslog-facility** LOG\_XXX (LOG\_DAEMON)

  Facility to use in syslog messages

### Daemon options:

- **-d** \[ **--daemon** \]

  Run as a daemon. Logs to syslog by default in this mode.

- **--transport** TRANSPORT (tcp)

  The transport for which to return the port

- **--pid-dir** DIR (/home/cajus/.qpidd)

  Directory where port-specific PID file is stored

- **-w** \[ **--wait** \] SECONDS (600)

  Sets the maximum wait time to initialize the daemon. If the daemon fails to initialize, prints an error and returns 1

- **-c** \[ **--check** \]

  Prints the daemon's process ID to stdout and returns 0 if the daemon is running, otherwise returns 1

- **-q** \[ **--quit** \]

  Tells the daemon to shut down

## ENVIRONMENT

*QPID\_\<option\>*

There is an environment variable for each option.

The environment variable is the option name in uppercase, prefixed with QPID\_ and '.' or '-' are replaced with '\_'. Environment settings are over-ridden by command line settings. For example:

  export QPID\_PORT=6000\
   export QPID\_MAX\_CONNECTIONS=10\
   export QPID\_LOG\_TO\_FILE=/tmp/qpidd.log

## FILES

*/etc/qpidd.conf*

Default configuration file.

Configuration file settings are over-ridden by command line or environment variable settings. '--config \<file\>' or 'export QPID\_CONFIG=\<file\>' specifies an alternate file.

Each line is a name=value pair. Blank lines and lines beginning with # are ignored. For example:

  \# My qpidd configuration file.\
   port=6000\
   max-connections=10\
   log-to-file=/tmp/qpidd.log

## AUTHOR

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

## REPORTING BUGS

Please report bugs to users@qpid.apache.org