forked from extern/zfs-auto-snapshot
Change objects to datasets in help and comments.
In the usage synopsis and program comments, change "objects" to "datasets" for consistency with upstream ZFS terminology.
This commit is contained in:
parent
74359e51a7
commit
c8507a0da9
@ -51,7 +51,7 @@ SNAPSHOTS_OLD=''
|
|||||||
print_usage ()
|
print_usage ()
|
||||||
{
|
{
|
||||||
echo "Usage: $0 [options] [-l label] <'//' | name [name...]>
|
echo "Usage: $0 [options] [-l label] <'//' | name [name...]>
|
||||||
--default-exclude Exclude objects if com.sun:auto-snapshot is unset.
|
--default-exclude Exclude datasets if com.sun:auto-snapshot is unset.
|
||||||
-d, --debug Print debugging messages.
|
-d, --debug Print debugging messages.
|
||||||
-e, --event=EVENT Set the com.sun:auto-snapshot-desc property to EVENT.
|
-e, --event=EVENT Set the com.sun:auto-snapshot-desc property to EVENT.
|
||||||
-n, --dry-run Print actions without actually doing anything.
|
-n, --dry-run Print actions without actually doing anything.
|
||||||
@ -67,7 +67,7 @@ print_usage ()
|
|||||||
-g, --syslog Write messages into the system log.
|
-g, --syslog Write messages into the system log.
|
||||||
-r, --recursive Snapshot named filesystem and all descendants.
|
-r, --recursive Snapshot named filesystem and all descendants.
|
||||||
-v, --verbose Print info messages.
|
-v, --verbose Print info messages.
|
||||||
name Filesystem and volume names, or '//' for all ZFS objects.
|
name Filesystem and volume names, or '//' for all ZFS datasets.
|
||||||
"
|
"
|
||||||
}
|
}
|
||||||
|
|
||||||
@ -369,15 +369,15 @@ ZPOOLS_NOTREADY=$(echo "$ZFS_STATUS" | awk -F ': ' \
|
|||||||
$1 ~ /^ *state$/ && $2 !~ /ONLINE|DEGRADED/ { print pool } ' \
|
$1 ~ /^ *state$/ && $2 !~ /ONLINE|DEGRADED/ { print pool } ' \
|
||||||
| sort)
|
| sort)
|
||||||
|
|
||||||
# Get a list of objects for which snapshots are explicitly disabled.
|
# Get a list of datasets for which snapshots are explicitly disabled.
|
||||||
NOAUTO=$(echo "$ZFS_LIST" | awk -F '\t' \
|
NOAUTO=$(echo "$ZFS_LIST" | awk -F '\t' \
|
||||||
'tolower($2) ~ /false/ || tolower($3) ~ /false/ {print $1}')
|
'tolower($2) ~ /false/ || tolower($3) ~ /false/ {print $1}')
|
||||||
|
|
||||||
# If the --default-exclude flag is set, then exclude all objects that lack
|
# If the --default-exclude flag is set, then exclude all datasets that lack
|
||||||
# an explicit com.sun:auto-snapshot* property. Otherwise, include them.
|
# an explicit com.sun:auto-snapshot* property. Otherwise, include them.
|
||||||
if [ -n "$opt_default_exclude" ]
|
if [ -n "$opt_default_exclude" ]
|
||||||
then
|
then
|
||||||
# Get a list of objects for which snapshots are explicitly enabled.
|
# Get a list of datasets for which snapshots are explicitly enabled.
|
||||||
CANDIDATES=$(echo "$ZFS_LIST" | awk -F '\t' \
|
CANDIDATES=$(echo "$ZFS_LIST" | awk -F '\t' \
|
||||||
'tolower($2) ~ /true/ || tolower($3) ~ /true/ {print $1}')
|
'tolower($2) ~ /true/ || tolower($3) ~ /true/ {print $1}')
|
||||||
else
|
else
|
||||||
@ -386,20 +386,20 @@ else
|
|||||||
'tolower($2) !~ /false/ && tolower($3) !~ /false/ {print $1}')
|
'tolower($2) !~ /false/ && tolower($3) !~ /false/ {print $1}')
|
||||||
fi
|
fi
|
||||||
|
|
||||||
# Initialize the list of objects that will get a recursive snapshot.
|
# Initialize the list of datasets that will get a recursive snapshot.
|
||||||
TARGETS_RECURSIVE=''
|
TARGETS_RECURSIVE=''
|
||||||
|
|
||||||
# Initialize the list of objects that will get a non-recursive snapshot.
|
# Initialize the list of datasets that will get a non-recursive snapshot.
|
||||||
TARGETS_REGULAR=''
|
TARGETS_REGULAR=''
|
||||||
|
|
||||||
for ii in $CANDIDATES
|
for ii in $CANDIDATES
|
||||||
do
|
do
|
||||||
# Qualify object names so variable globbing works properly.
|
# Qualify dataset names so variable globbing works properly.
|
||||||
# Suppose ii=tanker/foo and jj=tank sometime during the loop.
|
# Suppose ii=tanker/foo and jj=tank sometime during the loop.
|
||||||
# Just testing "$ii" != ${ii#$jj} would incorrectly match.
|
# Just testing "$ii" != ${ii#$jj} would incorrectly match.
|
||||||
iii="$ii/"
|
iii="$ii/"
|
||||||
|
|
||||||
# Exclude objects that are not named on the command line.
|
# Exclude datasets that are not named on the command line.
|
||||||
IN_ARGS='0'
|
IN_ARGS='0'
|
||||||
for jj in "$@"
|
for jj in "$@"
|
||||||
do
|
do
|
||||||
@ -413,13 +413,13 @@ do
|
|||||||
continue
|
continue
|
||||||
fi
|
fi
|
||||||
|
|
||||||
# Exclude objects in pools that cannot do a snapshot.
|
# Exclude datasets in pools that cannot do a snapshot.
|
||||||
for jj in $ZPOOLS_NOTREADY
|
for jj in $ZPOOLS_NOTREADY
|
||||||
do
|
do
|
||||||
# Ibid regarding iii.
|
# Ibid regarding iii.
|
||||||
jjj="$jj/"
|
jjj="$jj/"
|
||||||
|
|
||||||
# Check whether the pool name is a prefix of the object name.
|
# Check whether the pool name is a prefix of the dataset name.
|
||||||
if [ "$iii" != "${iii#$jjj}" ]
|
if [ "$iii" != "${iii#$jjj}" ]
|
||||||
then
|
then
|
||||||
print_log info "Excluding $ii because pool $jj is not ready."
|
print_log info "Excluding $ii because pool $jj is not ready."
|
||||||
@ -427,13 +427,13 @@ do
|
|||||||
fi
|
fi
|
||||||
done
|
done
|
||||||
|
|
||||||
# Exclude objects in scrubbing pools if the --skip-scrub flag is set.
|
# Exclude datasets in scrubbing pools if the --skip-scrub flag is set.
|
||||||
test -n "$opt_skip_scrub" && for jj in $ZPOOLS_SCRUBBING
|
test -n "$opt_skip_scrub" && for jj in $ZPOOLS_SCRUBBING
|
||||||
do
|
do
|
||||||
# Ibid regarding iii.
|
# Ibid regarding iii.
|
||||||
jjj="$jj/"
|
jjj="$jj/"
|
||||||
|
|
||||||
# Check whether the pool name is a prefix of the object name.
|
# Check whether the pool name is a prefix of the dataset name.
|
||||||
if [ "$iii" != "${iii#$jjj}" ]
|
if [ "$iii" != "${iii#$jjj}" ]
|
||||||
then
|
then
|
||||||
print_log info "Excluding $ii because pool $jj is scrubbing."
|
print_log info "Excluding $ii because pool $jj is scrubbing."
|
||||||
@ -449,14 +449,14 @@ do
|
|||||||
# The --recusive switch only matters for non-wild arguments.
|
# The --recusive switch only matters for non-wild arguments.
|
||||||
if [ -z "$opt_recursive" -a "$1" != '//' ]
|
if [ -z "$opt_recursive" -a "$1" != '//' ]
|
||||||
then
|
then
|
||||||
# Snapshot this object non-recursively.
|
# Snapshot this dataset non-recursively.
|
||||||
print_log debug "Including $ii for regular snapshot."
|
print_log debug "Including $ii for regular snapshot."
|
||||||
TARGETS_REGULAR="${TARGETS_REGULAR:+$TARGETS_REGULAR }$ii" # nb: \t
|
TARGETS_REGULAR="${TARGETS_REGULAR:+$TARGETS_REGULAR }$ii" # nb: \t
|
||||||
continue 2
|
continue 2
|
||||||
# Check whether the candidate name is a prefix of any excluded object name.
|
# Check whether the candidate name is a prefix of any excluded dataset name.
|
||||||
elif [ "$jjj" != "${jjj#$iii}" ]
|
elif [ "$jjj" != "${jjj#$iii}" ]
|
||||||
then
|
then
|
||||||
# Snapshot this object non-recursively.
|
# Snapshot this dataset non-recursively.
|
||||||
print_log debug "Including $ii for regular snapshot."
|
print_log debug "Including $ii for regular snapshot."
|
||||||
TARGETS_REGULAR="${TARGETS_REGULAR:+$TARGETS_REGULAR }$ii" # nb: \t
|
TARGETS_REGULAR="${TARGETS_REGULAR:+$TARGETS_REGULAR }$ii" # nb: \t
|
||||||
continue 2
|
continue 2
|
||||||
@ -468,7 +468,7 @@ do
|
|||||||
# Ibid regarding iii.
|
# Ibid regarding iii.
|
||||||
jjj="$jj/"
|
jjj="$jj/"
|
||||||
|
|
||||||
# Check whether any included object is a prefix of the candidate name.
|
# Check whether any included dataset is a prefix of the candidate name.
|
||||||
if [ "$iii" != "${iii#$jjj}" ]
|
if [ "$iii" != "${iii#$jjj}" ]
|
||||||
then
|
then
|
||||||
print_log debug "Excluding $ii because $jj includes it recursively."
|
print_log debug "Excluding $ii because $jj includes it recursively."
|
||||||
|
Loading…
Reference in New Issue
Block a user