deb-triggers

deb-triggers(5)                   dpkg suite                   deb-triggers(5)

NAME
       deb-triggers - package triggers

SYNOPSIS
       triggers

DESCRIPTION
       A  package  declares its relationship to some trigger(s) by including a
       triggers file in  its  control  archive  (i.e.  DEBIAN/triggers  during
       package creation).

       This  file  contains  directives,  one  per  line. Leading and trailing
       whitespace and everything after  the  first  #  on  any  line  will  be
       trimmed, and empty lines will be ignored.

       The trigger control directives currently supported are:

       interest trigger-name
       interest-await trigger-name
       interest-noawait trigger-name

              Specifies  that  the package is interested in the named trigger.
              All triggers in which a package is  interested  must  be  listed
              using this directive in the triggers control file. The "noawait"
              variant does not put the triggering packages in triggers-awaited
              state.  This  should  be used when the functionality provided by
              the trigger is not crucial.

       activate trigger-name
       activate-await trigger-name
       activate-noawait trigger-name

              Arranges that changes to this package's state will activate  the
              specified trigger. The trigger will be activated at the start of
              the following operations: unpack, configure,  remove  (including
              for   the   benefit   of   a  conflicting  package),  purge  and
              deconfigure.  The "noawait" variant does not put the  triggering
              packages in triggers-awaited state. This should be used when the
              functionality provided by the trigger is not crucial.

              If this package  disappears  during  the  unpacking  of  another
              package  the trigger will be activated when the disappearance is
              noted towards the end of the  unpack.  Trigger  processing,  and
              transition  from  triggers-awaited  to installed, does not cause
              activations.  In the case of unpack, triggers mentioned in  both
              the old and new versions of the package will be activated.

       Unknown  directives are an error which will prevent installation of the
       package.

       The "-noawait" variants should always be favored  when  possible  since
       triggering  packages are not put in triggers-awaited state and can thus
       be immediately configured  without  requiring  the  processing  of  the
       trigger.  If the triggering packages are dependencies of other upgraded
       packages, it will avoid an early trigger processing  run  and  make  it
       possible  to  run the trigger only once as one of the last steps of the
       upgrade.

       The "-noawait" variants are supported since dpkg 1.16.1, and will  lead
       to errors if used with an older dpkg.

       The  "-await" alias variants are supported since dpkg 1.17.21, and will
       lead to errors if used with an older dpkg.

SEE ALSO
       dpkg-trigger(1), dpkg(1), /usr/share/doc/dpkg-dev/triggers.txt.gz.

1.19.0.5                          2019-09-05                   deb-triggers(5)
Man Pages Copyright Respective Owners. Site Copyright (C) 1994 - 2021 Hurricane Electric. All Rights Reserved.