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:
Darik Horn 2011-12-18 07:31:48 -06:00
parent 74359e51a7
commit c8507a0da9

View File

@ -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."