# rotation.sizeLimit

This permits to set a size limit on the output file.

This parameter applies to omfile: File Output Module.

Name:

  rotation.sizeLimit

Scope:

  action

Type:

  size

Default:

  action=0 (disabled)

Required?:

  no

Introduced:

  at least 5.x, possibly earlier

## Description

This permits to set a size limit on the output file. When the limit is reached, rotation of the file is tried. The rotation script needs to be configured via rotation.sizeLimitCommand.

Please note that the size limit is not exact. Some excess bytes are permitted to prevent messages from being split across two files. Also, a full batch of messages is not terminated in between. As such, in practice, the size of the output file can grow some KiB larger than configured.

Also avoid to configure a too-low limit, especially for busy files. Calling the rotation script is relatively performance intense. As such, it could negatively affect overall rsyslog performance.

## Action usage

    action(type="omfile" rotation.sizeLimit="...")

### Legacy names (for reference)

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

- $outchannel — maps to rotation.sizeLimit (status: legacy)

## See also

See also omfile: File 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.