data-structure-v9.rst 2.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142
  1. ================================
  2. kernel data structure for DRBD-9
  3. ================================
  4. This describes the in kernel data structure for DRBD-9. Starting with
  5. Linux v3.14 we are reorganizing DRBD to use this data structure.
  6. Basic Data Structure
  7. ====================
  8. A node has a number of DRBD resources. Each such resource has a number of
  9. devices (aka volumes) and connections to other nodes ("peer nodes"). Each DRBD
  10. device is represented by a block device locally.
  11. The DRBD objects are interconnected to form a matrix as depicted below; a
  12. drbd_peer_device object sits at each intersection between a drbd_device and a
  13. drbd_connection::
  14. /--------------+---------------+.....+---------------\
  15. | resource | device | | device |
  16. +--------------+---------------+.....+---------------+
  17. | connection | peer_device | | peer_device |
  18. +--------------+---------------+.....+---------------+
  19. : : : : :
  20. : : : : :
  21. +--------------+---------------+.....+---------------+
  22. | connection | peer_device | | peer_device |
  23. \--------------+---------------+.....+---------------/
  24. In this table, horizontally, devices can be accessed from resources by their
  25. volume number. Likewise, peer_devices can be accessed from connections by
  26. their volume number. Objects in the vertical direction are connected by double
  27. linked lists. There are back pointers from peer_devices to their connections a
  28. devices, and from connections and devices to their resource.
  29. All resources are in the drbd_resources double-linked list. In addition, all
  30. devices can be accessed by their minor device number via the drbd_devices idr.
  31. The drbd_resource, drbd_connection, and drbd_device objects are reference
  32. counted. The peer_device objects only serve to establish the links between
  33. devices and connections; their lifetime is determined by the lifetime of the
  34. device and connection which they reference.