[thirdparty/xfsprogs-dev.git] / man / man8 / xfs_estimate.8

.TH xfs_estimate 8
.SH NAME
xfs_estimate \- estimate the space that an XFS filesystem will take
.SH SYNOPSIS
.nf
\f3xfs_estimate\f1 [ \f3\-h\f1 ] [ \f3\-b\f1 blocksize ] [ \f3\-i\f1 logsize ]
		   [ \f3\-e\f1 logsize ] [ \f3\-v\f1 ] directory ...
.br
.B xfs_estimate \-V
.fi
.SH DESCRIPTION
For each \f2directory\f1 argument,
.I xfs_estimate
estimates the space that directory would take if it were copied to an XFS
filesystem.
.I xfs_estimate
does not cross mount points.
The following definitions
are used:
.PD 0
.IP
KB = *1024
.IP
MB = *1024*1024
.IP
GB = *1024*1024*1024
.PD
.PP
The
.I xfs_estimate
options are:
.TP
\f3\-b\f1 \f2blocksize\f1
Use
.I blocksize
instead of the default blocksize of 4096 bytes.
The modifier
.B k
can be used
after the number to indicate multiplication by 1024.
For example,
.sp .8v
.RS
	\f4xfs_estimate \-b 64k /\f1
.RE
.IP
requests an estimate of the space required by the directory / on an
XFS filesystem using a blocksize of 64K (65536) bytes.
.TP
.B \-v
Display more information, formatted.
.TP
.B \-h
Display usage message.
.TP
\f3\-i, \-e\f1 \f2logsize\f1
Use
.I logsize
instead of the default log size of 1000 blocks.
.B \-i
refers to an internal log, while
.B \-e
refers to an external log.
The modifiers
.B k
or
.B m
can be used
after the number to indicate multiplication by 1024 or 1048576, respectively.
.IP
For example,
.sp .8v
.RS
	\f4xfs_estimate \-i 1m /\f1
.RE
.IP
requests an estimate of the space required by the directory / on an
XFS filesystem using an internal log of 1 megabyte.
.TP
.B \-V
Print the version number and exits.
.SH EXAMPLES
.nf
.sp 8v
% \f4xfs_estimate \-e 10m /var/tmp\f1\f7
/var/tmp will take about 4.2 megabytes
        with the external log using 2560 blocks or about 10.0 megabytes
.fi
.nf
.sp .8v
% \f4xfs_estimate \-v \-e 10m /var/tmp\f1\f7
directory                     bsize   blocks    megabytes    logsize
/var/tmp                       4096      792        4.0MB   10485760
.fi
.nf
.sp .8v
% \f4xfs_estimate \-v /var/tmp\f1\f7
directory                     bsize   blocks    megabytes    logsize
/var/tmp                       4096     3352       14.0MB   10485760
.fi
.nf
.sp .8v
% \f4xfs_estimate /var/tmp\f1\f7
/var/tmp will take about 14.0 megabytes
.fi
Commit	Line	Data
c84e0133 CH	1	.TH xfs_estimate 8
	2	.SH NAME
	3	xfs_estimate \- estimate the space that an XFS filesystem will take
	4	.SH SYNOPSIS
	5	.nf
eaa6a2bf	6	\f3xfs_estimate\f1 [ \f3\-h\f1 ] [ \f3\-b\f1 blocksize ] [ \f3\-i\f1 logsize ]
c84e0133	7	[ \f3\-e\f1 logsize ] [ \f3\-v\f1 ] directory ...
eaa6a2bf ES	8	.br
eaa6a2bf ES	9	.B xfs_estimate \-V
c84e0133 CH	10	.fi
	11	.SH DESCRIPTION
	12	For each \f2directory\f1 argument,
	13	.I xfs_estimate
	14	estimates the space that directory would take if it were copied to an XFS
	15	filesystem.
	16	.I xfs_estimate
	17	does not cross mount points.
	18	The following definitions
	19	are used:
	20	.PD 0
	21	.IP
	22	KB = *1024
	23	.IP
	24	MB = 10241024
	25	.IP
	26	GB = 10241024*1024
	27	.PD
	28	.PP
	29	The
	30	.I xfs_estimate
	31	options are:
	32	.TP
	33	\f3\-b\f1 \f2blocksize\f1
	34	Use
	35	.I blocksize
	36	instead of the default blocksize of 4096 bytes.
	37	The modifier
	38	.B k
	39	can be used
	40	after the number to indicate multiplication by 1024.
	41	For example,
	42	.sp .8v
	43	.RS
	44	\f4xfs_estimate \-b 64k /\f1
	45	.RE
	46	.IP
	47	requests an estimate of the space required by the directory / on an
	48	XFS filesystem using a blocksize of 64K (65536) bytes.
	49	.TP
	50	.B \-v
	51	Display more information, formatted.
	52	.TP
	53	.B \-h
	54	Display usage message.
	55	.TP
c84e0133 CH	56	\f3\-i, \-e\f1 \f2logsize\f1
	57	Use
	58	.I logsize
	59	instead of the default log size of 1000 blocks.
	60	.B \-i
	61	refers to an internal log, while
	62	.B \-e
	63	refers to an external log.
	64	The modifiers
	65	.B k
	66	or
	67	.B m
	68	can be used
	69	after the number to indicate multiplication by 1024 or 1048576, respectively.
	70	.IP
	71	For example,
	72	.sp .8v
	73	.RS
	74	\f4xfs_estimate \-i 1m /\f1
	75	.RE
	76	.IP
	77	requests an estimate of the space required by the directory / on an
	78	XFS filesystem using an internal log of 1 megabyte.
eaa6a2bf ES	79	.TP
	80	.B \-V
	81	Print the version number and exits.
c84e0133 CH	82	.SH EXAMPLES
	83	.nf
	84	.sp 8v
	85	% \f4xfs_estimate \-e 10m /var/tmp\f1\f7
	86	/var/tmp will take about 4.2 megabytes
	87	with the external log using 2560 blocks or about 10.0 megabytes
	88	.fi
	89	.nf
	90	.sp .8v
	91	% \f4xfs_estimate \-v \-e 10m /var/tmp\f1\f7
	92	directory bsize blocks megabytes logsize
	93	/var/tmp 4096 792 4.0MB 10485760
	94	.fi
	95	.nf
	96	.sp .8v
	97	% \f4xfs_estimate \-v /var/tmp\f1\f7
	98	directory bsize blocks megabytes logsize
	99	/var/tmp 4096 3352 14.0MB 10485760
	100	.fi
	101	.nf
	102	.sp .8v
	103	% \f4xfs_estimate /var/tmp\f1\f7
	104	/var/tmp will take about 14.0 megabytes
	105	.fi