← Back to branch summary

~ubuntu-branches/ubuntu/precise/util-linux/precise

« back to all changes in this revision

Viewing changes to disk-utils/mkfs.8

  • Committer: Package Import Robot
  • Author(s): Steve Langasek
  • Date: 2011-12-16 22:53:42 UTC
  • mfrom: (1.6.4) (4.5.5 sid)
  • Revision ID: package-import@ubuntu.com-20111216225342-206wz4bhvutyvx0d
Tags: 2.20.1-1ubuntu1
* Merge from Debian unstable, remaining changes:
  - Build for multiarch.
  - Add pre-depends on multiarch-support.
  - configure.ac: don't try to be clever about extracting a path name from
    $libdir to append to /usr in a way that's not overridable; instead,
    reuse the built-in configurable libexecdir.
  - Fix up the .pc.in files to know about libexecdir, so our substitutions
    don't leave us with unusable pkg-config files.
  - Install custom blkid.conf to use /dev/.blkid.tab since we don't
    expect device names to survive a reboot
  - Mention mountall(8) in fstab(5) manpages, along with its special
    options.
  - Since upstart is required in Ubuntu, the hwclock.sh init script is not
    called on startup and the hwclockfirst.sh init script is removed.
  - Drop depends on initscripts for the above.
  - Replace hwclock udev rule with an Upstart job.
  - For the case where mount is called with a directory to mount, look
    that directory up in mountall's /lib/init/fstab if we couldn't find
    it mentioned anywhere else.  This means "mount /proc", "mount /sys",
    etc. work.
  - mount.8 points to the cifs-utils package, not the obsolete smbfs one. 
  - Use canonicalize_spec in getmntdevbackward. proc should not be
    interpreted as a non-canonical-path.
* Dropped changes, superseded upstream:
  - shlibs/mount/src/tab_update.c: don't refuse to update mtab when source
    is 'none'.

Show diffs side-by-side

added added

removed removed

Lines of Context:
disk-utils/mkfs.8
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),