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