FreeBSD manual

download PDF document: pkg-triggers.5.pdf

PKG-TRIGGERS(5) FreeBSD File Formats Manual PKG-TRIGGERS(5)
NAME triggers - trigger file format
DESCRIPTION triggers are executed at the end of the transactions: installation, deinstallation or upgrade. They are only executed once even if they have been triggered multiple times.
are triggered by pattern matching during the transaction. triggers are files located in /usr/local/share/pkg/triggers Those files are in UCL format and should use a .ucl extension.
The format is the following:
path exact path to match: each time a package installs a file or directory exactly matching the path the trigger will be executed at the end of the transation .
path_glob glob path to match: each time a package installs a file or directory which matches the glob pattern pattern the trigger will be executed at the end of the transation .
path_regexp regexp path to match: each time a package installs a file or directory which matches the regexp pattern pattern the trigger will be executed at the end of the transation .

cleanup Object which represent the script to execute in case the transaction results in removal of the trigger from the installation. The object requires the following fields:
type The type of the script to be executed, currently only lua script is supported (See pkg-lua-script(5)).
script The script itself.
trigger Object which represent the script to execute at the end of the transaction if a pattern has been matched. This object requires the following fields:
type The type of the script to be executed, currently only lua script is supported (See pkg-lua-script(5)).
script The script itself. It will receive as arguments the list of paths that matched the patterns during the transaction.
SEE ALSO pkg_create(3), pkg_printf(3), pkg_repos(3), pkg-keywords(5), pkg-lua-script(5), pkg-repository(5), pkg-script(5), pkg.conf(5), pkg(8), pkg-add(8), pkg-alias(8), pkg-annotate(8), pkg-audit(8), pkg-autoremove(8), pkg-check(8), pkg-clean(8), pkg-config(8), pkg-create(8), pkg-delete(8), pkg-fetch(8), pkg-info(8), pkg-install(8), pkg-lock(8), pkg-query(8), pkg-register(8), pkg-repo(8), pkg-rquery(8), pkg-search(8), pkg-set(8), pkg-shell(8), pkg-shlib(8), pkg-ssh(8),