THIN_METADATA_SIZE(8)THIN_METADATA_SIZE(8)NAME
thin_metadata_size - thin provisioning metadata device/file size calcu‐
lator.
SYNOPSIS
thin_metadata_size [options]
DESCRIPTION
thin_metadata_size calculates the size of the thin provisioning meta‐
data based on the block size of the thin provisioned devices, the size
of the thin provisioning pool and the maximum number of all thin pri‐
sioned devices and snapshots. Because thin provisioning pools are
holding widely variable contents, this tool is needed to provide sensi‐
ble initial default size.
-b, --block-size BLOCKSIZE[bskKmMgGtTpPeEzZyY]
Block size of thin provisioned devices in units of bytes,sec‐
tors,kilobytes,kibibytes,... respectively. Default is in sec‐
tors without a block size unit specifier. Size/number option
arguments can be followed by unit specifiers in short one char‐
acter and long form (eg. -b1m or -b1megabytes).
-s, --pool-size POOLSIZE[bskKmMgGtTpPeEzZyY]
Thin provisioning pool size in units of bytes,sectors,kilo‐
bytes,kibibytes,... respectively. Default is in sectors without
a pool size unit specifier.
-m, --max-thins #[bskKmMgGtTpPeEzZyY]
Maximum sum of all thin provisioned devices and snapshots. Unit
identifier supported to allow for convenient entry of large
quantities, eg. 1000000 = 1M. Default is absolute quantity
without a number unit specifier.
-u, --unit {bskKmMgGtTpPeEzZyY}
Output unit specifier in units of bytes,sectors,kilo‐
bytes,kibibytes,... respectively. Default is in sectors without
an output unit specifier.
-n, --numeric-only [short|long]
Limit output to just the size number with the optional unit
specifier character/string.
-h, --help
Print help and exit.
-V, --version
Output version information and exit.
EXAMPLES
Calculates the thin provisioning metadata device size for block size 64
kilobytes, pool size 1 terabytes and maximum number of thin provisioned
devices and snapshots of 1000 in units of sectors with long output:
thin_metadata_size -b64k -s1t -m1000
Or (using the long options instead) for block size 1 gigabyte, pool
size 1 petabytes and maximum number of thin provisioned devices and
snapshots of 1 million with numeric only output in units of gigabytes:
thin_metadata_size --block-size=1g --pool-size=1p --max-thins=1M
--unit=g --numeric-only
Same as before (1g,1p,1M,numeric-only) but with unit specifier charac‐
ter appended:
thin_metadata_size --block-size=1giga --pool-size=1petabytes --max-
thins=1mebi --unit=g --numeric-only=short
Or with unit specifier string appended:
thin_metadata_size --block-size=1giga --pool-size=1petabytes --max-
thins=1mebi --unit=g -nlong
DIAGNOSTICS
thin_metadata_size returns an exit code of 0 for success or 1 for
error.
SEE ALSOthin_dump(8)thin_check(8)thin_repair(8)thin_restore(8)thin_rmap(8)AUTHOR
Joe Thornber <ejt@redhat.com>
Heinz Mauelshagen <HeinzM@RedHat.com>
Red Hat, Inc. Thin Provisioning Tools THIN_METADATA_SIZE(8)