← Back to branch summary

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

« back to all changes in this revision

Viewing changes to man/man8/xfs_admin.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:
man/man8/xfs_admin.8
 
1
.TH xfs_admin 8
 
2
.SH NAME
 
3
xfs_admin \- change parameters of an XFS filesystem
 
4
.SH SYNOPSIS
 
5
.nf
 
6
\f3xfs_admin\f1 [ \f3-lu\f1] [ \f3\-L \f2label\f1 ] [ \f3\-U \f2uuid\f1 ] device
 
7
\f3xfs_admin \-f\f1 [ \f3-lu\f1] [ \f3\-L \f2label\f1 ] [ \f3\-U \f2uuid\f1 ] filename
 
8
.fi
 
9
.SH DESCRIPTION
 
10
.I xfs_admin
 
11
uses the
 
12
.IR xfs_db (8)
 
13
command to modify various parameters of a filesystem.
 
14
.PP
 
15
Devices that are mounted cannot be modified.
 
16
Administrators must unmount filesystems before
 
17
.I xfs_admin
 
18
or
 
19
.I xfs_db
 
20
can convert parameters.
 
21
A number of parameters of a mounted filesystem can be examined
 
22
and modified using the
 
23
.IR xfs_growfs (8)
 
24
command.
 
25
.SH OPTIONS
 
26
.TP 5
 
27
\f3\-f\f1
 
28
Specifies that the filesystem image to be processed is stored in a
 
29
regular file (see the \f2mkfs.xfs\f1 \f3\-d\f1 \f2file\f1 option).
 
30
.TP 5
 
31
\f3\-l\f1
 
32
Print the current filesystem label.
 
33
.TP 5
 
34
\f3\-u\f1
 
35
Print the current filesystem UUID (Universally Unique IDentifier).
 
36
.TP 5
 
37
\f3\-L\f1 \f2label\f1
 
38
Set the filesystem label.
 
39
XFS filesystem labels can be at most 12 characters long; if
 
40
.I label
 
41
is longer than 12 characters,
 
42
.I xfs_admin
 
43
will truncate it and print a warning message.
 
44
The filesystem label can be cleared using the special ``\c
 
45
.BR \-\- ''
 
46
value for
 
47
.IR label .
 
48
.TP 5
 
49
\f3\-U\f1 \f2UUID\f1
 
50
Set the UUID of the filesystem.
 
51
A sample UUID looks like this: "c1b9d5a2-f162-11cf-9ece-0020afc76f16".
 
52
The uuid may also be
 
53
.IR null ,
 
54
which will set the filesystem UUID to the null UUID.
 
55
The uuid may also be
 
56
.IR generate ,
 
57
which will generate a new UUID for the filesystem.
 
58
.PP
 
59
The
 
60
.IR mount (8)
 
61
manual entry describes how to mount a filesystem using its label or UUID,
 
62
rather than its block special device name.
 
63
.SH SEE ALSO
 
64
mkfs.xfs(8),
 
65
mount(8),
 
66
xfs_db(8),
 
67
xfs_growfs(8),
 
68
xfs(5).