# failOnChOwnFailure

This option modifies behaviour of file creation.

This parameter applies to omfile: File Output Module.

Name:

  failOnChOwnFailure

Scope:

  action

Type:

  boolean

Default:

  action=on

Required?:

  no

Introduced:

  at least 5.x, possibly earlier

## Description

This option modifies behaviour of file creation. If different owners or groups are specified for new files or directories and rsyslogd fails to set these new owners or groups, it will log an error and NOT write to the file in question if that option is set to “on”. If it is set to “off”, the error will be ignored and processing continues. Keep in mind, that the files in this case may be (in)accessible by people who should not have permission. The default is “on”.

## Action usage

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

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

- $FailOnCHOwnFailure — maps to failOnChOwnFailure (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.