URPMI.ADDMEDIA(1) Mageia Package Management URPMI.ADDMEDIA(1)NAMEurpmi.addmedia - adds a new rpm media to be used by urpmi
SYNOPSISurpmi.addmedia [options] <name> <url>
DESCRIPTIONurpmi.addmedia is used to add a new media to be used by urpmi, so it
can find new rpms at the specified location. Currently supported media
types are: local drives, removable drives (such as CDs), and networked
media via different protocols (http, ftp, ssh and rsync). One of the
following modes must be chosen:
urpmi.addmedia [options] --distrib --mirrorlist [<url>]
A mirror list is a special API to describe mirrors available. urpmi
will pick the nearest mirror, and will dynamically handle new
mirrors. Example:
urpmi.addmedia--distrib --mirrorlist
urpmi.addmedia [options] --mirrorlist <url> <name> <relative path>
Example:
urpmi.addmedia--mirrorlist '$MIRRORLIST' backports media/main/backports
urpmi.addmedia [options] <name> http://<login>:<pass>@<host>/<path>
where <name> is a human-readable name for the new media (e.g.
"updates"). <name> is optional if --distrib is given in the options
list. <host>/<path> is the location of the media directory on the
net (e.g. "media/main"). The location is given relative to <path>.
curl is used by default to download files, wget may be used if curl
is not installed or if or --wget is given in options. Example:
urpmi.addmedia http http://jpackage.sf.net/rpm/free
urpmi.addmedia [options] <name> ftp://<login>:<pass>@<host>/<path>
The same as for http. Add your login and password if required (note
that you don't need to specify anonymous as login for anonymous
access ftp servers). If wget is used to download files with a
firewall you may have to ensure that the passive_ftp option is on
in /etc/wgetrc (that's usually the default). Example:
urpmi.addmedia ftp ftp://a:a@leia//export/media/main
urpmi.addmedia [options] <name> ssh://<login>@<host>/<path>
The same as for http and ftp; add your login and password if
required. You may want to export the public key in order not to
have to type your password. rsync over an ssh connection will be
used to get files. urpmi will try to re-use the same ssh connection
over multiple invocations.
Example:
urpmi.addmedia ssh ssh://fpons@bi/c/i586/media/main
urpmi.addmedia [options] <name> rsync://<login>@<host>:<port>/<path>
The same as for http; you can use the <host>::<path> syntax too.
Example:
urpmi.addmedia rsync rsync://ftp.orst.edu::mandrake-devel/contrib/ppc
urpmi.addmedia [options] <name> file://<path>
where <name> is a human-readable name for the new media (e.g.
"local updates"). <path> is the location of the media directory on
your machine (e.g. "media/main").
urpmi.addmedia [options] <name> cdrom://<path>
<path> is the location of the media directory in the CDROM or DVD.
OPTIONS--wget
Use wget only for downloading distant files. By default curl is
used if available.
--curl
Use curl only for downloading distant files. This is the default if
curl is available.
--curl-options 'options'
--rsync-options 'options'
--wget-options 'options'
Specify additional command-line options to be passed to curl, rsync
or wget when retrieving files. If several options are to be passed,
separate them with spaces and enclose them in quotes.
Note that the rsync options will also be used for ssh media.
--limit-rate rate
Try to limit the download speed, rate is given in bytes/sec. This
option is not active by default.
--proxy proxyhost[:port|1080]
Use specified HTTP proxy.
--proxy-user user:password
Use specified user and password to use for proxy authentication.
Specifying --proxy-user=ask will cause "urpmi.addmedia" to prompt
for a username and a password.
--update
Adds a media which will be taken into account by MageiaUpdate or by
"urpmi --update" when looking for updates.
If used together with --distrib, it will only add media flagged
"update".
--verify-rpm
--no-verify-rpm
Activate or deactivate rpm signature checking of newly added media.
It's activated by default, and can be overriden in global
configuration.
--xml-info
Use the specific policy for downloading xml info files. It must be
one of: never, on-demand, update-only, always. See urpmi.cfg(5)
for more information.
--probe-synthesis
Use synthesis file.
--probe-rpms
Use rpm files (instead of synthesis).
--mirrorlist
Use the given url as a mirror list. It is quite special, please see
examples at the beginning of this page.
You can also give a space seperated list of urls. Each url can be
either a mirrorlist or a mirror url. This is useful if you have a
mirror to use inside a local network, but still use standard
mirrors when the local mirror is not available.
nb: $MIRRORLIST is a special variable which gives the default URL
for the current distribution/arch. $MIRRORLIST is the default
mirrorlist.
--zeroconf
Find a media repository for the current distribution using zeroconf
(DNS-SD). It can be used together with --distrib or by specifying
a media name and a path to the media directory, relative to the
repository root.
--distrib
Retrieve a set of media from a distribution. Typically, the URL
provided to "urpmi.addmedia" will represent the parent directory of
a directory media, which in turn will contain various
subdirectories for each medium of the distribution. <name> is
combined with medium names found to create newer medium names in
the urpmi database.
--interactive
This option is to be used with --distrib. With it, "urpmi.addmedia"
will ask for confirmation for each media it finds for the specified
distribution.
--all-media
This option is to be used with --distrib. With it, "urpmi.addmedia"
will attempt to add all media it finds. By default, it won't add
media containing source rpms, or media corresponding to
supplementary CD-ROMs on distributions.
--urpmi-root directory
Use the file system tree rooted for urpmi database and rpm install.
Contrary to --root, the urpmi configuration comes from the rooted
tree.
--wait-lock
If the urpmi or rpm db is busy, wait until it is available
--virtual
Creates a virtual medium: the medium is always up-to-date and so it
does not need to be updated by "urpmi.update".
--raw
Add the new media in the urpmi configuration file, but don't update
it nor proceed to any download. The media, to be usable, will need
to be updated with "urpmi.update"; it's ignored until then.
--nopubkey
Don't import pubkey of added media.
Variables
Beginning with urpmi 4.6.16, you can use variables in media URLs (for
example /mnt/mirror/$RELEASE/$ARCH/media/main). The variables supported
so far are:
$ARCH
The architecture (if found in /etc/release).
$RELEASE
The OS release (if found in /etc/release; its value should be
cauldron on a Mageia cauldron system.)
$HOST
The canonical hostname of the machine urpmi runs on.
$MIRRORLIST
The url of the default mirrorlist for the distribution.
SEE ALSOurpmi(8), urpmi.update(8), urpmi.removemedia(8), urpmf(8), urpmq(8),
urpmi.files(5).
Author
Pascal Rigaux <pixel@mandriva.com> (original author and current
maintainer), Francois Pons, Rafael Garcia-Suarez
Mageia Linux 2013-09-01 URPMI.ADDMEDIA(1)
