rbd-ggate – map rbd images via FreeBSD GEOM Gate

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 willmap a rbd image to a ggate (FreeBSD GEOM Gate class) device, allowingaccess it as regular local block device.

Commands

map

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

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 slashcharacter (‘/’), 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 athttp://ceph.com/docs for more information.

rbd-ggate