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

# fedmsg-trigger(1)

run a command when messages arrive on the fedmsg bug

## NAME

fedmsg-trigger - run a command when messages arrive on the fedmsg bug

## SYNOPSIS

**fedmsg-trigger** \[**--topic** *TOPIC*\] \[**--exclude** *REGEXP*\] \[**--include** *REGEXP*\] **--command** *COMMAND* \[*\<common fedmsg options\>*\]

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

## DESCRIPTION

**fedmsg-trigger** runs the command *COMMAND* every time a message matching the filtering options is received on the fedmsg bus. It passes the contents of the received message on the standard input of the command.

## OPTIONS

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

  Print an help message and exit

- **--command** COMMAND

  Command to run when a message matches our criteria.

**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.

## 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.