~ubuntu-branches/ubuntu/utopic/xfsprogs/utopic-proposed

« back to all changes in this revision

Viewing changes to man/man8/xfs_growfs.8

  • Committer: Bazaar Package Importer
  • Author(s): Nathan Scott
  • Date: 2002-04-13 09:45:06 UTC
  • Revision ID: james.westby@ubuntu.com-20020413094506-t8dhemv41gkeg4kx
Tags: 2.0.3-1
New upstream bugfix release

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.TH xfs_growfs 8
 
2
.SH NAME
 
3
xfs_growfs, xfs_info \- expand an XFS filesystem
 
4
.SH SYNOPSIS
 
5
.nf
 
6
\f3xfs_growfs\f1 [ \f3\-dilnrxV\f1 ] [ \f3\-D\f1 size ] [ \f3\-e\f1 rtextsize ]
 
7
                [ \f3\-L\f1 size ] [ \f3\-m\f1 maxpct ] [ \f3-t\f1 mtab ]
 
8
                [ \f3\-R\f1 size ] mount-point
 
9
\f3xfs_info\f1 [ \f3-t\f1 mtab ] mount-point
 
10
.fi
 
11
.SH DESCRIPTION
 
12
.I xfs_growfs
 
13
expands an existing XFS filesystem (see
 
14
.IR xfs (5)).
 
15
The
 
16
.I mount-point
 
17
argument is the pathname of the directory where the filesystem
 
18
is mounted.
 
19
The filesystem must be mounted to be grown (see
 
20
.IR mount (8)).
 
21
The existing contents of the filesystem are undisturbed, and the added space
 
22
becomes available for additional file storage.
 
23
.PP
 
24
.I xfs_info
 
25
is equivalent to invoking
 
26
.I xfs_growfs
 
27
with the
 
28
.B \-n
 
29
option (see discussion below).
 
30
.PP
 
31
The options to
 
32
.I xfs_growfs
 
33
are:
 
34
.TP
 
35
\f3\-d\f1, \f3\-D\f1 \f2size\f1
 
36
Specifies that the data section of the filesystem should be grown.
 
37
If the
 
38
.B \-D
 
39
.I size
 
40
option is given, the data section is grown to that size, otherwise
 
41
the data section is grown to the largest size possible.
 
42
The size
 
43
is expressed in
 
44
filesystem blocks.
 
45
.TP
 
46
.B \-e
 
47
Allows the real-time extent size to be specified.
 
48
In
 
49
.IR mkfs.xfs (8)
 
50
this is specified with
 
51
.B \-r
 
52
.BI extsize= nnnn.
 
53
.TP
 
54
.B \-i
 
55
The new log is an internal log
 
56
(inside the data section).
 
57
.TP
 
58
\f3\-l\f1, \f3\-L\f1 \f2size\f1
 
59
Specifies that the log section of the filesystem should be grown,
 
60
shrunk, or moved.
 
61
If the
 
62
.B \-L
 
63
.I size
 
64
option is given, the log section is changed to be that size,
 
65
if possible.
 
66
The size is expressed in
 
67
filesystem blocks.
 
68
The size of an internal log must be smaller than the size
 
69
of an allocation group (this value is printed at \f2mkfs\f1(8) time).
 
70
If neither
 
71
.B \-i
 
72
nor
 
73
.B \-x
 
74
is given with
 
75
.BR \-l ,
 
76
the log continues to be internal or external as it was before.
 
77
.TP
 
78
.B \-m
 
79
Specify a new value for the maximum percentage
 
80
of space in the filesystem that can be allocated as inodes.
 
81
In
 
82
.I mkfs.xfs
 
83
this is specified with
 
84
.B -i
 
85
.BI maxpct= nn.
 
86
.TP
 
87
.B \-n
 
88
Specifies that no change to the filesystem is to be made.
 
89
The filesystem geometry is printed, and argument checking is performed,
 
90
but no growth occurs.
 
91
.TP
 
92
\f3\-r\f1, \f3\-R\f1 \f2size\f1
 
93
Specifies that the real-time section of the filesystem should be grown.
 
94
If the
 
95
.B \-R
 
96
.I size
 
97
option is given, the real-time section is grown to that size, otherwise
 
98
the real-time section is grown to the largest size possible.
 
99
The size
 
100
is expressed in
 
101
filesystem blocks.
 
102
The filesystem does not need to have contained a real-time section before
 
103
the \f2xfs_growfs\f1 operation.
 
104
.TP
 
105
.B \-t
 
106
Specifies an alternate mount table file (default is
 
107
.IR /etc/mtab ).
 
108
This is used when working with filesystems mounted without writing to
 
109
.I /etc/mtab
 
110
file - refer to
 
111
.BR mount (8)
 
112
for further details.
 
113
.TP
 
114
.PP
 
115
.I xfs_growfs
 
116
is most often used in conjunction with
 
117
logical volumes
 
118
(see
 
119
.IR lvm (8)
 
120
).
 
121
However, it can also be used on a regular disk partition, for example if a
 
122
partition has been enlarged while retaining the same starting block.
 
123
.SH PRACTICAL USE
 
124
Filesystems normally occupy all of the space on the device where they
 
125
reside.
 
126
In order to grow a filesystem, it is necessary to provide added
 
127
space for it to occupy.
 
128
Therefore there must be at least one spare new disk partition available.
 
129
Adding the space is often done through the use of a logical volume manager.
 
130
.SH SEE ALSO
 
131
mkfs.xfs(8),
 
132
lvm(8),
 
133
mount(8).