8 Inclusion

Overview

Additional files or directories can be included into server/proxy/agent configuration using the Include parameter.

Notes on inclusion

If the Include parameter is used for including a file, the file must be readable.

If the Include parameter is used for including a directory:

1. All files in the directory must be readable.

2. No particular order of inclusion should be assumed (e.g. files are not included in alphabetical order). Therefore do not define one parameter in several Include files (e.g. to override a general setting with a specific one).

3. All files in the directory are included into configuration.

4. Beware of file backup copies automatically created by some text editors. For example, if editing the include/my_specific.conf file produces a backup copy include/my_specific_conf.BAK then both files will be included. Move include/my_specific.conf.BAK out of the “Include” directory. On Linux, contents of the Include directory can be checked with a ls -al command for unnecessary files.

If the Include parameter is used for including files using a pattern:

1. All files matching the pattern must be readable.

2. No particular order of inclusion should be assumed (e.g. files are not included in alphabetical order). Therefore do not define one parameter in several Include files (e.g. to override a general setting with a specific one).