~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/smart/medium.py

  • Committer: Canonical.com Patch Queue Manager
  • Date: 2009-04-09 20:23:07 UTC
  • mfrom: (4265.1.4 bbc-merge)
  • Revision ID: pqm@pqm.ubuntu.com-20090409202307-n0depb16qepoe21o
(jam) Change _fetch_uses_deltas = False for CHK repos until we can
        write a better fix.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
# Copyright (C) 2006-2011 Canonical Ltd
 
1
# Copyright (C) 2006 Canonical Ltd
2
2
#
3
3
# This program is free software; you can redistribute it and/or modify
4
4
# it under the terms of the GNU General Public License as published by
24
24
bzrlib/transport/smart/__init__.py.
25
25
"""
26
26
 
 
27
import errno
27
28
import os
 
29
import socket
28
30
import sys
29
31
import urllib
30
32
 
31
 
import bzrlib
32
33
from bzrlib.lazy_import import lazy_import
33
34
lazy_import(globals(), """
34
 
import socket
35
 
import thread
 
35
import atexit
36
36
import weakref
37
 
 
38
37
from bzrlib import (
39
38
    debug,
40
39
    errors,
 
40
    osutils,
 
41
    symbol_versioning,
41
42
    trace,
42
43
    ui,
43
44
    urlutils,
44
45
    )
45
 
from bzrlib.smart import client, protocol, request, vfs
 
46
from bzrlib.smart import client, protocol
46
47
from bzrlib.transport import ssh
47
48
""")
48
 
from bzrlib import osutils
49
 
 
50
 
# Throughout this module buffer size parameters are either limited to be at
51
 
# most _MAX_READ_SIZE, or are ignored and _MAX_READ_SIZE is used instead.
52
 
# For this module's purposes, MAX_SOCKET_CHUNK is a reasonable size for reads
53
 
# from non-sockets as well.
54
 
_MAX_READ_SIZE = osutils.MAX_SOCKET_CHUNK
 
49
 
 
50
 
 
51
# We must not read any more than 64k at a time so we don't risk "no buffer
 
52
# space available" errors on some platforms.  Windows in particular is likely
 
53
# to give error 10053 or 10055 if we read more than 64k from a socket.
 
54
_MAX_READ_SIZE = 64 * 1024
 
55
 
55
56
 
56
57
def _get_protocol_factory_for_bytes(bytes):
57
58
    """Determine the right protocol factory for 'bytes'.
273
274
    def _serve_one_request_unguarded(self, protocol):
274
275
        while protocol.next_read_size():
275
276
            # We can safely try to read large chunks.  If there is less data
276
 
            # than MAX_SOCKET_CHUNK ready, the socket will just return a
277
 
            # short read immediately rather than block.
278
 
            bytes = self.read_bytes(osutils.MAX_SOCKET_CHUNK)
 
277
            # than _MAX_READ_SIZE ready, the socket wil just return a short
 
278
            # read immediately rather than block.
 
279
            bytes = self.read_bytes(_MAX_READ_SIZE)
279
280
            if bytes == '':
280
281
                self.finished = True
281
282
                return
284
285
        self._push_back(protocol.unused_data)
285
286
 
286
287
    def _read_bytes(self, desired_count):
287
 
        return osutils.read_bytes_from_socket(
288
 
            self.socket, self._report_activity)
 
288
        # We ignore the desired_count because on sockets it's more efficient to
 
289
        # read large chunks (of _MAX_READ_SIZE bytes) at a time.
 
290
        bytes = osutils.until_no_eintr(self.socket.recv, _MAX_READ_SIZE)
 
291
        self._report_activity(len(bytes), 'read')
 
292
        return bytes
289
293
 
290
294
    def terminate_due_to_error(self):
291
295
        # TODO: This should log to a server log file, but no such thing
294
298
        self.finished = True
295
299
 
296
300
    def _write_out(self, bytes):
297
 
        tstart = osutils.timer_func()
298
301
        osutils.send_all(self.socket, bytes, self._report_activity)
299
 
        if 'hpss' in debug.debug_flags:
300
 
            thread_id = thread.get_ident()
301
 
            trace.mutter('%12s: [%s] %d bytes to the socket in %.3fs'
302
 
                         % ('wrote', thread_id, len(bytes),
303
 
                            osutils.timer_func() - tstart))
304
302
 
305
303
 
306
304
class SmartServerPipeStreamMedium(SmartServerStreamMedium):
477
475
        if not line.endswith('\n'):
478
476
            # end of file encountered reading from server
479
477
            raise errors.ConnectionReset(
480
 
                "Unexpected end of message. Please check connectivity "
481
 
                "and permissions, and report a bug if problems persist.")
 
478
                "please check connectivity and permissions")
482
479
        return line
483
480
 
484
481
    def _read_line(self):
493
490
class _DebugCounter(object):
494
491
    """An object that counts the HPSS calls made to each client medium.
495
492
 
496
 
    When a medium is garbage-collected, or failing that when
497
 
    bzrlib.global_state exits, the total number of calls made on that medium
498
 
    are reported via trace.note.
 
493
    When a medium is garbage-collected, or failing that when atexit functions
 
494
    are run, the total number of calls made on that medium are reported via
 
495
    trace.note.
499
496
    """
500
497
 
501
498
    def __init__(self):
502
499
        self.counts = weakref.WeakKeyDictionary()
503
500
        client._SmartClient.hooks.install_named_hook(
504
501
            'call', self.increment_call_count, 'hpss call counter')
505
 
        bzrlib.global_state.cleanups.add_cleanup(self.flush_all)
 
502
        atexit.register(self.flush_all)
506
503
 
507
504
    def track(self, medium):
508
505
        """Start tracking calls made to a medium.
512
509
        """
513
510
        medium_repr = repr(medium)
514
511
        # Add this medium to the WeakKeyDictionary
515
 
        self.counts[medium] = dict(count=0, vfs_count=0,
516
 
                                   medium_repr=medium_repr)
 
512
        self.counts[medium] = [0, medium_repr]
517
513
        # Weakref callbacks are fired in reverse order of their association
518
514
        # with the referenced object.  So we add a weakref *after* adding to
519
515
        # the WeakKeyDict so that we can report the value from it before the
523
519
    def increment_call_count(self, params):
524
520
        # Increment the count in the WeakKeyDictionary
525
521
        value = self.counts[params.medium]
526
 
        value['count'] += 1
527
 
        try:
528
 
            request_method = request.request_handlers.get(params.method)
529
 
        except KeyError:
530
 
            # A method we don't know about doesn't count as a VFS method.
531
 
            return
532
 
        if issubclass(request_method, vfs.VfsRequest):
533
 
            value['vfs_count'] += 1
 
522
        value[0] += 1
534
523
 
535
524
    def done(self, ref):
536
525
        value = self.counts[ref]
537
 
        count, vfs_count, medium_repr = (
538
 
            value['count'], value['vfs_count'], value['medium_repr'])
 
526
        count, medium_repr = value
539
527
        # In case this callback is invoked for the same ref twice (by the
540
528
        # weakref callback and by the atexit function), set the call count back
541
529
        # to 0 so this item won't be reported twice.
542
 
        value['count'] = 0
543
 
        value['vfs_count'] = 0
 
530
        value[0] = 0
544
531
        if count != 0:
545
 
            trace.note('HPSS calls: %d (%d vfs) %s',
546
 
                       count, vfs_count, medium_repr)
 
532
            trace.note('HPSS calls: %d %s', count, medium_repr)
547
533
 
548
534
    def flush_all(self):
549
535
        for ref in list(self.counts.keys()):
606
592
            # which is newer than a previously supplied older-than version.
607
593
            # This indicates that some smart verb call is not guarded
608
594
            # appropriately (it should simply not have been tried).
609
 
            trace.mutter(
 
595
            raise AssertionError(
610
596
                "_remember_remote_is_before(%r) called, but "
611
597
                "_remember_remote_is_before(%r) was called previously."
612
 
                , version_tuple, self._remote_version_is_before)
613
 
            if 'hpss' in debug.debug_flags:
614
 
                ui.ui_factory.show_warning(
615
 
                    "_remember_remote_is_before(%r) called, but "
616
 
                    "_remember_remote_is_before(%r) was called previously."
617
 
                    % (version_tuple, self._remote_version_is_before))
618
 
            return
 
598
                % (version_tuple, self._remote_version_is_before))
619
599
        self._remote_version_is_before = version_tuple
620
600
 
621
601
    def protocol_version(self):
732
712
 
733
713
    def _read_bytes(self, count):
734
714
        """See SmartClientStreamMedium._read_bytes."""
735
 
        bytes_to_read = min(count, _MAX_READ_SIZE)
736
 
        bytes = self._readable_pipe.read(bytes_to_read)
 
715
        bytes = self._readable_pipe.read(count)
737
716
        self._report_activity(len(bytes), 'read')
738
717
        return bytes
739
718
 
740
719
 
741
 
class SSHParams(object):
742
 
    """A set of parameters for starting a remote bzr via SSH."""
 
720
class SmartSSHClientMedium(SmartClientStreamMedium):
 
721
    """A client medium using SSH."""
743
722
 
744
723
    def __init__(self, host, port=None, username=None, password=None,
745
 
            bzr_remote_path='bzr'):
746
 
        self.host = host
747
 
        self.port = port
748
 
        self.username = username
749
 
        self.password = password
750
 
        self.bzr_remote_path = bzr_remote_path
751
 
 
752
 
 
753
 
class SmartSSHClientMedium(SmartClientStreamMedium):
754
 
    """A client medium using SSH.
755
 
    
756
 
    It delegates IO to a SmartClientSocketMedium or
757
 
    SmartClientAlreadyConnectedSocketMedium (depending on platform).
758
 
    """
759
 
 
760
 
    def __init__(self, base, ssh_params, vendor=None):
 
724
            base=None, vendor=None, bzr_remote_path=None):
761
725
        """Creates a client that will connect on the first use.
762
726
 
763
 
        :param ssh_params: A SSHParams instance.
764
727
        :param vendor: An optional override for the ssh vendor to use. See
765
728
            bzrlib.transport.ssh for details on ssh vendors.
766
729
        """
767
 
        self._real_medium = None
768
 
        self._ssh_params = ssh_params
769
 
        # for the benefit of progress making a short description of this
770
 
        # transport
771
 
        self._scheme = 'bzr+ssh'
 
730
        self._connected = False
 
731
        self._host = host
 
732
        self._password = password
 
733
        self._port = port
 
734
        self._username = username
772
735
        # SmartClientStreamMedium stores the repr of this object in its
773
736
        # _DebugCounter so we have to store all the values used in our repr
774
737
        # method before calling the super init.
775
738
        SmartClientStreamMedium.__init__(self, base)
 
739
        self._read_from = None
 
740
        self._ssh_connection = None
776
741
        self._vendor = vendor
777
 
        self._ssh_connection = None
 
742
        self._write_to = None
 
743
        self._bzr_remote_path = bzr_remote_path
 
744
        # for the benefit of progress making a short description of this
 
745
        # transport
 
746
        self._scheme = 'bzr+ssh'
778
747
 
779
748
    def __repr__(self):
780
 
        if self._ssh_params.port is None:
781
 
            maybe_port = ''
782
 
        else:
783
 
            maybe_port = ':%s' % self._ssh_params.port
784
 
        return "%s(%s://%s@%s%s/)" % (
 
749
        return "%s(connected=%r, username=%r, host=%r, port=%r)" % (
785
750
            self.__class__.__name__,
786
 
            self._scheme,
787
 
            self._ssh_params.username,
788
 
            self._ssh_params.host,
789
 
            maybe_port)
 
751
            self._connected,
 
752
            self._username,
 
753
            self._host,
 
754
            self._port)
790
755
 
791
756
    def _accept_bytes(self, bytes):
792
757
        """See SmartClientStreamMedium.accept_bytes."""
793
758
        self._ensure_connection()
794
 
        self._real_medium.accept_bytes(bytes)
 
759
        self._write_to.write(bytes)
 
760
        self._report_activity(len(bytes), 'write')
795
761
 
796
762
    def disconnect(self):
797
763
        """See SmartClientMedium.disconnect()."""
798
 
        if self._real_medium is not None:
799
 
            self._real_medium.disconnect()
800
 
            self._real_medium = None
801
 
        if self._ssh_connection is not None:
802
 
            self._ssh_connection.close()
803
 
            self._ssh_connection = None
 
764
        if not self._connected:
 
765
            return
 
766
        self._read_from.close()
 
767
        self._write_to.close()
 
768
        self._ssh_connection.close()
 
769
        self._connected = False
804
770
 
805
771
    def _ensure_connection(self):
806
772
        """Connect this medium if not already connected."""
807
 
        if self._real_medium is not None:
 
773
        if self._connected:
808
774
            return
809
775
        if self._vendor is None:
810
776
            vendor = ssh._get_ssh_vendor()
811
777
        else:
812
778
            vendor = self._vendor
813
 
        self._ssh_connection = vendor.connect_ssh(self._ssh_params.username,
814
 
                self._ssh_params.password, self._ssh_params.host,
815
 
                self._ssh_params.port,
816
 
                command=[self._ssh_params.bzr_remote_path, 'serve', '--inet',
 
779
        self._ssh_connection = vendor.connect_ssh(self._username,
 
780
                self._password, self._host, self._port,
 
781
                command=[self._bzr_remote_path, 'serve', '--inet',
817
782
                         '--directory=/', '--allow-writes'])
818
 
        io_kind, io_object = self._ssh_connection.get_sock_or_pipes()
819
 
        if io_kind == 'socket':
820
 
            self._real_medium = SmartClientAlreadyConnectedSocketMedium(
821
 
                self.base, io_object)
822
 
        elif io_kind == 'pipes':
823
 
            read_from, write_to = io_object
824
 
            self._real_medium = SmartSimplePipesClientMedium(
825
 
                read_from, write_to, self.base)
826
 
        else:
827
 
            raise AssertionError(
828
 
                "Unexpected io_kind %r from %r"
829
 
                % (io_kind, self._ssh_connection))
 
783
        self._read_from, self._write_to = \
 
784
            self._ssh_connection.get_filelike_channels()
 
785
        self._connected = True
830
786
 
831
787
    def _flush(self):
832
788
        """See SmartClientStreamMedium._flush()."""
833
 
        self._real_medium._flush()
 
789
        self._write_to.flush()
834
790
 
835
791
    def _read_bytes(self, count):
836
792
        """See SmartClientStreamMedium.read_bytes."""
837
 
        if self._real_medium is None:
 
793
        if not self._connected:
838
794
            raise errors.MediumNotConnected(self)
839
 
        return self._real_medium.read_bytes(count)
 
795
        bytes_to_read = min(count, _MAX_READ_SIZE)
 
796
        bytes = self._read_from.read(bytes_to_read)
 
797
        self._report_activity(len(bytes), 'read')
 
798
        return bytes
840
799
 
841
800
 
842
801
# Port 4155 is the default port for bzr://, registered with IANA.
844
803
BZR_DEFAULT_PORT = 4155
845
804
 
846
805
 
847
 
class SmartClientSocketMedium(SmartClientStreamMedium):
848
 
    """A client medium using a socket.
849
 
    
850
 
    This class isn't usable directly.  Use one of its subclasses instead.
851
 
    """
 
806
class SmartTCPClientMedium(SmartClientStreamMedium):
 
807
    """A client medium using TCP."""
852
808
 
853
 
    def __init__(self, base):
 
809
    def __init__(self, host, port, base):
 
810
        """Creates a client that will connect on the first use."""
854
811
        SmartClientStreamMedium.__init__(self, base)
 
812
        self._connected = False
 
813
        self._host = host
 
814
        self._port = port
855
815
        self._socket = None
856
 
        self._connected = False
857
816
 
858
817
    def _accept_bytes(self, bytes):
859
818
        """See SmartClientMedium.accept_bytes."""
860
819
        self._ensure_connection()
861
820
        osutils.send_all(self._socket, bytes, self._report_activity)
862
821
 
863
 
    def _ensure_connection(self):
864
 
        """Connect this medium if not already connected."""
865
 
        raise NotImplementedError(self._ensure_connection)
866
 
 
867
 
    def _flush(self):
868
 
        """See SmartClientStreamMedium._flush().
869
 
 
870
 
        For sockets we do no flushing. For TCP sockets we may want to turn off
871
 
        TCP_NODELAY and add a means to do a flush, but that can be done in the
872
 
        future.
873
 
        """
874
 
 
875
 
    def _read_bytes(self, count):
876
 
        """See SmartClientMedium.read_bytes."""
877
 
        if not self._connected:
878
 
            raise errors.MediumNotConnected(self)
879
 
        return osutils.read_bytes_from_socket(
880
 
            self._socket, self._report_activity)
881
 
 
882
822
    def disconnect(self):
883
823
        """See SmartClientMedium.disconnect()."""
884
824
        if not self._connected:
887
827
        self._socket = None
888
828
        self._connected = False
889
829
 
890
 
 
891
 
class SmartTCPClientMedium(SmartClientSocketMedium):
892
 
    """A client medium that creates a TCP connection."""
893
 
 
894
 
    def __init__(self, host, port, base):
895
 
        """Creates a client that will connect on the first use."""
896
 
        SmartClientSocketMedium.__init__(self, base)
897
 
        self._host = host
898
 
        self._port = port
899
 
 
900
830
    def _ensure_connection(self):
901
831
        """Connect this medium if not already connected."""
902
832
        if self._connected:
936
866
                    (self._host, port, err_msg))
937
867
        self._connected = True
938
868
 
939
 
 
940
 
class SmartClientAlreadyConnectedSocketMedium(SmartClientSocketMedium):
941
 
    """A client medium for an already connected socket.
942
 
    
943
 
    Note that this class will assume it "owns" the socket, so it will close it
944
 
    when its disconnect method is called.
945
 
    """
946
 
 
947
 
    def __init__(self, base, sock):
948
 
        SmartClientSocketMedium.__init__(self, base)
949
 
        self._socket = sock
950
 
        self._connected = True
951
 
 
952
 
    def _ensure_connection(self):
953
 
        # Already connected, by definition!  So nothing to do.
954
 
        pass
 
869
    def _flush(self):
 
870
        """See SmartClientStreamMedium._flush().
 
871
 
 
872
        For TCP we do no flushing. We may want to turn off TCP_NODELAY and
 
873
        add a means to do a flush, but that can be done in the future.
 
874
        """
 
875
 
 
876
    def _read_bytes(self, count):
 
877
        """See SmartClientMedium.read_bytes."""
 
878
        if not self._connected:
 
879
            raise errors.MediumNotConnected(self)
 
880
        # We ignore the desired_count because on sockets it's more efficient to
 
881
        # read large chunks (of _MAX_READ_SIZE bytes) at a time.
 
882
        try:
 
883
            bytes = osutils.until_no_eintr(self._socket.recv, _MAX_READ_SIZE)
 
884
        except socket.error, e:
 
885
            if len(e.args) and e.args[0] == errno.ECONNRESET:
 
886
                # Callers expect an empty string in that case
 
887
                return ''
 
888
            else:
 
889
                raise
 
890
        else:
 
891
            self._report_activity(len(bytes), 'read')
 
892
            return bytes
955
893
 
956
894
 
957
895
class SmartClientStreamMediumRequest(SmartClientMediumRequest):
993
931
        """
994
932
        self._medium._flush()
995
933
 
996