2 #emacs: -*- mode: shell-script; c-basic-offset: 4; tab-width: 4; indent-tabs-mode: nil -*-
3 #ex: set sts=4 ts=4 sw=4 et:
5 # Depends: apt (assumed to be present), python, wget
6 # Recommends: netselect
16 nd_aptenable_version=0.1
19 nd_config_url=https://raw.githubusercontent.com/neurodebian/neurodebian/master/neurodebian.cfg
20 nd_config_file=/etc/neurodebian/neurodebian.cfg
21 nd_mirror_origin=http://neuro.debian.net/debian
22 nd_mirror_default=$nd_mirror_origin # or may be AWS?
24 # To be set by cmdline args or via env variables with prefix ND_AE_
25 ae_release=${ND_AE_RELEASE:-}
26 ae_components=${ND_AE_COMPONENTS:-software,data}
27 ae_flavor=${ND_AE_FLAVOR:-}
28 ae_mirror=${ND_AE_MIRROR:-best}
29 ae_suffix=${ND_AE_SUFFIX:-}
30 ae_verbose=${ND_AE_VERBOSE:-1}
31 ae_overwrite=${ND_AE_OVERWRITE:-}
32 ae_sources=${ND_AE_SOURCES:-}
33 ae_install=${ND_AE_INSTALL:-}
34 ae_update=${ND_AE_UPDATE:-1}
35 ae_dry_run=${ND_AE_DRY_RUN:-}
36 ae_defun_only=${ND_AE_DEFUN_ONLY:-} # mode to source this file as a "library"
42 # - apt priority! (so we could avoid automagic upgrades etc)
45 if [ -z "${ND_AE_TEMPDIR:-}" ]; then
46 ae_tempdir=$(mktemp -d)
47 trap "rm -rf \"$ae_tempdir\"" TERM INT EXIT
49 # reuse the same directory/fetched configuration if was specified
50 ae_tempdir="${ND_AE_TEMPDIR:-}"
54 nd_config_file_fresh="$ae_tempdir/neurodebian.cfg"
59 if [ "$ae_verbose" -ge $level ]; then
60 # use stderr for printing within functions stdout of which might be used
62 i=1; while [ $i -lt $level ]; do echo -ne " ">&2; i=$(($i+1)); done
77 nd-aptenable $nd_aptenable_version
79 Copyright (C) 2014 Yaroslav Halchenko <debian@onerussian.com>
81 Licensed under GNU Public License version 3 or later.
82 This is free software; see the source for copying conditions. There is NO
83 warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
85 Written by Yaroslav Halchenko for the NeuroDebian project.
92 if [ -z "$ae_dry_run" ]; then
93 if eval "$ae_sudo $@" 1>|"$ae_tempdir/eval.log" 2>&1; then
94 rm "$ae_tempdir/eval.log"
96 error $? "Command $@ failed with exit code $?. Output was: `cat $ae_tempdir/eval.log`"
107 Usage: nd-aptenable [options]
109 Enables NeuroDebian repository for the current Debian or Ubuntu release.
113 -r, --release=RELEASE
114 Name of the Debian/Ubuntu release to be used. If not specified,
115 it is deduced from the apt-cache policy output, by taking repository
116 of Debian or Ubuntu origin with highest priority.
119 Return a list of releases present in NeuroDebian repository.
121 -f, --flavor=full|libre
122 Which flavor of the repository should be enabled:
123 libre -- Only main component, containing only DFSG-compliant content.
124 full -- Includes main, contrib, and non-free.
125 If not specified -- deduced from the output of apt-cache policy
127 -c, --components=c1,c2,c3
128 Comma separated list of components to enable among:
129 software -- primary software repository
130 data -- data packages
131 devel -- "overlay" of development versions (like Debians' "experimental").
132 Not sufficient on its own and available only from the main site
133 If not specified -- "software,data"
135 -m, --mirror=NAME|URL
136 Which mirror to use. Could be a mirror code-name (as specified in
137 /etc/neurodebian/neurodebian.cfg), or a URL.
140 Return a list (with abbreviation) of known NeuroDebian mirrors.
143 If apt file already present, it would not be overriden (by default).
144 Use this option to overwrite.
147 Which suffix to add to the apt file, in case you are trying to enable
148 multiple repositories
150 --sources, --no-sources
151 Either to enable deb-src lines. If none specified -- would be enabled if
152 sources for a core package (apt) are available.
155 Do not perform any changes -- generated configurations and commands will
156 simply be printed to stdout
159 If found absent, all necessary tools (wget, netselect) if available will
163 Enable additional progress messages. Could be used multiple times
166 Make operation quiet -- only error messages would be output
169 Print short description, usage summary and option list.
172 Print version information and exit.
176 non-0 exit status in case of error. Error exit code would depend
177 on which command has failed
181 - Enable software and data components from the optimal (according to
182 netselect) mirror. Some information about progress will be printed
186 - Quietly enable -devel repository for the current release, and place apt
187 configuration into /etc/apt/sources.list.d/neurodebian.sources-devel.list
189 nd-aptenable -q --suffix=-devel -c devel
191 - Force sid distribution, all the components, from the Japan mirror:
193 nd-aptenable -q --suffix=-de-sid-full -c software,data,devel -m jp
198 get_neurodebian_cfg()
200 if [ -s "$nd_config_file_fresh" ]; then
201 print_verbose 3 "Config file $nd_config_file_fresh exists -- not fetching"
202 echo "$nd_config_file_fresh"
205 # First we try to fetch the most recent version from the github
206 print_verbose 3 "Fetching config file from the github repository"
207 assure_command_from_package wget wget 1
208 wget --no-check-certificate -c -q -O$nd_config_file_fresh \
210 && { echo "$nd_config_file_fresh"; } \
211 || { [ -e "$nd_config_file" ] \
212 && echo "$nd_config_file" \
213 || error 10 "Neither could fetch $nd_config_url, nor found $nd_config_file"; }
220 print_verbose 3 "Querying config $config_file section $section"
221 assure_command_from_package python python-minimal 1
222 python -c "from ConfigParser import SafeConfigParser as SP; cfg = SP(); cfg.read('$config_file'); print('\n'.join([' '.join(x) for x in cfg.items('$section')]))"
227 nd_config=`get_neurodebian_cfg`
228 # $exe_dir/nd_querycfg -F" " --config-file="$nd_config" "mirrors" \
230 query_cfg_section "$nd_config" "mirrors" \
231 | while read mirror_name mirror_url; do
232 # verify that url is just a url
233 if echo "$mirror_url" | grep -v -e '^[a-z0-9:+]*://[-+_%.a-z0-9/]*$'; then
234 print_verbose 1 "Mirror $mirror_name has 'illegit' URL: $mirror_url. Skipping"
236 [ -z "$n" ] || echo -ne "${ND_IFS:-\n}"; n+=1
237 echo -n "$mirror_name $mirror_url"
243 nd_config=`get_neurodebian_cfg`
245 query_cfg_section "$nd_config" "release files" \
246 | while read release_name release_url; do
247 # verify that url is just a url
248 if [ "$release_name" = "data" ]; then
252 [ -z "$n" ] || echo -ne "${ND_IFS:-\n}"; n+=1
253 echo -n "$release_name"
257 get_package_version()
259 pkg_version=$(apt-cache policy "$1" | awk '/^ *Installed:/{print $2;}')
260 [ "$pkg_version" != '(none)' ] || pkg_version=''
265 # select "closest" mirror according to netselect.
266 print_verbose 2 "Selecting the 'best' mirror using netselect"
267 assure_command_from_package netselect
268 if ! which netselect >&/dev/null; then
269 print_verbose 1 "netselect (apt-get install netselect) needed to select the 'best' mirror was not found"
270 print_verbose 1 "Selecting the default repository: $nd_mirror_default"
271 echo $nd_mirror_default
273 # squeeze version doesn't have -D yet to force output of the URL not IP, but for our mirrors ATM it shouldn't matter
274 netselect_opts="-s 1"
275 netselect_version="$(get_package_version netselect)"
276 if dpkg --compare-versions "$netselect_version" ge 0.3.ds1-17; then
277 netselect_opts+=" -D"
279 if dpkg --compare-versions "$netselect_version" ge 0.3.ds1-15; then
280 netselect_opts+=" -I"
282 best_mirror=$(get_mirrors | awk '{print $2;}' | eval $ae_sudo xargs netselect $netselect_opts | awk '{print $2;}')
283 print_verbose 2 "Best mirror: $best_mirror"
290 # given mirror alias -- find its url
291 url=$(get_mirrors | awk "/^$1 /{print \$2;}")
292 if [ -z "$url" ]; then
293 error 9 "Cannot resolve mirror $1 to the URL"
300 # Get apt-cache policy output in a single list for matching suites
301 # (could be a separated with \| or , for multiple choices, e.g.
303 # get_apt_policy Debian,Ubuntu
305 # get_apt_policy NeuroDebian
307 $ae_sudo apt-cache policy | grep -B1 -e "o=\(${suites//,/\\|}\)" | tr '\n' ' ' | sed -e 's, -- ,\n,g' | grep -v -e '-\(updates\|security\)' | sort -nr
310 is_component_included()
312 echo "$ae_components" | tr ',' '\n' | grep -q "^$1\$"
317 apt-cache showsrc apt >&/dev/null && echo 1 || echo 0
320 assure_command_from_package()
326 which "$cmd" >&/dev/null && return 0
328 # if absent -- check availability of the package
329 apt_cache=$(LANG=C apt-cache policy "$pkg" 2>&1)
330 if [[ "$apt_cache" =~ "Unable to locate package" ]] || [[ "$apt_cache" =~ "Candidate: (none)" ]]; then
331 print_verbose 1 "Package $pkg providing command $cmd is N/A. Skipping"
334 if echo "$apt_cache" | grep -q '^\s*\*\*\*'; then
335 print_verbose 1 "WARNING -- command $cmd is N/A but package $pkg is claimed to be installed"
336 [ -z "$fail" ] && return 11 || error $fail "Command $cmd is required to proceed"
338 if [ "$ae_install" = "1" ]; then
339 print_verbose 1 "Installing $pkg package to get $cmd command"
340 eval_dry DEBIAN_FRONTEND=noninteractive apt-get install -y "$pkg"
343 print_verbose 1 "Command $cmd (from package $pkg) is N/A."
344 print_verbose 1 "Use with --install to get all necessary packages installed automatically"
345 [ -z "$fail" ] && return 12 || error $fail "Command $cmd is required to proceed"
349 # if it was requested -- return without doing anything
350 [ -z "$ae_defun_only" ] || return
353 # Commandline options handling
356 # Parse commandline options (taken from the getopt examples from the Debian util-linux package)
357 # Note that we use `"$@"' to let each command-line parameter expand to a
358 # separate word. The quotes around `$@' are essential!
359 # We need CLOPTS as the `eval set --' would nuke the return value of getopt.
360 CLOPTS=`getopt -o h,r:,m:,f:,c:,q,v,n --long help,version,quiet,verbose,mirror:,release:,flavor:,components:,suffix:,overwrite,sources,no-sources,install,dry-run,do-not-update,print-releases,print-mirrors,print-best-mirror -n 'nd-aptenable' -- "$@"`
362 if [ $? != 0 ] ; then
363 error 2 "Problem with parsing cmdline. Terminating..."
366 # Note the quotes around `$CLOPTS': they are essential!
367 eval set -- "$CLOPTS"
369 if [ `whoami` != "root" ]; then
375 -r|--release) shift; ae_release="$1"; shift;;
376 -f|--flavor) shift; ae_flavor="$1"; shift;;
377 -c|--components) shift; ae_components="$1"; shift;;
378 -m|--mirror) shift; ae_mirror="$1"; shift;;
379 --print-mirrors) get_mirrors; exit 0;;
380 --print-best-mirror) netselect_mirror; exit 0;;
381 --print-releases) get_releases; exit 0;;
382 -n|--dry-run) ae_dry_run=1; shift;;
383 --suffix) shift; ae_suffix="$1"; shift;;
384 --overwrite) ae_overwrite="$1"; shift;;
385 --do-not-update) ae_update=""; shift;;
386 --sources) ae_sources=1; shift;;
387 --no-sources) ae_sources=0; shift;;
388 --install) ae_install=1; shift;;
389 -q|--quiet) ae_verbose=0; shift;;
390 -v|--verbose) ae_verbose=$(($ae_verbose+1)); shift;;
391 -h|--help) print_help; exit 0;;
392 --version) print_version; exit 0;;
394 *) error 1 "Internal error! ($1)";;
399 if [ $# -gt 0 ] ; then
405 [ -z "$ae_sudo" ] || print_verbose 1 "This script requires root access. Since current user is not root, sudo will be used"
408 # Basic system/environment knowledge
411 ae_output_file=/etc/apt/sources.list.d/neurodebian.sources${ae_suffix}.list
413 apt_policy=$(get_apt_policy "Debian,Ubuntu" )
415 if [ -z "$ae_release" ]; then
416 ae_release=$(echo "$apt_policy" | head -1 | sed -e 's/.*,n=\([^,]*\),.*/\1/g')
419 if [ -z "$ae_flavor" ]; then
420 ae_flavor=$(echo "$apt_policy" | grep -e ",n=$ae_release," | grep -qe 'c=\(non-free\|restricted\)' && echo "full" || echo "libre")
424 # Determine which mirror to use
427 # knowing mirror is not necessary for -devel available only from the main site
428 if is_component_included software || is_component_included data; then
429 # for now just use default
430 if [ -z "$ae_mirror" ]; then # none specified
431 ae_mirror_url=$nd_mirror_origin
433 if ! [[ "$ae_mirror" =~ ".*://.*" ]]; then
435 best) ae_mirror_url=$(netselect_mirror);;
436 default) ae_mirror_url=$nd_mirror_default;;
437 origin) ae_mirror_url=$nd_mirror_origin;;
438 *) ae_mirror_url=$(get_mirror_url "$ae_mirror");;
441 ae_mirror_url="$ae_mirror" # it was some kind of a URL already
451 full) apt_flavor="contrib non-free";;
452 libre) apt_flavor="";;
453 *) error 5 "Unknown value of flavor $apt_flavor. Must be full or libre"
456 if [ -z "$ae_sources" ]; then
457 ae_sources=$(is_sources_enabled)
460 if [ $ae_sources -eq 0 ]; then
468 if is_component_included software; then
470 # NeuroDebian software repository
471 deb $ae_mirror_url $ae_release main $apt_flavor
472 ${sources_comment}deb-src $ae_mirror_url $ae_release main $apt_flavor
476 if is_component_included data; then
478 # NeuroDebian data repository
479 deb $ae_mirror_url data main $apt_flavor
480 ${sources_comment}deb-src $ae_mirror_url data main $apt_flavor
484 if is_component_included devel; then
486 # NeuroDebian -devel repository
487 deb http://neuro.debian.net/debian-devel $ae_release main $apt_flavor
488 ${sources_comment}deb-src http://neuro.debian.net/debian-devel $ae_release main $apt_flavor
492 if [ -e "$ae_output_file" ] && [ -z "$ae_overwrite" ]; then
493 if diff "$ae_output_file" <(echo "$apt_list") | grep -q .; then
495 print_verbose 1 "File $ae_output_file already exists, containing:\n`cat \"$ae_output_file\"`\n\nI: New configuration is different:\n$apt_list"
496 if get_apt_policy NeuroDebian >/dev/null; then
497 print_verbose 1 "NeuroDebian repositories are already available, thus skipping the rest."
498 print_verbose 1 "Rerun with --overwrite if you would like to reconfigure."
501 print_verbose 1 "NeuroDebian configuration is found but not yet available -- continuing with new configuration."
504 print_verbose 1 "New configuration is identical to existing and NeuroDebian repository is already enabled."
505 print_verbose 1 "Skiping the rest. Rerun with --overwrite if you would like to reconfigure."
509 print_verbose 1 "Generating $ae_output_file"
510 if [ -z "$ae_dry_run" ]; then
511 echo "$apt_list" | $ae_sudo bash -c "cat - >| '$ae_output_file'"
520 # Assure present archive GPG key for APT system
523 # Figure out if key needs to be imported (if ran within package,
524 # should already be there due to neurodebian-keyring package)
525 if LANG=C eval $ae_sudo apt-key export $nd_key_id 2>&1 1>/dev/null | grep -qe "nothing exported"; then
526 print_verbose 1 "Fetching the key from the server"
527 eval_dry apt-key adv --recv-keys --keyserver pgp.mit.edu $nd_key_id
532 # Finalizing (apt-get update etc)
535 if [ ! -z "$ae_update" ]; then
536 print_verbose 1 "Updating APT listings, might take a few minutes"
537 if [ -z "$ae_dry_run" ]; then
538 apt_logfile="$ae_tempdir/apt.log"
539 $ae_sudo apt-get update 1>"$apt_logfile" 2>&1 \
540 && rm -f "$apt_logfile" \
542 apt_log=$(cat "$apt_logfile")
544 if echo "$apt_log" | grep -q "Malformed line [0-9]* in source list $ae_output_file"; then
545 $ae_sudo mv "${ae_output_file}" "${ae_output_file}-failed.disabled"
546 error 6 "Update failed to possible errorneous APT listing file produced by this script. Generated $ae_output_file renamed to ${ae_output_file}-failed.disabled to not interfer"
548 error 5 "Update failed with exit code $? (above output logged into $apt_logfile)."
551 eval_dry apt-get update
555 if [ "$ae_verbose" -ge 2 ]; then
556 print_verbose 2 "Currently enabled NeuroDebian suites/mirrors:"
557 get_apt_policy NeuroDebian