2018-11-12 18:24:21 +00:00
|
|
|
ZFS-PRUNE-SNAPSHOTS 1 "NOV 2018" "User Commands"
|
|
|
|
|
================================================
|
|
|
|
|
|
|
|
|
|
NAME
|
|
|
|
|
----
|
|
|
|
|
|
|
|
|
|
`zfs-prune-snapshots` - Remove snapshots from one or more zpools that match
|
|
|
|
|
given criteria
|
|
|
|
|
|
|
|
|
|
SYNOPSIS
|
|
|
|
|
--------
|
|
|
|
|
|
|
|
|
|
`zfs-prune-snapshots [OPTIONS] <time> [[DATASET1] ...]`
|
|
|
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
|
-----------
|
|
|
|
|
|
|
|
|
|
Remove snapshots from one or more zpools that match a criteria given over the
|
|
|
|
|
command line.
|
|
|
|
|
|
|
|
|
|
OPTIONS
|
|
|
|
|
-------
|
|
|
|
|
|
|
|
|
|
`-h`
|
|
|
|
|
print this message and exit
|
|
|
|
|
|
|
|
|
|
`-n`
|
|
|
|
|
dry-run, don't actually delete snapshots
|
|
|
|
|
|
2021-12-01 04:05:41 +00:00
|
|
|
`-l`
|
|
|
|
|
list only mode, just list matching snapshots names without deleting (like
|
|
|
|
|
dry-run mode with machine-parseable output)
|
|
|
|
|
|
2018-11-12 18:24:21 +00:00
|
|
|
`-p <prefix>`
|
|
|
|
|
snapshot prefix string to match
|
|
|
|
|
|
2019-12-16 16:19:53 +00:00
|
|
|
`-s <suffix>`
|
|
|
|
|
snapshot suffix string to match
|
|
|
|
|
|
2021-11-27 23:53:51 +00:00
|
|
|
`-i`
|
|
|
|
|
invert matching of prefix and suffix
|
|
|
|
|
|
2018-11-12 18:24:21 +00:00
|
|
|
`-q`
|
|
|
|
|
quiet, do not printout removed snapshots
|
|
|
|
|
|
2021-11-28 00:17:32 +00:00
|
|
|
`-R`
|
|
|
|
|
recursively delete, pass '-R' directly to 'zfs destroy'
|
|
|
|
|
|
2018-11-12 18:24:21 +00:00
|
|
|
`-v`
|
|
|
|
|
increase verbosity
|
|
|
|
|
|
|
|
|
|
`-V`
|
|
|
|
|
print the version number and exit
|
|
|
|
|
|
|
|
|
|
`TIMESPEC`
|
|
|
|
|
|
|
|
|
|
The first argument denotes how old a snapshot must be for it to be considered
|
|
|
|
|
for deletion - possible specifiers are
|
|
|
|
|
|
|
|
|
|
`s` seconds
|
|
|
|
|
|
|
|
|
|
`m` minutes
|
|
|
|
|
|
|
|
|
|
`h` hours
|
|
|
|
|
|
|
|
|
|
`d` days
|
|
|
|
|
|
|
|
|
|
`w` weeks
|
|
|
|
|
|
|
|
|
|
`M` months
|
|
|
|
|
|
|
|
|
|
`y` years
|
|
|
|
|
|
|
|
|
|
EXAMPLES
|
|
|
|
|
--------
|
|
|
|
|
|
|
|
|
|
`zfs-prune-snapshots 1w`
|
|
|
|
|
Remove snapshots older than a week across all zpools
|
|
|
|
|
|
|
|
|
|
`zfs-prune-snapshots -vn 1w`
|
|
|
|
|
Same as above, but with increased verbosity and without actually deleting any
|
|
|
|
|
snapshots (dry-run)
|
|
|
|
|
|
|
|
|
|
`zfs-prune-snapshots 3w tank1 tank2/backup`
|
|
|
|
|
Remove snapshots older than 3 weeks on tank1 and tank2/backup. Note that this
|
|
|
|
|
script will recurse through *all* of tank1 and *all* datasets below
|
|
|
|
|
tank2/backup
|
|
|
|
|
|
|
|
|
|
`zfs-prune-snapshots -p 'autosnap_' 1M zones`
|
|
|
|
|
Remove snapshots older than a month on the zones pool that start with the
|
|
|
|
|
string `"autosnap_"`
|
|
|
|
|
|
2019-12-16 16:19:53 +00:00
|
|
|
`zfs-prune-snapshots -s '_frequent' 2M tank`
|
|
|
|
|
Remove snapshots older than two months on the tank pool that end with the
|
|
|
|
|
string `"_frequent"`
|
|
|
|
|
|
2021-11-27 23:53:51 +00:00
|
|
|
`zfs-prune-snapshots -i -p 'autosnap_' 1M zones`
|
|
|
|
|
Remove snapshots older than a month on the zones pool that do not start
|
|
|
|
|
with the string `"autosnap_"`
|
|
|
|
|
|
2018-11-12 18:24:21 +00:00
|
|
|
BUGS
|
|
|
|
|
----
|
|
|
|
|
|
|
|
|
|
https://github.com/bahamas10/zfs-prune-snapshots
|
|
|
|
|
|
|
|
|
|
AUTHOR
|
|
|
|
|
------
|
|
|
|
|
|
|
|
|
|
`Dave Eddy <bahamas10> <dave@daveeddy.com> (https://www.daveeddy.com)`
|
|
|
|
|
|
|
|
|
|
SEE ALSO
|
|
|
|
|
--------
|
|
|
|
|
|
|
|
|
|
zpool(1M), zfs(1M)
|
|
|
|
|
|
|
|
|
|
LICENSE
|
|
|
|
|
-------
|
|
|
|
|
|
|
|
|
|
MIT License
|
