This file is indexed.

/usr/lib/python2.7/dist-packages/provisioningserver/boot/utils.py is in python-maas-provisioningserver 1.5.4+bzr2294-0ubuntu1.2.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
# Copyright 2014 Canonical Ltd.  This software is licensed under the
# GNU Affero General Public License version 3 (see the file LICENSE).

"""Utilities that BootMethod's can use."""

from __future__ import (
    absolute_import,
    print_function,
    unicode_literals,
    )

str = None

__metaclass__ = type
__all__ = [
    'get_distro_release',
    'get_package',
    'get_updates_package',
    ]

import gzip
import hashlib
import os
from platform import linux_distribution
import re
import StringIO
import subprocess
import urllib2

from provisioningserver.utils import (
    call_capture_and_check,
    tempdir,
    )


def urljoin(*args):
    return '/'.join(s.strip('/') for s in args)


def get_distro_release():
    """Returns the release name for the current distribution."""
    distname, version, codename = linux_distribution()
    return codename


def get_file(url):
    """Downloads the file from the URL.

    :param url: URL to download file
    :returns: File data, or None
    """
    response = urllib2.urlopen(url)
    return response.read()


def get_md5sum(data):
    """Returns the md5sum for the provided data."""
    md5 = hashlib.md5()
    md5.update(data)
    return md5.hexdigest()


def gpg_verify_data(signature, data_file):
    """Verify's data using the signature."""
    with tempdir() as tmp:
        sig_out = os.path.join(tmp, 'verify.gpg')
        with open(sig_out, 'wb') as stream:
            stream.write(signature)

        data_out = os.path.join(tmp, 'verify')
        with open(data_out, 'wb') as stream:
            stream.write(data_file)

        args = [
            "gpgv",
            "--keyring",
            "/etc/apt/trusted.gpg",
            sig_out,
            data_out
            ]
        call_capture_and_check(args, stderr=subprocess.STDOUT)


def decompress_packages(packages):
    compressed = StringIO.StringIO(packages)
    decompressed = gzip.GzipFile(fileobj=compressed)
    return unicode(decompressed.read(), errors='ignore')


def get_packages(archive, component, architecture, release=None):
    """Gets the packages list from the archive."""
    release = get_distro_release() if release is None else release
    url = urljoin(archive, 'dists', release)
    release_url = urljoin(url, 'Release')
    release_file = get_file(release_url)
    release_file_gpg = get_file('%s.gpg' % release_url)
    gpg_verify_data(release_file_gpg, release_file)

    # Download the packages and verify that md5sum matches
    path = '%s/binary-%s/Packages.gz' % (component, architecture)
    packages_url = urljoin(url, path)
    packages = get_file(packages_url)
    md5sum = re.search(
        r"^\s*?([a-zA-Z0-9]{32})\s+?[0-9]+\s+%s$" % path,
        release_file,
        re.MULTILINE).group(1)
    if get_md5sum(packages) != md5sum:
        raise ValueError("%s failed checksum." % packages_url)

    return decompress_packages(packages)


def get_package_info(package, archive, component, architecture, release=None):
    """Gets the package information."""
    release = get_distro_release() if release is None else release
    packages = get_packages(archive, component, architecture, release=release)

    info = re.search(
        r"^(Package: %s.*?)\n\n" % package,
        packages,
        re.MULTILINE | re.DOTALL)
    if info is None:
        return None
    info = info.group(1)

    data = {}
    for line in info.splitlines():
        key, value = line.split(':', 1)
        data[key] = value.strip()
    return data


def get_package(package, archive, component, architecture, release=None):
    """Downloads the package from the archive."""
    release = get_distro_release() if release is None else release
    package = get_package_info(
        package, archive, component, architecture, release=release)
    if package is None:
        return None, None

    # Download the package and check checksum
    path = package['Filename']
    filename = os.path.basename(path)
    url = urljoin(archive, path)
    deb = get_file(url)
    md5 = get_md5sum(deb)
    if md5 != package['MD5sum']:
        raise ValueError("%s failed checksum." % filename)
    return deb, filename


def get_updates_package(package, archive, component, architecture,
                        release=None):
    """Downloads the package from the {release}-updates if it exists, if not
    fails back to {release} archive.
    """
    release = get_distro_release() if release is None else release
    releases = ['%s-updates' % release, release]
    for release in releases:
        deb, filename = get_package(
            package, archive, component, architecture, release=release)
        if deb is not None:
            return deb, filename
    return None, None