NAME

rbd-ggate - map rbd images via FreeBSD GEOM Gate

SYNOPSIS

rbd-ggate [--read-only] [--exclusive] [--device ggate device] map image-spec | snap-spec
rbd-ggate unmap ggate device
rbd-ggate list

DESCRIPTION

rbd-ggate is a client for RADOS block device (rbd) images. It will map a rbd image to a ggate (FreeBSD GEOM Gate class) device, allowing access it as regular local block device.

COMMANDS

map

Spawn a process responsible for the creation of ggate device and forwarding I/O requests between the GEOM Gate kernel subsystem and RADOS.

unmap

Destroy ggate device and terminate the process responsible for it.

list

List mapped ggate devices.

OPTIONS

--device *ggate device*: Specify ggate device path.

--read-only: Map read-only.

--exclusive: Forbid writes by other clients.

IMAGE AND SNAP SPECS

image-spec is [pool-name]/image-name
snap-spec  is [pool-name]/image-name@snap-name

The default for pool-name is "rbd". If an image name contains a slash character ('/'), pool-name is required.

AVAILABILITY

rbd-ggate is part of Ceph, a massively scalable, open-source, distributed storage system. Please refer to the Ceph documentation at http://ceph.com/docs for more information.

COPYRIGHT

2010-2014, Inktank Storage, Inc. and contributors. Licensed under Creative Commons Attribution Share Alike 3.0 (CC-BY-SA-3.0)