dpkg-trigger(1)

1dpkg-trigger(1)                   dpkg suite                   dpkg-trigger(1)
2
3
4

NAME

6       dpkg-trigger - a package trigger utility
7

SYNOPSIS

9       dpkg-trigger [option...] trigger-name
10       dpkg-trigger [option...] command
11

DESCRIPTION

13       dpkg-trigger  is  a  tool to explicitly activate triggers and check for
14       its support on the running dpkg.
15
16       This can be used by  maintainer  scripts  in  complex  and  conditional
17       situations  where  the  file  triggers,  or  the  declarative  activate
18       triggers control file directive, are insufficiently rich. It  can  also
19       be  used  for  testing  and by system administrators (but note that the
20       triggers won't actually be run by dpkg-trigger).
21
22       Unrecognized trigger name syntaxes are an error for dpkg-trigger.
23

COMMANDS

25       --check-supported
26              Check if the running dpkg supports triggers (usually called from
27              a  postinst). Will exit 0 if a triggers-capable dpkg has run, or
28              1 with an error message to stderr if not. Normally, however,  it
29              is   better   just   to   activate   the  desired  trigger  with
30              dpkg-trigger.
31
32       -?, --help
33              Show the usage message and exit.
34
35       --version
36              Show the version and exit.
37

OPTIONS

39       --admindir=dir
40              Change the location of the dpkg database. The  default  location
41              is /var/lib/dpkg.
42
43       --by-package=package
44              Override  trigger  awaiter  (normally  set  by  dpkg through the
45              DPKG_MAINTSCRIPT_PACKAGE environment variable of the  maintainer
46              scripts,  naming  the  package  to which the script belongs, and
47              this will be used by default).
48
49       --no-await
50              This option arranges that the calling package T  (if  any)  need
51              not  await  the  processing  of  this  trigger;  the  interested
52              package(s) I, will  not  be  added  to  T's  trigger  processing
53              awaited  list  and T's status is unchanged.  T may be considered
54              installed even though I may not yet have processed the trigger.
55
56       --await
57              This option does the inverse of --no-await (since dpkg 1.17.21).
58              If  the  interested  package has declared a “noawait” directive,
59              then this option will not be effective.   It  is  currently  the
60              default behavior.
61
62       --no-act
63              Just test, do not actually change anything.
64

EXIT STATUS

66       0      The  requested action was successfully performed.  Or a check or
67              assertion command returned true.
68
69       1      A check or assertion command returned false.
70
71       2      Fatal or unrecoverable error due to invalid command-line  usage,
72              or  interactions  with  the  system,  such  as  accesses  to the
73              database, memory allocations, etc.
74

ENVIRONMENT

76       DPKG_ADMINDIR
77              If set and the --admindir option has not been specified, it will
78              be used as the dpkg data directory.
79
80       DPKG_COLORS
81              Sets the color mode (since dpkg 1.18.5).  The currently accepted
82              values are: auto (default), always and never.
83