.TH urpmi.addmedia 8 "05 Sep 2000" "Mandrakesoft" "Linux-Mandrake"
.IX urpmi.addmedia
.SH NAME
urpmi.addmedia \- adds a new rpms media for use with urpmi
.SH SYNOPSIS
.B urpmi.addmedia <\fIname\fP> <\fIurl\fP>
.SH DESCRIPTION
urpmi.addmedia tells urpmi that he can find new rpms at the specified
location. Currently supported medias are: local drives, removable drives
(such as cd's), http and ftp.
.PP
All users belonging to group urpmi are allowed to add a new media.
.PP
One of the following modes must be choosen:
.PP
http:
.br
.IP "\fB    urpmi.addmedia <\fIname\fP> http://<\fIhost\fP>/<\fIpath\fP> with <\fIrelative path of hdlist\fP>\fP"
Where <\fIname\fP> is your reference for the media (e.g. MandrakeUpdate).
.br
<\fIhost\fP>/<\fIpath\fP> is the location of the rpm directory on the net.
.br
<\fIrelative path of hdlist\fP> is the pathname where to find the hdlist of
the rpms. The location is given relative to <\fIpath\fP>.
.nf
eg: urpmi.addmedia ftp ftp://a:a@leia//export/Mandrake/RPMS with ../base/hdlist
.fi
.br
.IP "\fB    urpmi.addmedia <\fIname\fP> ftp://<\fIlogin\fP>:<\fIuser\fP>@<\fIhost\fP>/<\fIpath\fP> with <\fIrelative path of hdlist\fP>\fP"
The same as for http, just add your login and user if required (Note that
you needn't to specify anonymous as login for anonymous access ftp servers).
.PP
Local drive or NFS:
.br
.IP "\fB    urpmi.addmedia <\fIname\fP> file://<\fIpath\fP>\fP"
Where <\fIname\fP> is your reference for the media (e.g. Myrpms).
.br
<\fIpath\fP> is the location of the rpm directory on your machine.
.PP
Removable device:
.br
.IP "\fB    urpmi.addmedia removable_<\fIdevice\fP>_<\fInumber\fP>://<\fIpath\fP>\fP"
<\fIdevice\fP> is the name of your media as specified in the /dev/ directory
(e.g. cdrom, floppy, zip, ...).
.br
<\fInumber\fP> is used urpmi to choose in what order medias are inserted in
case of multiple medias install with dependencies. '1' is reserved for the
origin install medias.
.br
<\fIpath\fP> is the location of the rpm directory on your machine when media
is mounted.
.PP

.SH FILES
/usr/bin/urpmi
.br
The \fBurpmi\fP executable (perl script)
.PP
/var/lib/urpmi/list.*
.br
Contains the list of all packages known by urpmi and their location. There
is one filelist per media(*).
.PP
/var/lib/urpmi/hdlist.*
.br
Contain information about all known packages, it's a summary of rpm headers.
There is one filelist per media(*).
.PP
/etc/urpmi/urpmi.cfg
.br
Contains one line <\fIname\fP> <\fIurl\fP> per media.
.PP
/var/lib/urpmi/depslist.ordered
.br
A simple text file containing all dependencies of all known packages.
.PP
/var/lib/urpmi/provides
.br
A simple text file containning all provides and the list of associated
packages that contains them.
.PP
/var/lib/urpmi/compss
.br
A simple text file containning for each Group used the list of package in
this group.
.SH "SEE ALSO"
urpmi(8),
urpmi.update(8),
urpmi.removemedia(8),
autoirpm(8),
autoirpm-icons(8),
gurpmi(8),
urpmf(8),
urpmq(8),
rpmdrake(8)
.SH AUTHOR
Pascal Rigaux, Mandrakesoft
.br
pixel@mandrakesoft.com