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

   1 .\" dpkg manual page - deb-preinst(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\-preinst 5 "%RELEASE_DATE%" "%VERSION%" "dpkg suite"
  19 .nh
  20 .SH NAME
  21 deb\-preinst \- package pre-installation maintainer script
  22 .
  23 .SH SYNOPSIS
  24 preinst
  25 .
  26 .SH DESCRIPTION
  27 A package can perform several pre-installation actions via maintainer
  28 scripts, by including an executable \fIpreinst\fP file in its control
  29 archive (i.e. \fIDEBIAN/preinst\fP during package creation).
  30 .PP
  31 The script can be called in the following ways:
  32 .TP
  33 \fInew-preinst\fP \fBinstall\fP
  34 Before the package is installed.
  35 .TP
  36 \fInew-preinst\fP \fBinstall\fP \fIold-version new-version\fP
  37 Before removed package is upgraded.
  38 .TP
  39 \fInew-preinst\fP \fBupgrade\fP \fIold-version new-version\fP
  40 Before the package is upgraded.
  41 .TP
  42 \fIold-preinst\fP \fBabort-upgrade\fP \fInew-version\fP
  43 If \fIpostrm\fP fails during upgrade or fails on failed upgrade.
  44 .
  45 .SH SEE ALSO
  46 .BR dpkg (1).