Crate librados 

librados

Idiomatic bindings (both sync and runtime-agnostic async) for Ceph’s librados.

Linking

This library automatically dynamically links to an in-tree copy of the librados.so.2.0.0 dynamic library, as included in Ceph reef (ceph version 18.2.7 (6b0e988052ec84cf2d4a54ff9bbbc5e720b621ad) reef (stable)).

This means that the computer you run your final binary program on must have a compatible version of librados installed, and findable in the link path. The default installation of Ceph does this for you automatically.

The librados library is licensed under LGPLv2.1 (see LICENSE-LGPL2.1), which places requirements on software compiled using this library.

Usage

For usage examples, start at the Rados struct, or the examples.

License

This project is licensed under the MIT license. See LICENSE for the full license text.

Notice

The copy of librados.so.2.0.0 included in this source tree is licensed under the LGPLv2.1 license (see LICENSE-LGPL2.1).

This project dynamically links against librados, licensed under the LGPLv2.1 license (see LICENSE-LGPL2.1), which places requirements on software compiled using this library.

Structs

ByteCount

An amount of bytes, with a core::fmt::Display implementation that attempts to render the amount of B/KiB/MiB/GiB/TiB nicely.

ClusterStats

Cluster statistics.

Cursor

An object cursor.

ExtendedAttributes

An iterator over the extended attributes of a file.

IoCtx

A rados input-output context. These are created using Rados::create_ioctx.

ObjectsIterator

An iterator yielding objects in a pool.

OmapKeyValues

An iterator over Omap key value pairs.

OwnedObject

An owned ListObject.

PoolStats

Statistics about a pool.

Rados

A connection to a rados cluster.

RadosConfig

Configuration to be used when connecting to a Rados cluster.

RawObject

Raw objects (that are freed by librados).

RefObject

An object reference.

Stat

The basic statistics of an object.

Enums

FileConfig

File configurations that can be applied when connecting to a Rados cluster.

Namespace

A namespace within the pool.

RadosError

A rados error.

Traits

ListObject

A trait describing the information available on a rados objects obtained from a list.

Type Aliases

Result

A generic result type, containing a value T or a RadosError.