# binary

Specifies the command line of the external program to execute.

This parameter applies to omprog: Program integration Output module.

Name:

  binary

Scope:

  action

Type:

  string

Default:

  none

Required?:

  yes

Introduced:

  at least 5.x, possibly earlier

## Description

Full path and command line parameters of the external program to execute. Arbitrary external programs should be placed under the /usr/libexec/rsyslog directory. That is, the binaries put in this namespaced directory are meant for the consumption of rsyslog, and are not intended to be executed by users. In legacy config, it is not possible to specify command line parameters.

## Action usage

    action(type="omprog" binary="/usr/libexec/rsyslog/log.sh")

### Legacy names (for reference)

Historic names/directives for compatibility. Do not use in new configs.

- $ActionOMProgBinary — maps to binary (status: legacy)

## See also

See also omprog: Program integration Output module.

Support: rsyslog Assistant | GitHub Discussions | GitHub Issues: rsyslog source project

Contributing: Source & docs: rsyslog source project

© 2008–2025 Rainer Gerhards and others. Licensed under the Apache License 2.0.