mirror of https://github.com/ceph/ceph
95 lines
2.1 KiB
ReStructuredText
95 lines
2.1 KiB
ReStructuredText
==============
|
|
Librados (C)
|
|
==============
|
|
|
|
.. highlight:: c
|
|
|
|
`Librados` provides low-level access to the RADOS service. For an
|
|
overview of RADOS, see :doc:`/architecture`.
|
|
|
|
|
|
Example: connecting and writing an object
|
|
=========================================
|
|
|
|
To use `Librados`, you instantiate a :c:type:`rados_t` variable and
|
|
call :c:func:`rados_create()` with a pointer to it::
|
|
|
|
int err;
|
|
rados_t cluster;
|
|
|
|
err = rados_create(&cluster, NULL);
|
|
if (err < 0) {
|
|
fprintf(stderr, "%s: cannot open a rados connection: %s\n", argv[0], strerror(-err));
|
|
exit(1);
|
|
}
|
|
|
|
Then you open an "IO context", a :c:type:`rados_ioctx_t`, with :c:func:`rados_ioctx_create()`::
|
|
|
|
rados_ioctx_t io;
|
|
char *poolname = "mypool";
|
|
|
|
err = rados_ioctx_create(cluster, poolname, &io);
|
|
if (err < 0) {
|
|
fprintf(stderr, "%s: cannot open rados pool %s: %s\n", argv[0], poolname, strerror(-err));
|
|
rados_shutdown(cluster);
|
|
exit(1);
|
|
}
|
|
|
|
Note that the pool you try to access must exist.
|
|
|
|
Then you can use the RADOS data manipulation functions, for example
|
|
write into an object called ``greeting`` with
|
|
:c:func:`rados_write_full()`::
|
|
|
|
err = rados_write_full(io, "greeting", "hello", 5);
|
|
if (err < 0) {
|
|
fprintf(stderr, "%s: cannot write pool %s: %s\n", argv[0], poolname, strerror(-err));
|
|
rados_ioctx_destroy(io);
|
|
rados_shutdown(cluster);
|
|
exit(1);
|
|
}
|
|
|
|
In the end, you'll want to close your IO context and connection to RADOS with :c:func:`rados_ioctx_destroy()` and :c:func:`rados_shutdown()`::
|
|
|
|
rados_ioctx_destroy(io);
|
|
rados_shutdown(cluster);
|
|
|
|
|
|
|
|
|
|
|
|
API calls
|
|
=========
|
|
|
|
.. todo:: this document mentions individual entries, and not all of
|
|
librados.h, because processing the whole file in takes 2
|
|
minutes
|
|
|
|
.. .. doxygenfile:: rados/librados.h
|
|
|
|
|
|
Cluster operations
|
|
------------------
|
|
|
|
.. doxygentypedef:: rados_t
|
|
|
|
.. doxygenfunction:: rados_create
|
|
|
|
.. doxygenfunction:: rados_shutdown
|
|
|
|
|
|
IO Context
|
|
----------
|
|
|
|
.. doxygentypedef:: rados_ioctx_t
|
|
|
|
.. doxygenfunction:: rados_ioctx_create
|
|
|
|
.. doxygenfunction:: rados_ioctx_destroy
|
|
|
|
|
|
Operations on objects
|
|
---------------------
|
|
|
|
.. doxygenfunction:: rados_write_full
|