THIN_METADATA_SIZE(8)					      System Manager's Manual					     THIN_METADATA_SIZE(8)

NAME

       thin_metadata_size - thin provisioning metadata device/file size calculator.

SYNOPSIS

       thin_metadata_size [options]

DESCRIPTION

       thin_metadata_size  calculates the size of the thin provisioning metadata based on the block size of the thin provisioned devices, the size
       of the thin provisioning pool and the maximum number of all thin prisioned devices and snapshots.   Because  thin  provisioning	pools  are
       holding widely variable contents, this tool is needed to provide sensible initial default size.

       -b, --block-size BLOCKSIZE[bskKmMgGtTpPeEzZyY]
	      Block  size of thin provisioned devices in units of bytes,sectors,kilobytes,kibibytes,... respectively.  Default is in sectors with-
	      out a block size unit specifier.	Size/number option arguments can be followed by unit specifiers in short one  character  and  long
	      form (eg. -b1m or -b1megabytes).

       -s, --pool-size POOLSIZE[bskKmMgGtTpPeEzZyY]
	      Thin  provisioning  pool	size in units of bytes,sectors,kilobytes,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 quanti-
	      ties, eg. 1000000 = 1M.  Default is absolute quantity without a number unit specifier.

       -u, --unit {bskKmMgGtTpPeEzZyY}
	      Output  unit specifier in units of bytes,sectors,kilobytes,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  provi-
       sioned 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 character 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 ALSO

       thin_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)