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

SYNOPSIS

10       thin_metadata_size [options]
11
12

DESCRIPTION

14       thin_metadata_size calculates the size of the thin  provisioning  meta‐
15       data  based on the block size of the thin provisioned devices, the size
16       of the thin provisioning pool and the maximum number of all thin provi‐
17       sioned devices and snapshots. Because thin provisioning pools are hold‐
18       ing widely variable contents, this tool is needed to  provide  sensible
19       initial default size.
20

OPTIONS

22       -h, --help
23              Print help and exit.
24
25       -V, --version
26              Print version information and exit.
27
28       -b, --block-size {BLOCKSIZE[bskKmMgGtTpPeEzZyY]}
29              Set block size.
30
31           Block size of thin provisioned devices in units of bytes, sectors,
32           kibibytes, kilobytes, ... respectively. Default is in sectors without a
33           block size unit specifier. Size/number option arguments can be followed by
34           unit specifiers in short one character and long form (eg. -b1m or
35           -b1mebibytes).
36
37
38       -s, --pool-size {POOLSIZE[bskKmMgGtTpPeEzZyY]}
39              Set pool size.
40
41           Thin provisioning pool size in units of bytes, sectors, kibibytes,
42           kilobytes, ... respectively. Default is in sectors without a pool size
43           unit specifier.
44
45
46       -m, --max-thins {count[bskKmMgGtTpPeEzZyY]}
47              Set max thins.
48
49           Maximum sum of all thin provisioned devices and snapshots. Unit identifier
50           supported to allow for convenient entry of large quantities, eg. 1000000 =
51           1M. Default is absolute quantity without a number unit specifier.
52
53       -u, --unit {bskKmMgGtTpPeEzZyY}
54
55           Output unit specifier in units of bytes, sectors, kibibytes, kilobytes, ...
56           respectively. Default is in sectors without an output unit specifier.
57
58
59       -n, --numeric-only {short|long}
60              Limit output to just the size number.
61

EXAMPLES

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

DIAGNOSTICS

86       thin_metadata_size returns an exit code of 0 for success or 1  for  er‐
87       ror.
88

SEE ALSO

90       thin_dump(8),     thin_check(8),    thin_repair(8),    thin_restore(8),
91       thin_rmap(8)
92

AUTHOR

94       Joe Thornber <ejt@redhat.com>, Heinz Mauelshagen <HeinzM@RedHat.com>
95
96
97
98System Manager's Manual       Device Mapper Tools        thin_metadata_size(8)
Impressum