IMPORT(7)

NAME

import - includes files or references snippets from a Conffile

DESCRIPTION

The import handler can be used to include files into the main configuration. Another use is to reference predefined snippets. Both can help to avoid some duplication.

This is a unique handler in that import can appear outside of a handler block. In other words, it can appear at the top of a Conffile where an address would normally be.

You can have a maximum of 1000 imports in the configuration, this is to prevent cycles.

SYNTAX

    import PATTERN

•   PATTERN is the file, glob pattern (*) or snippet to include. Its contents will replace this line, as if that file's contents appeared here to begin with.

FILES

You can use import to include a file or files. This file's location is relative to the Conffile's location. It is an error if a specific file cannot be found, but an empty glob pattern is not an error.

SNIPPETS

You can define snippets to be reused later in your Conffile by defining a block with a single-token label surrounded by parentheses:

    (mysnippet) {
        ...
    }

Then you can invoke the snippet with import:

    import mysnippet

EXAMPLES

Import a shared configuration:

    . {
       import config/common.conf
    }

Where config/common.conf contains:

    prometheus
    errors
    log

This imports files found in the zones directory:

    import ../zones/*

SEE ALSO

See atomdns-conffile(5).