File: xfs_admin.8

package info (click to toggle)
xfsprogs 2.9.8-1lenny1
  • links: PTS
  • area: main
  • in suites: lenny
  • size: 5,512 kB
  • ctags: 9,344
  • sloc: ansic: 92,865; makefile: 765; sh: 639
file content (108 lines) | stat: -rw-r--r-- 2,589 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
.TH xfs_admin 8
.SH NAME
xfs_admin \- change parameters of an XFS filesystem
.SH SYNOPSIS
.B xfs_admin
[
.B \-eflu
] [
.BR "\-c 0" | 1
] [
.B \-L
.I label
] [
.B \-U
.I uuid
]
.I device
.SH DESCRIPTION
.B xfs_admin
uses the
.BR xfs_db (8)
command to modify various parameters of a filesystem.
.PP
Devices that are mounted cannot be modified.
Administrators must unmount filesystems before
.BR xfs_admin " or " xfs_db (8)
can convert parameters.
A number of parameters of a mounted filesystem can be examined
and modified using the
.BR xfs_growfs (8)
command.
.SH OPTIONS
.TP
.B \-e
Enables unwritten extent support on a filesystem that does not
already have this enabled (for legacy filesystems, it can't be
disabled anymore at mkfs time).
.TP
.B \-f
Specifies that the filesystem image to be processed is stored in a
regular file at
.I device
(see the
.B mkfs.xfs \-d
.I file
option).
.TP
.B \-j
Enables version 2 log format (journal format supporting larger
log buffers).
.TP
.B \-l
Print the current filesystem label.
.TP
.B \-u
Print the current filesystem UUID (Universally Unique IDentifier).
.TP
.BR "\-c 0" | 1
Enable (1) or disable (0) lazy-counters in the filesystem.
This operation may take quite a bit of time on large filesystems as the
entire filesystem needs to be scanned when this option is changed.
.IP
With lazy-counters enabled, the superblock is not modified or logged on
every change of the free-space and inode counters. Instead, enough
information is kept in other parts of the filesystem to be able to
maintain the counter values without needing to keep them in the
superblock. This gives significant improvements in performance on some
configurations and metadata intensive workloads.
.TP
.BI \-L " label"
Set the filesystem label to
.IR label .
XFS filesystem labels can be at most 12 characters long; if
.I label
is longer than 12 characters,
.B xfs_admin
will truncate it and print a warning message.
The filesystem label can be cleared using the special "\c
.B \-\-\c
" value for
.IR label .
.TP
.BI \-U " uuid"
Set the UUID of the filesystem to
.IR uuid .
A sample UUID looks like this: "c1b9d5a2-f162-11cf-9ece-0020afc76f16".
The
.I uuid
may also be
.BR nil ,
which will set the filesystem UUID to the null UUID.
The
.I uuid
may also be
.BR generate ,
which will generate a new UUID for the filesystem.
.PP
The
.BR mount (8)
manual entry describes how to mount a filesystem using its label or UUID,
rather than its block special device name.
.SH SEE ALSO
.BR mkfs.xfs (8),
.BR mount (8),
.BR xfs_db (8),
.BR xfs_growfs (8),
.BR xfs_repair (8),
.BR xfs (5).