1THIN_METADATA_SIZE(8)       System Manager's Manual      THIN_METADATA_SIZE(8)
2
3
4

NAME

6       thin_metadata_size - thin provisioning metadata device/file size calcu‐
7       lator.
8
9

SYNOPSIS

11       thin_metadata_size [options]
12
13

DESCRIPTION

15       thin_metadata_size calculates the size of the thin  provisioning  meta‐
16       data  based on the block size of the thin provisioned devices, the size
17       of the thin provisioning pool and the maximum number of all  thin  pri‐
18       sioned  devices  and  snapshots.   Because  thin provisioning pools are
19       holding widely variable contents, this tool is needed to provide sensi‐
20       ble initial default size.
21
22
23       -b, --block-size BLOCKSIZE[bskKmMgGtTpPeEzZyY]
24              Block  size  of thin provisioned devices in units of bytes, sec‐
25              tors, kibibytes, kilobytes, ...  respectively.   Default  is  in
26              sectors without a block size unit specifier.  Size/number option
27              arguments can be followed by unit specifiers in short one  char‐
28              acter and long form (eg. -b1m or -b1mebibytes).
29
30
31       -s, --pool-size POOLSIZE[bskKmMgGtTpPeEzZyY]
32              Thin   provisioning  pool  size  in  units  of  bytes,  sectors,
33              kibibytes, kilobytes, ... respectively.  Default is  in  sectors
34              without a pool size unit specifier.
35
36
37       -m, --max-thins #[bskKmMgGtTpPeEzZyY]
38              Maximum sum of all thin provisioned devices and snapshots.  Unit
39              identifier supported to allow  for  convenient  entry  of  large
40              quantities,  eg.  1000000  =  1M.   Default is absolute quantity
41              without a number unit specifier.
42
43
44       -u, --unit {bskKmMgGtTpPeEzZyY}
45              Output unit specifier in units  of  bytes,  sectors,  kibibytes,
46              kilobytes,  ...  respectively.  Default is in sectors without an
47              output unit specifier.
48
49
50       -n, --numeric-only [short|long]
51              Limit output to just the size  number  with  the  optional  unit
52              specifier character/string.
53
54
55       -h, --help
56              Print help and exit.
57
58
59       -V, --version
60              Output version information and exit.
61
62

EXAMPLES

64       Calculates the thin provisioning metadata device size for block size 64
65       kibibytes, pool size 1 tebibytes and maximum number of thin provisioned
66       devices and snapshots of 1000 in units of sectors with long output:
67
68       thin_metadata_size -b64k -s1t -m1000
69
70       Or  (using  the  long  options instead) for block size 1 gibibyte, pool
71       size 1 petabyte and maximum number  of  thin  provisioned  devices  and
72       snapshots of 1 million with numeric-only output in units of gigabytes:
73
74       thin_metadata_size    --block-size=1g   --pool-size=1P   --max-thins=1M
75       --unit=G --numeric-only
76
77       Same as before (1g, 1P, 1M, numeric-only) but with unit specifier char‐
78       acter appended:
79
80       thin_metadata_size   --block-size=1gibi  --pool-size=1petabytes  --max-
81       thins=1mega --unit=G --numeric-only=short
82
83       Or with unit specifier string appended:
84
85       thin_metadata_size  --block-size=1gibi  --pool-size=1petabytes   --max-
86       thins=1mega --unit=G -nlong
87
88

DIAGNOSTICS

90       thin_metadata_size  returns  an  exit  code  of  0 for success or 1 for
91       error.
92
93

SEE ALSO

95       thin_dump(8) thin_check(8) thin_repair(8) thin_restore(8) thin_rmap(8)
96
97

AUTHOR

99       Joe Thornber <ejt@redhat.com>
100       Heinz Mauelshagen <HeinzM@RedHat.com>
101
102
103
104Red Hat, Inc.               Thin Provisioning Tools      THIN_METADATA_SIZE(8)
Impressum