| .\" -*- nroff -*- |
| .\" Copyright 1996-2003 Hans Reiser. |
| .\" |
| .TH MKREISERFS 8 "April 2003" "Reiserfsprogs-3.6.9" |
| .SH NAME |
| mkreiserfs \- create a Linux ReiserFS file system |
| .SH SYNOPSIS |
| .B mkreiserfs |
| [ \fB-dfV\fR ] |
| [ \fB-b\fR | \fB--block-size \fIN\fR ] |
| [ \fB-h\fR | \fB--hash \fIHASH\fR ] |
| [ \fB-u\fR | \fB--uuid \fIUUID\fR ] |
| [ \fB-l\fR | \fB--label \fILABEL\fR ] |
| [ \fB--format \fIFORMAT\fR ] |
| [ \fB-q\fR | \fB--quiet\fR ] |
| [ \fB-j\fR | \fB--journal-device \fIFILE\fR ] |
| [ \fB-s\fR | \fB--journal-size \fIN\fR ] |
| [ \fB-o\fR | \fB--journal-offset \fIN\fR ] |
| [ \fB-t\fR | \fB--transaction-max-size\fR \fIN\fR ] \fI device\fR |
| [ \fIfilesystem-size\fR ] |
| .SH DESCRIPTION |
| It creates a Linux ReiserFS file system on a device |
| (usually a disk partition). |
| .TP |
| .I device |
| is the special file corresponding to the device (e.g /dev/hdXX for |
| IDE disk partition or /dev/sdXX for SCSI disk partition). |
| .TP |
| .I filesystem-size |
| size of filesystem in blocks. If omitted, it will be |
| determined by |
| .B mkreiserfs |
| automatically. |
| .SH OPTIONS |
| .TP |
| \fB-b\fR | \fB--block-size \fIN\fR |
| \fIN\fR is block size in bytes. 4096 only for now. |
| .TP |
| \fB-h\fR | \fB--hash \fIHASH\fR |
| \fIHASH\fR specifies the name of hash function file names in directories |
| will be sorted with. Choose one of r5, rupasov, tea. r5 is default |
| .TP |
| \fB--format \fIFORMAT\fR |
| \fIFORMAT\fR specifies a format new filsystem has to be of. Choose one |
| of 3.5 and 3.6. If none is specified \fBmkreiserfs\fR will create format 3.6 |
| if running kernel is 2.4, 3.5 if 2.2 is running, and will refuse |
| creation under other kernels. |
| .TP |
| \fB-u\fR | \fB--uuid \fIUUID\fR |
| Set the universally unique identifier (\fB UUID \fR) of the filesystem to |
| \fIUUID\fR (see also \fBuuidgen(8)\fR). The format of the UUID is a |
| series of hex digits separated by hypthens, like this: |
| "c1b9d5a2-f162-11cf-9ece-0020afc76f16". If the option skipped, |
| \fBmkreiserfs\fR generates a new one. |
| .TP |
| \fB-l\fR | \fB--label \fILABEL\fR |
| Set the volume label of the filesystem. \fILABEL\fR can be at most 16 |
| characters long; if it is longer than 16 characters, \fBmkreiserfs\fR will truncate it. |
| .TP |
| \fB-q\fR | \fB--quiet \fR |
| Make \fBmkreiserfs\fR to work quiet without producing any message, progress and question. |
| It is useful if you run \fBmkreiserfs\fR in a script. For use by end users only. |
| .TP |
| \fB-j\fR | \fB--journal-device \fIFILE\fR |
| \fIFILE\fR is name of block device where the file system is to have |
| journal on. |
| .TP |
| \fB-o\fR | \fB--journal-offset \fIN\fR |
| \fIN\fR is an offset where journal starts when it is to be on a |
| separate device. Default is 0. Makes no effect when journal is to be |
| on a host device |
| .TP |
| \fB-s\fR | \fB--journal-size \fIN |
| \fIN\fR is size of journal in blocks. When journal is to be on a |
| separate device - its size defaults to number of blocks that device |
| has. When journal is to be on a host device - its size defaults 8193 |
| and maximal possible value is 32749 (for blocksize 4k). Minimun is 513 |
| for both cases. |
| .TP |
| \fB-t\fR | \fB--transaction-max-size \fIN |
| \fIN\fR is the maximum transaction size parameter for the journal. The |
| default, and max possible, value is 1024 blocks. It should be less |
| than half the size of the journal. If specifed incorrectly, it will be |
| adjusted. |
| .TP |
| \fB-f\fR |
| This forces \fBmkreiserfs\fR to continue even if device is either whole |
| disk, or looks mounted or is not a block device. Specified more than |
| once allows to avoid asking for confirmation. |
| .TP |
| \fB-d\fR |
| This makes \fBmkreiserfs\fR to print debugging information during \fBmkreiserfs\fR. |
| .TP |
| \fB-V\fR |
| This prints version and exits. |
| |
| .SH AUTHOR |
| This version of |
| .B mkreiserfs |
| has been written by Edward Shishkin <edward@namesys.com>. |
| .SH BUGS |
| No other blocksizes but 4k are available. |
| Please, report about other bugs to |
| the ReiserFS mail-list <reiserfs-list@namesys.com> |
| .SH SEE ALSO |
| .BR reiserfsck (8), |
| .BR debugreiserfs (8), |
| .BR reiserfstune (8) |