summaryrefslogtreecommitdiffstats
path: root/disk-utils/mkfs.cramfs.8
blob: 9eef51afa6f3fa4fb50571cb6095b398856b89d5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
'\" t
.\"     Title: mkfs.cramfs
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.20
.\"      Date: 2023-11-21
.\"    Manual: System Administration
.\"    Source: util-linux 2.39.3
.\"  Language: English
.\"
.TH "MKFS.CRAMFS" "8" "2023-11-21" "util\-linux 2.39.3" "System Administration"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NAME"
mkfs.cramfs \- make compressed ROM file system
.SH "SYNOPSIS"
.sp
\fBmkfs.cramfs\fP [options] \fIdirectory file\fP
.SH "DESCRIPTION"
.sp
Files on cramfs file systems are zlib\-compressed one page at a time to allow random read access. The metadata is not compressed, but is expressed in a terse representation that is more space\-efficient than conventional file systems.
.sp
The file system is intentionally read\-only to simplify its design; random write access for compressed files is difficult to implement. cramfs ships with a utility (\fBmkcramfs\fP(8)) to pack files into new cramfs images.
.sp
File sizes are limited to less than 16 MB.
.sp
Maximum file system size is a little under 272 MB. (The last file on the file system must begin before the 256 MB block, but can extend past it.)
.SH "ARGUMENTS"
.sp
The \fIdirectory\fP is simply the root of the directory tree that we want to generate a compressed filesystem out of.
.sp
The \fIfile\fP will contain the cram file system, which later can be mounted.
.SH "OPTIONS"
.sp
\fB\-v\fP
.RS 4
Enable verbose messaging.
.RE
.sp
\fB\-E\fP
.RS 4
Treat all warnings as errors, which are reflected as command exit status.
.RE
.sp
\fB\-b\fP \fIblocksize\fP
.RS 4
Use defined block size, which has to be divisible by page size.
.RE
.sp
\fB\-e\fP \fIedition\fP
.RS 4
Use defined file system edition number in superblock.
.RE
.sp
\fB\-N\fP \fIbig, little, host\fP
.RS 4
Use defined endianness. Value defaults to \fIhost\fP.
.RE
.sp
\fB\-i\fP \fIfile\fP
.RS 4
Insert a \fIfile\fP to cramfs file system.
.RE
.sp
\fB\-n\fP \fIname\fP
.RS 4
Set name of the cramfs file system.
.RE
.sp
\fB\-p\fP
.RS 4
Pad by 512 bytes for boot code.
.RE
.sp
\fB\-s\fP
.RS 4
This option is ignored. Originally the \fB\-s\fP turned on directory entry sorting.
.RE
.sp
\fB\-z\fP
.RS 4
Make explicit holes.
.RE
.sp
\fB\-l\fP[=\fImode\fP]
.RS 4
Use exclusive BSD lock for device or file it operates.  The optional argument
\fImode\fP can be \fIyes\fP, \fIno\fP (or 1 and 0) or \fInonblock\fP.  If the \fImode\fP
argument is omitted, it defaults to \fI"yes"\fP.  This option overwrites
environment variable \fB$LOCK_BLOCK_DEVICE\fP.  The default is not to use any
lock at all, but it\(cqs recommended to avoid collisions with udevd or other
tools.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
Display help text and exit.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
Print version and exit.
.RE
.SH "EXIT STATUS"
.sp
\fB0\fP
.RS 4
success
.RE
.sp
\fB8\fP
.RS 4
operation error, such as unable to allocate memory
.RE
.SH "SEE ALSO"
.sp
\fBfsck.cramfs\fP(8),
\fBmount\fP(8)
.SH "REPORTING BUGS"
.sp
For bug reports, use the issue tracker at \c
.URL "https://github.com/util\-linux/util\-linux/issues" "" "."
.SH "AVAILABILITY"
.sp
The \fBmkfs.cramfs\fP command is part of the util\-linux package which can be downloaded from \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Linux Kernel Archive" "."