~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/smart/medium.py

  • Committer: John Arbash Meinel
  • Author(s): Mark Hammond
  • Date: 2008-09-09 17:02:21 UTC
  • mto: This revision was merged to the branch mainline in revision 3697.
  • Revision ID: john@arbash-meinel.com-20080909170221-svim3jw2mrz0amp3
An updated transparent icon for bzr.

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
12
12
#
13
13
# You should have received a copy of the GNU General Public License
14
14
# along with this program; if not, write to the Free Software
15
 
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
 
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
16
16
 
17
17
"""The 'medium' layer for the smart servers and clients.
18
18
 
24
24
bzrlib/transport/smart/__init__.py.
25
25
"""
26
26
 
27
 
from __future__ import absolute_import
28
 
 
29
 
import errno
30
27
import os
 
28
import socket
31
29
import sys
32
 
import time
 
30
import urllib
33
31
 
34
 
import bzrlib
35
32
from bzrlib.lazy_import import lazy_import
36
33
lazy_import(globals(), """
37
 
import select
38
 
import socket
39
 
import thread
40
 
import weakref
41
 
 
42
34
from bzrlib import (
43
 
    debug,
44
35
    errors,
45
 
    trace,
46
 
    transport,
47
 
    ui,
 
36
    osutils,
 
37
    symbol_versioning,
48
38
    urlutils,
49
39
    )
50
 
from bzrlib.i18n import gettext
51
 
from bzrlib.smart import client, protocol, request, signals, vfs
 
40
from bzrlib.smart import protocol
52
41
from bzrlib.transport import ssh
53
42
""")
54
 
from bzrlib import osutils
55
 
 
56
 
# Throughout this module buffer size parameters are either limited to be at
57
 
# most _MAX_READ_SIZE, or are ignored and _MAX_READ_SIZE is used instead.
58
 
# For this module's purposes, MAX_SOCKET_CHUNK is a reasonable size for reads
59
 
# from non-sockets as well.
60
 
_MAX_READ_SIZE = osutils.MAX_SOCKET_CHUNK
 
43
 
 
44
 
 
45
# We must not read any more than 64k at a time so we don't risk "no buffer
 
46
# space available" errors on some platforms.  Windows in particular is likely
 
47
# to give error 10053 or 10055 if we read more than 64k from a socket.
 
48
_MAX_READ_SIZE = 64 * 1024
 
49
 
61
50
 
62
51
def _get_protocol_factory_for_bytes(bytes):
63
52
    """Determine the right protocol factory for 'bytes'.
93
82
 
94
83
def _get_line(read_bytes_func):
95
84
    """Read bytes using read_bytes_func until a newline byte.
96
 
 
 
85
    
97
86
    This isn't particularly efficient, so should only be used when the
98
87
    expected size of the line is quite short.
99
 
 
 
88
    
100
89
    :returns: a tuple of two strs: (line, excess)
101
90
    """
102
91
    newline_pos = -1
118
107
 
119
108
    def __init__(self):
120
109
        self._push_back_buffer = None
121
 
 
 
110
        
122
111
    def _push_back(self, bytes):
123
112
        """Return unused bytes to the medium, because they belong to the next
124
113
        request(s).
158
147
 
159
148
    def _get_line(self):
160
149
        """Read bytes from this request's response until a newline byte.
161
 
 
 
150
        
162
151
        This isn't particularly efficient, so should only be used when the
163
152
        expected size of the line is quite short.
164
153
 
167
156
        line, excess = _get_line(self.read_bytes)
168
157
        self._push_back(excess)
169
158
        return line
170
 
 
171
 
    def _report_activity(self, bytes, direction):
172
 
        """Notify that this medium has activity.
173
 
 
174
 
        Implementations should call this from all methods that actually do IO.
175
 
        Be careful that it's not called twice, if one method is implemented on
176
 
        top of another.
177
 
 
178
 
        :param bytes: Number of bytes read or written.
179
 
        :param direction: 'read' or 'write' or None.
180
 
        """
181
 
        ui.ui_factory.report_transport_activity(self, bytes, direction)
182
 
 
183
 
 
184
 
_bad_file_descriptor = (errno.EBADF,)
185
 
if sys.platform == 'win32':
186
 
    # Given on Windows if you pass a closed socket to select.select. Probably
187
 
    # also given if you pass a file handle to select.
188
 
    WSAENOTSOCK = 10038
189
 
    _bad_file_descriptor += (WSAENOTSOCK,)
190
 
 
 
159
 
191
160
 
192
161
class SmartServerStreamMedium(SmartMedium):
193
162
    """Handles smart commands coming over a stream.
198
167
    One instance is created for each connected client; it can serve multiple
199
168
    requests in the lifetime of the connection.
200
169
 
201
 
    The server passes requests through to an underlying backing transport,
 
170
    The server passes requests through to an underlying backing transport, 
202
171
    which will typically be a LocalTransport looking at the server's filesystem.
203
172
 
204
173
    :ivar _push_back_buffer: a str of bytes that have been read from the stream
207
176
        the stream.  See also the _push_back method.
208
177
    """
209
178
 
210
 
    _timer = time.time
211
 
 
212
 
    def __init__(self, backing_transport, root_client_path='/', timeout=None):
 
179
    def __init__(self, backing_transport, root_client_path='/'):
213
180
        """Construct new server.
214
181
 
215
182
        :param backing_transport: Transport for the directory served.
218
185
        self.backing_transport = backing_transport
219
186
        self.root_client_path = root_client_path
220
187
        self.finished = False
221
 
        if timeout is None:
222
 
            raise AssertionError('You must supply a timeout.')
223
 
        self._client_timeout = timeout
224
 
        self._client_poll_timeout = min(timeout / 10.0, 1.0)
225
188
        SmartMedium.__init__(self)
226
189
 
227
190
    def serve(self):
233
196
            while not self.finished:
234
197
                server_protocol = self._build_protocol()
235
198
                self._serve_one_request(server_protocol)
236
 
        except errors.ConnectionTimeout, e:
237
 
            trace.note('%s' % (e,))
238
 
            trace.log_exception_quietly()
239
 
            self._disconnect_client()
240
 
            # We reported it, no reason to make a big fuss.
241
 
            return
242
199
        except Exception, e:
243
200
            stderr.write("%s terminating on exception %s\n" % (self, e))
244
201
            raise
245
 
        self._disconnect_client()
246
 
 
247
 
    def _stop_gracefully(self):
248
 
        """When we finish this message, stop looking for more."""
249
 
        trace.mutter('Stopping %s' % (self,))
250
 
        self.finished = True
251
 
 
252
 
    def _disconnect_client(self):
253
 
        """Close the current connection. We stopped due to a timeout/etc."""
254
 
        # The default implementation is a no-op, because that is all we used to
255
 
        # do when disconnecting from a client. I suppose we never had the
256
 
        # *server* initiate a disconnect, before
257
 
 
258
 
    def _wait_for_bytes_with_timeout(self, timeout_seconds):
259
 
        """Wait for more bytes to be read, but timeout if none available.
260
 
 
261
 
        This allows us to detect idle connections, and stop trying to read from
262
 
        them, without setting the socket itself to non-blocking. This also
263
 
        allows us to specify when we watch for idle timeouts.
264
 
 
265
 
        :return: Did we timeout? (True if we timed out, False if there is data
266
 
            to be read)
267
 
        """
268
 
        raise NotImplementedError(self._wait_for_bytes_with_timeout)
269
202
 
270
203
    def _build_protocol(self):
271
204
        """Identifies the version of the incoming request, and returns an
276
209
 
277
210
        :returns: a SmartServerRequestProtocol.
278
211
        """
279
 
        self._wait_for_bytes_with_timeout(self._client_timeout)
280
 
        if self.finished:
281
 
            # We're stopping, so don't try to do any more work
282
 
            return None
283
212
        bytes = self._get_line()
284
213
        protocol_factory, unused_bytes = _get_protocol_factory_for_bytes(bytes)
285
214
        protocol = protocol_factory(
287
216
        protocol.accept_bytes(unused_bytes)
288
217
        return protocol
289
218
 
290
 
    def _wait_on_descriptor(self, fd, timeout_seconds):
291
 
        """select() on a file descriptor, waiting for nonblocking read()
292
 
 
293
 
        This will raise a ConnectionTimeout exception if we do not get a
294
 
        readable handle before timeout_seconds.
295
 
        :return: None
296
 
        """
297
 
        t_end = self._timer() + timeout_seconds
298
 
        poll_timeout = min(timeout_seconds, self._client_poll_timeout)
299
 
        rs = xs = None
300
 
        while not rs and not xs and self._timer() < t_end:
301
 
            if self.finished:
302
 
                return
303
 
            try:
304
 
                rs, _, xs = select.select([fd], [], [fd], poll_timeout)
305
 
            except (select.error, socket.error) as e:
306
 
                err = getattr(e, 'errno', None)
307
 
                if err is None and getattr(e, 'args', None) is not None:
308
 
                    # select.error doesn't have 'errno', it just has args[0]
309
 
                    err = e.args[0]
310
 
                if err in _bad_file_descriptor:
311
 
                    return # Not a socket indicates read() will fail
312
 
                elif err == errno.EINTR:
313
 
                    # Interrupted, keep looping.
314
 
                    continue
315
 
                raise
316
 
        if rs or xs:
317
 
            return
318
 
        raise errors.ConnectionTimeout('disconnecting client after %.1f seconds'
319
 
                                       % (timeout_seconds,))
320
 
 
321
219
    def _serve_one_request(self, protocol):
322
220
        """Read one request from input, process, send back a response.
323
 
 
 
221
        
324
222
        :param protocol: a SmartServerRequestProtocol.
325
223
        """
326
 
        if protocol is None:
327
 
            return
328
224
        try:
329
225
            self._serve_one_request_unguarded(protocol)
330
226
        except KeyboardInterrupt:
346
242
 
347
243
class SmartServerSocketStreamMedium(SmartServerStreamMedium):
348
244
 
349
 
    def __init__(self, sock, backing_transport, root_client_path='/',
350
 
                 timeout=None):
 
245
    def __init__(self, sock, backing_transport, root_client_path='/'):
351
246
        """Constructor.
352
247
 
353
248
        :param sock: the socket the server will read from.  It will be put
354
249
            into blocking mode.
355
250
        """
356
251
        SmartServerStreamMedium.__init__(
357
 
            self, backing_transport, root_client_path=root_client_path,
358
 
            timeout=timeout)
 
252
            self, backing_transport, root_client_path=root_client_path)
359
253
        sock.setblocking(True)
360
254
        self.socket = sock
361
 
        # Get the getpeername now, as we might be closed later when we care.
362
 
        try:
363
 
            self._client_info = sock.getpeername()
364
 
        except socket.error:
365
 
            self._client_info = '<unknown>'
366
 
 
367
 
    def __str__(self):
368
 
        return '%s(client=%s)' % (self.__class__.__name__, self._client_info)
369
 
 
370
 
    def __repr__(self):
371
 
        return '%s.%s(client=%s)' % (self.__module__, self.__class__.__name__,
372
 
            self._client_info)
373
255
 
374
256
    def _serve_one_request_unguarded(self, protocol):
375
257
        while protocol.next_read_size():
376
258
            # We can safely try to read large chunks.  If there is less data
377
 
            # than MAX_SOCKET_CHUNK ready, the socket will just return a
378
 
            # short read immediately rather than block.
379
 
            bytes = self.read_bytes(osutils.MAX_SOCKET_CHUNK)
 
259
            # than _MAX_READ_SIZE ready, the socket wil just return a short
 
260
            # read immediately rather than block.
 
261
            bytes = self.read_bytes(_MAX_READ_SIZE)
380
262
            if bytes == '':
381
263
                self.finished = True
382
264
                return
383
265
            protocol.accept_bytes(bytes)
384
 
 
 
266
        
385
267
        self._push_back(protocol.unused_data)
386
268
 
387
 
    def _disconnect_client(self):
388
 
        """Close the current connection. We stopped due to a timeout/etc."""
389
 
        self.socket.close()
390
 
 
391
 
    def _wait_for_bytes_with_timeout(self, timeout_seconds):
392
 
        """Wait for more bytes to be read, but timeout if none available.
393
 
 
394
 
        This allows us to detect idle connections, and stop trying to read from
395
 
        them, without setting the socket itself to non-blocking. This also
396
 
        allows us to specify when we watch for idle timeouts.
397
 
 
398
 
        :return: None, this will raise ConnectionTimeout if we time out before
399
 
            data is available.
400
 
        """
401
 
        return self._wait_on_descriptor(self.socket, timeout_seconds)
402
 
 
403
269
    def _read_bytes(self, desired_count):
404
 
        return osutils.read_bytes_from_socket(
405
 
            self.socket, self._report_activity)
 
270
        # We ignore the desired_count because on sockets it's more efficient to
 
271
        # read large chunks (of _MAX_READ_SIZE bytes) at a time.
 
272
        return self.socket.recv(_MAX_READ_SIZE)
406
273
 
407
274
    def terminate_due_to_error(self):
408
275
        # TODO: This should log to a server log file, but no such thing
411
278
        self.finished = True
412
279
 
413
280
    def _write_out(self, bytes):
414
 
        tstart = osutils.timer_func()
415
 
        osutils.send_all(self.socket, bytes, self._report_activity)
416
 
        if 'hpss' in debug.debug_flags:
417
 
            thread_id = thread.get_ident()
418
 
            trace.mutter('%12s: [%s] %d bytes to the socket in %.3fs'
419
 
                         % ('wrote', thread_id, len(bytes),
420
 
                            osutils.timer_func() - tstart))
 
281
        osutils.send_all(self.socket, bytes)
421
282
 
422
283
 
423
284
class SmartServerPipeStreamMedium(SmartServerStreamMedium):
424
285
 
425
 
    def __init__(self, in_file, out_file, backing_transport, timeout=None):
 
286
    def __init__(self, in_file, out_file, backing_transport):
426
287
        """Construct new server.
427
288
 
428
289
        :param in_file: Python file from which requests can be read.
429
290
        :param out_file: Python file to write responses.
430
291
        :param backing_transport: Transport for the directory served.
431
292
        """
432
 
        SmartServerStreamMedium.__init__(self, backing_transport,
433
 
            timeout=timeout)
 
293
        SmartServerStreamMedium.__init__(self, backing_transport)
434
294
        if sys.platform == 'win32':
435
295
            # force binary mode for files
436
296
            import msvcrt
441
301
        self._in = in_file
442
302
        self._out = out_file
443
303
 
444
 
    def serve(self):
445
 
        """See SmartServerStreamMedium.serve"""
446
 
        # This is the regular serve, except it adds signal trapping for soft
447
 
        # shutdown.
448
 
        stop_gracefully = self._stop_gracefully
449
 
        signals.register_on_hangup(id(self), stop_gracefully)
450
 
        try:
451
 
            return super(SmartServerPipeStreamMedium, self).serve()
452
 
        finally:
453
 
            signals.unregister_on_hangup(id(self))
454
 
 
455
304
    def _serve_one_request_unguarded(self, protocol):
456
305
        while True:
457
306
            # We need to be careful not to read past the end of the current
470
319
                return
471
320
            protocol.accept_bytes(bytes)
472
321
 
473
 
    def _disconnect_client(self):
474
 
        self._in.close()
475
 
        self._out.flush()
476
 
        self._out.close()
477
 
 
478
 
    def _wait_for_bytes_with_timeout(self, timeout_seconds):
479
 
        """Wait for more bytes to be read, but timeout if none available.
480
 
 
481
 
        This allows us to detect idle connections, and stop trying to read from
482
 
        them, without setting the socket itself to non-blocking. This also
483
 
        allows us to specify when we watch for idle timeouts.
484
 
 
485
 
        :return: None, this will raise ConnectionTimeout if we time out before
486
 
            data is available.
487
 
        """
488
 
        if (getattr(self._in, 'fileno', None) is None
489
 
            or sys.platform == 'win32'):
490
 
            # You can't select() file descriptors on Windows.
491
 
            return
492
 
        return self._wait_on_descriptor(self._in, timeout_seconds)
493
 
 
494
322
    def _read_bytes(self, desired_count):
495
323
        return self._in.read(desired_count)
496
324
 
517
345
    request.finished_reading()
518
346
 
519
347
    It is up to the individual SmartClientMedium whether multiple concurrent
520
 
    requests can exist. See SmartClientMedium.get_request to obtain instances
521
 
    of SmartClientMediumRequest, and the concrete Medium you are using for
 
348
    requests can exist. See SmartClientMedium.get_request to obtain instances 
 
349
    of SmartClientMediumRequest, and the concrete Medium you are using for 
522
350
    details on concurrency and pipelining.
523
351
    """
524
352
 
533
361
    def accept_bytes(self, bytes):
534
362
        """Accept bytes for inclusion in this request.
535
363
 
536
 
        This method may not be called after finished_writing() has been
 
364
        This method may not be be called after finished_writing() has been
537
365
        called.  It depends upon the Medium whether or not the bytes will be
538
366
        immediately transmitted. Message based Mediums will tend to buffer the
539
367
        bytes until finished_writing() is called.
570
398
    def _finished_reading(self):
571
399
        """Helper for finished_reading.
572
400
 
573
 
        finished_reading checks the state of the request to determine if
 
401
        finished_reading checks the state of the request to determine if 
574
402
        finished_reading is allowed, and if it is hands off to _finished_reading
575
403
        to perform the action.
576
404
        """
590
418
    def _finished_writing(self):
591
419
        """Helper for finished_writing.
592
420
 
593
 
        finished_writing checks the state of the request to determine if
 
421
        finished_writing checks the state of the request to determine if 
594
422
        finished_writing is allowed, and if it is hands off to _finished_writing
595
423
        to perform the action.
596
424
        """
616
444
        read_bytes checks the state of the request to determing if bytes
617
445
        should be read. After that it hands off to _read_bytes to do the
618
446
        actual read.
619
 
 
 
447
        
620
448
        By default this forwards to self._medium.read_bytes because we are
621
449
        operating on the medium's stream.
622
450
        """
627
455
        if not line.endswith('\n'):
628
456
            # end of file encountered reading from server
629
457
            raise errors.ConnectionReset(
630
 
                "Unexpected end of message. Please check connectivity "
631
 
                "and permissions, and report a bug if problems persist.")
 
458
                "please check connectivity and permissions",
 
459
                "(and try -Dhpss if further diagnosis is required)")
632
460
        return line
633
461
 
634
462
    def _read_line(self):
635
463
        """Helper for SmartClientMediumRequest.read_line.
636
 
 
 
464
        
637
465
        By default this forwards to self._medium._get_line because we are
638
466
        operating on the medium's stream.
639
467
        """
640
468
        return self._medium._get_line()
641
469
 
642
470
 
643
 
class _VfsRefuser(object):
644
 
    """An object that refuses all VFS requests.
645
 
 
646
 
    """
647
 
 
648
 
    def __init__(self):
649
 
        client._SmartClient.hooks.install_named_hook(
650
 
            'call', self.check_vfs, 'vfs refuser')
651
 
 
652
 
    def check_vfs(self, params):
653
 
        try:
654
 
            request_method = request.request_handlers.get(params.method)
655
 
        except KeyError:
656
 
            # A method we don't know about doesn't count as a VFS method.
657
 
            return
658
 
        if issubclass(request_method, vfs.VfsRequest):
659
 
            raise errors.HpssVfsRequestNotAllowed(params.method, params.args)
660
 
 
661
 
 
662
 
class _DebugCounter(object):
663
 
    """An object that counts the HPSS calls made to each client medium.
664
 
 
665
 
    When a medium is garbage-collected, or failing that when
666
 
    bzrlib.global_state exits, the total number of calls made on that medium
667
 
    are reported via trace.note.
668
 
    """
669
 
 
670
 
    def __init__(self):
671
 
        self.counts = weakref.WeakKeyDictionary()
672
 
        client._SmartClient.hooks.install_named_hook(
673
 
            'call', self.increment_call_count, 'hpss call counter')
674
 
        bzrlib.global_state.cleanups.add_cleanup(self.flush_all)
675
 
 
676
 
    def track(self, medium):
677
 
        """Start tracking calls made to a medium.
678
 
 
679
 
        This only keeps a weakref to the medium, so shouldn't affect the
680
 
        medium's lifetime.
681
 
        """
682
 
        medium_repr = repr(medium)
683
 
        # Add this medium to the WeakKeyDictionary
684
 
        self.counts[medium] = dict(count=0, vfs_count=0,
685
 
                                   medium_repr=medium_repr)
686
 
        # Weakref callbacks are fired in reverse order of their association
687
 
        # with the referenced object.  So we add a weakref *after* adding to
688
 
        # the WeakKeyDict so that we can report the value from it before the
689
 
        # entry is removed by the WeakKeyDict's own callback.
690
 
        ref = weakref.ref(medium, self.done)
691
 
 
692
 
    def increment_call_count(self, params):
693
 
        # Increment the count in the WeakKeyDictionary
694
 
        value = self.counts[params.medium]
695
 
        value['count'] += 1
696
 
        try:
697
 
            request_method = request.request_handlers.get(params.method)
698
 
        except KeyError:
699
 
            # A method we don't know about doesn't count as a VFS method.
700
 
            return
701
 
        if issubclass(request_method, vfs.VfsRequest):
702
 
            value['vfs_count'] += 1
703
 
 
704
 
    def done(self, ref):
705
 
        value = self.counts[ref]
706
 
        count, vfs_count, medium_repr = (
707
 
            value['count'], value['vfs_count'], value['medium_repr'])
708
 
        # In case this callback is invoked for the same ref twice (by the
709
 
        # weakref callback and by the atexit function), set the call count back
710
 
        # to 0 so this item won't be reported twice.
711
 
        value['count'] = 0
712
 
        value['vfs_count'] = 0
713
 
        if count != 0:
714
 
            trace.note(gettext('HPSS calls: {0} ({1} vfs) {2}').format(
715
 
                       count, vfs_count, medium_repr))
716
 
 
717
 
    def flush_all(self):
718
 
        for ref in list(self.counts.keys()):
719
 
            self.done(ref)
720
 
 
721
 
_debug_counter = None
722
 
_vfs_refuser = None
723
 
 
724
 
 
725
471
class SmartClientMedium(SmartMedium):
726
472
    """Smart client is a medium for sending smart protocol requests over."""
727
473
 
736
482
        # _remote_version_is_before tracks the bzr version the remote side
737
483
        # can be based on what we've seen so far.
738
484
        self._remote_version_is_before = None
739
 
        # Install debug hook function if debug flag is set.
740
 
        if 'hpss' in debug.debug_flags:
741
 
            global _debug_counter
742
 
            if _debug_counter is None:
743
 
                _debug_counter = _DebugCounter()
744
 
            _debug_counter.track(self)
745
 
        if 'hpss_client_no_vfs' in debug.debug_flags:
746
 
            global _vfs_refuser
747
 
            if _vfs_refuser is None:
748
 
                _vfs_refuser = _VfsRefuser()
749
485
 
750
486
    def _is_remote_before(self, version_tuple):
751
487
        """Is it possible the remote side supports RPCs for a given version?
776
512
        """
777
513
        if (self._remote_version_is_before is not None and
778
514
            version_tuple > self._remote_version_is_before):
779
 
            # We have been told that the remote side is older than some version
780
 
            # which is newer than a previously supplied older-than version.
781
 
            # This indicates that some smart verb call is not guarded
782
 
            # appropriately (it should simply not have been tried).
783
 
            trace.mutter(
 
515
            raise AssertionError(
784
516
                "_remember_remote_is_before(%r) called, but "
785
517
                "_remember_remote_is_before(%r) was called previously."
786
 
                , version_tuple, self._remote_version_is_before)
787
 
            if 'hpss' in debug.debug_flags:
788
 
                ui.ui_factory.show_warning(
789
 
                    "_remember_remote_is_before(%r) called, but "
790
 
                    "_remember_remote_is_before(%r) was called previously."
791
 
                    % (version_tuple, self._remote_version_is_before))
792
 
            return
 
518
                % (version_tuple, self._remote_version_is_before))
793
519
        self._remote_version_is_before = version_tuple
794
520
 
795
521
    def protocol_version(self):
829
555
 
830
556
    def disconnect(self):
831
557
        """If this medium maintains a persistent connection, close it.
832
 
 
 
558
        
833
559
        The default implementation does nothing.
834
560
        """
835
 
 
 
561
        
836
562
    def remote_path_from_transport(self, transport):
837
563
        """Convert transport into a path suitable for using in a request.
838
 
 
 
564
        
839
565
        Note that the resulting remote path doesn't encode the host name or
840
566
        anything but path, so it is only safe to use it in requests sent over
841
567
        the medium from the matching transport.
842
568
        """
843
569
        medium_base = urlutils.join(self.base, '/')
844
570
        rel_url = urlutils.relative_url(medium_base, transport.base)
845
 
        return urlutils.unquote(rel_url)
 
571
        return urllib.unquote(rel_url)
846
572
 
847
573
 
848
574
class SmartClientStreamMedium(SmartClientMedium):
869
595
 
870
596
    def _flush(self):
871
597
        """Flush the output stream.
872
 
 
 
598
        
873
599
        This method is used by the SmartClientStreamMediumRequest to ensure that
874
600
        all data for a request is sent, to avoid long timeouts or deadlocks.
875
601
        """
883
609
        """
884
610
        return SmartClientStreamMediumRequest(self)
885
611
 
886
 
    def reset(self):
887
 
        """We have been disconnected, reset current state.
888
 
 
889
 
        This resets things like _current_request and connected state.
890
 
        """
891
 
        self.disconnect()
892
 
        self._current_request = None
893
 
 
894
612
 
895
613
class SmartSimplePipesClientMedium(SmartClientStreamMedium):
896
614
    """A client medium using simple pipes.
897
 
 
 
615
    
898
616
    This client does not manage the pipes: it assumes they will always be open.
899
617
    """
900
618
 
905
623
 
906
624
    def _accept_bytes(self, bytes):
907
625
        """See SmartClientStreamMedium.accept_bytes."""
908
 
        try:
909
 
            self._writeable_pipe.write(bytes)
910
 
        except IOError, e:
911
 
            if e.errno in (errno.EINVAL, errno.EPIPE):
912
 
                raise errors.ConnectionReset(
913
 
                    "Error trying to write to subprocess", e)
914
 
            raise
915
 
        self._report_activity(len(bytes), 'write')
 
626
        self._writeable_pipe.write(bytes)
916
627
 
917
628
    def _flush(self):
918
629
        """See SmartClientStreamMedium._flush()."""
919
 
        # Note: If flush were to fail, we'd like to raise ConnectionReset, etc.
920
 
        #       However, testing shows that even when the child process is
921
 
        #       gone, this doesn't error.
922
630
        self._writeable_pipe.flush()
923
631
 
924
632
    def _read_bytes(self, count):
925
633
        """See SmartClientStreamMedium._read_bytes."""
926
 
        bytes_to_read = min(count, _MAX_READ_SIZE)
927
 
        bytes = self._readable_pipe.read(bytes_to_read)
928
 
        self._report_activity(len(bytes), 'read')
929
 
        return bytes
930
 
 
931
 
 
932
 
class SSHParams(object):
933
 
    """A set of parameters for starting a remote bzr via SSH."""
934
 
 
 
634
        return self._readable_pipe.read(count)
 
635
 
 
636
 
 
637
class SmartSSHClientMedium(SmartClientStreamMedium):
 
638
    """A client medium using SSH."""
 
639
    
935
640
    def __init__(self, host, port=None, username=None, password=None,
936
 
            bzr_remote_path='bzr'):
937
 
        self.host = host
938
 
        self.port = port
939
 
        self.username = username
940
 
        self.password = password
941
 
        self.bzr_remote_path = bzr_remote_path
942
 
 
943
 
 
944
 
class SmartSSHClientMedium(SmartClientStreamMedium):
945
 
    """A client medium using SSH.
946
 
 
947
 
    It delegates IO to a SmartSimplePipesClientMedium or
948
 
    SmartClientAlreadyConnectedSocketMedium (depending on platform).
949
 
    """
950
 
 
951
 
    def __init__(self, base, ssh_params, vendor=None):
 
641
            base=None, vendor=None, bzr_remote_path=None):
952
642
        """Creates a client that will connect on the first use.
953
 
 
954
 
        :param ssh_params: A SSHParams instance.
 
643
        
955
644
        :param vendor: An optional override for the ssh vendor to use. See
956
645
            bzrlib.transport.ssh for details on ssh vendors.
957
646
        """
958
 
        self._real_medium = None
959
 
        self._ssh_params = ssh_params
960
 
        # for the benefit of progress making a short description of this
961
 
        # transport
962
 
        self._scheme = 'bzr+ssh'
963
 
        # SmartClientStreamMedium stores the repr of this object in its
964
 
        # _DebugCounter so we have to store all the values used in our repr
965
 
        # method before calling the super init.
966
647
        SmartClientStreamMedium.__init__(self, base)
 
648
        self._connected = False
 
649
        self._host = host
 
650
        self._password = password
 
651
        self._port = port
 
652
        self._username = username
 
653
        self._read_from = None
 
654
        self._ssh_connection = None
967
655
        self._vendor = vendor
968
 
        self._ssh_connection = None
969
 
 
970
 
    def __repr__(self):
971
 
        if self._ssh_params.port is None:
972
 
            maybe_port = ''
973
 
        else:
974
 
            maybe_port = ':%s' % self._ssh_params.port
975
 
        if self._ssh_params.username is None:
976
 
            maybe_user = ''
977
 
        else:
978
 
            maybe_user = '%s@' % self._ssh_params.username
979
 
        return "%s(%s://%s%s%s/)" % (
980
 
            self.__class__.__name__,
981
 
            self._scheme,
982
 
            maybe_user,
983
 
            self._ssh_params.host,
984
 
            maybe_port)
 
656
        self._write_to = None
 
657
        self._bzr_remote_path = bzr_remote_path
 
658
        if self._bzr_remote_path is None:
 
659
            symbol_versioning.warn(
 
660
                'bzr_remote_path is required as of bzr 0.92',
 
661
                DeprecationWarning, stacklevel=2)
 
662
            self._bzr_remote_path = os.environ.get('BZR_REMOTE_PATH', 'bzr')
985
663
 
986
664
    def _accept_bytes(self, bytes):
987
665
        """See SmartClientStreamMedium.accept_bytes."""
988
666
        self._ensure_connection()
989
 
        self._real_medium.accept_bytes(bytes)
 
667
        self._write_to.write(bytes)
990
668
 
991
669
    def disconnect(self):
992
670
        """See SmartClientMedium.disconnect()."""
993
 
        if self._real_medium is not None:
994
 
            self._real_medium.disconnect()
995
 
            self._real_medium = None
996
 
        if self._ssh_connection is not None:
997
 
            self._ssh_connection.close()
998
 
            self._ssh_connection = None
 
671
        if not self._connected:
 
672
            return
 
673
        self._read_from.close()
 
674
        self._write_to.close()
 
675
        self._ssh_connection.close()
 
676
        self._connected = False
999
677
 
1000
678
    def _ensure_connection(self):
1001
679
        """Connect this medium if not already connected."""
1002
 
        if self._real_medium is not None:
 
680
        if self._connected:
1003
681
            return
1004
682
        if self._vendor is None:
1005
683
            vendor = ssh._get_ssh_vendor()
1006
684
        else:
1007
685
            vendor = self._vendor
1008
 
        self._ssh_connection = vendor.connect_ssh(self._ssh_params.username,
1009
 
                self._ssh_params.password, self._ssh_params.host,
1010
 
                self._ssh_params.port,
1011
 
                command=[self._ssh_params.bzr_remote_path, 'serve', '--inet',
 
686
        self._ssh_connection = vendor.connect_ssh(self._username,
 
687
                self._password, self._host, self._port,
 
688
                command=[self._bzr_remote_path, 'serve', '--inet',
1012
689
                         '--directory=/', '--allow-writes'])
1013
 
        io_kind, io_object = self._ssh_connection.get_sock_or_pipes()
1014
 
        if io_kind == 'socket':
1015
 
            self._real_medium = SmartClientAlreadyConnectedSocketMedium(
1016
 
                self.base, io_object)
1017
 
        elif io_kind == 'pipes':
1018
 
            read_from, write_to = io_object
1019
 
            self._real_medium = SmartSimplePipesClientMedium(
1020
 
                read_from, write_to, self.base)
1021
 
        else:
1022
 
            raise AssertionError(
1023
 
                "Unexpected io_kind %r from %r"
1024
 
                % (io_kind, self._ssh_connection))
1025
 
        for hook in transport.Transport.hooks["post_connect"]:
1026
 
            hook(self)
 
690
        self._read_from, self._write_to = \
 
691
            self._ssh_connection.get_filelike_channels()
 
692
        self._connected = True
1027
693
 
1028
694
    def _flush(self):
1029
695
        """See SmartClientStreamMedium._flush()."""
1030
 
        self._real_medium._flush()
 
696
        self._write_to.flush()
1031
697
 
1032
698
    def _read_bytes(self, count):
1033
699
        """See SmartClientStreamMedium.read_bytes."""
1034
 
        if self._real_medium is None:
 
700
        if not self._connected:
1035
701
            raise errors.MediumNotConnected(self)
1036
 
        return self._real_medium.read_bytes(count)
 
702
        bytes_to_read = min(count, _MAX_READ_SIZE)
 
703
        return self._read_from.read(bytes_to_read)
1037
704
 
1038
705
 
1039
706
# Port 4155 is the default port for bzr://, registered with IANA.
1040
 
BZR_DEFAULT_INTERFACE = None
 
707
BZR_DEFAULT_INTERFACE = '0.0.0.0'
1041
708
BZR_DEFAULT_PORT = 4155
1042
709
 
1043
710
 
1044
 
class SmartClientSocketMedium(SmartClientStreamMedium):
1045
 
    """A client medium using a socket.
1046
 
 
1047
 
    This class isn't usable directly.  Use one of its subclasses instead.
1048
 
    """
1049
 
 
1050
 
    def __init__(self, base):
 
711
class SmartTCPClientMedium(SmartClientStreamMedium):
 
712
    """A client medium using TCP."""
 
713
    
 
714
    def __init__(self, host, port, base):
 
715
        """Creates a client that will connect on the first use."""
1051
716
        SmartClientStreamMedium.__init__(self, base)
 
717
        self._connected = False
 
718
        self._host = host
 
719
        self._port = port
1052
720
        self._socket = None
1053
 
        self._connected = False
1054
721
 
1055
722
    def _accept_bytes(self, bytes):
1056
723
        """See SmartClientMedium.accept_bytes."""
1057
724
        self._ensure_connection()
1058
 
        osutils.send_all(self._socket, bytes, self._report_activity)
1059
 
 
1060
 
    def _ensure_connection(self):
1061
 
        """Connect this medium if not already connected."""
1062
 
        raise NotImplementedError(self._ensure_connection)
1063
 
 
1064
 
    def _flush(self):
1065
 
        """See SmartClientStreamMedium._flush().
1066
 
 
1067
 
        For sockets we do no flushing. For TCP sockets we may want to turn off
1068
 
        TCP_NODELAY and add a means to do a flush, but that can be done in the
1069
 
        future.
1070
 
        """
1071
 
 
1072
 
    def _read_bytes(self, count):
1073
 
        """See SmartClientMedium.read_bytes."""
1074
 
        if not self._connected:
1075
 
            raise errors.MediumNotConnected(self)
1076
 
        return osutils.read_bytes_from_socket(
1077
 
            self._socket, self._report_activity)
 
725
        osutils.send_all(self._socket, bytes)
1078
726
 
1079
727
    def disconnect(self):
1080
728
        """See SmartClientMedium.disconnect()."""
1084
732
        self._socket = None
1085
733
        self._connected = False
1086
734
 
1087
 
 
1088
 
class SmartTCPClientMedium(SmartClientSocketMedium):
1089
 
    """A client medium that creates a TCP connection."""
1090
 
 
1091
 
    def __init__(self, host, port, base):
1092
 
        """Creates a client that will connect on the first use."""
1093
 
        SmartClientSocketMedium.__init__(self, base)
1094
 
        self._host = host
1095
 
        self._port = port
1096
 
 
1097
735
    def _ensure_connection(self):
1098
736
        """Connect this medium if not already connected."""
1099
737
        if self._connected:
1100
738
            return
 
739
        self._socket = socket.socket()
 
740
        self._socket.setsockopt(socket.IPPROTO_TCP, socket.TCP_NODELAY, 1)
1101
741
        if self._port is None:
1102
742
            port = BZR_DEFAULT_PORT
1103
743
        else:
1104
744
            port = int(self._port)
1105
745
        try:
1106
 
            sockaddrs = socket.getaddrinfo(self._host, port, socket.AF_UNSPEC,
1107
 
                socket.SOCK_STREAM, 0, 0)
1108
 
        except socket.gaierror, (err_num, err_msg):
1109
 
            raise errors.ConnectionError("failed to lookup %s:%d: %s" %
1110
 
                    (self._host, port, err_msg))
1111
 
        # Initialize err in case there are no addresses returned:
1112
 
        err = socket.error("no address found for %s" % self._host)
1113
 
        for (family, socktype, proto, canonname, sockaddr) in sockaddrs:
1114
 
            try:
1115
 
                self._socket = socket.socket(family, socktype, proto)
1116
 
                self._socket.setsockopt(socket.IPPROTO_TCP,
1117
 
                                        socket.TCP_NODELAY, 1)
1118
 
                self._socket.connect(sockaddr)
1119
 
            except socket.error, err:
1120
 
                if self._socket is not None:
1121
 
                    self._socket.close()
1122
 
                self._socket = None
1123
 
                continue
1124
 
            break
1125
 
        if self._socket is None:
 
746
            self._socket.connect((self._host, port))
 
747
        except socket.error, err:
1126
748
            # socket errors either have a (string) or (errno, string) as their
1127
749
            # args.
1128
750
            if type(err.args) is str:
1132
754
            raise errors.ConnectionError("failed to connect to %s:%d: %s" %
1133
755
                    (self._host, port, err_msg))
1134
756
        self._connected = True
1135
 
        for hook in transport.Transport.hooks["post_connect"]:
1136
 
            hook(self)
1137
 
 
1138
 
 
1139
 
class SmartClientAlreadyConnectedSocketMedium(SmartClientSocketMedium):
1140
 
    """A client medium for an already connected socket.
1141
 
    
1142
 
    Note that this class will assume it "owns" the socket, so it will close it
1143
 
    when its disconnect method is called.
1144
 
    """
1145
 
 
1146
 
    def __init__(self, base, sock):
1147
 
        SmartClientSocketMedium.__init__(self, base)
1148
 
        self._socket = sock
1149
 
        self._connected = True
1150
 
 
1151
 
    def _ensure_connection(self):
1152
 
        # Already connected, by definition!  So nothing to do.
1153
 
        pass
 
757
 
 
758
    def _flush(self):
 
759
        """See SmartClientStreamMedium._flush().
 
760
        
 
761
        For TCP we do no flushing. We may want to turn off TCP_NODELAY and 
 
762
        add a means to do a flush, but that can be done in the future.
 
763
        """
 
764
 
 
765
    def _read_bytes(self, count):
 
766
        """See SmartClientMedium.read_bytes."""
 
767
        if not self._connected:
 
768
            raise errors.MediumNotConnected(self)
 
769
        # We ignore the desired_count because on sockets it's more efficient to
 
770
        # read large chunks (of _MAX_READ_SIZE bytes) at a time.
 
771
        return self._socket.recv(_MAX_READ_SIZE)
1154
772
 
1155
773
 
1156
774
class SmartClientStreamMediumRequest(SmartClientMediumRequest):
1169
787
 
1170
788
    def _accept_bytes(self, bytes):
1171
789
        """See SmartClientMediumRequest._accept_bytes.
1172
 
 
 
790
        
1173
791
        This forwards to self._medium._accept_bytes because we are operating
1174
792
        on the mediums stream.
1175
793
        """
1178
796
    def _finished_reading(self):
1179
797
        """See SmartClientMediumRequest._finished_reading.
1180
798
 
1181
 
        This clears the _current_request on self._medium to allow a new
 
799
        This clears the _current_request on self._medium to allow a new 
1182
800
        request to be created.
1183
801
        """
1184
802
        if self._medium._current_request is not self:
1185
803
            raise AssertionError()
1186
804
        self._medium._current_request = None
1187
 
 
 
805
        
1188
806
    def _finished_writing(self):
1189
807
        """See SmartClientMediumRequest._finished_writing.
1190
808
 
1191
809
        This invokes self._medium._flush to ensure all bytes are transmitted.
1192
810
        """
1193
811
        self._medium._flush()
 
812