# asyncWriting

If turned on, the files will be written in asynchronous mode via a separate thread.

This parameter applies to omfile: File Output Module.

Name:

  asyncWriting

Scope:

  action

Type:

  boolean

Default:

  action=off

Required?:

  no

Introduced:

  at least 5.x, possibly earlier

## Description

If turned on, the files will be written in asynchronous mode via a separate thread. In that case, double buffers will be used so that one buffer can be filled while the other buffer is being written. Note that in order to enable FlushInterval, AsyncWriting must be set to “on”. Otherwise, the flush interval will be ignored.

## Action usage

    action(type="omfile" asyncWriting="...")

## Notes

- Legacy documentation referred to the type as `binary`; this maps to `boolean`.

### Legacy names (for reference)

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

- $OMFileASyncWriting — maps to asyncWriting (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.