mirror of
https://github.com/ceph/ceph
synced 2024-12-17 17:05:42 +00:00
107821fe9b
The header was displaying the newline as a simple "n" due to quoting in the doc. Signed-off-by: Christian Theune <ct@gocept.com>
70 lines
963 B
ReStructuredText
70 lines
963 B
ReStructuredText
RBD Incremental Backup
|
|
======================
|
|
|
|
This is a simple streaming file format for representing a diff between
|
|
two snapshots (or a snapshot and the head) of an RBD image.
|
|
|
|
Header
|
|
~~~~~~
|
|
|
|
"rbd diff v1\\n"
|
|
|
|
Metadata records
|
|
~~~~~~~~~~~~~~~~
|
|
|
|
Every record has a one byte "tag" that identifies the record type,
|
|
followed by some other data.
|
|
|
|
Metadata records come in the first part of the image. Order is not
|
|
important, as long as all the metadata records come before the data
|
|
records.
|
|
|
|
From snap
|
|
---------
|
|
|
|
- u8: 'f'
|
|
- le32: snap name length
|
|
- snap name
|
|
|
|
To snap
|
|
-------
|
|
|
|
- u8: 't'
|
|
- le32: snap name length
|
|
- snap name
|
|
|
|
Size
|
|
----
|
|
|
|
- u8: 's'
|
|
- u64: (ending) image size
|
|
|
|
Data Records
|
|
~~~~~~~~~~~~
|
|
|
|
These records come in the second part of the sequence.
|
|
|
|
Updated data
|
|
------------
|
|
|
|
- u8: 'w'
|
|
- le64: offset
|
|
- le64: length
|
|
- length bytes of actual data
|
|
|
|
Zero data
|
|
---------
|
|
|
|
- u8: 'z'
|
|
- le64: offset
|
|
- le64: length
|
|
|
|
|
|
Final Record
|
|
~~~~~~~~~~~~
|
|
|
|
End
|
|
---
|
|
|
|
- u8: 'e'
|