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
17
17
"""Implementation of Transport that prevents access to locations above a set
20
from urlparse import urlparse
22
from bzrlib import errors, urlutils
21
23
from bzrlib.transport import (
23
25
register_transport,
27
class ChrootServer(pathfilter.PathFilteringServer):
30
from bzrlib.transport.decorator import TransportDecorator, DecoratorServer
31
from bzrlib.transport.memory import MemoryTransport
34
class ChrootServer(Server):
28
35
"""User space 'chroot' facility.
30
37
The server's get_url returns the url for a chroot transport mapped to the
31
38
backing transport. The url is of the form chroot-xxx:/// so parent
32
39
directories of the backing transport are not visible. The chroot url will
33
40
not allow '..' sequences to result in requests to the chroot affecting
34
41
directories outside the backing transport.
36
PathFilteringServer does all the path sanitation needed to enforce a
37
chroot, so this is a simple subclass of PathFilteringServer that ignores
41
44
def __init__(self, backing_transport):
42
pathfilter.PathFilteringServer.__init__(self, backing_transport, None)
45
self.backing_transport = backing_transport
44
47
def _factory(self, url):
48
assert url.startswith(self.scheme)
45
49
return ChrootTransport(self, url)
47
def start_server(self):
48
55
self.scheme = 'chroot-%d:///' % id(self)
49
56
register_transport(self.scheme, self._factory)
52
class ChrootTransport(pathfilter.PathFilteringTransport):
59
unregister_transport(self.scheme, self._factory)
62
class ChrootTransport(Transport):
53
63
"""A ChrootTransport.
55
65
Please see ChrootServer for details.
58
def _filter(self, relpath):
59
# A simplified version of PathFilteringTransport's _filter that omits
60
# the call to self.server.filter_func.
61
return self._relpath_from_server_root(relpath)
68
def __init__(self, server, base):
70
if not base.endswith('/'):
72
Transport.__init__(self, base)
73
self.base_path = self.base[len(self.server.scheme)-1:]
74
self.scheme = self.server.scheme
76
def _call(self, methodname, relpath, *args):
77
method = getattr(self.server.backing_transport, methodname)
78
return method(self._safe_relpath(relpath), *args)
80
def _safe_relpath(self, relpath):
81
safe_relpath = self._combine_paths(self.base_path, relpath)
82
assert safe_relpath.startswith('/')
83
return safe_relpath[1:]
86
def abspath(self, relpath):
87
return self.scheme + self._safe_relpath(relpath)
89
def append_file(self, relpath, f, mode=None):
90
return self._call('append_file', relpath, f, mode)
92
def _can_roundtrip_unix_modebits(self):
93
return self.server.backing_transport._can_roundtrip_unix_modebits()
95
def clone(self, relpath):
96
return ChrootTransport(self.server, self.abspath(relpath))
98
def delete(self, relpath):
99
return self._call('delete', relpath)
101
def delete_tree(self, relpath):
102
return self._call('delete_tree', relpath)
104
def external_url(self):
105
"""See bzrlib.transport.Transport.external_url."""
106
# Chroots, like MemoryTransport depend on in-process
107
# state and thus the base cannot simply be handed out.
108
# See the base class docstring for more details and
109
# possible directions. For now we return the chrooted
111
return self.server.backing_transport.external_url()
113
def get(self, relpath):
114
return self._call('get', relpath)
116
def has(self, relpath):
117
return self._call('has', relpath)
119
def iter_files_recursive(self):
120
backing_transport = self.server.backing_transport.clone(
121
self._safe_relpath('.'))
122
return backing_transport.iter_files_recursive()
125
return self.server.backing_transport.listable()
127
def list_dir(self, relpath):
128
return self._call('list_dir', relpath)
130
def lock_read(self, relpath):
131
return self._call('lock_read', relpath)
133
def lock_write(self, relpath):
134
return self._call('lock_write', relpath)
136
def mkdir(self, relpath, mode=None):
137
return self._call('mkdir', relpath, mode)
139
def open_write_stream(self, relpath, mode=None):
140
return self._call('open_write_stream', relpath, mode)
142
def put_file(self, relpath, f, mode=None):
143
return self._call('put_file', relpath, f, mode)
145
def rename(self, rel_from, rel_to):
146
return self._call('rename', rel_from, self._safe_relpath(rel_to))
148
def rmdir(self, relpath):
149
return self._call('rmdir', relpath)
151
def stat(self, relpath):
152
return self._call('stat', relpath)
155
class TestingChrootServer(ChrootServer):
158
"""TestingChrootServer is not usable until setUp is called."""
160
def setUp(self, backing_server=None):
161
"""Setup the Chroot on backing_server."""
162
if backing_server is not None:
163
self.backing_transport = get_transport(backing_server.get_url())
165
self.backing_transport = get_transport('.')
166
ChrootServer.setUp(self)
64
169
def get_test_permutations():
65
170
"""Return the permutations to be used in testing."""
66
from bzrlib.tests import test_server
67
return [(ChrootTransport, test_server.TestingChrootServer)]
171
return [(ChrootTransport, TestingChrootServer),