SNAPM(5)

πŸ“¦ version 0.7.0, in centos-stream 10, centos-stream 9, fedora 43, fedora 44

🌸 SNAPM(5) β€” FILE FORMATS MANUAL 🌸

okay bestie, welcome to the snapm file formats manual, section 5, and honestly? this one's a whole vibe. it's all about plugind.d β€” the boom configuration files πŸ’…


✨ NAME ✨

plugind.d β€” boom configuration files πŸŽ€


πŸ¦‹ SYNOPSIS πŸ¦‹

/etc/snapm/plugins.d/*.conf

πŸ’– DESCRIPTION πŸ’–

so here's the tea: the files chillin' in /etc/snapm/plugins.d get loaded during the initialisation of snapm, and they hand over configuration options that change how plugins behave. that's it, that's the job 🫢

the files are structured in INI format β€” section headers show up in square brackets, and configuration values show up as key-value pairs, with one pair per line. iconic, classic, no notes ✨


πŸ‘‘ SECTIONS πŸ‘‘

🌈 Limits

the Limits section may contain the MaxSnapshotsPerOrigin and MaxSnapshotsPerOriginPool keys, and they place limits on the maximum number of snapshots per origin device and thin pool respectively. literally capping the chaos πŸ’€

plugins may opt-in to applying these options depending on the specific snapshot back end. for example, lvm2-cow implements the MaxSnapshotsPerOrigin key, since excessive per-origin snapshots using the device-mapper dm-snapshot target leads to read and write IO performance degradation 😭 (not the IO glow-down, we can't). the lvm2-thin and stratis plugins on th other hand respect the MaxSnapshotsPerPool key, since they share the same underlying dm-thin implementation. twins fr fr 🫢

the values in both cases are a single non-negative integer specifying the maximum allowed number of snapshots across all snapshot sets and unmanaged snapshots. a number, bestie, that's the whole vibe ⭐

πŸ’œ Priority

the Priority section may contain the PluginPriority key. setting this key to an integer value greater than zero will override the default priority value for the corresponding plugin πŸ‘‘

this can be used, for example, to prefer lvm2-cow snapshots over lvm2-thin even when the latter are available and could be used to snapshot a given source. main character energy for lvm2-cow, periodt πŸ’…


πŸŽ€ AUTHORS πŸŽ€

Bryn M. Reeves <bmr@redhat.com> β€” shoutout to the icon who wrote this πŸ‘‘


πŸ”₯ SEE ALSO πŸ”₯


and that's the whole page, bestie πŸ¦‹ this one's from Linux, dated Jun 16 2025, and it lives at SNAPM(5) β€” go forth and configure your plugins, you absolute legend πŸ’–βœ¨

πŸ“¦ where this page comes from