~ubuntu-branches/ubuntu/trusty/util-linux/trusty-proposed

« back to all changes in this revision

Viewing changes to disk-utils/mkfs.8

  • Committer: Package Import Robot
  • Author(s): LaMont Jones
  • Date: 2011-11-03 15:38:23 UTC
  • mto: (4.5.5 sid) (1.6.4)
  • mto: This revision was merged to the branch mainline in revision 85.
  • Revision ID: package-import@ubuntu.com-20111103153823-10sx16jprzxlhkqf
ImportĀ upstreamĀ versionĀ 2.20.1

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
.\" -*- nroff -*-
2
 
.TH MKFS 8 "Jun 1995" "Version 1.9"
 
2
.TH MKFS 8 "June 2011" "util-linux" "System Administration"
3
3
.SH NAME
4
 
mkfs \- build a Linux file system
 
4
mkfs \- build a Linux filesystem
 
5
.SH SYNOPSIS
5
6
.SH SYNOPSIS
6
7
.B mkfs
7
 
.RB [ \-V ]
 
8
.RI [ options ]
8
9
.RB [ \-t
9
 
.IR fstype ]
10
 
.RI [ fs-options ]
11
 
.I filesys
12
 
.RI [ blocks ]
 
10
.IR "type fs-options" ] " device " [ size ]
13
11
.SH DESCRIPTION
14
12
.B mkfs
15
 
is used to build a Linux file system on a device, usually
16
 
a hard disk partition.
17
 
.I filesys
18
 
is either the device name (e.g.
 
13
is used to build a Linux filesystem on a device, usually
 
14
a hard disk partition.  The
 
15
.I device
 
16
argument is either the device name (e.g.
19
17
.IR /dev/hda1 ,
20
18
.IR /dev/sdb2 ),
21
 
or a regular file that shall contain the file system.
22
 
.I blocks
23
 
is the number of blocks to be used for the file system.
 
19
or a regular file that shall contain the filesystem.  The
 
20
.I size
 
21
argument is the number of blocks to be used for the filesystem.
24
22
.PP
25
23
The exit code returned by
26
24
.B mkfs
28
26
.PP
29
27
In actuality,
30
28
.B mkfs
31
 
is simply a front-end for the various file system builders
 
29
is simply a front-end for the various filesystem builders
32
30
(\fBmkfs.\fIfstype\fR)
33
31
available under Linux.
34
 
The file system-specific builder is searched for in a number
35
 
of directories like perhaps
 
32
The filesystem-specific builder is searched for in a number
 
33
of directories, like perhaps
36
34
.IR /sbin ,
37
35
.IR /sbin/fs ,
38
36
.IR /sbin/fs.d ,
45
43
.IR /sbin/fs ),
46
44
and finally in the directories
47
45
listed in the PATH environment variable.
48
 
Please see the file system-specific builder manual pages for
 
46
Please see the filesystem-specific builder manual pages for
49
47
further details.
50
48
.SH OPTIONS
51
49
.TP
52
 
.B -V
53
 
Produce verbose output, including all file system-specific commands
 
50
.BR \-t , " \-\-type " \fItype\fR
 
51
Specify the \fItype\fR of filesystem to be built.
 
52
If not specified, the default filesystem type
 
53
(currently ext2) is used.
 
54
.TP
 
55
.I fs-options
 
56
Filesystem-specific options to be passed to the real filesystem builder.
 
57
Although not guaranteed, the following options are supported
 
58
by most filesystem builders.
 
59
.TP
 
60
.BR \-V , " \-\-verbose"
 
61
Produce verbose output, including all filesystem-specific commands
54
62
that are executed.
55
63
Specifying this option more than once inhibits execution of any
56
 
file system-specific commands.
 
64
filesystem-specific commands.
57
65
This is really only useful for testing.
58
66
.TP
59
 
.BI -t \ fstype
60
 
Specifies the type of file system to be built.
61
 
If not specified, the default file system type
62
 
(currently ext2) is used.
63
 
.TP
64
 
.I fs-options
65
 
File system-specific options to be passed to the real file
66
 
system builder.
67
 
Although not guaranteed, the following options are supported
68
 
by most file system builders.
69
 
.TP
70
 
.B -c
71
 
Check the device for bad blocks before building the file system.
72
 
.TP
73
 
.BI -l \ filename
74
 
Read the bad blocks list from
75
 
.I filename
76
 
.TP
77
 
.B -v
78
 
Produce verbose output.
 
67
.BR \-V , " \-\-version"
 
68
Display version information and exit.  (Option \fB\-V\fR will display
 
69
version information only when it is the only parameter, otherwise it
 
70
will work as \fB\-\-verbose\fR.)
 
71
.TP
 
72
.BR \-h , " \-\-help"
 
73
Display help and exit.
79
74
.SH BUGS
80
75
All generic options must precede and not be combined with
81
 
file system-specific options.
82
 
Some file system-specific programs do not support the
83
 
.I -v
 
76
filesystem-specific options.
 
77
Some filesystem-specific programs do not support the
 
78
.B -V
84
79
(verbose) option, nor return meaningful exit codes.
85
 
Also, some file system-specific programs do not automatically
 
80
Also, some filesystem-specific programs do not automatically
86
81
detect the device size and require the
87
 
.I blocks
 
82
.I size
88
83
parameter to be specified.
89
84
.SH AUTHORS
90
85
David Engel (david@ods.com)
94
89
Ron Sommeling (sommel@sci.kun.nl)
95
90
.br
96
91
The manual page was shamelessly adapted from Remy Card's version
97
 
for the ext2 file system.
 
92
for the ext2 filesystem.
98
93
.SH SEE ALSO
99
94
.BR fs (5),
100
95
.BR badblocks (8),