43 lines
2.0 KiB
ReStructuredText
43 lines
2.0 KiB
ReStructuredText
================================
|
|
kernel data structure for DRBD-9
|
|
================================
|
|
|
|
This describes the in kernel data structure for DRBD-9. Starting with
|
|
Linux v3.14 we are reorganizing DRBD to use this data structure.
|
|
|
|
Basic Data Structure
|
|
====================
|
|
|
|
A node has a number of DRBD resources. Each such resource has a number of
|
|
devices (aka volumes) and connections to other nodes ("peer nodes"). Each DRBD
|
|
device is represented by a block device locally.
|
|
|
|
The DRBD objects are interconnected to form a matrix as depicted below; a
|
|
drbd_peer_device object sits at each intersection between a drbd_device and a
|
|
drbd_connection::
|
|
|
|
/--------------+---------------+.....+---------------\
|
|
| resource | device | | device |
|
|
+--------------+---------------+.....+---------------+
|
|
| connection | peer_device | | peer_device |
|
|
+--------------+---------------+.....+---------------+
|
|
: : : : :
|
|
: : : : :
|
|
+--------------+---------------+.....+---------------+
|
|
| connection | peer_device | | peer_device |
|
|
\--------------+---------------+.....+---------------/
|
|
|
|
In this table, horizontally, devices can be accessed from resources by their
|
|
volume number. Likewise, peer_devices can be accessed from connections by
|
|
their volume number. Objects in the vertical direction are connected by double
|
|
linked lists. There are back pointers from peer_devices to their connections a
|
|
devices, and from connections and devices to their resource.
|
|
|
|
All resources are in the drbd_resources double-linked list. In addition, all
|
|
devices can be accessed by their minor device number via the drbd_devices idr.
|
|
|
|
The drbd_resource, drbd_connection, and drbd_device objects are reference
|
|
counted. The peer_device objects only serve to establish the links between
|
|
devices and connections; their lifetime is determined by the lifetime of the
|
|
device and connection which they reference.
|