# Facility

Sets the syslog facility for messages read from this file.

This parameter applies to imfile: Text File Input Module.

Name:

  Facility

Scope:

  input

Type:

  word

Default:

  local0

Required?:

  no

Introduced:

  at least 5.x, possibly earlier

## Description

The syslog facility to be assigned to messages read from this file. It can be specified in textual form (for example `local0`) or as a number (for example `16`). Textual form is recommended.

## Input usage

    input(type="imfile"
          File="/var/log/example.log"
          Tag="example"
          Facility="local0")

## Notes

- See https://en.wikipedia.org/wiki/Syslog for facility numbers.

### Legacy names (for reference)

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

- `$InputFileFacility` — maps to Facility (status: legacy)

## See also

See also imfile: Text File Input 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.