summaryrefslogtreecommitdiffstats
path: root/pod/8/urpme.pod
blob: c61a88272b78d24ac36c751955def0c62b09a386 (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
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
=head1 NAME

urpme - rpm deinstaller

=head1 SYNOPSIS

    urpme [options] [package_name...]
    urpme [options] --auto-orphans

=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<--verbose>

Proposes a verbose mode with various messages.

=item B<-v>

This is the same as B<--verbose>.

=item B<--auto>

Removes packages non-interactively, without asking questions.

=item B<--auto-orphans>

Removes orphans.

=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<--justdb>

Update only the database, not the filesystem.

=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<--urpmi-root> I<directory>

Use the file system tree rooted for urpmi database and rpm install. Contrary
to B<--root>, the urpmi configuration comes from the rooted tree.

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

Configure urpme on the fly from a distribution tree.

=item B<--wait-lock>

If the urpmi or rpm db is busy, wait until it is available

=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 

=head1 SEE ALSO

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