# Регистрация обработчиков почты

Чтобы зарегистрировать обработчик, используйте следующую команду:

    # ./mail_handlers_control --add
                    --priority=<number>
                    --name=<handler name>
                    --mailname=<mailname>
                    --queue=<before-local|before-remote|before-queue|before-data>
                    --type=<sender|recipient|sender-domain|recipient-domain|global>
                    --executable=<executable file>
                    [ --context=<context> ]
                    [ --enabled ]

Аргументы этой команды описаны в следующей таблице.

Аргумент | Определение
--- | ---
`--name` | Указывает имя обработчика. Эта строка может содержать любые символы, допустимые в имени файла UNIX (то есть, любые, кроме косой черты и NUL). Регистрация невозможна, если обработчик с указанным именем уже зарегистрирован.
`--type` | Указывает тип обработчика, может принимать следующие значения: `global` обработчик вызывается для всех сообщений. `sender-domain` обработчик вызывается для сообщений, домен адреса отправителя которых совпадает с указанным доменом `recipient-domain` обработчик вызывается для сообщений, домен адреса получателя которых совпадает с указанным доменом `sender` обработчик вызывается для сообщений, адрес отправителя которых совпадает с указанным адресом `recipient` обработчик вызывается для сообщений, адрес получателя которых совпадает с указанным адресом
    --mailname
| Указывает домен или почтовый адрес для типа обработчика. Не требуется, если тип обработчика – `global`.
`--priority` | Указывает приоритет хука в очереди хуков.
`--executable` | Указывает исполняемый файл обработчика. Регистрация невозможна, если указанный файл не существует.
`--context` | Указывает контекст. Это строка типа opaque, передаваемая обработчику через командную строку.
`--enabled` | Указывает, следует ли включать обработчик.
`--queue` | Указывает точку перехвата. Может принимать одно из следующих значений: `before-queue`, `before-local`, `before-remote`, `before-data`. Смотрите подробную информацию в разделе Точки перехвата.

Следующий обработчик добавляется, чтобы отфильтровать корреспонденцию перед локальной доставкой:

    # ./mail_handlers_control --add
        --name=1my_handler-ld
        --type=sender
        --mailname=myema@example.com
        --executable=/usr/local/bin/my_handler.sh
        --context='context'
        --queue=before-local
        --priority=33
        --enabled