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.