dpkg (1.18.25) stretch; urgency=medium
[dpkg] / man / deb-postrm.man
1 .\" dpkg manual page - deb-postrm(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\-postrm 5 "%RELEASE_DATE%" "%VERSION%" "dpkg suite"
19 .nh
20 .SH NAME
21 deb\-postrm \- package post-removal maintainer script
22 .
23 .SH SYNOPSIS
24 postrm
25 .
26 .SH DESCRIPTION
27 A package can perform several post-removal actions via maintainer
28 scripts, by including an executable \fIpostrm\fP file in its control
29 archive (i.e. \fIDEBIAN/postrm\fP during package creation).
30 .PP
31 The script can be called in the following ways:
32 .TP
33 \fIpostrm\fP \fBremove\fP
34 After the package was removed.
35 .TP
36 \fIpostrm\fP \fBpurge\fP
37 After the package was purged.
38 .TP
39 \fIold-postrm\fP \fBupgrade\fP \fInew-version\fP
40 After the package was upgraded.
41 .TP
42 \fInew-postrm\fI \fBfailed-upgrade\fP \fIold-version new-version\fP
43 If the above \fBupgrade\fP call fails.
44 .TP
45 \fIpostrm\fP \fBdisappear\fP \fIoverwriter-package\fP \fIoverwriter-version\fP
46 After all of the packages files have been replaced.
47 .TP
48 \fInew-postrm\fP \fBabort-install\fP
49 If \fIpreinst\fP fails during install.
50 .TP
51 \fInew-postrm\fP \fBabort-install\fP \fIold-version new-version\fP
52 If \fIpreinst\fP fails during upgrade of removed package.
53 .TP
54 \fInew-postrm\fP \fBabort-upgrade\fP \fIold-version new-version\fP
55 If \fIpreinst\fP fails during upgrade.
56 .
57 .SH SEE ALSO
58 .BR dpkg (1).