| 1 |
.\" -*- nroff -*- |
| 2 |
.\" Copyright 1996-2004 Hans Reiser. |
| 3 |
.\" |
| 4 |
.TH MKREISERFS 8 "January 2009" "Reiserfsprogs-3.6.27" |
| 5 |
.SH NAME |
| 6 |
mkreiserfs \- The create tool for the Linux ReiserFS filesystem. |
| 7 |
.SH SYNOPSIS |
| 8 |
.B mkreiserfs |
| 9 |
[ \fB-dfV\fR ] |
| 10 |
[ \fB-b\fR | \fB--block-size \fIN\fR ] |
| 11 |
[ \fB-h\fR | \fB--hash \fIHASH\fR ] |
| 12 |
[ \fB-u\fR | \fB--uuid \fIUUID\fR ] |
| 13 |
[ \fB-l\fR | \fB--label \fILABEL\fR ] |
| 14 |
[ \fB--format \fIFORMAT\fR ] |
| 15 |
[ \fB-q\fR | \fB--quiet\fR ] |
| 16 |
[ \fB-j\fR | \fB--journal-device \fIFILE\fR ] |
| 17 |
[ \fB-s\fR | \fB--journal-size \fIN\fR ] |
| 18 |
[ \fB-o\fR | \fB--journal-offset \fIN\fR ] |
| 19 |
[ \fB-t\fR | \fB--transaction-max-size\fR \fIN\fR ] |
| 20 |
[ \fB-B\fR | \fB--badblocks\fR \fIfile\fR ] \fI device\fR |
| 21 |
[ \fIfilesystem-size\fR ] |
| 22 |
.SH DESCRIPTION |
| 23 |
\fBmkreiserfs\fR creates a Linux ReiserFS filesystem on a device (usually a disk |
| 24 |
partition). |
| 25 |
.TP |
| 26 |
.I device |
| 27 |
is the special file corresponding to a device or to a partition (e.g |
| 28 |
/dev/hdXX for an IDE disk partition or /dev/sdXX for a SCSI disk partition). |
| 29 |
.TP |
| 30 |
.I filesystem-size |
| 31 |
is the size in blocks of the filesystem. If omitted, \fBmkreiserfs\fR will |
| 32 |
automatically set it. |
| 33 |
.SH OPTIONS |
| 34 |
.TP |
| 35 |
\fB-b\fR | \fB--block-size \fIN\fR |
| 36 |
\fIN\fR is block size in bytes. It may only be set to a power of 2 within the |
| 37 |
512-8192 interval. |
| 38 |
.TP |
| 39 |
\fB-h\fR | \fB--hash \fIHASH\fR |
| 40 |
\fIHASH\fR specifies which hash function will sort the names in the directories. |
| 41 |
Choose from r5, rupasov, or tea. r5 is the default one. |
| 42 |
.TP |
| 43 |
\fB--format \fIFORMAT\fR |
| 44 |
\fIFORMAT\fR specifies the format for the new filsystem. Choose format 3.5 or |
| 45 |
3.6. If none is specified \fBmkreiserfs\fR will create format 3.6 if running |
| 46 |
kernel is 2.4 or higher, and format 3.5 if kernel 2.2 is running, and will |
| 47 |
refuse creation under all other kernels. |
| 48 |
.TP |
| 49 |
\fB-u\fR | \fB--uuid \fIUUID\fR |
| 50 |
Sets the Universally Unique IDentifier of the filesystem to \fIUUID\fR |
| 51 |
(see also \fBuuidgen(8)\fR). The format of the \fIUUID\fR is a series |
| 52 |
of hex digits separated by hypthens, e.g.: "c1b9d5a2-f162-11cf-9ece-0020afc76f16". |
| 53 |
If the option is skipped, \fBmkreiserfs\fR will by default generate a new |
| 54 |
\fIUUID\fR. |
| 55 |
.TP |
| 56 |
\fB-l\fR | \fB--label \fILABEL\fR |
| 57 |
Sets the volume label of the filesystem. \fILABEL\fR can at most be 16 |
| 58 |
characters long; if it is longer than 16 characters, \fBmkreiserfs\fR will |
| 59 |
truncate it. |
| 60 |
.TP |
| 61 |
\fB-q\fR | \fB--quiet \fR |
| 62 |
Sets \fBmkreiserfs\fR to work quietly without producing messages, progress or |
| 63 |
questions. It is useful, but only for use by end users, if you run \fBmkreiserfs\fR |
| 64 |
in a script. |
| 65 |
.TP |
| 66 |
\fB-j\fR | \fB--journal-device \fIFILE\fR |
| 67 |
\fIFILE\fR is the name of the block device on which is to be places the |
| 68 |
filesystem journal. |
| 69 |
.TP |
| 70 |
\fB-o\fR | \fB--journal-offset \fIN\fR |
| 71 |
\fIN\fR is the offset where the journal starts when it is to be on a separate |
| 72 |
device. Default is 0. \fIN\fR has no effect when the journal is to be on the |
| 73 |
host device. |
| 74 |
.TP |
| 75 |
\fB-s\fR | \fB--journal-size \fIN |
| 76 |
\fIN\fR is the size of the journal in blocks. When the journal is to be on a |
| 77 |
separate device, its size defaults to the number of blocks that the device has. |
| 78 |
When journal is to be on the host device, its size defaults to 8193 and the |
| 79 |
maximal possible size is 32749 (for blocksize 4k). The minimum size is 513 blocks |
| 80 |
(whether the journal is on the host or on a separate device). |
| 81 |
.TP |
| 82 |
\fB-t\fR | \fB--transaction-max-size \fIN |
| 83 |
\fIN\fR is the maximum transaction size parameter for the journal. The |
| 84 |
default, and max possible, value is 1024 blocks. It should be less |
| 85 |
than half the size of the journal. If specified incorrectly, it will automatically |
| 86 |
be adjusted. |
| 87 |
.TP |
| 88 |
\fB-B\fR | \fB--badblocks \fIfile |
| 89 |
\fIFile\fR is the file name of the file that contains the list of blocks to be |
| 90 |
marked as bad on the filesystem. This list can be created by |
| 91 |
\fB/sbin/badblocks \-b block-size device\fR. |
| 92 |
.TP |
| 93 |
\fB-f\fR |
| 94 |
Forces \fBmkreiserfs\fR to continue even when the device is the whole disk, |
| 95 |
looks mounted, or is not a block device. If \fB-f\fR is specified more than |
| 96 |
once, it allows the user to avoid asking for confirmation. |
| 97 |
.TP |
| 98 |
\fB-d\fR |
| 99 |
Sets \fBmkreiserfs\fR to print debugging information during \fBmkreiserfs\fR. |
| 100 |
.TP |
| 101 |
\fB-V\fR |
| 102 |
Prints the version and then exits. |
| 103 |
|
| 104 |
.SH AUTHOR |
| 105 |
This version of |
| 106 |
.B mkreiserfs |
| 107 |
has been written by Edward Shishkin <[email protected]>. |
| 108 |
.SH BUGS |
| 109 |
Please report bugs to the ReiserFS developers <[email protected]>, providing |
| 110 |
as much information as possible--your hardware, kernel, patches, settings, all printed |
| 111 |
messages; check the syslog file for any related information. |
| 112 |
.SH SEE ALSO |
| 113 |
.BR reiserfsck (8), |
| 114 |
.BR debugreiserfs (8), |
| 115 |
.BR reiserfstune (8) |