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
26
register_transport,
27
class ChrootServer(pathfilter.PathFilteringServer):
31
from bzrlib.transport.decorator import TransportDecorator, DecoratorServer
32
from bzrlib.transport.memory import MemoryTransport
35
class ChrootServer(Server):
28
36
"""User space 'chroot' facility.
30
38
The server's get_url returns the url for a chroot transport mapped to the
31
39
backing transport. The url is of the form chroot-xxx:/// so parent
32
40
directories of the backing transport are not visible. The chroot url will
33
41
not allow '..' sequences to result in requests to the chroot affecting
34
42
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
45
def __init__(self, backing_transport):
42
pathfilter.PathFilteringServer.__init__(self, backing_transport, None)
46
self.backing_transport = backing_transport
44
48
def _factory(self, url):
49
assert url.startswith(self.scheme)
45
50
return ChrootTransport(self, url)
47
def start_server(self):
48
56
self.scheme = 'chroot-%d:///' % id(self)
49
57
register_transport(self.scheme, self._factory)
52
class ChrootTransport(pathfilter.PathFilteringTransport):
60
unregister_transport(self.scheme, self._factory)
63
class ChrootTransport(Transport):
53
64
"""A ChrootTransport.
55
66
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)
69
def __init__(self, server, base):
71
if not base.endswith('/'):
73
Transport.__init__(self, base)
74
self.base_path = self.base[len(self.server.scheme)-1:]
75
self.scheme = self.server.scheme
77
def _call(self, methodname, relpath, *args):
78
method = getattr(self.server.backing_transport, methodname)
79
return method(self._safe_relpath(relpath), *args)
81
def _safe_relpath(self, relpath):
82
safe_relpath = self._combine_paths(self.base_path, relpath)
83
assert safe_relpath.startswith('/')
84
return safe_relpath[1:]
87
def abspath(self, relpath):
88
return self.scheme + self._safe_relpath(relpath)
90
def append_file(self, relpath, f, mode=None):
91
return self._call('append_file', relpath, f, mode)
93
def clone(self, relpath):
94
return ChrootTransport(self.server, self.abspath(relpath))
96
def delete(self, relpath):
97
return self._call('delete', relpath)
99
def delete_tree(self, relpath):
100
return self._call('delete_tree', relpath)
102
def get(self, relpath):
103
return self._call('get', relpath)
105
def has(self, relpath):
106
return self._call('has', relpath)
108
def iter_files_recursive(self):
109
backing_transport = self.server.backing_transport.clone(
110
self._safe_relpath('.'))
111
return backing_transport.iter_files_recursive()
114
return self.server.backing_transport.listable()
116
def list_dir(self, relpath):
117
return self._call('list_dir', relpath)
119
def lock_read(self, relpath):
120
return self._call('lock_read', relpath)
122
def lock_write(self, relpath):
123
return self._call('lock_write', relpath)
125
def mkdir(self, relpath, mode=None):
126
return self._call('mkdir', relpath, mode)
128
def put_file(self, relpath, f, mode=None):
129
return self._call('put_file', relpath, f, mode)
131
def rename(self, rel_from, rel_to):
132
return self._call('rename', rel_from, self._safe_relpath(rel_to))
134
def rmdir(self, relpath):
135
return self._call('rmdir', relpath)
137
def stat(self, relpath):
138
return self._call('stat', relpath)
141
class TestingChrootServer(ChrootServer):
144
"""TestingChrootServer is not usable until setUp is called."""
146
def setUp(self, backing_server=None):
147
"""Setup the Chroot on backing_server."""
148
if backing_server is not None:
149
self.backing_transport = get_transport(backing_server.get_url())
151
self.backing_transport = get_transport('.')
152
ChrootServer.setUp(self)
64
155
def get_test_permutations():
65
156
"""Return the permutations to be used in testing."""
66
from bzrlib.tests import test_server
67
return [(ChrootTransport, test_server.TestingChrootServer)]
157
return [(ChrootTransport, TestingChrootServer),