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
11       dpkg-trigger [option...] command
12

DESCRIPTION

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

COMMANDS

26       --check-supported
27           Check if the running dpkg supports triggers (usually called from a
28           postinst). Will exit 0 if a triggers-capable dpkg has run, or 1
29           with an error message to stderr if not. Normally, however, it is
30           better just to activate the desired trigger with 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 is
41           /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 this
47           will be used by default).
48
49       --no-await
50           This option arranges that the calling package T (if any) need not
51           await the processing of this trigger; the interested package(s) I,
52           will not be added to T's trigger processing awaited list and T's
53           status is unchanged.  T may be considered installed even though I
54           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, then
59           this option will not be effective.  It is currently the default
60           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, or
72           interactions with the system, such as accesses to the database,
73           memory allocations, etc.
74

ENVIRONMENT

76       DPKG_ADMINDIR
77           If set and the --admindir option has not been specified, it will be
78           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