Port details |
- zfsnap Simple sh script to make zfs rolling snaphosts with cron
- 1.11.1_1 filesystems
=0 Package not present on quarterly.This port was created during this quarter. It will be in the next quarterly branch but not the current one.
- Maintainer: yamagi@yamagi.org
- Port Added: 2024-11-07 19:52:55
- Last Update: 2024-11-06 15:17:35
- Commit Hash: 6e2da96
- Also Listed In: sysutils
- License: BSD3CLAUSE
- WWW:
- https://github.com/zfsnap/zfsnap
- Description:
- zfSnap is a simple sh script for creating ZFS snapshots. When called from
cron rolling snapshots can be created and deleted automatically. The main
advantage of zfSnap is that it is written in 100% pure /bin/sh, does not
require any additional software to run, and is simple to use.
zfSnap keeps all information about snapshot in snapshot name. zfs snapshot
names are in form: Timestamp--TTL where timestamp is date and time of
snapshot creation and TTL is Time To Live in human readable form.
- ¦ ¦ ¦ ¦
- Manual pages:
- FreshPorts has no man page information for this port.
- pkg-plist: as obtained via:
make generate-plist - Dependency lines:
-
- zfsnap>0:filesystems/zfsnap
- To install the port:
- cd /usr/ports/filesystems/zfsnap/ && make install clean
- To add the package, run one of these commands:
- pkg install filesystems/zfsnap
- pkg install zfsnap
NOTE: If this package has multiple flavors (see below), then use one of them instead of the name specified above.- PKGNAME: zfsnap
- Flavors: there is no flavor information for this port.
- distinfo:
- TIMESTAMP = 1730905205
SHA256 (zfsnap-zfsnap-v1.11.1_GH0.tar.gz) = dd533d5faff9fa98deeb9ae0909784b67b0dc43d3870f259eeb390fbc1d03bcf
SIZE (zfsnap-zfsnap-v1.11.1_GH0.tar.gz) = 4969
Packages (timestamps in pop-ups are UTC):
- This port has no dependencies.
- There are no ports dependent upon this port
Configuration Options:
- No options to configure
- Options name:
- filesystems_zfsnap
- pkg-message:
- For install:
- To run zfSnap periodically you can add these options to your
/etc/periodic.conf
xPERIODICx_zfsnap_enable - Enable xPERIODICx snapshots
(values: YES | NO)
xPERIODICx_zfsnap_fs - Space separated zfs filesystems
to create non-recursive snapshots
xPERIODICx_zfsnap_recursive_fs - Space separated zfs filesystems
to create recursive snapshots
xPERIODICx_zfsnap_ttl - Set Time To Live
xPERIODICx_zfsnap_verbose - Verbose output (values: YES | NO)
xPERIODICx_zfsnap_flags - zfSnap generic flags
(except -v and -d)
xPERIODICx_zfsnap_enable_prefix - Create snapshots with prefix
(Default = YES)
xPERIODICx_zfsnap_prefix - Set prefix to use for new snapshots
(Default = "xPERIODICx-")
(where xPERIODICx is any of hourly, daily, weekly, monthly, reboot)
xPERIODICx_zfsnap_delete_enable - Delete old snapshots periodically
(values: YES | NO)
xPERIODICx_zfsnap_delete_flags - zfSnap generic flags
(except -v and -d)
xPERIODICx_zfsnap_delete_verbose - Verbose output (values: YES | NO)
xPERIODICx_zfsnap_delete_prefixes - Space separated list of prefixes
of old zfSnap snapshots to delete
'hourly-', 'daily-', 'weekly-',
'monthly-' and 'reboot-' prefixes
are hard-coded
(where xPERIODICx is any of daily, weekly, monthly)
Add these lines to your /etc/crontab
4 * * * * root periodic hourly
@reboot root periodic reboot
NOTE: it is not recommended to delete zfSnap snapshots every hour.
Deleting zfs snapshots takes more time than creating them.
There for it's better to delete snapshots once per day...
Periodic scripts provide very limited feature set. If you want to use
more advanced setup, you need to call zfSnap from crontab directly.
This way you can combine all sort of parameter combinations.
Don't forget to check https://github.com/graudeejs/zfSnap/wiki for more
info.
Feedback welcomed: graudeejs@gmail.com
- Master Sites:
|