This file is indexed.

/usr/share/pyshared/landscape/amp.py is in landscape-common 12.04.3-0ubuntu1.

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
import os
import logging

from landscape.lib.amp import (
    MethodCallProtocol, MethodCallFactory, RemoteObjectConnector)


class ComponentProtocol(MethodCallProtocol):
    """Communication protocol between the various Landscape components.

    It can be used both as server-side protocol for exposing the methods of a
    certain Landscape component, or as client-side protocol for connecting to
    another Landscape component we want to call the methods of.
    """
    methods = ["ping", "exit"]
    timeout = 60


class ComponentProtocolFactory(MethodCallFactory):

    protocol = ComponentProtocol
    initialDelay = 0.05


class RemoteComponentConnector(RemoteObjectConnector):
    """Utility superclass for creating connections with a Landscape component.

    @cvar component: The class of the component to connect to, it is expected
        to define a C{name} class attribute, which will be used to find out
        the socket to use. It must be defined by sub-classes.

    @param reactor: A L{TwistedReactor} object.
    @param config: A L{LandscapeConfiguration}.
    @param args: Positional arguments for protocol factory constructor.
    @param kwargs: Keyword arguments for protocol factory constructor.

    @see: L{MethodCallClientFactory}.
    """

    factory = ComponentProtocolFactory

    def __init__(self, reactor, config, *args, **kwargs):
        self._twisted_reactor = reactor
        socket = os.path.join(config.sockets_path,
                              self.component.name + ".sock")
        super(RemoteComponentConnector, self).__init__(
            self._twisted_reactor._reactor, socket, *args, **kwargs)

    def connect(self, max_retries=None, factor=None, quiet=False):
        """Connect to the remote Landscape component.

        If the connection is lost after having been established, and then
        it is established again by the reconnect mechanism, an event will
        be fired.

        @param max_retries: If given, the connector will keep trying to connect
            up to that number of times, if the first connection attempt fails.
        @param factor: Optionally a float indicating by which factor the
            delay between subsequent retries should increase. Smaller values
            result in a faster reconnection attempts pace.
        @param quiet: A boolean indicating whether to log errors.
        """

        def fire_reconnect(remote):
            self._twisted_reactor.fire("%s-reconnect" %
                                       self.component.name)

        def connected(remote):
            self._factory.add_notifier(fire_reconnect)
            return remote

        def log_error(failure):
            logging.error("Error while connecting to %s", self.component.name)
            return failure

        result = super(RemoteComponentConnector, self).connect(
            max_retries=max_retries, factor=factor)
        if not quiet:
            result.addErrback(log_error)
        result.addCallback(connected)
        return result


class RemoteComponentsRegistry(object):
    """
    A global registry for looking up Landscape component connectors by name.
    """

    _by_name = {}

    @classmethod
    def get(cls, name):
        """Get the connector class for the given Landscape component.

        @param name: Name of the Landscape component we want to connect to, for
           instance C{monitor} or C{manager}.
        """
        return cls._by_name[name]

    @classmethod
    def register(cls, connector_class):
        """Register a connector for a Landscape component.

        @param connector_class: A sub-class of L{RemoteComponentConnector}
            that can be used to connect to a certain component.
        """
        cls._by_name[connector_class.component.name] = connector_class