Source code for oio.blob.utils

# Copyright (C) 2015-2020 OpenIO SAS, as part of OpenIO SDS
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU Affero General Public License as
# published by the Free Software Foundation, either version 3 of the
# License, or (at your option) any later version.
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# GNU Affero General Public License for more details.
# You should have received a copy of the GNU Affero General Public License
# along with this program.  If not, see <>.

from six import iteritems
from oio.common import exceptions as exc
from oio.common.xattr import read_user_xattr
from oio.common.constants import chunk_xattr_keys, chunk_xattr_keys_optional, \
from oio.common.fullpath import decode_fullpath
from oio.common.utils import cid_from_name

[docs]def check_volume(volume_path): """ Check if `volume_path` points to a rawx directory. :returns: the namespace name and the service ID :raises oio.common.exceptions.OioException: when the specified path does not belong to a rawx service or misses some attributes. """ return check_volume_for_service_type(volume_path, "rawx")
[docs]def check_volume_for_service_type(volume_path, required_type): """ Check if `volume_path` points to a directory for the specified service type. :returns: the namespace name and the service ID :raises oio.common.exceptions.OioException: when the specified path does not belong to a service from the specified type or is missing some attributes. """ msg_pfx = 'Invalid volume path [%s]: ' % volume_path meta = read_user_xattr(volume_path) server_type = meta.get(volume_xattr_keys['type']) if server_type is None: raise exc.OioException(msg_pfx + 'missing %s xattr' % volume_xattr_keys['type']) if server_type != required_type: raise exc.OioException( msg_pfx + 'service is a {0}, not a {1}'.format(server_type, required_type)) namespace = meta.get(volume_xattr_keys['namespace']) server_id = meta.get(volume_xattr_keys['id']) if server_id is None: raise exc.OioException(msg_pfx + 'missing %s xattr' % volume_xattr_keys['id']) elif namespace is None: raise exc.OioException(msg_pfx + 'missing %s xattr' % volume_xattr_keys['namespace']) return namespace, server_id
[docs]def read_chunk_metadata(fd, chunk_id, for_conversion=False): chunk_id = chunk_id.upper() raw_meta = read_user_xattr(fd) raw_meta_copy = None meta = {} meta['links'] = dict() attr_vers = 0.0 raw_chunk_id = container_id = path = version = content_id = None missing = list() for k, v in raw_meta.items(): # New chunks have a version if k == chunk_xattr_keys['oio_version']: attr_vers = float(v) # Chunks with version >= 4.2 have a "full_path" elif k.startswith(CHUNK_XATTR_CONTENT_FULLPATH_PREFIX): parsed_chunk_id = k[len(CHUNK_XATTR_CONTENT_FULLPATH_PREFIX):] if parsed_chunk_id == chunk_id: raw_chunk_id = parsed_chunk_id meta['full_path'] = v account, container, path, version, content_id = \ decode_fullpath(v) container_id = cid_from_name(account, container) else: meta['links'][parsed_chunk_id] = v if raw_chunk_id: raw_meta_copy = raw_meta.copy() raw_meta[chunk_xattr_keys['chunk_id']] = raw_chunk_id raw_meta[chunk_xattr_keys['container_id']] = container_id raw_meta[chunk_xattr_keys['content_path']] = path raw_meta[chunk_xattr_keys['content_version']] = version raw_meta[chunk_xattr_keys['content_id']] = content_id if attr_vers >= 4.2 and 'full_path' not in meta: # TODO(FVE): in that case, do not warn about other attributes # that could be deduced from this one. missing.append(exc.MissingAttribute( CHUNK_XATTR_CONTENT_FULLPATH_PREFIX + chunk_id)) for k, v in iteritems(chunk_xattr_keys): if v not in raw_meta: if k not in chunk_xattr_keys_optional: missing.append(exc.MissingAttribute(v)) else: meta[k] = raw_meta[v] if missing: raise exc.FaultyChunk(*missing) if not for_conversion and meta['chunk_id'] != chunk_id: raise exc.MissingAttribute(chunk_xattr_keys['chunk_id']) return meta, raw_meta_copy if raw_meta_copy else raw_meta