NAME

urpmi.addmedia - adds a new rpm media to be used by urpmi

SYNOPSIS

urpmi.addmedia [options] <name> <url>

DESCRIPTION

urpmi.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, https, 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>. wget is used by default to download files, curl may be used if wget is not installed or if or --curl is given in options. Example:

urpmi.addmedia http http://jpackage.sf.net/rpm/free

urpmi.addmedia [options] <name> https://<login>:<pass>@<host>/<path>

The same as for http but using the encrypted https protocol.

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

Media Search and Selection

--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 separated 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.

Media Handling

--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 overridden 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).

--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.

Download Options

--wget

Use wget only for downloading distant files. This is the default if wget is available.

--curl

Use curl only for downloading distant files. By default wget is used if 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.

Database Options

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

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 ALSO

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

Author

Thierry Vignaud <tv@mageia.org> (current maintainer), Pascal Rigaux (original author), François Pons, Rafael Garcia-Suarez