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,  kibibytes,  kilobytes,  ...
              respectively.   Default  is  in  sectors  without 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
              -b1mebibytes).

       -s, --pool-size POOLSIZE[bskKmMgGtTpPeEzZyY]
              Thin  provisioning  pool  size in units of bytes, sectors, kibibytes, kilobytes, ... 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, kibibytes, kilobytes, ... 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 kibibytes, pool size 1 tebibytes
       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 gibibyte, pool size 1 petabyte 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=1gibi   --pool-size=1petabytes  --max-thins=1mega  --unit=G  --numeric-
       only=short

       Or with unit specifier string appended:

       thin_metadata_size --block-size=1gibi --pool-size=1petabytes --max-thins=1mega --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)