summaryrefslogtreecommitdiffstats
path: root/pod/urpme.8.pod
blob: 5b46ae2f5ec3de26081848aac97fc7ec5609bfcf (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
=head1 NAME

urpme - rpm deinstaller

=head1 SYNOPSIS

    urpme [options] [package_name...]

=head1 DESCRIPTION

urpme allows packages to be deinstalled, including all their dependencies.
I<package_names> must have one of the forms I<name>, I<name-version>,
I<name-version-release>, or I<name-version-release.architecture>. If you
want to specify packages more broadly, use the B<-a> option.

=head1 OPTIONS

=over

=item B<--help>

Prints a help message and exit (this is the same as B<-h> or B<-?>).

=item B<-a>

If multiple packages match the given substring, deinstall them all.

=item B<-v>

Proposes a verbose mode with various messages.

=item B<--auto>

Removes packages non-interactively, without asking questions.

=item B<--test>

Test deinstallation of packages but do not modify the system.

=item B<--force>

Force invocation even if some packages do not exist.

=item B<--noscripts>

Don't execute the scriptlets. This is equivalent to B<rpm --noscripts>.
This can be useful to remove packages where uninstall scriptlets fail for
some reason.

=item B<--parallel> I<alias>

Activate distributed execution of urpmi to other machines (it is mandatory
that urpmi is installed, but it is not necessary to have media defined on
any machines). I<alias> defines which extension module is to be used by
urpmi (currently, urpmi-parallel-ka-run or urpmi-parallel-ssh are
available) and which machines should be updated. This alias is defined in
the file F</etc/urpmi/parallel.cfg> as described below.

=item B<--repackage>

Save previous state of upgraded packages; in other words, save the old
rpms (usually in F</var/spool/repackage>, but you can override this with
an rpm macro.) This is equivalent to providing the B<--repackage> flag to
rpm.

If you want to use the repackage/rollback functionality of rpm, you should
check out the C<urpmi.recover> tool.

=item B<--root> I<directory>

Use the file system tree rooted for rpm install. All operations and
scripts will run after chroot(2). The rpm database that lies in the
rooted tree will be used, but the urpmi configuration comes from the
normal system.

=item B<--use-distrib> I<directory>

Configure urpme on the fly from a distribution tree.

=back

=head1 FILES

See urpmi.files(5).

=head1 EXIT CODES

=over

=item 0

Success; or nothing was found to remove; or the user cancelled the whole
operation.

=item 1

Command line inconsistency, invocation failure (you are not root), or
packages not found.

=item 2

Removal of packages failed.

=back

=head1 AUTHORS

Pascal Rigaux <pixel@mandriva.com> (current maintainer), 
Francois Pons, Rafael Garcia-Suarez <rgarciasuarez@mandriva.com>

=head1 SEE ALSO

urpmi.addmedia(8), urpmi.update(8), urpmi.removemedia(8), urpmf(8),
urpmi(8), urpmq(8), urpmi.files(5), urpmi.recover(8).