Back to main site | Back to man page index

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, kibibytes,  kilobytes,  ...  respec‐
              tively.   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 con‐
              venient 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

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 <[email protected]>
       Heinz Mauelshagen <[email protected]>



Red Hat, Inc.                                  Thin Provisioning Tools                          THIN_METADATA_SIZE(8)