summaryrefslogtreecommitdiffstats
path: root/pod/urpmi.addmedia.8.pod
diff options
context:
space:
mode:
Diffstat (limited to 'pod/urpmi.addmedia.8.pod')
-rw-r--r--pod/urpmi.addmedia.8.pod246
1 files changed, 0 insertions, 246 deletions
diff --git a/pod/urpmi.addmedia.8.pod b/pod/urpmi.addmedia.8.pod
deleted file mode 100644
index d5d233e8..00000000
--- a/pod/urpmi.addmedia.8.pod
+++ /dev/null
@@ -1,246 +0,0 @@
-=head1 NAME
-
-urpmi.addmedia - adds a new rpm media to be used by urpmi
-
-=head1 SYNOPSIS
-
- urpmi.addmedia [options] <name> <url>
-
-=head1 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, ftp, ssh and rsync). One of the following modes
-must be chosen:
-
-=over
-
-=item B<urpmi.addmedia> [I<options>] --distrib --mirrorlist [<I<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
-
-=item B<urpmi.addmedia> [I<options>] --mirrorlist <I<url>> <I<name>> <I<relative path>>
-
-Example:
-
- urpmi.addmedia --mirrorlist '$MIRRORLIST' backports media/main/backports
-
-=item B<urpmi.addmedia> [I<options>] <I<name>> http://<I<login>>:<I<pass>>@<I<host>>/<I<path>>
-
-where <I<name>> is a human-readable name for the new media (e.g.
-"updates"). <I<name>> is optional if B<--distrib> is given in the options
-list. <I<host>>/<I<path>> is the location of the media directory on the
-net (e.g. C<media/main>). The location is given relative to
-<I<path>>. B<curl> is used by default to download files, B<wget> may be
-used if B<curl> is not installed or if or B<--wget> is given in
-I<options>. Example:
-
- urpmi.addmedia http http://jpackage.sf.net/rpm/free
-
-=item B<urpmi.addmedia> [I<options>] <I<name>> ftp://<I<login>>:<I<pass>>@<I<host>>/<I<path>>
-
-The same as for http. Add your login and password if required (note that
-you don't need to specify B<anonymous> as login for anonymous access ftp
-servers). If B<wget> is used to download files with a firewall you may
-have to ensure that the B<passive_ftp> option is on in B</etc/wgetrc>
-(that's usually the default). Example:
-
- urpmi.addmedia ftp ftp://a:a@leia//export/media/main
-
-=item B<urpmi.addmedia> [I<options>] <I<name>> ssh://<I<login>>@<I<host>>/<I<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
-
-=item B<urpmi.addmedia> [I<options>] <I<name>> rsync://<I<login>>@<I<host>>:<I<port>>/<I<path>>
-
-The same as for http; you can use the <I<host>>::<I<path>> syntax too. Example:
-
- urpmi.addmedia rsync rsync://ftp.orst.edu::mandrake-devel/contrib/ppc
-
-=item B<urpmi.addmedia> [I<options>] <I<name>> file://<I<path>>
-
-where <I<name>> is a human-readable name for the new media (e.g.
-"local updates"). <I<path>> is the location of the media directory on your
-machine (e.g. C<media/main>).
-
-=item B<urpmi.addmedia> [I<options>] <I<name>> cdrom://<I<path>>
-
-<I<path>> is the location of the media directory in the CDROM or DVD.
-
-=back
-
-=head1 OPTIONS
-
-=over
-
-=item B<--wget>
-
-Use wget only for downloading distant files. By default curl is used if
-available.
-
-=item B<--curl>
-
-Use curl only for downloading distant files. This is the default if curl
-is available.
-
-=item B<--curl-options> I<'options'>
-
-=item B<--rsync-options> I<'options'>
-
-=item B<--wget-options> I<'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.
-
-=item B<--limit-rate I<rate>>
-
-Try to limit the download speed, I<rate> is given in bytes/sec. This option
-is not active by default.
-
-=item B<--proxy> I<proxyhost[:port|1080]>
-
-Use specified HTTP proxy.
-
-=item B<--proxy-user> I<user:password>
-
-Use specified user and password to use for proxy authentication.
-Specifying B<--proxy-user=ask> will cause C<urpmi.addmedia> to prompt for a
-username and a password.
-
-=item B<--update>
-
-Adds a media which will be taken into account by B<MageiaUpdate> or by
-C<urpmi --update> when looking for updates.
-
-If used together with B<--distrib>, it will only add media flagged "update".
-
-=item B<--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.
-
-=item B<--probe-synthesis>
-
-Use synthesis file.
-
-=item B<--probe-rpms>
-
-Use rpm files (instead of synthesis).
-
-=item B<--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.
-
-=item B<--zeroconf>
-
-Find a media repository for the current distribution using zeroconf (DNS-SD).
-It can be used together with B<--distrib> or by specifying a media name and a
-path to the media directory, relative to the repository root.
-
-=item B<--distrib>
-
-Retrieve a set of media from a distribution. Typically, the URL provided
-to C<urpmi.addmedia> will represent the parent directory of a directory
-B<media>, which in turn will contain various subdirectories for each
-medium of the distribution. <I<name>> is combined with medium names found
-to create newer medium names in the urpmi database.
-
-=item B<--interactive>
-
-This option is to be used with B<--distrib>. With it, C<urpmi.addmedia>
-will ask for confirmation for each media it finds for the specified
-distribution.
-
-=item B<--all-media>
-
-This option is to be used with B<--distrib>. With it, C<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.
-
-=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<--wait-lock>
-
-If the urpmi or rpm db is busy, wait until it is available
-
-=item B<--virtual>
-
-Creates a virtual medium: the medium is always up-to-date and so it does not
-need to be updated by C<urpmi.update>.
-
-=item B<--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 C<urpmi.update>; it's ignored until then.
-
-=item B<--nopubkey>
-
-Don't import pubkey of added media.
-
-=back
-
-=head1 Variables
-
-Beginning with urpmi 4.6.16, you can use variables in media URLs (for
-example F</mnt/mirror/$RELEASE/$ARCH/media/main>). The variables supported
-so far are:
-
-=over
-
-=item B<$ARCH>
-
-The architecture (if found in F</etc/release>).
-
-=item B<$RELEASE>
-
-The OS release (if found in F</etc/release>; its value should be B<cauldron>
-on a Mageia cauldron system.)
-
-=item B<$HOST>
-
-The canonical hostname of the machine urpmi runs on.
-
-=item B<$MIRRORLIST>
-
-The url of the default mirrorlist for the distribution.
-
-=back
-
-=head1 SEE ALSO
-
-urpmi(8), urpmi.update(8), urpmi.removemedia(8), urpmf(8), urpmq(8), urpmi.files(5).
-
-=head1 Author
-
-Pascal Rigaux <pixel@mandriva.com> (original author and current maintainer),
-FranE<ccedil>ois Pons, Rafael Garcia-Suarez