{ "content": [ { "type": "text", "text": "# dpkg-trigger (info)\n\n## NAME\n\ndpkg-trigger - a package trigger utility\n\n## SYNOPSIS\n\ndpkg-trigger [option...] trigger-name\ndpkg-trigger [option...] command\n\n## DESCRIPTION\n\ndpkg-trigger is a tool to explicitly activate triggers and check for\nits support on the running dpkg.\n\n## Sections\n\n- **NAME**\n- **SYNOPSIS**\n- **DESCRIPTION**\n- **COMMANDS** (2 subsections)\n- **OPTIONS** (3 subsections)\n- **EXIT STATUS**\n- **ENVIRONMENT**\n- **SEE ALSO**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n" } ], "structuredContent": { "command": "dpkg-trigger", "section": "", "mode": "info", "summary": "dpkg-trigger - a package trigger utility", "synopsis": "dpkg-trigger [option...] trigger-name\ndpkg-trigger [option...] command", "tldr_summary": null, "tldr_examples": [], "tldr_source": null, "flags": [ { "flag": "", "long": "--no-await", "arg": null, "description": "This option arranges that the calling package T (if any) need not await the processing of this trigger; the interested package(s) I, will not be added to T's trigger processing awaited list and T's status is unchanged. T may be considered installed even though I may not yet have processed the trigger." }, { "flag": "", "long": "--await", "arg": null, "description": "This option does the inverse of --no-await (since dpkg 1.17.21). If the interested package has declared a \"noawait\" directive, then this option will not be effective. It is currently the default behavior." }, { "flag": "", "long": "--no-act", "arg": null, "description": "Just test, do not actually change anything." } ], "examples": [], "see_also": [ { "name": "dpkg", "section": "1", "url": "https://www.chedong.com/phpMan.php/man/dpkg/1/json" }, { "name": "deb-triggers", "section": "5", "url": "https://www.chedong.com/phpMan.php/man/deb-triggers/5/json" } ], "section_outline": [ { "name": "NAME", "lines": 2, "subsections": [] }, { "name": "SYNOPSIS", "lines": 4, "subsections": [] }, { "name": "DESCRIPTION", "lines": 11, "subsections": [] }, { "name": "COMMANDS", "lines": 1, "subsections": [ { "name": "--check-supported", "lines": 8, "long": "--check-supported" }, { "name": "--version", "lines": 2, "long": "--version" } ] }, { "name": "OPTIONS", "lines": 14, "subsections": [ { "name": "--no-await", "lines": 6, "long": "--no-await" }, { "name": "--await", "lines": 5, "long": "--await" }, { "name": "--no-act", "lines": 2, "long": "--no-act" } ] }, { "name": "EXIT STATUS", "lines": 9, "subsections": [] }, { "name": "ENVIRONMENT", "lines": 12, "subsections": [] }, { "name": "SEE ALSO", "lines": 3, "subsections": [] } ], "sections": { "NAME": { "content": "dpkg-trigger - a package trigger utility\n", "subsections": [] }, "SYNOPSIS": { "content": "dpkg-trigger [option...] trigger-name\n\ndpkg-trigger [option...] command\n", "subsections": [] }, "DESCRIPTION": { "content": "dpkg-trigger is a tool to explicitly activate triggers and check for\nits support on the running dpkg.\n\nThis can be used by maintainer scripts in complex and conditional\nsituations where the file triggers, or the declarative activate\ntriggers control file directive, are insufficiently rich. It can also\nbe used for testing and by system administrators (but note that the\ntriggers won't actually be run by dpkg-trigger).\n\nUnrecognized trigger name syntaxes are an error for dpkg-trigger.\n", "subsections": [] }, "COMMANDS": { "content": "", "subsections": [ { "name": "--check-supported", "content": "Check if the running dpkg supports triggers (usually called from a\npostinst). Will exit 0 if a triggers-capable dpkg has run, or 1\nwith an error message to stderr if not. Normally, however, it is\nbetter just to activate the desired trigger with dpkg-trigger.\n\n-?, --help\nShow the usage message and exit.\n", "long": "--check-supported" }, { "name": "--version", "content": "Show the version and exit.\n", "long": "--version" } ] }, "OPTIONS": { "content": "--admindir=dir\nChange the location of the dpkg database. The default location is\n/var/lib/dpkg.\n\n--root=directory\nSet the root directory to directory, which sets the administrative\ndirectory to <> (since dpkg 1.21.0).\n\n--by-package=package\nOverride trigger awaiter (normally set by dpkg through the\nDPKGMAINTSCRIPTPACKAGE environment variable of the maintainer\nscripts, naming the package to which the script belongs, and this\nwill be used by default).\n", "subsections": [ { "name": "--no-await", "content": "This option arranges that the calling package T (if any) need not\nawait the processing of this trigger; the interested package(s) I,\nwill not be added to T's trigger processing awaited list and T's\nstatus is unchanged. T may be considered installed even though I\nmay not yet have processed the trigger.\n", "long": "--no-await" }, { "name": "--await", "content": "This option does the inverse of --no-await (since dpkg 1.17.21).\nIf the interested package has declared a \"noawait\" directive, then\nthis option will not be effective. It is currently the default\nbehavior.\n", "long": "--await" }, { "name": "--no-act", "content": "Just test, do not actually change anything.\n", "long": "--no-act" } ] }, "EXIT STATUS": { "content": "0 The requested action was successfully performed. Or a check or\nassertion command returned true.\n\n1 A check or assertion command returned false.\n\n2 Fatal or unrecoverable error due to invalid command-line usage, or\ninteractions with the system, such as accesses to the database,\nmemory allocations, etc.\n", "subsections": [] }, "ENVIRONMENT": { "content": "DPKGROOT\nIf set and the --root option has not been specified, it will be\nused as the filesystem root directory (since dpkg 1.21.0).\n\nDPKGADMINDIR\nIf set and the --admindir option has not been specified, it will be\nused as the dpkg data directory.\n\nDPKGCOLORS\nSets the color mode (since dpkg 1.18.5). The currently accepted\nvalues are: auto (default), always and never.\n", "subsections": [] }, "SEE ALSO": { "content": "dpkg(1), deb-triggers(5), /usr/share/doc/dpkg/triggers.txt.gz.\n\n1.21.1 2025-09-09 dpkg-trigger(1)", "subsections": [] } } } }