---
name: "fedmsg-tail"
section: "1"
platform: "linux"
package: "fedmsg"
version: "0.9.3-1"
release: "Debian 8 (Jessie)"
platforms: ["linux"]
url: "https://new.carta.tech/fedmsg-tail"
---

# fedmsg-tail(1)

listen to the fedmsg bus and print the received messages

## NAME

fedmsg-tail - listen to the fedmsg bus and print the received messages

## SYNOPSIS

**fedmsg-tail** \[**--terse**\|**--pretty**\|**--really-pretty**\|**--query** *QUERY\_STRING*\] \[**--topic** *TOPIC*\] \[**--exclude** *REGEXP*\] \[**--include** *REGEXP*\] \[**--users** *USERS*\] \[**--packages** *PACKAGES*\] \[*\<common fedmsg options\>*\]

**fedmsg-tail** \[**-h**\|**--help**\]

## DESCRIPTION

**fedmsg-tail** connects to all the configured enpoints on the bus, filters the messages according to the filter options, and pretty-prints them to the standard output according to the formatting options.

## OPTIONS

- **-h**, **--help**

  Print an help message and exit

**FILTERING**

- **--topic** TOPIC

  The topic pattern to listen for. Everything by default.

- **--exclude** REGEXP

  Only show topics that do not match the supplied regexp.

- **--include** REGEXP

  Only show topics that match the supplied regexp.

- **--users** USERS

  A comma-separated list of usernames. Show only the messages related to these users.

- **--packages** PACKAGES

  A comma-separated list of packages. Show only the messages related to these packages.

**FORMATTING**

- **--terse**

  Print "english" representations of messages only.

- **--pretty**

  Pretty print the JSON messages.

- **--really-pretty**

  Extra-pretty print the JSON messages.

- **--query** QUERY\_STRING

  Displays only message contents matching the QUERY\_STRING instead of everything.

## COMMON FEDMSG OPTIONS

- **--io-threads** IO\_THREADS

  Number of io threads for 0mq to use

- **--topic-prefix** TOPIC\_PREFIX

  Prefix for the topic of each message sent.

- **--post-init-sleep** POST\_INIT\_SLEEP

  Number of seconds to sleep after initializing.

- **--config-filename** CONFIG\_FILENAME

  Config file to use.

- **--print-config**

  Simply print out the configuration and exit. No action taken.

- **--timeout** TIMEOUT

  Timeout in seconds for any blocking zmq operations.

- **--high-water-mark** HIGH\_WATER\_MARK

  Limit on the number of messages in the queue before blocking.

- **--linger** ZMQ\_LINGER

  Number of milliseconds to wait before timing out connections.

## AUTHORS

- **The Fedora Infrastructure team** \<messaging-sig@lists.fedoraproject.org\>

  Wrote the **fedmsg** software.

- **Nicolas Dandrimont** \<olasd@debian.org\>

  Wrote this manpage for the Debian system.

## COPYRIGHT

Copyright © 2014 Nicolas Dandrimont\

This manual page was written for the Debian system (and may be used by others).

You can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.

On Debian systems, a copy of the license can be found in the */usr/share/common-licenses/LGPL-2.1* file.