config/global/download.in
author "Yann E. MORIN" <yann.morin.1998@anciens.enib.fr>
Tue Aug 02 23:11:25 2011 +0200 (2011-08-02)
changeset 2593 2472b2f24e3a
parent 2564 5d4e91c0343e
child 2595 d6b2354d9d17
permissions -rw-r--r--
scripts/functions: always prefer the mirror

Currently, the mirror can be used either:
- as a fallback in case upstream is unavailable (default behavior)
- as the preferred source for downloads

But the most common use-case seems to provide a truely-LAN mirror
to speed up downloads in big corpos', and/or provide a 'trusted'
source for the tarballs.

So, make the following changes;
- if a mirror is specified, always try that before trying upstream

Signed-off-by: "Yann E. MORIN" <yann.morin.1998@anciens.enib.fr>
     1 # Options specific to downloading packages
     2 
     3 comment "Downloading"
     4 
     5 config FORBID_DOWNLOAD
     6     bool
     7     prompt "Forbid downloads"
     8     help
     9       Normally, crosstool-NG will try to download missing tarballs (or
    10       checkout from CVS/SVN...).
    11       If you do not have network connectivity when you run crosstool-NG,
    12       and some files are missing, it can be a long time before crosstool-NG
    13       fails.
    14       
    15       Saying 'y' here will prevent crosstool-NG from downloading missing
    16       files, thus failing early so that you don't get stuck.
    17 
    18 if ! FORBID_DOWNLOAD
    19 
    20 config FORCE_DOWNLOAD
    21     bool
    22     prompt "Force downloads"
    23     help
    24       Force downloading tarballs, even if one already exists.
    25       
    26       Useful if you suspect a tarball to be damaged.
    27 
    28 config USE_MIRROR
    29     bool
    30     prompt "Use a mirror"
    31     help
    32       If you have a machine on your LAN that mirrors some of the needed
    33       tarballs, you can say 'Y' here, and configure adequate values in
    34       the following options.
    35       
    36       Obviously, nothing prevents you from using a mirror that is in fact
    37       *not* on your LAN, for example on another subnet of your company's
    38       network, or a mirror on the Internet.
    39 
    40 config MIRROR_BASE_URL
    41     string
    42     prompt "Base URL"
    43     depends on USE_MIRROR
    44     default "http://ymorin.is-a-geek.org/mirrors/"
    45     help
    46       This is the base URL searched in for tarballs.
    47       
    48       I (Yann E. MORIN) have set up such a mirror to host snapshots of
    49       some components, when those snapshots are volatile on the upstream
    50       servers. The mirror is *slow*, because it is hosted behind an ADSL
    51       line. For the time being, I haven't set up bandwidth limitations,
    52       but should the mirror be abused, I will. Please avoid using my
    53       machine when you can... Also, no guarantee is made as to its
    54       availability. Use at your own risks.
    55       
    56       The mirror is available at:
    57         http://ymorin.is-a-geek.org/mirrors/
    58 
    59 config CONNECT_TIMEOUT
    60     int
    61     prompt "Connection timeout"
    62     default 10
    63     help
    64       From the curl manual:
    65         Maximum time in seconds that you allow the connection to the server to take.
    66       
    67       The scenario is as follows;
    68         - some enterprise networks have firewalls that prohibit FTP traffic, while
    69           still allowing HTTP
    70         - most download sites have http:// equivalent for the ftp:// URL
    71         - after this number of seconds, it is considered that the connection could
    72           not be established, and the next URL in the list is tried, until we reach
    73           an URL that will go through the firewall, most probably an http:// URL.
    74       
    75       If you have a slow network, you'd better set this value higher than the default
    76       10s. If you know a firewall is blocking connections, but your network is globally
    77       fast, you can try to lower this value to jump more quickly to allowed URLs. YMMV.
    78       
    79       Note that this value applies equally to wget if you have that installed.
    80 
    81 config ONLY_DOWNLOAD
    82     bool
    83     prompt "Stop after downloading tarballs"
    84     help
    85       Only download the tarballs. Exit once it done.
    86       
    87       Useful to pre-retrieve the tarballs before going off-line.
    88 
    89 endif # ! FORBID_DOWNLOAD