Debian Codegraph @

upstream/debian-trixie/man8/mkreiserfs.8

raw
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)