chiark - git - mdw - dpkg/blob - man/deb-postinst.man

   1 .\" dpkg manual page - deb-postinst(5)
   2 .\"
   3 .\" Copyright © 2016 Guillem Jover <guillem@debian.org>
   4 .\"
   5 .\" This is free software; you can redistribute it and/or modify
   6 .\" it under the terms of the GNU General Public License as published by
   7 .\" the Free Software Foundation; either version 2 of the License, or
   8 .\" (at your option) any later version.
   9 .\"
  10 .\" This is distributed in the hope that it will be useful,
  11 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
  12 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13 .\" GNU General Public License for more details.
  14 .\"
  15 .\" You should have received a copy of the GNU General Public License
  16 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
  17 .
  18 .TH deb\-postinst 5 "%RELEASE_DATE%" "%VERSION%" "dpkg suite"
  19 .nh
  20 .SH NAME
  21 deb\-postinst \- package post-installation maintainer script
  22 .
  23 .SH SYNOPSIS
  24 postinst
  25 .
  26 .SH DESCRIPTION
  27 A package can perform several post-installation actions via maintainer
  28 scripts, by including an executable \fIpostinst\fP file in its control
  29 archive (i.e. \fIDEBIAN/postinst\fP during package creation).
  30 .PP
  31 The script can be called in the following ways:
  32 .TP
  33 \fIpostinst\fP \fBconfigure\fP \fIold-version\fP
  34 After the package was installed.
  35 .TP
  36 \fIpostinst\fP \fBtriggered\fP \fItrigger-name...\fP
  37 After the package was triggered.
  38 .TP
  39 \fIold-postinst\fP \fBabort-upgrade\fP \fInew-version\fP
  40 If \fIprerm\fP fails during upgrade or fails on failed upgrade.
  41 .TP
  42 \fIold-postinst\fP \fBabort-remove\fP
  43 If \fIprerm\fP fails during removal.
  44 .TP
  45 \fIpostinst\fP \fBabort-deconfigure in-favour\fP \fInew-package new-version\fP
  46 .TQ
  47        [ \fBremoving\fP \fIold-package old-version\fP ]
  48 If \fIprerm\fP fails during deconfiguration of a package.
  49 .TP
  50 \fIpostinst\fP \fBabort-remove in-favour\fP \fInew-package new-version\fP
  51 If \fIprerm\fP fails during replacement due to conflict.
  52 .
  53 .SH SEE ALSO
  54 .BR dpkg (1).