From 9a08cbfcc1ef900a04580f35afe2a4592d7d6030 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Mon, 6 May 2024 02:45:20 +0200 Subject: Adding upstream version 1.19.8. Signed-off-by: Daniel Baumann --- man/dpkg-trigger.man | 113 +++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 113 insertions(+) create mode 100644 man/dpkg-trigger.man (limited to 'man/dpkg-trigger.man') diff --git a/man/dpkg-trigger.man b/man/dpkg-trigger.man new file mode 100644 index 0000000..65fdd9a --- /dev/null +++ b/man/dpkg-trigger.man @@ -0,0 +1,113 @@ +.\" dpkg manual page - dpkg-trigger(1) +.\" +.\" Copyright © 2008-2015 Guillem Jover +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see . +. +.TH dpkg\-trigger 1 "%RELEASE_DATE%" "%VERSION%" "dpkg suite" +.nh +.SH NAME +dpkg\-trigger \- a package trigger utility +. +.SH SYNOPSIS +.B dpkg\-trigger +.RI [ option "...] " trigger-name +.br +.B dpkg\-trigger +.RI [ option "...] " command +. +.SH DESCRIPTION +\fBdpkg\-trigger\fP is a tool to explicitly activate triggers and check +for its support on the running \fBdpkg\fP. +.PP +This can be used by maintainer scripts in complex and conditional +situations where the file triggers, or the declarative \fBactivate\fP +triggers control file directive, are insufficiently rich. It can also +be used for testing and by system administrators (but note that the +triggers won't actually be run by \fBdpkg\-trigger\fP). +.PP +Unrecognized trigger name syntaxes are an error for \fBdpkg\-trigger\fP. +. +.SH COMMANDS +.TP +.B \-\-check\-supported +Check if the running \fBdpkg\fP supports triggers (usually called from a +postinst). Will exit \fB0\fP if a triggers-capable \fBdpkg\fP has run, +or \fB1\fP with an error message to stderr if not. Normally, however, +it is better just to activate the desired trigger with \fBdpkg\-trigger\fP. +.TP +.BR \-? ", " \-\-help +Show the usage message and exit. +.TP +.B \-\-version +Show the version and exit. +. +.SH OPTIONS +.TP +.BI \-\-admindir= dir +Change the location of the \fBdpkg\fR database. The default location is +\fI%ADMINDIR%\fP. +.TP +.BI \-\-by\-package= package +Override trigger awaiter (normally set by \fBdpkg\fP through the +\fBDPKG_MAINTSCRIPT_PACKAGE\fP environment variable of the maintainer scripts, +naming the package to which the script belongs, and this will be used +by default). +.TP +.B \-\-no\-await +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. +.TP +.B \-\-await +This option does the inverse of \fB\-\-no\-await\fP (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. +.TP +.B \-\-no\-act +Just test, do not actually change anything. +. +.SH EXIT STATUS +.TP +.B 0 +The requested action was successfully performed. +Or a check or assertion command returned true. +.TP +.B 1 +A check or assertion command returned false. +.TP +.B 2 +Fatal or unrecoverable error due to invalid command-line usage, or +interactions with the system, such as accesses to the database, +memory allocations, etc. +. +.SH ENVIRONMENT +.TP +.B DPKG_ADMINDIR +If set and the \fB\-\-admindir\fP option has not been specified, it will +be used as the \fBdpkg\fP data directory. +.TP +.B DPKG_COLORS +Sets the color mode (since dpkg 1.18.5). +The currently accepted values are: \fBauto\fP (default), \fBalways\fP and +\fBnever\fP. +. +.SH SEE ALSO +.BR dpkg (1), +.BR deb\-triggers (5), +.\" FIXME: Unhardcode the pathname, and use dpkg instead of dpkg-dev. +.BR /usr/share/doc/dpkg\-dev/triggers.txt.gz . -- cgit v1.2.3