src/ceph/doc/dev/osd_internals/pgpool.rst

   1 ==================
   2 PGPool
   3 ==================
   4
   5 PGPool is a structure used to manage and update the status of removed
   6 snapshots.  It does this by maintaining two fields, cached_removed_snaps - the
   7 current removed snap set and newly_removed_snaps - newly removed snaps in the
   8 last epoch. In OSD::load_pgs the osd map is recovered from the pg's file store
   9 and passed down to OSD::_get_pool where a PGPool object is initialised with the
  10 map.
  11
  12 With each new map we receive we call PGPool::update with the new map. In that
  13 function we build a list of newly removed snaps
  14 (pg_pool_t::build_removed_snaps) and merge that with our cached_removed_snaps.
  15 This function included checks to make sure we only do this update when things
  16 have changed or there has been a map gap.
  17
  18 When we activate the pg we initialise the snap trim queue from
  19 cached_removed_snaps and subtract the purged_snaps we have already purged
  20 leaving us with the list of snaps that need to be trimmed. Trimming is later
  21 performed asynchronously by the snap_trim_wq.
  22